lix/doc/manual/rl-next
Rebecca Turner 727b43478c 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
    Lix 2.90.0
    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-04-08 17:11:47 -07:00
..
better-errors-in-nix-repl.md Add pre-commit checks 2024-03-29 22:57:40 -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
forbid-nested-debuggers.md Merge pull request #9920 from 9999years/forbid-nested-debuggers 2024-03-31 17:28:25 +00: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
no-cache-eval-errors.md always re-eval cached failures 2024-04-06 04:35:25 +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-doc-command.md repl: improve :doc builtin repl command to support lambdas. 2024-04-03 13:47:22 -06:00
repl-overlays.md Add repl-overlays 2024-04-08 17:11:47 -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