lix/doc/manual/rl-next
Rebecca Turner e2a1f79490 Add repl-overlays
Adds a `repl-overlays` option, which specifies files that can overlay
and modify the top-level bindings in `nix repl`. For example, with the
following contents in `~/.config/nix/repl.nix`:

    info: final: prev: let
      optionalAttrs = predicate: attrs:
        if predicate
        then attrs
        else {};
    in
      optionalAttrs (prev ? legacyPackages && prev.legacyPackages ? ${info.currentSystem})
      {
        pkgs = prev.legacyPackages.${info.currentSystem};
      }

We can run `nix repl` and use `pkgs` to refer to `legacyPackages.${currentSystem}`:

    $ nix repl --repl-overlays ~/.config/nix/repl.nix nixpkgs
    Nix 2.21.0pre20240309_4111bb6
    Type :? for help.
    Loading installable 'flake:nixpkgs#'...
    Added 5 variables.
    Loading 'repl-overlays'...
    Added 6 variables.
    nix-repl> pkgs.bash
    «derivation /nix/store/g08b5vkwwh0j8ic9rkmd8mpj878rk62z-bash-5.2p26.drv»

Change-Id: Ic12e0f2f210b2f46e920c33088dfe1083f42391a
2024-03-29 19:35:39 -07:00
..
better-errors-in-nix-repl.md Merge pull request #9928 from 9999years/error-messages-in-nix-repl 2024-03-09 03:37:35 -07:00
debugger-locals-for-let-expressions.md manual: fix release notes 2024-03-27 03:09:14 +00:00
debugger-on-trace.md Merge pull request #9914 from 9999years/debugger-on-trace 2024-03-09 10:17:26 -07:00
drop-vendored-toml11.md Stop vendoring toml11 2024-03-27 21:04:00 -04:00
drv-string-parse-hang.md Merge pull request #9673 from pennae/drv-parse-opts 2024-03-04 07:36:51 +01:00
dup-attr-errors.md build: replace changelog-d with local script 2024-03-27 03:09:14 +00:00
empty-search-regex.md manual: fix release notes 2024-03-27 03:09:14 +00:00
enter-debugger-more-reliably-in-let-and-calls.md Merge pull request #9917 from 9999years/enter-debugger-more-reliably 2024-03-09 03:37:35 -07:00
env-size-reduction.md Merge pull request #9658 from pennae/env-diet 2024-03-04 07:37:45 +01:00
eval-system.md Merge pull request #4093 from matthewbauer/eval-system 2024-03-04 07:21:01 +01:00
formal-order.md normalize formal order on ExprLambda::show 2024-03-18 07:56:34 -06:00
inherit-error-positions.md report inherit attr errors at the duplicate name 2024-03-18 16:12:45 +01:00
inherit-from-by-need.md evaluate inherit (from) exprs only once per directive 2024-03-10 03:18:32 -06:00
nix-env-json-drv-path.md Merge pull request #9573 from hercules-ci/rl-next-md-frontmatter 2024-03-04 07:12:09 +01:00
nix-flake-check-logs-actions.md Add release notes 2024-03-07 12:29:57 -08:00
nix-flake-update-ux.md manual: fix release notes 2024-03-27 03:09:14 +00:00
nixversion-fake.md build: replace changelog-d with local script 2024-03-27 03:09:14 +00:00
print-value-in-coercion-error.md manual: fix release notes 2024-03-27 03:09:14 +00:00
print-value-in-type-error.md manual: fix release notes 2024-03-27 03:09:14 +00:00
reduce-debugger-clutter.md Merge pull request #9919 from 9999years/reduce-debugger-clutter 2024-03-04 08:52:57 +01:00
repl-overlays.md Add repl-overlays 2024-03-29 19:35:39 -07:00
short-expr-flag.md build: replace changelog-d with local script 2024-03-27 03:09:14 +00:00
source-location-in-while-evaluating-attribute.md Merge pull request #9915 from 9999years/evaluating-attribute-position 2024-03-04 09:25:17 +01:00
source-positions-in-errors.md Merge pull request #9753 from 9999years/print-value-on-type-error 2024-03-09 00:05:41 -07:00
stack-overflow-segfaults.md Merge pull request #9617 from 9999years/stack-overflow-segfault 2024-03-04 07:35:20 +01:00
upstart-removal.md build: replace changelog-d with local script 2024-03-27 03:09:14 +00:00
with-error-reporting.md Merge pull request #9753 from 9999years/print-value-on-type-error 2024-03-09 00:05:41 -07:00