Contributing

# Clone the repository
git clone https://github.com/capsulerun/vpod
cd vpod

# One-time: generate the AOT stub (a fresh clone has no translated blocks)
./scripts/aot-stub.sh

# Build the WASM component (library + CLI), copied into sdks/python/vpod/
./scripts/build-wasm.sh

# Install the CLI
cargo install --path crates/vpod

# Build the TypeScript SDK, which picks the component up from the Python SDK directory
cd sdks/typescript && npm install && npm run build

# Install the Python SDK in dev mode
pip install -e "sdks/python[dev]"

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all

# Python SDK integration tests (needs the WASM library in place)
cp target/wasm32-wasip2/release/vpod_wasi_lib.wasm sdks/python/vpod/
pytest sdks/python/tests/ -v -m integration

npm run typecheck
npm test           # unit
npm run test:all   # unit + integration, needs a local snapshot
npm run test:perf  # guest-time regressions, exact constants

// TypeScript: a file on disk (Node), or bytes (anywhere)
await Sandbox.create({ snapshot: { path: "./dist/alpine-3.23.0-256mb.snap" } });
await Sandbox.create({ snapshot: { bytes, name: "alpine-3.23.0-256mb.snap" } });

# Python and the CLI: point at the file
VPOD_SNAPSHOT=/path/to/alpine-3.23.0-256mb.snap

./scripts/build-default-snapshot.sh   # dist/alpine-3.23.0-256mb.snap
./scripts/build-data-snapshot.sh      # 512 MB variant with numpy/pandas/scipy