2020-09-16 15:55:24 +03:00
|
|
|
with builtins;
|
|
|
|
|
2021-01-25 19:19:32 +02:00
|
|
|
rec {
|
2020-09-16 15:55:24 +03:00
|
|
|
splitLines = s: filter (x: !isList x) (split "\n" s);
|
|
|
|
|
|
|
|
concatStrings = concatStringsSep "";
|
2021-01-25 19:19:32 +02:00
|
|
|
|
2023-04-06 19:24:11 +03:00
|
|
|
attrsToList = a:
|
|
|
|
map (name: { inherit name; value = a.${name}; }) (builtins.attrNames a);
|
|
|
|
|
2022-08-27 00:09:19 +03:00
|
|
|
replaceStringsRec = from: to: string:
|
|
|
|
# recursively replace occurrences of `from` with `to` within `string`
|
|
|
|
# example:
|
|
|
|
# replaceStringRec "--" "-" "hello-----world"
|
|
|
|
# => "hello-world"
|
|
|
|
let
|
|
|
|
replaced = replaceStrings [ from ] [ to ] string;
|
|
|
|
in
|
|
|
|
if replaced == string then string else replaceStringsRec from to replaced;
|
|
|
|
|
|
|
|
squash = replaceStringsRec "\n\n\n" "\n\n";
|
|
|
|
|
|
|
|
trim = string:
|
|
|
|
# trim trailing spaces and squash non-leading spaces
|
|
|
|
let
|
|
|
|
trimLine = line:
|
|
|
|
let
|
|
|
|
# separate leading spaces from the rest
|
|
|
|
parts = split "(^ *)" line;
|
|
|
|
spaces = head (elemAt parts 1);
|
|
|
|
rest = elemAt parts 2;
|
|
|
|
# drop trailing spaces
|
|
|
|
body = head (split " *$" rest);
|
|
|
|
in spaces + replaceStringsRec " " " " body;
|
|
|
|
in concatStringsSep "\n" (map trimLine (splitLines string));
|
|
|
|
|
2021-01-25 19:19:32 +02:00
|
|
|
# FIXME: O(n^2)
|
|
|
|
unique = foldl' (acc: e: if elem e acc then acc else acc ++ [ e ]) [];
|
|
|
|
|
|
|
|
nameValuePair = name: value: { inherit name value; };
|
|
|
|
|
|
|
|
filterAttrs = pred: set:
|
|
|
|
listToAttrs (concatMap (name: let v = set.${name}; in if pred name v then [(nameValuePair name v)] else []) (attrNames set));
|
2023-03-21 13:58:14 +02:00
|
|
|
|
2023-03-23 11:09:25 +02:00
|
|
|
showSetting = { useAnchors }: name: { description, documentDefault, defaultValue, aliases, value }:
|
2023-03-21 13:58:14 +02:00
|
|
|
let
|
|
|
|
result = squash ''
|
2023-03-22 14:11:35 +02:00
|
|
|
- ${if useAnchors
|
2023-03-21 13:58:14 +02:00
|
|
|
then ''<span id="conf-${name}">[`${name}`](#conf-${name})</span>''
|
2023-03-22 14:11:35 +02:00
|
|
|
else ''`${name}`''}
|
2023-03-21 13:58:14 +02:00
|
|
|
|
|
|
|
${indent " " body}
|
|
|
|
'';
|
2023-03-21 15:12:15 +02:00
|
|
|
|
2023-03-21 13:58:14 +02:00
|
|
|
# separate body to cleanly handle indentation
|
|
|
|
body = ''
|
|
|
|
${description}
|
|
|
|
|
|
|
|
**Default:** ${showDefault documentDefault defaultValue}
|
|
|
|
|
|
|
|
${showAliases aliases}
|
|
|
|
'';
|
2023-03-21 15:12:15 +02:00
|
|
|
|
2023-03-21 13:58:14 +02:00
|
|
|
showDefault = documentDefault: defaultValue:
|
|
|
|
if documentDefault then
|
|
|
|
# a StringMap value type is specified as a string, but
|
|
|
|
# this shows the value type. The empty stringmap is `null` in
|
|
|
|
# JSON, but that converts to `{ }` here.
|
|
|
|
if defaultValue == "" || defaultValue == [] || isAttrs defaultValue
|
|
|
|
then "*empty*"
|
|
|
|
else if isBool defaultValue then
|
|
|
|
if defaultValue then "`true`" else "`false`"
|
|
|
|
else "`${toString defaultValue}`"
|
|
|
|
else "*machine-specific*";
|
2023-03-21 15:12:15 +02:00
|
|
|
|
2023-03-21 13:58:14 +02:00
|
|
|
showAliases = aliases:
|
|
|
|
if aliases == [] then "" else
|
|
|
|
"**Deprecated alias:** ${(concatStringsSep ", " (map (s: "`${s}`") aliases))}";
|
2023-03-21 15:12:15 +02:00
|
|
|
|
|
|
|
in result;
|
2023-03-21 13:58:14 +02:00
|
|
|
|
2023-04-05 05:57:11 +03:00
|
|
|
indent = prefix: s:
|
|
|
|
concatStringsSep "\n" (map (x: if x == "" then x else "${prefix}${x}") (splitLines s));
|
|
|
|
|
2023-03-23 11:08:49 +02:00
|
|
|
showSettings = args: settingsInfo: concatStrings (attrValues (mapAttrs (showSetting args) settingsInfo));
|
2020-09-16 15:55:24 +03:00
|
|
|
}
|