nushell/crates
WindSoilder 0b97f52a8b
make better usage of error value in catch block (#8460)
# Description

Fixes: #8402  #8391

The cause of these issue if when we want to evaluate a expression with
`Value::Error`, nushell show error immediately. To fix the issue, we can
wrap the `Value::Error` into a `Value::Record`. So user can see the
message he want.

# User-Facing Changes

Before
```
❯ try { 1 / 0 } catch {|e| echo $"error is ($e)"}
Error: nu:🐚:division_by_zero

  × Division by zero.
   ╭─[entry #2:1:1]
 1 │ try { 1 / 0 } catch {|e| echo $"error is ($e)"}
   ·         ┬
   ·         ╰── division by zero
   ╰────
```

After
```
❯ try { 1 / 0 } catch {|e| echo $"error is ($e)"}
error is {msg: Division by zero., debug: DivisionByZero { span: Span { start: 43104, end: 43105 } }, raw: DivisionByZero { sp
an: Span { start: 43104, end: 43105 } }}
```

As we can see, error becomes a record with `msg`, `debug`, `raw`
columns.
1. msg column is a user friendly message.
2. debug column is more about `Value::Error` information as a string.
3. raw column is a `Value::Error` itself, if user want to re-raise the
error, just use `$e | get raw`

# 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

> **Note**
> from `nushell` you can also use the `toolkit` as follows
> ```bash
> use toolkit.nu # or use an `env_change` hook to activate it
automatically
> toolkit check pr
> ```

# 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.
2023-03-15 20:56:18 -07:00
..
nu_plugin_custom_values Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu_plugin_example Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu_plugin_formats Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu_plugin_gstat Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu_plugin_inc Optional members in cell paths: Attempt 2 (#8379) 2023-03-15 20:50:58 -07:00
nu_plugin_python update nu_plugin_python due to signature changes (#8107) 2023-02-18 13:27:24 +00:00
nu_plugin_query Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-cli Optional members in cell paths: Attempt 2 (#8379) 2023-03-15 20:50:58 -07:00
nu-cmd-lang make better usage of error value in catch block (#8460) 2023-03-15 20:56:18 -07:00
nu-color-config Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-command make better usage of error value in catch block (#8460) 2023-03-15 20:56:18 -07:00
nu-engine Optional members in cell paths: Attempt 2 (#8379) 2023-03-15 20:50:58 -07:00
nu-explore Optional members in cell paths: Attempt 2 (#8379) 2023-03-15 20:50:58 -07:00
nu-glob Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-json Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-parser Optional members in cell paths: Attempt 2 (#8379) 2023-03-15 20:50:58 -07:00
nu-path Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-plugin Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-pretty-hex Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-protocol Optional members in cell paths: Attempt 2 (#8379) 2023-03-15 20:50:58 -07:00
nu-system Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-table Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-term-grid Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-test-support Bump to 0.77.1 development version (#8453) 2023-03-14 23:26:08 +01:00
nu-utils DOC: make the README of the standard library clearer (#8465) 2023-03-15 20:13:09 -07: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.