bcachefs-tools/nix/nixpkgs.json

{
  "url":    "https://github.com/nixos/nixpkgs/archive/5ae883b8c3b04e0c4a9c92a5ab3c7c84b9942943.tar.gz",
  "rev":    "5ae883b8c3b04e0c4a9c92a5ab3c7c84b9942943",
  "sha256": "1s2nhax586v2fax7r5qd1s3d2gdg25isva7k7r9pf9x9ay630cmb"
}
nix: add nix expressions for development This adds Nix expressions for bcachefs-tools that are modular, work in purely sandboxed build environments (e.g. on NixOS itself, or macOS, where sandboxing is enabled by default), use a fixed copy of Nixpkgs (to avoid hidden, global state) and uses standard build idioms. This change uses a fixed version of Nixpkgs, one that will always be used for every build of bcachefs-tools, for all users, rather than relying on whatever copy of Nixpkgs the user has available. This has a major benefit in that it allows the build to work in sandboxed environments such as NixOS, and it correctly declares all of the necessary dependencies that bcachefs-tools needs. This is done simply by using stdenv.mkDerivation in order to write a "normal" Nix expression, where the previous version used a variant of the stdenv builder, but this isn't needed for the most part. (Doing this has other knock-on benefits, such as the usage of standardized options like `enableParallelBuild = true;` -- allowing `nix-build` to automatically do parallel builds, etc.) Another major benefit of this change is that anyone can now use `nix-shell` to develop/hack on bcachefs-tools incrementally; simply running nix-shell will put you in a Bash shell environment where all of bcachefs-tools' dependencies are proprerly provided, no matter the state of the outside build environment/host operating system: $ nix-shell [nix-shell:~/src/bcachefs-tools]$ make -j4 # works immediately As mentioned before, with this change, by default, nix-build and nix-shell run using a prepackaged copy of an upstream Nixpkgs snapshot. This is done purely to ensure anyone who builds bcachefs-tools using Nix does, in fact, get a reproducible build. Without this, nix-build defaults to using the the `<nixpkgs>` NIX_PATH entry in order to fetch dependencies; meaning that two users on different channels will get different results (for example, if you have the November 2017 channel but I have the October 2017 channel, the results may be different). With this patch, a user running $ nix-build will always use the exact same copy of nixpkgs to bootstrap the build, regardless of whatever channels the user has. This bootstrap mechanism does not even depend on an existing copy of Nixpkgs itself; e.g. it can work with a completely empty `NIX_PATH`. This is arguably anti-modular, but for end-user applications like bcachefs-tools, fixing the version of Nixpkgs is not normally a huge deal. Users who wish to use a different copy of Nixpkgs can provide this with an argument to nix-build directly, using the `nixpkgs` argument to the expression: $ nix-build --pure --arg nixpkgs 'import <nixpkgs> {}' This uses the `<nixpkgs>` provided inside your `NIX_PATH` environment variable to acquire dependencies, which by default is managed using `nix-channel`. If you have a copy of the Nixpkgs source code e.g. from a `git clone`, you may use that too by simply using `-I` to prepend your Nixpkgs to `NIX_PATH` (see `man nix-build` for more): $ nix-build --pure \ -I nixpkgs=$HOME/src/nixpkgs \ --arg nixpkgs 'import <nixpkgs> {}' Signed-off-by: Austin Seipp <aseipp@pobox.com> 2017-11-26 09:20:14 +03:00			`{`
			`"url": "https://github.com/nixos/nixpkgs/archive/5ae883b8c3b04e0c4a9c92a5ab3c7c84b9942943.tar.gz",`
			`"rev": "5ae883b8c3b04e0c4a9c92a5ab3c7c84b9942943",`
			`"sha256": "1s2nhax586v2fax7r5qd1s3d2gdg25isva7k7r9pf9x9ay630cmb"`
			`}`