mirror of
https://github.com/nushell/nushell.git
synced 2025-05-28 14:07:08 +02:00
a0d7c1a4fd
# Description
Built-in commands can have parameter of `SyntaxShape::OneOf`.
This PR changes `OneOf`'s string representation and gives users the
ability to use it in definitions.
> _Syntax updated after discussion on discord._
```nushell
def foo [
param: oneof<binary, string>
] { .. }
```
```
Usage:
> foo <param>
Flags:
-h, --help: Display the help message for this command
Parameters:
param <oneof<binary, string>>
Input/output types:
╭───┬───────┬────────╮
│ # │ input │ output │
├───┼───────┼────────┤
│ 0 │ any │ any │
╰───┴───────┴────────╯
```
<details><summary>Previous iterations</summary>
<p>
> ```nushell
> def foo [
> param: (binary | string)
> ] { .. }
> ```
> ---
>
> ```nushell
> def foo [
> param: one_of(binary, string)
> ] { .. }
> ```
</p>
</details>
# User-Facing Changes
# Tests + Formatting
Added some test cases.
- 🟢 toolkit fmt
- 🟢 toolkit clippy
- 🟢 toolkit test
- 🟢 toolkit test stdlib
# After Submitting
- Update the website to include the new syntax
[here](https://github.com/nushell/nushell.github.io/blob/main/book/custom_commands.md)
- Update [tree-sitter-nu](https://github.com/nushell/tree-sitter-nu)
- Update `std` and `std-rfc` where applicable
---------
Co-authored-by: Bahex <17417311+Bahex@users.noreply.github.com>
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.