1.8 KiB
Naersk
Nix support for building cargo crates.
Install
Use niv:
$ niv add nmattia/naersk
And then
let
pkgs = import <nixpkgs> {};
sources = import ./nix/sources.nix;
naersk = pkgs.callPackage sources.naersk {};
in naersk.buildPackage ./path/to/rust
NOTE: ./path/to/rust/ should contain a Cargo.lock.
Configuration
The buildPackage function also accepts an attribute set. The attributes are
described below. When the argument passed in not an attribute set, e.g.
naersk.buildPackage theArg
it is converted to an attribute set equivalent to { root = theArg; }.
GEN_CONFIGURATION
Comparison
There are two other notable Rust frameworks in Nix: rustPlatform and
carnix.
naersk uses cargo directly, as opposed to carnix which emulates cargo's
build logic. Moreover naersk sources build information directly from the
project's Cargo.lock which makes any code generation unnecessary.
For the same reason, naersk does not need anything like rustPlatform's
cargoSha256. All crates are downloaded using the sha256 checksums provided
in the project's Cargo.lock.
Because cargo doesn't register checksums for git dependencies, naersk's
support for git dependencies is experimental and has to be enabled with
allowGitDependencies = true (see the configuration
section).
Finally naersk supports incremental builds by first performing a
dependency-only build, and then a build that depends on the top-level crate's
code and configuration.