os/doc/concepts/suites.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

30 lines
653 B
Markdown
Raw Normal View History

2021-02-14 02:38:20 +00:00
# Suites
2022-11-20 22:28:23 +00:00
Suites provide a mechanism for users to easily combine and name collections of
profiles.
2021-02-14 02:38:20 +00:00
`suites` are defined in the `importables` argument in either the `home` or `nixos`
namespace. They are a special case of an `importable` which is passed as a special
argument (one that can be use in an `imports` line) to your hosts. All lists defined
in `suites` are flattened and type-checked as paths.
2021-02-14 02:38:20 +00:00
## Definition
2022-11-20 22:28:23 +00:00
2021-02-14 02:38:20 +00:00
```nix
rec {
workstation = [ profiles.develop profiles.graphical users.nixos ];
mobileWS = workstation ++ [ profiles.laptop ];
}
```
## Usage
2022-11-20 22:28:23 +00:00
2021-02-14 02:38:20 +00:00
`hosts/my-laptop.nix`:
2022-11-20 22:28:23 +00:00
2021-02-14 02:38:20 +00:00
```nix
{ suites, ... }:
{
imports = suites.mobileWS;
}
```