{ config, lib, pkgs, ... }: with lib; let cfg = config.home; dag = config.lib.dag; languageSubModule = types.submodule { options = { base = mkOption { default = null; type = types.nullOr types.str; description = '' The language to use unless overridden by a more specific option. ''; }; address = mkOption { default = null; type = types.nullOr types.str; description = '' The language to use for addresses. ''; }; monetary = mkOption { default = null; type = types.nullOr types.str; description = '' The language to use for formatting currencies and money amounts. ''; }; paper = mkOption { default = null; type = types.nullOr types.str; description = '' The language to use for paper sizes. ''; }; time = mkOption { default = null; type = types.nullOr types.str; description = '' The language to use for formatting times. ''; }; }; }; keyboardSubModule = types.submodule { options = { layout = mkOption { type = types.str; default = "us"; description = '' Keyboard layout. ''; }; model = mkOption { type = types.str; default = "pc104"; example = "presario"; description = '' Keyboard model. ''; }; options = mkOption { type = types.listOf types.str; default = []; example = ["grp:caps_toggle" "grp_led:scroll"]; description = '' X keyboard options; layout switching goes here. ''; }; variant = mkOption { type = types.str; default = ""; example = "colemak"; description = '' X keyboard variant. ''; }; }; }; in { meta.maintainers = [ maintainers.rycee ]; imports = [ (mkRemovedOptionModule [ "home" "sessionVariableSetter" ] '' Session variables are now always set through the shell. This is done automatically if the shell configuration is managed by Home Manager. If not, then you must source the ~/.nix-profile/etc/profile.d/hm-session-vars.sh file yourself. '') ]; options = { home.username = mkOption { type = types.str; defaultText = "$USER"; description = "The user's username."; }; home.homeDirectory = mkOption { type = types.path; defaultText = "$HOME"; description = "The user's home directory."; }; home.profileDirectory = mkOption { type = types.path; defaultText = "~/.nix-profile"; internal = true; readOnly = true; description = '' The profile directory where Home Manager generations are installed. ''; }; home.language = mkOption { type = languageSubModule; default = {}; description = "Language configuration."; }; home.keyboard = mkOption { type = keyboardSubModule; default = {}; description = "Keyboard configuration."; }; home.sessionVariables = mkOption { default = {}; type = types.attrs; example = { EDITOR = "emacs"; GS_OPTIONS = "-sPAPERSIZE=a4"; }; description = '' Environment variables to always set at login. The values may refer to other environment variables using POSIX.2 style variable references. For example, a variable parameter may be referenced as $parameter or ''${parameter}. A default value foo may be given as per ''${parameter:-foo} and, similarly, an alternate value bar can be given as per ''${parameter:+bar}. Note, these variables may be set in any order so no session variable may have a runtime dependency on another session variable. In particular code like home.sessionVariables = { FOO = "Hello"; BAR = "$FOO World!"; }; may not work as expected. If you need to reference another session variable, then do so inside Nix instead. The above example then becomes home.sessionVariables = { FOO = "Hello"; BAR = "''${config.home.sessionVariables.FOO} World!"; }; ''; }; home.packages = mkOption { type = types.listOf types.package; default = []; description = "The set of packages to appear in the user environment."; }; home.extraOutputsToInstall = mkOption { type = types.listOf types.str; default = []; example = [ "doc" "info" "devdoc" ]; description = '' List of additional package outputs of the packages home.packages that should be installed into the user environment. ''; }; home.path = mkOption { internal = true; description = "The derivation installing the user packages."; }; home.emptyActivationPath = mkOption { internal = true; default = false; type = types.bool; description = '' Whether the activation script should start with an empty PATH variable. When false then the user's PATH will be used. ''; }; home.activation = mkOption { internal = true; default = {}; type = types.attrs; description = '' Activation scripts for the home environment. Any script should respect the DRY_RUN variable, if it is set then no actual action should be taken. The variable DRY_RUN_CMD is set to echo if dry run is enabled. Thus, many cases you can use the idiom $DRY_RUN_CMD rm -rf /. ''; }; home.activationPackage = mkOption { internal = true; type = types.package; description = "The package containing the complete activation script."; }; home.extraBuilderCommands = mkOption { type = types.lines; default = ""; internal = true; description = '' Extra commands to run in the Home Manager generation builder. ''; }; home.extraProfileCommands = mkOption { type = types.lines; default = ""; internal = true; description = '' Extra commands to run in the Home Manager profile builder. ''; }; }; config = { assertions = [ { assertion = config.home.username != ""; message = "Username could not be determined"; } { assertion = config.home.homeDirectory != ""; message = "Home directory could not be determined"; } ]; home.username = mkDefault (builtins.getEnv "USER"); home.homeDirectory = mkDefault (builtins.getEnv "HOME"); home.profileDirectory = cfg.homeDirectory + "/.nix-profile"; home.sessionVariables = let maybeSet = n: v: optionalAttrs (v != null) { ${n} = v; }; in (maybeSet "LANG" cfg.language.base) // (maybeSet "LC_ADDRESS" cfg.language.address) // (maybeSet "LC_MONETARY" cfg.language.monetary) // (maybeSet "LC_PAPER" cfg.language.paper) // (maybeSet "LC_TIME" cfg.language.time); home.packages = [ # Provide a file holding all session variables. ( pkgs.writeTextFile { name = "hm-session-vars.sh"; destination = "/etc/profile.d/hm-session-vars.sh"; text = '' # Only source this once. if [ -n "$__HM_SESS_VARS_SOURCED" ]; then return; fi export __HM_SESS_VARS_SOURCED=1 ${config.lib.shell.exportAll cfg.sessionVariables} ''; } ) ]; # A dummy entry acting as a boundary between the activation # script's "check" and the "write" phases. home.activation.writeBoundary = dag.entryAnywhere ""; # Install packages to the user environment. # # Note, if we are running as a NixOS module then we cannot rely on # `nix-envĀ -i` because our target may not allow modification of # the Nix store. We will instead use the # `users.users..packages` NixOS option. We still need this # activation command, however, since some modules need to ensure # that their activation commands are run after packages are # guaranteed to be installed. # # In case the user has moved from a user-install of Home Manager # to one managed through the NixOS module we attempt to uninstall # the `home-manager-path` package if it is installed. home.activation.installPackages = dag.entryAfter ["writeBoundary"] ( if config.submoduleSupport.enable then '' if nix-env -q | grep '^home-manager-path$'; then nix-env -e home-manager-path fi '' else '' $DRY_RUN_CMD nix-env -i ${cfg.path} '' ); home.activationPackage = let mkCmd = res: '' noteEcho Activating ${res.name} ${res.data} ''; sortedCommands = dag.topoSort cfg.activation; activationCmds = if sortedCommands ? result then concatStringsSep "\n" (map mkCmd sortedCommands.result) else abort ("Dependency cycle in activation script: " + builtins.toJSON sortedCommands); # Programs that always should be available on the activation # script's PATH. activationBinPaths = lib.makeBinPath [ pkgs.bash pkgs.coreutils pkgs.diffutils # For `cmp` and `diff`. pkgs.findutils pkgs.gnugrep pkgs.gnused pkgs.ncurses # For `tput`. ] + optionalString (!cfg.emptyActivationPath) "\${PATH:+:}$PATH"; activationScript = pkgs.writeScript "activation-script" '' #!${pkgs.stdenv.shell} set -eu set -o pipefail cd $HOME export PATH="${activationBinPaths}" . ${./lib-bash/color-echo.sh} ${builtins.readFile ./lib-bash/activation-init.sh} ${activationCmds} ''; in pkgs.stdenv.mkDerivation { name = "home-manager-generation"; preferLocalBuild = true; allowSubstitutes = false; buildCommand = '' mkdir -p $out cp ${activationScript} $out/activate substituteInPlace $out/activate \ --subst-var-by GENERATION_DIR $out ln -s ${config.home-files} $out/home-files ln -s ${cfg.path} $out/home-path ${cfg.extraBuilderCommands} ''; }; home.path = pkgs.buildEnv { name = "home-manager-path"; paths = cfg.packages; inherit (cfg) extraOutputsToInstall; postBuild = cfg.extraProfileCommands; meta = { description = "Environment of packages installed through home-manager"; }; }; }; }