npingler-switch(1)

📦
version 0.6.0 · 2 versions
, in nixpkgs unstable

💅 npingler-switch — NAME

okay so bestie, welcome to npingler-switch, a page from the General Commands Manual that's about to become your new obsession ✨

npingler-switch — build the current profile and switch to it (alias: install) 🎀

✨ SYNOPSIS ✨

npingler switch [--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 and switch to it (alias: install) 💖

that's literally it, that's the whole vibe. build it, switch to it, slay 👑

🫶 OPTIONS 🫶

  • --hostname <HOSTNAME> — the hostname you're building the configuration for 🏠

this one corresponds to the `npingler.${hostname}` output attribute in your flake. also, you can set it with the HOSTNAME environment variable too, iykyk.

  • --config <CONFIG> — path to the configuration file you wanna use 📄

defaults to `~/.config/npingler/config.toml` ✨

  • --file <FILE> — path or directory that's holding your npingler Nix expressions 📁

defaults to the --config directory.

  • -h, --help — print help (see a summary with -h) 🙈

🦋 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, to use to diff derivations 🔍

this will be executed to display a diff of the changes being made to your profile before building it. no cap, it shows you what's about to change.

this may contain shell-quoted arguments 🐚

🧚 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 does not apply to (e.g.) nix-env. read that again bestie, it's giving "specific".

  • --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. periodt.

  • --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 🌈

  • --log-filter <LOG_FILTER> — tracing log filter 🪵

see this, it's the whole lore:

https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives

may also be specified with the NPINGLER_LOG environment variable.

  • --debug — alias for `--log-filter=trace` 🐛
  • -v, --verbose — alias for `--log-filter=debug` 🗣️
  • --dry — don't actually change the configuration 🧊
fr fr, this one means it's a dry run — nothing gets touched, bestie. zero chaos.

and that's the whole page, no crumbs left 💅 this was switch (the source/version bit) from the npingler-switch(1) manual, and the date on this beauty is right there in the footer — mwah, go build something iconic 🎀✨🦋

📦 where this page comes from