My personal project and infrastructure archive

You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Silvan Mosberger 65e25deb06 lib/modules: Implement freeform modules ... For programs that have a lot of (Nix-representable) configuration options, a simple way to represent this in a NixOS module is to declare an option of a type like `attrsOf str`, representing a key-value mapping which then gets generated into a config file. However with such a type, there's no way to add type checking for only some key values. On the other end of the spectrum, one can declare a single separate option for every key value that the program supports, ending up with a module with potentially 100s of options. This has the benefit that every value gets type checked, catching mistakes at evaluation time already. However the disadvantage is that the module becomes big, becomes coupled to the program version and takes a lot of effort to write and maintain. Previously there was a middle ground between these two extremes: Declare an option of a type like `attrsOf str`, but declare additional separate options for the values you wish to have type checked, and assign their values to the `attrsOf str` option. While this works decently, it has the problem of duplicated options, since now both the additional options and the `attrsOf str` option can be used to set a key value. This leads to confusion about what should happen if both are set, which defaults should apply, and more. Now with this change, a middle ground becomes available that solves above problems: The module system now supports setting a freeform type, which gets used for all definitions that don't have an associated option. This means that you can now declare all options you wish to have type checked, while for the rest a freeform type like `attrsOf str` can be used.		4 years ago
..
systems	redox: add as target	4 years ago
tests	lib/*: editorconfig fixes	4 years ago
asserts.nix	lib: move assertMsg and assertOneOf to their own library file	6 years ago
attrsets.nix	lib/attrsets: add getMan function	4 years ago
cli.nix	lib/cli: mkKey -> mkOptionName, use generators.mkValueStringDefault	4 years ago
customisation.nix	lib.callPackages(With): guard against a repeated mistake	4 years ago
debug.nix	lib/debug: Update documentation comments for docs generation	6 years ago
default.nix	lib: toHex -> toHexString & toBase -> toBaseDigits	4 years ago
deprecated.nix	lib.fake{Sri => Hash}: fix and rename	4 years ago
fetchers.nix	Convert libs to a fixed-point	7 years ago
filesystem.nix	Convert libs to a fixed-point	7 years ago
fixed-points.nix	lib.converge: optimise	5 years ago
generators.nix	lib/generators: Extend mkValueStringDefault with float support	4 years ago
kernel.nix	Merge pull request #84032 from teto/fix_kernel_merge	4 years ago
licenses.nix	licenses: Make single-version-only GPL explicit	4 years ago
lists.nix	fix example for foldl	4 years ago
meta.nix	lib: implement `setPrio`	6 years ago
minver.nix	Bump minver.nix to 2.2	4 years ago
modules.nix	lib/modules: Implement freeform modules	4 years ago
options.nix	lib/options: fix showOption example	4 years ago
sources.nix	commitIdFromGitRepo: fix stackoverflow if many branches are used.	4 years ago
strings-with-deps.nix	Convert libs to a fixed-point	7 years ago
strings.nix	lib/strings: Add floatToString	4 years ago
trivial.nix	lib: toHex -> toHexString & toBase -> toBaseDigits	4 years ago
types.nix	Replace short URL from #63103 with full URL.	5 years ago
versions.nix	lib/versions: expose splitVersion	5 years ago
zip-int-bits.nix	lib/trivial: move zipIntBits to its own file	6 years ago