nix3-profile-history(1)

๐Ÿ’– nix3-profile-history(1) ๐Ÿ’–

okay bestie, so this one lives in the General Commands Manual and it's literally called nix3-profile-history(1) โ€” say hi to her, she's iconic.

โš ๏ธ Warning โš ๏ธ โ€” this program is experimental and its interface is subject to change. So like, don't get too attached to the exact vibes, she might change her outfit on you. ๐Ÿ”ฎ

โœจ Name โœจ

nix profile history โ€” show all versions of a profile ๐ŸŒธ


๐Ÿฆ‹ Synopsis ๐Ÿฆ‹

nix profile history [optionโ€ฆ]

๐ŸŽ€ Examples ๐ŸŽ€

  • Show the changes between each version of your default profile:
# nix profile history
Version 508 (2020-04-10):
flake:nixpkgs#legacyPackages.x86_64-linux.awscli: โˆ… -> 1.17.13

Version 509 (2020-05-16) <- 508:
flake:nixpkgs#legacyPackages.x86_64-linux.awscli: 1.17.13 -> 1.18.211

like look at her go. so satisfying. ๐Ÿ’…


๐Ÿ’œ Description ๐Ÿ’œ

This command shows what packages were added, removed or upgraded between subsequent versions of a profile. ๐Ÿ“ˆ

Important tea though: it only shows top-level packages, not dependencies. if you want the dependency lore too, use nix profile diff-closures.

The addition of a package to a profile is denoted by the string โˆ… -> version, whereas the removal is denoted by version -> โˆ…. so like, โˆ… is the ghost of packages past. ๐Ÿ’€โœจ


๐Ÿ‘‘ Options ๐Ÿ‘‘

  • --profile path โ€” the profile to operate on. that's the one, that's the girl.

๐ŸŒˆ Common evaluation options ๐ŸŒˆ

  • --arg name expr โ€” pass the value expr as the argument name to Nix functions.
  • --arg-from-file name path โ€” pass the contents of file path as the argument name to Nix functions.
  • --arg-from-stdin name โ€” pass the contents of stdin as the argument name to Nix functions.
  • --argstr name string โ€” pass the string string as the argument name to Nix functions.
  • --debugger โ€” start an interactive environment if evaluation fails. like a little emergency sleepover for your errors. ๐Ÿซถ
  • --eval-store store-url โ€” the URL of the Nix store to use for evaluation, i.e. to store derivations (.drv files) and inputs referenced by them.
  • --impure โ€” allow access to mutable paths and repositories. living dangerously, love that for you. ๐Ÿ˜ณ
  • --include, -I path โ€” add path to search path entries used to resolve lookup paths.
    • This option may be given multiple times. ๐Ÿ”
    • Paths added through -I take precedence over the nix-path configuration setting and the NIX_PATH environment variable. she's got main character energy and she cuts the line. ๐Ÿ‘‘
  • --override-flake original-ref resolved-ref โ€” override the flake registries, redirecting original-ref to resolved-ref. it's giving set-a-redirect.
  • --debug โ€” set the logging verbosity level to โ€˜debugโ€™.
  • --log-format format โ€” set the format of log output; one of raw, internal-json, bar or bar-with-logs.
  • --print-build-logs, -L โ€” print full build logs on standard error.
  • --quiet โ€” decrease the logging verbosity level. shhh ๐Ÿคซ
  • --verbose, -v โ€” increase the logging verbosity level. tell me EVERYTHING ๐Ÿ—ฃ๏ธ

๐Ÿงš Miscellaneous global options ๐Ÿงš

  • --help โ€” show usage information.
  • --offline โ€” disable substituters and consider all previously downloaded files up-to-date.
  • --option name value โ€” set the Nix configuration setting name to value (overriding nix.conf).
  • --refresh โ€” consider all previously downloaded files out-of-date.
  • --repair โ€” during evaluation, rewrite missing or corrupted files in the Nix store. During building, rebuild missing or corrupted store paths.
  • --version โ€” show version information.
๐Ÿ“ Note โ€” see man nix.conf for overriding configuration settings with command line flags.

and that's the whole page bestie, no cap, nothing skipped, every single flag accounted for. ๐Ÿ’– the General Commands Manual said nix3-profile-history(1) and honestly? she ate. slay, periodt. โœจ๐ŸŽ€๐Ÿฆ‹

๐Ÿ“ฆ where this page comes from