Структура

В этом разделе будут использованы переменные myconfigName, isHomeManager и homeManagerUser, поэтому рекомендуется предварительно ознакомиться с соответствующим подразделом: Аргументы delib.configurations.

Аргументы функции

• name: строка. Рекомендуется, чтобы она совпадала с родительским путём опции enable модуля, например, "programs.example", так как передаваемый аргумент cfg зависит именно от этого пути.
• options: attrset или lambda, которая возвращает attrset (см. Опции).
• [myconfig|nixos|home].[ifEnabled|ifDisabled|always]: attrset или lambda, которая возвращает attrset.
• myconfig.*: устанавливает значения в config.${myconfigName}.
• nixos.*: устанавливает значения в config, если isHomeManager равен false, иначе не выполняется.
• home.*: устанавливает значения в config, если isHomeManager равен true, иначе в config.home-manager.users.${homeManagerUser}.
• [myconfig|nixos|home].ifEnabled: выполняется только если опция cfg.enable (см. Передаваемые аргументы - cfg) существует и равна true.
• [myconfig|nixos|home].ifDisabled: выполняется только если опция cfg.enable существует и равна false.
• [myconfig|nixos|home].always: выполняется всегда, даже если опция cfg.enable не существует.

Передаваемые аргументы

Список аргументов, которые передаются в options и [myconfig|nixos|home].[ifEnabled|ifDisabled|always], если их тип - это lambda:

• name: тот же name из аргументов delib.module.
• myconfig: равен config.${myConfigName}.
• cfg: равен результату выражения delib.getAttrByStrPath name config.${myConfigName} {}, где name - это аргумент delib.module, а {} - значение, которое возвращается, если атрибут не найден.

Псевдокод

delib.module {
  name = "";
  
  # options.${myConfigName} = ...
  options = {name, cfg, myconfig, ...}: {};

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

  # если isHomeManager
  # то {}
  # иначе {config = ...;}
  nixos.ifEnabled = {name, cfg, myconfig, ...}: {};
  nixos.ifDisabled = {name, cfg, myconfig, ...}: {};
  nixos.always = {name, cfg, myconfig, ...}: {};

  # если isHomeManager
  # то {config = ...;}
  # иначе {config.home-manager.users.${homeManagerUser} = ...;}
  home.ifEnabled = {name, cfg, myconfig, ...}: {};
  home.ifDisabled = {name, cfg, myconfig, ...}: {};
  home.always = {name, cfg, myconfig, ...}: {};
}