nushell/crates/nu-parser/src
Bahex a0d7c1a4fd
Add SyntaxShape::OneOf syntax users can use (#15646)
# 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>
2025-05-07 15:43:01 -05:00
..
deparse.rs Fix quoting in to nuon and refactor quoting functions (#14180) 2024-10-29 07:43:26 -05:00
exportable.rs Restructure nu-protocol in more meaningful units (#11917) 2024-03-10 18:45:45 +01:00
flatten.rs fix: flatten of empty closures (#15374) 2025-03-21 06:35:18 -05:00
known_external.rs Custom command attributes (#14906) 2025-02-11 06:34:51 -06:00
lex.rs 14523 all comments should be prefixed with space tab or be beginning of token (#14616) 2024-12-25 21:31:51 +08:00
lib.rs Fix quoting in to nuon and refactor quoting functions (#14180) 2024-10-29 07:43:26 -05:00
lite_parser.rs Custom command attributes (#14906) 2025-02-11 06:34:51 -06:00
parse_keywords.rs fix(parser): comments in subexpressions of let/mut (#15375) 2025-03-25 21:28:06 +01:00
parse_patterns.rs Custom command attributes (#14906) 2025-02-11 06:34:51 -06:00
parse_shape_specs.rs Add SyntaxShape::OneOf syntax users can use (#15646) 2025-05-07 15:43:01 -05:00
parser.rs Bugfix/loss of precision when parsing value with unit (#15606) 2025-04-19 17:02:40 -05:00
type_check.rs Rework operator type errors (#14429) 2025-02-12 20:03:40 -08:00