nushell/crates
Jakub Žádník 2388e1e80b
Reorder export-env eval and allow reloading an overlay (#7231)
# Description

This PR is a response to the issues raised in
https://github.com/nushell/nushell/pull/7087. It consists of two
changes:
* `export-env`, when evaluated in `overlay use`, will see the original
environment. Previously, it would see the environment from previous
overlay activation.
* Added a new `--reload` flag that reloads the overlay. Custom
definitions will be kept but the original definitions and environment
will be reloaded.

This enables a pattern when an overlay is supposed to shadow an existing
environment variable, such as `PROMPT_COMMAND`, but `overlay use` would
keep loading the value from the first activation. You can easily test it
by defining a module
```
module prompt {
    export-env {
        let-env PROMPT_COMMAND = (date now | into string)
    }
}
```
Calling `overlay use prompt` for the first time changes the prompt to
the current time, however, subsequent calls of `overlay use` won't
change the time. That's because overlays, once activated, store their
state so they can be hidden and restored at later time. To force-reload
the environment, use the new flag: Calling `overlay use --reload prompt`
repeatedly now updates the prompt with the current time each time.

# User-Facing Changes

* When calling `overlay use`, if the module has an `export-env` block,
the block will see the environment as it is _before_ the overlay is
activated. Previously, it was _after_.
* A new `overlay use --reload` flag.

# Tests + Formatting

Don't forget to add tests that cover your changes.

Make sure you've run and fixed any issues with these commands:

- `cargo fmt --all -- --check` to check standard code formatting (`cargo
fmt --all` applies these changes)
- `cargo clippy --workspace -- -D warnings -D clippy::unwrap_used -A
clippy::needless_collect` to check that you're using the standard code
style
- `cargo test --workspace` to check that all tests pass

# After Submitting

If your PR had any user-facing changes, update [the
documentation](https://github.com/nushell/nushell.github.io) after the
PR is merged, if necessary. This will help us keep the docs up to date.
2022-11-24 23:45:24 +01:00
..
nu_plugin_custom_values removes unused features. (#6938) 2022-11-12 18:44:56 +13:00
nu_plugin_example bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu_plugin_gstat bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu_plugin_inc bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu_plugin_python Further edits to help messages (#6913) 2022-10-26 09:36:42 -07:00
nu_plugin_query removes unused features. (#6938) 2022-11-12 18:44:56 +13:00
nu-cli New commands: break, continue, return, and loop (#7230) 2022-11-25 09:39:16 +13:00
nu-color-config fix color_config crashing on nonstring data (#7215) 2022-11-23 23:32:25 +01:00
nu-command Reorder export-env eval and allow reloading an overlay (#7231) 2022-11-24 23:45:24 +01:00
nu-engine New commands: break, continue, return, and loop (#7230) 2022-11-25 09:39:16 +13:00
nu-glob bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu-json Fixed json parsing (#7175) 2022-11-23 17:00:00 +13:00
nu-parser Reorder export-env eval and allow reloading an overlay (#7231) 2022-11-24 23:45:24 +01:00
nu-path bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu-plugin Friendly error message for missing plugin executable (#7163) 2022-11-19 12:12:18 +01:00
nu-pretty-hex bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu-protocol New commands: break, continue, return, and loop (#7230) 2022-11-25 09:39:16 +13:00
nu-system Turn off foreground processes on macOS (#7068) 2022-11-10 07:39:09 +13:00
nu-table [WIP] table: Change Record view in expand-mode (#6885) 2022-11-16 08:03:56 -06:00
nu-term-grid bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu-test-support bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
nu-utils Add auto-expanding table view to default config (#7172) 2022-11-20 20:52:38 +13:00
old bump to dev release 0.71.1 (#7064) 2022-11-09 13:18:34 +01:00
README.md Remove old nushell/merge engine-q 2022-02-07 14:54:06 -05:00

Nushell core libraries and plugins

These sub-crates form both the foundation for Nu and a set of plugins which extend Nu with additional functionality.

Foundational libraries are split into two kinds of crates:

  • Core crates - those crates that work together to build the Nushell language engine
  • Support crates - a set of crates that support the engine with additional features like JSON support, ANSI support, and more.

Plugins are likewise also split into two types:

  • Core plugins - plugins that provide part of the default experience of Nu, including access to the system properties, processes, and web-connectivity features.
  • Extra plugins - these plugins run a wide range of different capabilities like working with different file types, charting, viewing binary data, and more.