summary refs log tree commit diff
path: root/lib/modules.nix
AgeCommit message (Collapse)AuthorFilesLines
2021-11-15lib.modules: add mkDerivedConfigTaeer Bar-Yam1-0/+20
mkDerivedConfig : Option a -> (a -> Definition b) -> Definition b Create config definitions with the same priority as the definition of another option. This should be used for option definitions where one option sets the value of another as a convenience. For instance a config file could be set with a `text` or `source` option, where text translates to a `source` value using `mkDerivedConfig options.text (pkgs.writeText "filename.conf")`. It takes care of setting the right priority using `mkOverride`.
2021-11-03lib/modules: Use strict fold' as recursiveUpdate is also strictRobert Hensing1-2/+1
recursiveUpdate does not produce an attrset until it has evaluated both its arguments to weak head normal form. nix-repl> lib.recursiveUpdate (throw "a") (throw "b") error: b nix-repl> lib.recursiveUpdate (throw "a") {} error: a
2021-11-03lib/modules: Fix import* commentsRobert Hensing1-2/+2
Very confusing otherwise.
2021-11-03lib/modules: Remove a lib.flipRobert Hensing1-3/+2
In hot code, the overhead (envs, applies) can matter.
2021-11-03lib/modules: Short-circuit unmatchedDefns earlierRobert Hensing1-15/+16
2021-11-01modules: Update evalModules docRobert Hensing1-3/+26
2021-11-01modules: Add extendModules to module argsRobert Hensing1-15/+19
2021-11-01lib.evalModules: Add extendModules and type to resultRobert Hensing1-5/+22
Allows the simultaneous construction of top-level invocations and submodule types. This helps structure configuration systems integration code.
2021-10-31lib/modules: Short-circuit unmatchedDefns when configs is emptyRobert Hensing1-4/+10
2021-08-26lib/modules: grammar fix in error msgMaximilian Bosch1-1/+1
2021-08-25lib/modules: fix error-message when declaring an option inside `config'Maximilian Bosch1-7/+18
The message I originally implemented here was to catch a mixup of `config' and `options' in a `types.submodule'[1]. However it looks rather weird for a wrongly declared top-level option. So I decided to throw error: The option `foo' does not exist. Definition values: - In `<unknown-file>': { bar = { _type = "option"; type = { _type = "option-type"; ... It seems as you're trying to declare an option by placing it into `config' rather than `options'! for an expression like with import ./lib; evalModules { modules = [ { foo.bar = mkOption { type = types.str; }; } ]; } [1] fa30c9abed61f30218a211842204705986d486f9
2021-08-03lib/modules: add mkImageMediaOverrideDavid Arnold1-0/+1
so the underlaying use case of the preceding commit is so generic, that we gain a lot in reasoning to give it an appropriate name. As the comment states: image media needs to override host config short of mkForce
2021-07-12lib.mkFixStrictness: DeprecateRobert Hensing1-3/+1
2021-07-12Partially revert "lib/modules: Drop mkStrict and mkFixStrictness"Robert Hensing1-0/+4
mkFixStrictness was never properly deprecated and should only be removed after warning for some time. This partially reverts commit 8fb9984690c878fcd768e967190957441de05d11.
2021-06-06lib/modules: Drop mkStrict and mkFixStrictnessJanne Heß1-4/+0
This was deprecated in 2014 and is not used anywhere in the tree.
2021-05-07Merge pull request #121870 from Pacman99/pass-specialargsRobert Hensing1-1/+1
lib/modules: pass specialArgs to modules
2021-05-06lib/modules: pass specialArgs as a module argumentPacman991-1/+1
2021-05-06lib/modules: Small optimizationSilvan Mosberger1-6/+4
2021-05-05Merge pull request #114955 from berbiche/fix/modules-imports-listSilvan Mosberger1-0/+4
lib/modules: provide a better error message when "imports" contains a list
2021-05-05lib/modules: provide error message when imports contains a listNicolas Berbiche1-0/+4
2021-05-05Revert "lib/modules: Issue type deprecation warnings recursively"Robert Hensing1-13/+4
This reverts commit 4b54aedee5e05aaf2838f6d951508b83e33d2baa.
2021-05-03lib/modules: Issue type deprecation warnings recursivelySilvan Mosberger1-4/+13
Previously, an option of type attrsOf string wouldn't throw a deprecation warning, even though the string type is deprecated. This was because the deprecation warning trigger only looked at the type of the option itself, not any of its subtypes. This commit fixes this, causing each of the types deprecationMessages to trigger for the option. This relies on the subtypes mkOptionType attribute introduced in 26607a5a2e06653fec453c83d063cdfc4b59185f
2021-04-28treewide: use lib.warnIf where appropriateAlyssa Ross1-3/+3
2021-03-11lib/modules: better error message if an attr-set of options is expectedMaximilian Bosch1-0/+11
I recently wrote some Nix code where I wrongly set a value to an option which wasn't an actual option, but an attr-set of options. The mistake I made can be demonstrated with an expression like this: { foo = { lib, pkgs, config, ... }: with lib; { options.foo.bar.baz = mkOption { type = types.str; }; config.foo.bar = 23; }; } While it wasn't too hard to find the cause of the mistake for me, it was necessary to have some practice in reading stack traces from the module system since the eval-error I got was not very helpful: error: --- TypeError --------------------------------------------------------- nix-build at: (323:25) in file: /nix/store/3nm31brdz95pj8gch5gms6xwqh0xx55c-source/lib/modules.nix 322| foldl' (acc: module: 323| acc // (mapAttrs (n: v: | ^ 324| (acc.${n} or []) ++ f module v value is an integer while a set was expected (use '--show-trace' to show detailed location information) I figured that such an error can be fairly confusing for someone who's new to NixOS, so I decided to catch this case in th `byName` function in `lib/modules.nix` by checking if the value to map through is an actual attr-set. If not, a different error will be thrown.
2021-01-21lib/modules: Set submodule type for renamed option setsSilvan Mosberger1-1/+1
For renames like mkAliasOptionModule [ "services" "compton" ] [ "services" "picom" ] where the target is an option set (like services.picom) instead of a single option (like services.picom.enable), previously the renamed option type was unset, leading to it being `types.unspecified`. This changes it to be `types.submodule {}` instead, which makes more sense.
2020-12-18Revert "Module-builtin assertions, disabling assertions and submodule ↵Silvan Mosberger1-142/+22
assertions"
2020-12-18lib/modules: Prefix mkRemovedOptionModule & co. check namesSilvan Mosberger1-3/+3
To avoid name clashes Co-authored-by: Robert Hensing <robert@roberthensing.nl>
2020-12-17lib/modules: Introduce _module.checks.*.checkSilvan Mosberger1-18/+18
Previously the .enable option was used to encode the condition as well, which lead to some oddness: - In order to encode an assertion, one had to invert it - To disable a check, one had to mkForce it By introducing a separate .check option this is solved because: - It can be used to encode assertions - Disabling is done separately with .enable option, whose default can be overridden without a mkForce
2020-11-30lib/modules: _module.check should always be internalSilvan Mosberger1-8/+9
Honestly this option should probably just be removed
2020-11-30lib/modules: Remove _module.checks.*.triggerPath as it's not necessarySilvan Mosberger1-82/+27
Previously this option was thought to be necessary to avoid infinite recursion, but it actually isn't, since the check evaluation isn't fed back into the module fixed-point.
2020-11-30lib/modules: Rename _module.assertions to _module.checksSilvan Mosberger1-30/+36
2020-11-30nixos/modules: Expose the internal module in the top-level documentationSilvan Mosberger1-5/+10
2020-11-30nixos/modules: Allow options to be coerced to a string for convenienceSilvan Mosberger1-0/+2
2020-11-30lib/modules: Use module-builtin assertions for mkRemovedOptionModule and co.Silvan Mosberger1-14/+24
2020-11-30nixos/assertions: Use module-builtin assertion implementationSilvan Mosberger1-6/+6
2020-11-30lib/modules: Implement module-builtin assertionsSilvan Mosberger1-1/+152
This implements assertions/warnings supported by the module system directly, instead of just being a NixOS option (see nixos/modules/misc/assertions.nix). This has the following benefits: - It allows cleanly redoing the user interface. The new implementation specifically allows disabling assertions or converting them to warnings instead. - Assertions/warnings can now be thrown easily from within submodules, which previously wasn't possible and needed workarounds.
2020-11-30Merge pull request #99115 from Infinisil/toString-module-filesSilvan Mosberger1-2/+2
lib/modules: Make sure to not import module _file's into the store
2020-10-26Merge pull request #101139 from roberth/lib-use-static-scope-checkingRobert Hensing1-8/+49
lib: Use Nix's static scope checking, fix error message, optimize
2020-10-24docs: update documentation of `mkRemovedOptionModule`Robert Helgesson1-1/+1
Since b08b0bcbbec77046e5a7082177cedc12fbf1dc6c, the function actually causes an assertion error, not a warning.
2020-10-22lib/modules: Simplify inheritsRobert Hensing1-34/+32
2020-10-22lib: Use Nix's static scope checking, fix error message, optimizeRobert Hensing1-8/+51
Nix can perform static scope checking, but whenever code is inside a `with` expression, the analysis breaks down, because it can't know statically what's in the attribute set whose attributes were brought into scope. In those cases, Nix has to assume that everything works out. Except it doesnt. Removing `with` from lib/ revealed an undefined variable in an error message. If that doesn't convince you that we're better off without `with`, I can tell you that this PR results in a 3% evaluation performance improvement because Nix can look up local variables by index. This adds up with applications like the module system. Furthermore, removing `with` makes the binding site of each variable obvious, which helps with comprehension.
2020-10-09Merge pull request #96641 from zimbatm/data-module-importszimbatm1-0/+17
nixos: Data module imports
2020-09-29lib/modules: Make sure to not import module _file's into the storeSilvan Mosberger1-2/+2
Previously if `_file` was specified by a module: trace: warning: The type `types.string' of option `foo' defined in `/nix/store/yxhm2il5yrb92fldgriw0wyqh2kk9qyc-bug.nix' is deprecated. See https://github.com/NixOS/nixpkgs/pull/66346 for better alternative types. With this change: trace: warning: The type `types.string' of option `foo' defined in `/home/infinisil/src/nixpkgs/bug.nix' is deprecated. See https://github.com/NixOS/nixpkgs/pull/66346 for better alternative types.
2020-09-21lib/modules: Evaluate single defs for readOnly errorSilvan Mosberger1-1/+7
If multiple definitions are passed, this evaluates them all as if they were the only one, for a better error message. In particular this won't show module-internal properties like `_type = "override"` and co.
2020-09-21lib/modules: Improve error messages using showDefsSilvan Mosberger1-4/+4
2020-09-12lib: allow to import JSON and TOML fileszimbatm1-0/+17
The vision here is that configuration tools can generate .json or .toml files, which can be plugged into an existing configuration. Eg: { lib, ... }: { imports = [ (lib.modules.importJSON ./hardware-configuration.json) ]; }
2020-09-07lib/types: Allow types to emit a deprecation warningSilvan Mosberger1-1/+5
Previously the only way to deprecate a type was using theType = lib.warn "deprecated" (mkOptionType ...) This caused the warning to be emitted when the type was evaluated, but the error didn't include which option actually used that type. With this commit, types can specify a deprecationMessage, which when non-null, is printed along with the option that uses the type
2020-09-02treewide: completely remove types.loaOfrnhmjoj1-1/+0
2020-08-18lib/modules: improve error-message for undeclared options if prefix contains ↵Maximilian Bosch1-2/+13
no options An easy-to-make mistake when declaring e.g. a submodule is the accidental confusion of `options` and `config`: types.submodule { config = { foo = mkOption { /* ... */ }; }; } However the error-message The option `[definition 1-entry 1].foo' defined in `<expr.nix>' does not exist. is fairly unhelpful because it seems as the options are declared at the first sight. In fact, it took a colleague and me a while to track down such a mistake a few days ago and we both agreed that this should be somehow caught to save the time we spent debugging the module in question. At first I decided to catch this error in the `submodules`-type directly by checking whether `options` is undeclared, however this becomes fairly complicated as soon as a submodule-declaration e.g. depends on existing `config`-values which would've lead to some ugly `builtins.tryExec`-heuristic. This patch now simply checks if the option's prefix has any options defined if a point in evaluation is reached where it's clear that the option in question doesn't exist. This means that this patch doesn't change the logic of the module system, it only provides a more detailed error in certain cases: The option `[definition 1-entry 1].foo' defined in `<expr.nix>' does not exist. However it seems as there are no options defined in [definition 1-entry 1]. Are you sure you've declared your options properly? This happens if you e.g. declared your options in `types.submodule' under `config' rather than `options'.
2020-08-18lib/modules: Fix nonexistant option errorSilvan Mosberger1-2/+2
The refactoring in https://github.com/NixOS/nixpkgs/commit/fd75dc876586bde8cdb683a6952a41132e8db166 introduced a mistake in the error message that doesn't show the full context anymore. E.g. with this module: options.foo.bar = lib.mkOption { type = lib.types.submodule { baz = 10; }; default = {}; }; You'd get the error The option `baz' defined in `/home/infinisil/src/nixpkgs/config.nix' does not exist. instead of the previous The option `foo.bar.baz' defined in `/home/infinisil/src/nixpkgs/config.nix' does not exist. This commit undoes this regression