lib/tests/modules/docs.nix


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

/*
  A basic documentation generating module.
  Declares and defines a `docs` option, suitable for making assertions about
  the extraction "phase" of documentation generation.
 */
{ lib, options, ... }:

let
  inherit (lib)
    head
    length
    mkOption
    types
  ;

  traceListSeq = l: v: lib.foldl' (a: b: lib.traceSeq b a) v l;

in

{
  options.docs = mkOption {
    type = types.lazyAttrsOf types.raw;
    description = ''
      All options to be rendered, without any visibility filtering applied.
    '';
  };
  config.docs =
    lib.zipAttrsWith
      (name: values:
        if length values > 1 then
          traceListSeq values
          abort "Multiple options with the same name: ${name}"
        else
          assert length values == 1;
          head values
      )
      (map
        (opt: { ${opt.name} = opt; })
        (lib.optionAttrSetToDocList options)
      );
}