Install

From Nix + Nixpkgs

If on NixOS unstable, you can run (but be wary of version):

$ nix-shell -p nixtamal.{bin,data,doc,man}

Since the merge isn’t propogated to a biannual NixOS release, this technically means if you have extra-experimental-features = nix-command flakes, you could try nix run github:NixOS/nixpkgs?ref=nixos-unstable#nixtamal for now. Alternatively, if wanting to trial run one of the open pull requests, you can use nix-run https://github.com/toastal/nixpkgs/archive/refs/heads/nixtamal-${VERSION}.zip -A nixtamal.

From source

If you don’t have Darcs installed, you can use from Nixpkgs such as

$ nix-shell -p darcs

After/else clone from one of the mirrors

$ darcs clone --lazy https://darcs.toastal.in.th/nixtamal/stable/ nixtamal
$ darcs clone --lazy https://smeder.ee/~toastal/nixtamal.darcs nixtamal

Then change directory to the project & set up

$ cd nixtamal
$ darcs setpref boringfile .boring

Now build!

$ nix-build
$ result/bin/nixtamal --help

You can optionally install as Nix profile

$ nix profile add $(nix-build)

Add overlay

With access to nixtamal (even if from nixtamal/result/bin), you can now bootstrap yourself to add the overlay to a system configuration

$ nixtamal set-up
…
$ nixtamal tweak

With the manifest.kdl open

inputs {
	nixtamal {
		darcs {
			repository "https://darcs.toastal.in.th/nixtamal/stable"
			mirrors "https://smeder.ee/~toastal/nixtamal.darcs"
		}
		fresh-cmd {
			$ curl -sL "https://darcs.toastal.in.th/nixtamal/stable/_darcs/weak_hash"
		}
	}
}

Which can can now be used for adding the overlay

let
   # imports the lockfile thru default.nix shim
   inputs = import .nix/tamal { };

   pkgs = import inputs.nixpkgs {
      overlays = [
         # apply our Nixtamal overlay to Nixpkgs
         (import "${inputs.nixtamal}/nix/overlay")
         # Nixtamal binary will be at pkgs.nixtamal.nixtamal
      ];
   };
in
pkgs.nixtamal

For development & sending patches using pre-release @ next

$ darcs clone --lazy https://darcs.toastal.in.th/nixtamal/next nixtamal

Using pre-release in manifest.kdl

inputs {
	nixpkgs {// …

	}
	nixtamal {
		darcs {
			// next isn’t mirrored
			repository "https://darcs.toastal.in.th/nixtamal/next/"
		}
		fresh-cmd {
			$ curl -sL "https://darcs.toastal.in.th/nixtamal/next/_darcs/weak_hash"
		}
	}
}