Question 1

How to set up Namaka in a Nix flake?

Accepted Answer

Run `nix flake init -t github:nix-community/namaka` to initialize a template, then use `nix develop` to add it to the environment, as shown in the Quick Start guide. This sets up the test directory structure and commands for snapshot testing.

Question 2

What is the difference between Namaka and haumea?

Accepted Answer

Namaka is based on haumea but focuses specifically on snapshot testing for Nix expressions, adding features like interactive review workflows. Haumea is a general-purpose library for loading Nix files without built-in testing functionalities.

Question 3

Can Namaka be used without Nix Flakes?

Accepted Answer

Namaka is primarily designed for Nix Flakes integration, with default commands assuming Flakes are enabled. While configuration via namaka.toml allows some customization, it's not optimized for non-Flake Nix projects.

Question 4

How to customize serialization formats in Namaka?

Accepted Answer

Create a format.nix file in your test directory with values like 'json', 'pretty', or 'string' to specify how Nix expressions are serialized, as detailed in the usage section under format.nix options.

Question 5

Namaka vs traditional unit testing for Nix

Accepted Answer

Namaka excels at regression testing by automating snapshot comparisons, reducing boilerplate. Traditional unit tests with manual assertions are better for precise, logic-based testing where explicit conditions are needed, but require more upfront work.

Question 6

How does Namaka handle failed tests in CI?

Accepted Answer

It integrates with `nix flake check` to capture snapshots for failed tests, and the `namaka review` command can be used locally or in CI to manage updates, but the README doesn't specify automated CI workflows, requiring manual intervention for snapshot approval.

namaka

What is namaka?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions