holm/nushell
1
1
Fork 0
forked from extern/nushell
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Replace row conditions with closures in commands (#7428)

Browse Source 
# Description

This PR changes some commands that previously accepted row conditions
(like `$it > 5`) as parameter to accept closures instead. The reasons
are:
a) The commands would need to move into parser keywords in the future
while they feel more like commands to be implemented in Nushell code as
a part of standard library.
b) In scripts, it is useful to store the predicate condition in a
variable which you can't do with row conditions.
c) These commands are not used that often to benefit enough from the
shorter row condition syntax

# User-Facing Changes

The following commands now accept **closure** instead of a **row
condition**:
- `take until`
- `take while`
- `skip until`
- `skip while`
- `any`
- `all`

This is a part of an effort to move away from shape-directed parsing.
Related PR: https://github.com/nushell/nushell/pull/7365

# 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.
This commit is contained in:
Jakub Žádník
2022-12-10 19:24:06 +02:00
committed by GitHub
parent 4d7d97e0e6
commit 2bacc29d30
14 changed files with 73 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
crates/nu-command/src/filters/all.rs
View File

@ -22,8 +22,8 @@ impl Command for All {
])
.required(
"predicate",
SyntaxShape::RowCondition,
"the expression, or block, that must evaluate to a boolean",
SyntaxShape::Closure(Some(vec![SyntaxShape::Any, SyntaxShape::Int])),
"a closure that must evaluate to a boolean",
)
.category(Category::Filters)
}
@ -40,18 +40,7 @@ impl Command for All {
vec![
Example {
description: "Check if each row's status is the string 'UP'",
example: "[[status]; [UP] [UP]] | all status == UP",
result: Some(Value::test_bool(true)),
},
Example {
description:
"Check that all of the values are even, using the built-in $it variable",
example: "[2 4 6 8] | all ($it mod 2) == 0",
result: Some(Value::test_bool(true)),
},
Example {
description: "Check that all of the values are even, using a block",
example: "[2 4 6 8] | all {|e| $e mod 2 == 0 }",
example: "[[status]; [UP] [UP]] | all {|el| $el.status == UP }",
result: Some(Value::test_bool(true)),
},
Example {
@ -59,6 +48,11 @@ impl Command for All {
example: "[0 2 4 6] | all {|el ind| $el == $ind * 2 }",
result: Some(Value::test_bool(true)),
},
Example {
description: "Check that all of the values are even, using a stored closure",
example: "let cond = {|el| ($el mod 2) == 0 }; [2 4 6 8] | all $cond",
result: Some(Value::test_bool(true)),
},
]
}
// This is almost entirely a copy-paste of `any`'s run(), so make sure any changes to this are

21
crates/nu-command/src/filters/any.rs
View File

@ -22,8 +22,8 @@ impl Command for Any {
])
.required(
"predicate",
SyntaxShape::RowCondition,
"the expression, or block, that should return a boolean",
SyntaxShape::Closure(Some(vec![SyntaxShape::Any, SyntaxShape::Int])),
"a closure that must evaluate to a boolean",
)
.category(Category::Filters)
}
@ -40,17 +40,7 @@ impl Command for Any {
vec![
Example {
description: "Check if any row's status is the string 'DOWN'",
example: "[[status]; [UP] [DOWN] [UP]] | any status == DOWN",
result: Some(Value::test_bool(true)),
},
Example {
description: "Check if any of the values is odd, using the built-in $it variable",
example: "[2 4 1 6 8] | any ($it mod 2) == 1",
result: Some(Value::test_bool(true)),
},
Example {
description: "Check if any of the values are odd, using a block",
example: "[2 4 1 6 8] | any {|e| $e mod 2 == 1 }",
example: "[[status]; [UP] [DOWN] [UP]] | any {|el| $el.status == DOWN }",
result: Some(Value::test_bool(true)),
},
Example {
@ -58,6 +48,11 @@ impl Command for Any {
example: "[9 8 7 6] | any {|el ind| $el == $ind * 2 }",
result: Some(Value::test_bool(true)),
},
Example {
description: "Check if any of the values are odd, using a stored closure",
example: "let cond = {|e| $e mod 2 == 1 }; [2 4 1 6 8] | any $cond",
result: Some(Value::test_bool(true)),
},
]
}
// This is almost entirely a copy-paste of `all`'s run(), so make sure any changes to this are

14
crates/nu-command/src/filters/skip/skip_until.rs
View File

@ -25,7 +25,7 @@ impl Command for SkipUntil {
])
.required(
"predicate",
SyntaxShape::RowCondition,
SyntaxShape::Closure(Some(vec![SyntaxShape::Any, SyntaxShape::Int])),
"the predicate that skipped element must not match",
)
.category(Category::Filters)
@ -43,7 +43,15 @@ impl Command for SkipUntil {
vec![
Example {
description: "Skip until the element is positive",
example: "[-2 0 2 -1] | skip until $it > 0",
example: "[-2 0 2 -1] | skip until {|x| $x > 0 }",
result: Some(Value::List {
vals: vec![Value::test_int(2), Value::test_int(-1)],
span: Span::test_data(),
}),
},
Example {
description: "Skip until the element is positive using stored condition",
example: "let cond = {|x| $x > 0 }; [-2 0 2 -1] | skip until $cond",
result: Some(Value::List {
vals: vec![Value::test_int(2), Value::test_int(-1)],
span: Span::test_data(),
@ -51,7 +59,7 @@ impl Command for SkipUntil {
},
Example {
description: "Skip until the field value is positive",
example: "[{a: -2} {a: 0} {a: 2} {a: -1}] | skip until $it.a > 0",
example: "[{a: -2} {a: 0} {a: 2} {a: -1}] | skip until {|x| $x.a > 0 }",
result: Some(Value::List {
vals: vec![
Value::test_record(vec!["a"], vec![Value::test_int(2)]),

14
crates/nu-command/src/filters/skip/skip_while.rs
View File

@ -25,7 +25,7 @@ impl Command for SkipWhile {
])
.required(
"predicate",
SyntaxShape::RowCondition,
SyntaxShape::Closure(Some(vec![SyntaxShape::Any, SyntaxShape::Int])),
"the predicate that skipped element must match",
)
.category(Category::Filters)
@ -43,7 +43,15 @@ impl Command for SkipWhile {
vec![
Example {
description: "Skip while the element is negative",
example: "[-2 0 2 -1] | skip while $it < 0",
example: "[-2 0 2 -1] | skip while {|x| $x < 0 }",
result: Some(Value::List {
vals: vec![Value::test_int(0), Value::test_int(2), Value::test_int(-1)],
span: Span::test_data(),
}),
},
Example {
description: "Skip while the element is negative using stored condition",
example: "let cond = {|x| $x < 0 }; [-2 0 2 -1] | skip while $cond",
result: Some(Value::List {
vals: vec![Value::test_int(0), Value::test_int(2), Value::test_int(-1)],
span: Span::test_data(),
@ -51,7 +59,7 @@ impl Command for SkipWhile {
},
Example {
description: "Skip while the field value is negative",
example: "[{a: -2} {a: 0} {a: 2} {a: -1}] | skip while $it.a < 0",
example: "[{a: -2} {a: 0} {a: 2} {a: -1}] | skip while {|x| $x.a < 0 }",
result: Some(Value::List {
vals: vec![
Value::test_record(vec!["a"], vec![Value::test_int(0)]),

14
crates/nu-command/src/filters/take/take_until.rs
View File

@ -25,7 +25,7 @@ impl Command for TakeUntil {
])
.required(
"predicate",
SyntaxShape::RowCondition,
SyntaxShape::Closure(Some(vec![SyntaxShape::Any, SyntaxShape::Int])),
"the predicate that element(s) must not match",
)
.category(Category::Filters)
@ -39,7 +39,15 @@ impl Command for TakeUntil {
vec![
Example {
description: "Take until the element is positive",
example: "[-1 -2 9 1] | take until $it > 0",
example: "[-1 -2 9 1] | take until {|x| $x > 0 }",
result: Some(Value::List {
vals: vec![Value::test_int(-1), Value::test_int(-2)],
span: Span::test_data(),
}),
},
Example {
description: "Take until the element is positive using stored condition",
example: "let cond = {|x| $x > 0 }; [-1 -2 9 1] | take until $cond",
result: Some(Value::List {
vals: vec![Value::test_int(-1), Value::test_int(-2)],
span: Span::test_data(),
@ -47,7 +55,7 @@ impl Command for TakeUntil {
},
Example {
description: "Take until the field value is positive",
example: "[{a: -1} {a: -2} {a: 9} {a: 1}] | take until $it.a > 0",
example: "[{a: -1} {a: -2} {a: 9} {a: 1}] | take until {|x| $x.a > 0 }",
result: Some(Value::List {
vals: vec![
Value::test_record(vec!["a"], vec![Value::test_int(-1)]),

14
crates/nu-command/src/filters/take/take_while.rs
View File

@ -25,7 +25,7 @@ impl Command for TakeWhile {
])
.required(
"predicate",
SyntaxShape::RowCondition,
SyntaxShape::Closure(Some(vec![SyntaxShape::Any, SyntaxShape::Int])),
"the predicate that element(s) must match",
)
.category(Category::Filters)
@ -39,7 +39,15 @@ impl Command for TakeWhile {
vec![
Example {
description: "Take while the element is negative",
example: "[-1 -2 9 1] | take while $it < 0",
example: "[-1 -2 9 1] | take while {|x| $x < 0 }",
result: Some(Value::List {
vals: vec![Value::test_int(-1), Value::test_int(-2)],
span: Span::test_data(),
}),
},
Example {
description: "Take while the element is negative using stored condition",
example: "let cond = {|x| $x < 0 }; [-1 -2 9 1] | take while $cond",
result: Some(Value::List {
vals: vec![Value::test_int(-1), Value::test_int(-2)],
span: Span::test_data(),
@ -47,7 +55,7 @@ impl Command for TakeWhile {
},
Example {
description: "Take while the field value is negative",
example: "[{a: -1} {a: -2} {a: 9} {a: 1}] | take while $it.a < 0",
example: "[{a: -1} {a: -2} {a: 9} {a: 1}] | take while {|x| $x.a < 0 }",
result: Some(Value::List {
vals: vec![
Value::test_record(vec!["a"], vec![Value::test_int(-1)]),