Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,11 @@ gen-python/python/gen/static/jupyter_widget.js.map
# Cap'n proto generated files
**/generated/*capnp.rs

# wasm-cli build output
wasm-cli/dist/
wasm-cli/gen-wasm/
wasm-cli/cockle_wasm_env/

# precommit stuff
.cache

Expand Down
4 changes: 2 additions & 2 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,14 @@ repos:
- id: rustfmt
name: rustfmt
description: Check if all files follow the rustfmt style
entry: cargo +nightly fmt --all --
entry: cargo +nightly-2026-06-26 fmt --all --
language: system
types: [file, rust]
pass_filenames: true
- id: rust-clippy
name: Rust clippy
description: Run cargo clippy on files included in the commit. clippy should be installed before-hand.
entry: cargo +nightly clippy --all-targets --all-features -- -D clippy::all
entry: cargo +nightly-2026-06-26 clippy --all-targets --all-features -- -D clippy::all
pass_filenames: false
types: [file, rust]
language: system
Expand Down
8 changes: 8 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,12 @@ The repository is a Cargo workspace. The root crate provides the `gen` CLI and c
- `gen-tui/`, `gen-sugiyama/`: terminal UI and graph layout support.
- `gen-python/`: PyO3/maturin Python bindings and Jupyter widget assets.
- `gen-r/`: R package and Rust bridge crate.
- `wasm-cli/`: browser-based terminal running `gen` compiled to
`wasm32-unknown-emscripten` via `@jupyterlite/cockle` and xterm.js. See
`wasm-cli/README.md` for build steps and, importantly, the Playwright
testing setup — two easy-to-miss details there (serving root vs.
`index.html`, waiting for `.xterm` instead of a fixed sleep) are the
difference between the shell booting and silently hanging forever.
- `fixtures/`: shared test data. Prefer adding small, focused fixtures.
- `tests/`: integration tests.
- `docs/`, `examples/`, `paper/`: user docs, worked examples, and manuscript assets.
Expand Down Expand Up @@ -116,6 +122,8 @@ Use the narrowest reliable validation for the change, then broaden when touching

Some builds and tests need the Cap'n Proto compiler (`capnp`) installed. Python packaging targets may need `maturin`, and R targets may need Docker, R, and npm depending on the path exercised.

For the `wasm-cli/` browser terminal, see `wasm-cli/README.md` for build (`make wasm`/`make wasm-test`) and browser-testing instructions.

## CLI And Fixtures

- Prefer exercising behavior through CLI-level tests or small helper tests when changing imports, updates, exports, patching, or branch operations.
Expand Down
Loading