NIXTAMAL(1)

nixtamal - fulfilling input pinning for Nix

nixtamal COMMAND …

GNU General Public License, version 3.0 later (GPL-3.0-or-later)

toastal <https://toast.al/contact/>

See: https://toast.al/funding/

Checks that the manifest × lockfile is sound.
Garbage collect old generations (experimental). Requires NIXTAMAL_EXPERIMENTAL_GC to be set & is probably still broken. Keeping the freshest (configurable) number of generations. We suggest at least 2 if favoring rebase-style workflows so swapping back & forth is less trouble.
List stale inputs with fresh-cmd, without refreshing
Lock all not-yet-locked inputs.
Refreshes all non-frozen inputs using the fresh-cmd — or the default fresh-cmd for certain kinds with a reasonable default (Git).
Set up working directory for Nixtamal. By default, also adds Nixpkgs from upstream to the project's inputs.
Shows current inputs as understood by Nixtamal for earthlings.
Tweak the manifest file with $VISUAL, $EDITOR, or vi

--help[=FMT] (default=auto)
Show this help in format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined.
--version
Show version information.

nixtamal exits with:

0
on success.
65
Nixtamal working directory or manifest not set up. Run `nixtamal set-up`.
66
Version mismatch between manifest and lockfile. Run `nixtamal lock`, but might require *removing* the lockfile first until `nixtaml fast-forward` is made.
67
Failed to parse the manifest file.
68
Failed to parse the lockfile.
69
Failed to serialize lockfile.
70
Fresh command execution threw an exception.
71
Fresh command output nothing.
72
Prefetch command threw an exception.
73
Prefetch command output was unusable.
74
Prefetch command flopped on JSON output.
75
Snag when trying to work with the Darcs context.
76
Silo error (such as bad hex in generation number).
123
on indiscriminate errors reported on standard error.
124
on command line parsing errors.
125
on unexpected internal errors (bugs).

During alpha, contact the maker directly or join the XMPP chatroom @ <xmpp:nixtamal@chat.toastal.in.th?join>.

manifest.kdl format
Nixtamal 0.1.0-beta