225 lines
8.2 KiB
Nix
225 lines
8.2 KiB
Nix
{
|
|
lib,
|
|
config,
|
|
pkgs,
|
|
...
|
|
}:
|
|
let
|
|
inherit (lib) mkOption;
|
|
inherit (lib.types)
|
|
attrsOf
|
|
bool
|
|
either
|
|
enum
|
|
listOf
|
|
package
|
|
path
|
|
str
|
|
submoduleWith
|
|
;
|
|
# the original types.submodule has strange behavior
|
|
submodule =
|
|
module:
|
|
submoduleWith {
|
|
specialArgs.pkgs = pkgs;
|
|
modules = [ module ];
|
|
};
|
|
options = lib.mapAttrs (_: mkOption);
|
|
in
|
|
{
|
|
options = {
|
|
settings = import ./settings-opts.nix { inherit lib; };
|
|
generators = lib.mkOption {
|
|
description = ''
|
|
A set of generators that can be used to generate files.
|
|
Generators are scripts that produce files based on the values of other generators and user input.
|
|
Each generator is expected to produce a set of files under a directory.
|
|
'';
|
|
default = { };
|
|
type = attrsOf (
|
|
submodule (generator: {
|
|
imports = [ ./generator.nix ];
|
|
options = options {
|
|
dependencies = {
|
|
description = ''
|
|
A list of other generators that this generator depends on.
|
|
The output values of these generators will be available to the generator script as files.
|
|
For example, the file 'file1' of a dependency named 'dep1' will be available via $in/dep1/file1.
|
|
'';
|
|
type = listOf str;
|
|
default = [ ];
|
|
};
|
|
files = {
|
|
description = ''
|
|
A set of files to generate.
|
|
The generator 'script' is expected to produce exactly these files under $out.
|
|
'';
|
|
type = attrsOf (
|
|
submodule (file: {
|
|
imports = [ config.settings.fileModule ];
|
|
options = options {
|
|
name = {
|
|
type = lib.types.str;
|
|
description = ''
|
|
name of the public fact
|
|
'';
|
|
readOnly = true;
|
|
default = file.config._module.args.name;
|
|
};
|
|
generatorName = {
|
|
type = lib.types.str;
|
|
description = ''
|
|
name of the generator
|
|
'';
|
|
readOnly = true;
|
|
default = generator.config._module.args.name;
|
|
};
|
|
share = {
|
|
type = lib.types.bool;
|
|
description = ''
|
|
Whether the generated vars should be shared between machines.
|
|
Shared vars are only generated once, when the first machine using it is deployed.
|
|
Subsequent machines will re-use the already generated values.
|
|
'';
|
|
readOnly = true;
|
|
internal = true;
|
|
default = generator.config.share;
|
|
};
|
|
deploy = {
|
|
description = ''
|
|
Whether the file should be deployed to the target machine.
|
|
|
|
Enable this if the generated file is only used as an input to other generators.
|
|
'';
|
|
type = bool;
|
|
default = true;
|
|
};
|
|
secret = {
|
|
description = ''
|
|
Whether the file should be treated as a secret.
|
|
'';
|
|
type = bool;
|
|
default = true;
|
|
};
|
|
path = {
|
|
description = ''
|
|
The path to the file containing the content of the generated value.
|
|
This will be set automatically
|
|
'';
|
|
type = str;
|
|
};
|
|
value =
|
|
{
|
|
description = ''
|
|
The content of the generated value.
|
|
Only available if the file is not secret.
|
|
'';
|
|
type = str;
|
|
defaultText = "Throws error because the value of a secret file is not accessible";
|
|
}
|
|
// lib.optionalAttrs file.config.secret {
|
|
default = throw "Cannot access value of secret file";
|
|
};
|
|
};
|
|
})
|
|
);
|
|
};
|
|
prompts = {
|
|
description = ''
|
|
A set of prompts to ask the user for values.
|
|
Prompts are available to the generator script as files.
|
|
For example, a prompt named 'prompt1' will be available via $prompts/prompt1
|
|
'';
|
|
default = { };
|
|
type = attrsOf (
|
|
submodule (prompt: {
|
|
options = options {
|
|
createFile = {
|
|
description = ''
|
|
Whether the prompted value should be stored in a file with the same name as the prompt.
|
|
|
|
If enabled, the behavior is equivalent to the following configuration:
|
|
```nix
|
|
{
|
|
files.<name>.secret = true;
|
|
script = "cp $prompts/<name> $out/<name>";
|
|
}
|
|
```
|
|
'';
|
|
type = bool;
|
|
default = true;
|
|
};
|
|
description = {
|
|
description = ''
|
|
The description of the prompted value
|
|
'';
|
|
type = str;
|
|
example = "SSH private key";
|
|
default = prompt.config._module.args.name;
|
|
};
|
|
type = {
|
|
description = ''
|
|
The input type of the prompt.
|
|
The following types are available:
|
|
- hidden: A hidden text (e.g. password)
|
|
- line: A single line of text
|
|
- multiline: A multiline text
|
|
'';
|
|
type = enum [
|
|
"hidden"
|
|
"line"
|
|
"multiline"
|
|
];
|
|
default = "line";
|
|
};
|
|
};
|
|
})
|
|
);
|
|
};
|
|
runtimeInputs = {
|
|
description = ''
|
|
A list of packages that the generator script requires.
|
|
These packages will be available in the PATH when the script is run.
|
|
'';
|
|
type = listOf package;
|
|
default = [ ];
|
|
};
|
|
script = {
|
|
description = ''
|
|
The script to run to generate the files.
|
|
The script will be run with the following environment variables:
|
|
- $in: The directory containing the output values of all declared dependencies
|
|
- $out: The output directory to put the generated files
|
|
- $prompts: The directory containing the prompted values as files
|
|
The script should produce the files specified in the 'files' attribute under $out.
|
|
'';
|
|
type = either str path;
|
|
default = "";
|
|
};
|
|
finalScript = {
|
|
description = ''
|
|
The final generator script, wrapped, so:
|
|
- all required programs are in PATH
|
|
- sandbox is set up correctly
|
|
'';
|
|
type = lib.types.str;
|
|
readOnly = true;
|
|
internal = true;
|
|
visible = false;
|
|
};
|
|
share = {
|
|
description = ''
|
|
Whether the generated vars should be shared between machines.
|
|
Shared vars are only generated once, when the first machine using it is deployed.
|
|
Subsequent machines will re-use the already generated values.
|
|
'';
|
|
type = bool;
|
|
default = false;
|
|
};
|
|
};
|
|
})
|
|
);
|
|
};
|
|
};
|
|
}
|