998 B
Some notes on Nix language style
In an attempt to keep this more consistent than NixWRT ended up being, here is a Nix language style guide for this repo.
-
favour
callPackage
over rawimport
for calling derivations or any function that may generate one - any code that might needpkgs
or parts of it. -
prefer
let inherit (quark) up down strange charm
overwith quark
, in any context where the scope is more than a single expression or there is more than one reference toup
,down
etc.with pkgs; [ foo bar baz]
is OK,with lib; stdenv.mkDerivation { ... }
is usually not. -
is defined only when running tests, so don't refer to it in "application" code
-
the parameters to a derivation are sorted alphabetically, except for
lib
,stdenv
and maybe other non-package "special cases" -
indentation is whatever emacs nix-mode says it is.
- where a
let
form defines multiple names, put a newline after the tokenlet
, and indent each name two characters
- where a