Structure

This section uses the variables myconfigName, moduleSystem, and homeManagerUser, so it's recommended to first review the corresponding subsection: delib.configurations Function Arguments.

Function Arguments

• name: string. It is recommended that it matches the parent path of the module's enable option, such as "programs.example", since the cfg argument depends on this path.
• options: attrset or a lambda that returns an attrset (see Options).
• [myconfig|nixos|home|darwin].[ifEnabled|ifDisabled|always]: attrset or a lambda that returns an attrset.
  • myconfig.*: sets values in config.${myconfigName}.
  • nixos.*: sets values in config if moduleSystem is nixos. Otherwise, does nothing.
  • home.*: sets values in config if ModuleSystem is home. Otherwise, sets it in config.home-manager.users.${homeManagerUser}.
  • darwin.*: sets values in config if moduleSystem is darwin. Otherwise, does nothing.
  • [myconfig|nixos|home|darwin].ifEnabled: executed only if the cfg.enable option (see Passed Arguments - cfg) exists and is true.
  • [myconfig|nixos|home|darwin].ifDisabled: executed only if the cfg.enable option exists and is false.
  • [myconfig|nixos|home|darwin].always: always executed, even if the cfg.enable option doesn't exist.

Passed Arguments

A list of arguments passed to options and [myconfig|nixos|home|darwin].[ifEnabled|ifDisabled|always], if their type is a lambda:

• name: the same name from the delib.module arguments.
• myconfig: equals config.${myConfigName}.
• cfg: essentially, the config values (assigned options) of the current module. In other words, equals config.${myConfigName}.${name}, where name is the argument from delib.module and is "expanded" (converted to a valid attribute path).
• parent: equal to the "parent" module (attribute set) of cfg. Example: parent is config.${myConfigName}.programs if cfg is config.${myConfigName}.programs.example.

Pseudocode

delib.module {
  name = "";

  # options.${myConfigName} = ...
  options = {name, cfg, parent, myconfig, ...}: {};

  # config.${myConfigName} = ...
  myconfig.ifEnabled = {name, cfg, parent, myconfig, ...}: {};
  myconfig.ifDisabled = {name, cfg, parent, myconfig, ...}: {};
  myconfig.always = {name, cfg, parent, myconfig, ...}: {};

  # if moduleSystem == "nixos"
  # then {config = ...;}
  # else {}
  nixos.ifEnabled = {name, cfg, parent, myconfig, ...}: {};
  nixos.ifDisabled = {name, cfg, parent, myconfig, ...}: {};
  nixos.always = {name, cfg, parent, myconfig, ...}: {};

  # if moduleSystem == "home"
  # then {config = ...;}
  # else {config.home-manager.users.${homeManagerUser} = ...;}
  home.ifEnabled = {name, cfg, parent, myconfig, ...}: {};
  home.ifDisabled = {name, cfg, parent, myconfig, ...}: {};
  home.always = {name, cfg, parent, myconfig, ...}: {};

  # if moduleSystem == "darwin"
  # then {config = ...;}
  # else {}
  darwin.ifEnabled = {name, cfg, parent, myconfig, ...}: {};
  darwin.ifDisabled = {name, cfg, parent, myconfig, ...}: {};
  darwin.always = {name, cfg, parent, myconfig, ...}: {};
}