Skip to content

Repository files navigation

Latch

Latch is a TypeScript testing framework for running large-scale unit and integration tests on constrained systems.

Documentation · Live example

Latch demo

Quick Start

git clone https://github.com/TOPLLab/latch.git
cd latch
npm install
npm run build
npm run test:example

Development

Source code lives in src/, unit tests in tests/unit/, and executable examples in tests/examples/. Useful commands are:

npm run build          # Compile the package
npm run test:all       # Build and run all tests
npm run test:example   # Run example (requires recursive submodules)

The repository uses a recursive WARDuino/WABT test fixture for hardware and WebAssembly integration tests. Clone with submodules when working on those tests:

git clone --recurse-submodules https://github.com/TOPLLab/latch.git

Contributing

Bug reports, documentation improvements, and pull requests are welcome. For larger changes, please open an issue first so the approach can be discussed. Before submitting a pull request, run the build, tests, and linter locally and describe the user-visible change in the pull request body.