nushell/crates/nu-protocol/src
JT 62e34b69b3
New commands: break, continue, return, and loop (#7230)
# Description

This adds `break`, `continue`, `return`, and `loop`.

* `break` - breaks out a loop
* `continue` - continues a loop at the next iteration
* `return` - early return from a function call
* `loop` - loop forever (until the loop hits a break)

Examples:
```
for i in 1..10 {
    if $i == 5 {
       continue
    } 
    print $i
}
```

```
for i in 1..10 {
    if $i == 5 {
        break
    } 
    print $i
}
```

```
def foo [x] {
    if true {
        return 2
    }
    $x
}
foo 100
```

```
loop { print "hello, forever" }
```

```
[1, 2, 3, 4, 5] | each {|x| 
    if $x > 3 { break }
    $x
}
```

# User-Facing Changes

Adds the above commands.

# 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-25 09:39:16 +13:00
..
ast Make external command substitution works friendly(like fish shell, trailing ending newlines) (#7156) 2022-11-23 16:51:57 +13:00
engine add signature information when get help on one command (#7079) 2022-11-20 07:22:42 -06:00
value Stdout/Stderr redirection (#7185) 2022-11-23 07:26:13 +13:00
cli_error.rs Clippy fix for Rust 1.63 (#6299) 2022-08-11 11:54:54 -05:00
config.rs Add missing legacy support for config.table_index_mode. (#7170) 2022-11-20 00:46:13 -05:00
example.rs Start support for commandline args to nu itself (#851) 2022-01-27 01:42:39 +11:00
exportable.rs Removes export env command (#6468) 2022-09-25 19:52:43 +03:00
id.rs Overlays (#5375) 2022-05-08 07:39:22 +12:00
lev_distance.rs Improve "Did you mean?" suggestions (#6579) 2022-09-20 19:46:01 -05:00
lib.rs Improve "Did you mean?" suggestions (#6579) 2022-09-20 19:46:01 -05:00
module.rs Removes export env command (#6468) 2022-09-25 19:52:43 +03:00
pipeline_data.rs Make external command substitution works friendly(like fish shell, trailing ending newlines) (#7156) 2022-11-23 16:51:57 +13:00
shell_error.rs New commands: break, continue, return, and loop (#7230) 2022-11-25 09:39:16 +13:00
signature.rs add signature information when get help on one command (#7079) 2022-11-20 07:22:42 -06:00
span.rs Clippy fix for Rust 1.63 (#6299) 2022-08-11 11:54:54 -05:00
syntax_shape.rs Split blocks and closures (#7075) 2022-11-10 21:21:49 +13:00
ty.rs add signature information when get help on one command (#7079) 2022-11-20 07:22:42 -06:00
variable.rs Limited mutable variables (#7089) 2022-11-11 19:51:08 +13:00