npingler-build(1)

📦
version 0.6.0 · 2 versions
, in nixpkgs unstable

🎀 npingler-build(1) — bestie edition 🎀

okay so real quick: this is from the General Commands Manual, section 1, and the page name is npingler-build. got it? good. let's go 💅

✨ NAME ✨

npingler-build — build the current profile but don't switch to it 🫶

like, you're doing the homework but you're not turning it in yet. iconique behavior honestly.

✨ SYNOPSIS ✨

npingler build [--hostname] [--profile] [--diff-derivations]
[--pin-registry-root] [--root-registry-path] [--pin-channels-root]
[--root-profile] [--extra-nix-args] [--extra-nix-build-args]
[--extra-nix-eval-args] [--extra-nix-env-set-args] [--config] [--file]
[--log-filter] [--debug] [-v|--verbose] [--dry] [-h|--help]

✨ DESCRIPTION ✨

Build the current profile but don't switch to it.

no cap, that's the whole vibe: it builds. it does not switch. those are two different things and honestly the distinction is doing a lot of work here 😌

✨ OPTIONS ✨

  • --hostname <HOSTNAME> — the hostname you're building the configuration for 🖥️ this maps to the npingler.${hostname} output attribute in your flake, iykyk. you can also set it with the HOSTNAME environment variable.
  • --config <CONFIG> — path to the config file you wanna use. defaults to ~/.config/npingler/config.toml 🎀
  • --file <FILE> — path or directory that contains your npingler Nix expressions. defaults to whatever the --config directory is 📁
  • -h, --help — print help (see a summary with -h). the short one is the tl;dr version bestie 💖

✨ NIX PROFILE OPTIONS ✨

  • --profile <PROFILE> — the profile to use for nix profile operations. may also be specified with the NIX_PROFILE environment variable 🌸
  • --diff-derivations <DIFF_DERIVATIONS> — a command, like nix-diff or nvd, that you use to diff derivations 👀 this gets executed so you can see a diff of the changes being made to your profile before it builds. it may contain shell-quoted arguments (so yes, you can be fancy with it).

✨ NIX REGISTRY OPTIONS ✨

  • --pin-registry-root <PIN_REGISTRY_ROOT> — pin Nix Flake registry entries for the root user 👑 [possible values: true, false]
  • --root-registry-path <ROOT_REGISTRY_PATH> — the Nix Flake registry path for the root user. defaults to /etc/nix/registry.json. may also be specified with the ROOT_NIX_REGISTRY environment variable 🗂️

✨ NIX CHANNEL OPTIONS ✨

  • --pin-channels-root <PIN_CHANNELS_ROOT> — pin Nix channels for the root user ✨ [possible values: true, false]
  • --root-profile <ROOT_PROFILE> — the root user's Nix profile path. defaults to /nix/var/nix/profiles/per-user/root/channels. may also be specified with the ROOT_NIX_PROFILE environment variable 🧚

✨ NIX COMMAND ARG OPTIONS ✨

  • --extra-nix-args <EXTRA_NIX_ARGS> — extra args for nix invocations. this is for all nix binary ("nix3") invocations, but it does not apply to (e.g.) nix-env 💀
  • --extra-nix-build-args <EXTRA_NIX_BUILD_ARGS> — extra args for nix build invocations. note this is NOT for nix-build, which we do not invoke 🚫
  • --extra-nix-eval-args <EXTRA_NIX_EVAL_ARGS> — extra args for nix eval invocations 🔍
  • --extra-nix-env-set-args <EXTRA_NIX_ENV_SET_ARGS> — extra args for nix-env --set invocations 🎯

✨ LOGGING OPTIONS ✨

💜 reminder from your girl: --dry means genuinely nothing changes. it's giving "window shopping". don't come for me if you expected it to write stuff, because it will not.

slay, that's the whole page 🦋 this was build (the version/source bit, as printed down there in the footer) and it's dated npingler-build(1) — okay that part is just the manual reference, but the footer literally reads build on the left and npingler-build(1) on the right, so there ya go. go build your profile without switching to it, bestie. proud of you. periodt 💖🎀🌈

📦 where this page comes from