lix-unit
October 8, 2024 ยท View on GitHub
Note
This is a fork of nix-unit that works with Lix.
This project runs an attribute set of tests compatible with lib.debug.runTests while allowing individual attributes to fail.
Why use lix-unit?
-
Simple structure compatible with
lib.debug.runTests -
Allows individual test attributes to fail individually.
Rather than evaluating the entire test suite in one go, serialise & compare lix-unit uses the Nix evaluator C++ API.
Meaning that we can catch test failures individually, even if the failure is caused by an evaluation error.
- Fast.
No additional processing and coordination overhead caused by the external process approach.
Comparison with other tools
This comparison matrix was originally taken from Unit test your Nix code but has been adapted. Pythonix is excluded as it's unmaintained.
| Tool | Can test eval failures | Tests defined in Nix | in nixpkgs | snapshot testing(1) | Supports Lix |
|---|---|---|---|---|---|
| Lix-unit | yes | yes | no | no | yes (2) |
| Nix-unit | yes | yes | yes | no | no |
| runTests | no | yes | yes | no | yes |
| Nixt | no | yes | no | no | yes |
| Namaka | no | yes | yes | yes | ? |
- Snapshot testing
- While lix-unit supports Lix, it does not support Nix, and vice versa.
Using with Nix instead of Lix
The Lix codebase has gone through significant changes, and it's not tenable to have a single code base that supports both implementations. Therefore lix-unit was forked from nix-unit.