nixpkgs/lib
Maximilian Bosch e878fc4aac
lib/modules: better error message if an attr-set of options is expected
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-03-11 14:55:56 +01:00
..
systems lib: fix typo in platforms.nix 2021-02-11 08:58:04 +01:00
tests lib/modules: better error message if an attr-set of options is expected 2021-03-11 14:55:56 +01:00
asserts.nix
attrsets.nix lib/attrsets: add cartesianProductOfSets function 2021-01-28 23:08:59 +01:00
cli.nix
customisation.nix lib: Create makeScopeWithSplicing 2020-11-19 00:07:14 -05:00
debug.nix lib/debug: add traceFnSeqN 2021-01-25 19:25:50 +01:00
default.nix lib/attrsets: add cartesianProductOfSets function 2021-01-28 23:08:59 +01:00
deprecated.nix
fetchers.nix
filesystem.nix lib: Add readTree function to filesystem 2020-10-19 16:42:21 -07:00
fixed-points.nix lib: Add composeManyExtensions 2020-11-13 21:37:57 +01:00
generators.nix Revert "lib/generators: fix toPretty throwing on (partially applied) builtins" 2021-02-01 16:27:38 +01:00
kernel.nix
licenses.nix lib/licenses: fix regression removing shortName for some licenses 2021-02-25 23:01:09 +01:00
lists.nix lib: remove mention of flashplayer in docs 2021-02-08 09:38:41 -08:00
meta.nix
minver.nix
modules.nix lib/modules: better error message if an attr-set of options is expected 2021-03-11 14:55:56 +01:00
options.nix Revert "Module-builtin assertions, disabling assertions and submodule assertions" 2020-12-18 16:44:37 +01:00
sources.nix lib/sources.nix: fix incorrect inherit 2020-10-30 23:19:22 +01:00
strings-with-deps.nix lib: Use Nix's static scope checking, fix error message, optimize 2020-10-22 13:46:47 +02:00
strings.nix lib/string: drop redundant string in description of toInt. 2020-12-05 14:35:30 +00:00
trivial.nix lib: add importTOML 2020-09-12 16:37:50 +02:00
types.nix lib/types: add description for functionTo 2021-01-31 15:59:13 +01:00
versions.nix
zip-int-bits.nix