Update #4455, Regenerate all commands' docs (#4557)

This commit is contained in:
Justin Ma 2022-02-20 09:13:33 +08:00 committed by GitHub
parent aea4355d04
commit 2ecae0ef43
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
48 changed files with 481 additions and 52 deletions

View File

@ -15,3 +15,10 @@ Alias a command (with optional flags) to a new name
- `name`: name of the alias - `name`: name of the alias
- `initial_value`: equals sign followed by value - `initial_value`: equals sign followed by value
## Examples
Alias ll to ls -l
```shell
> alias ll = ls -l
```

View File

@ -14,3 +14,10 @@ Time the running time of a block
- `block`: the block to run - `block`: the block to run
## Examples
Benchmarks a command within a block
```shell
> benchmark { sleep 500ms }
```

View File

@ -14,3 +14,10 @@ Change directory.
- `path`: the path to change to - `path`: the path to change to
## Examples
Change to your home directory
```shell
> cd ~
```

View File

@ -16,3 +16,15 @@ Copy files.
- `destination`: the place to copy to - `destination`: the place to copy to
- `--recursive`: copy recursively through subdirectories - `--recursive`: copy recursively through subdirectories
## Examples
Copy myfile to dir_b
```shell
> cp myfile dir_b
```
Recursively copy dir_a to dir_b
```shell
> cp -r dir_a dir_b
```

View File

@ -4,29 +4,35 @@ layout: command
version: 0.59.0 version: 0.59.0
--- ---
Format a given date using the given format string. Format a given date using a format string.
## Signature ## Signature
```> date format (format string)``` ```> date format (format string) --list```
## Parameters ## Parameters
- `format string`: the desired date format - `format string`: the desired date format
- `--list`: lists strftime cheatsheet
## Examples ## Examples
Format a given date using the given format string. Format a given date using the default format (RFC 2822).
```shell
> "2021-10-22 20:00:12 +01:00" | date format
```
Format a given date using a given format string.
```shell ```shell
> date format '%Y-%m-%d' > date format '%Y-%m-%d'
``` ```
Format a given date using the given format string. Format a given date using a given format string.
```shell ```shell
> date format "%Y-%m-%d %H:%M:%S" > date format "%Y-%m-%d %H:%M:%S"
``` ```
Format a given date using the given format string. Format a given date using a given format string.
```shell ```shell
> "2021-10-22 20:00:12 +01:00" | date format "%Y-%m-%d" > "2021-10-22 20:00:12 +01:00" | date format "%Y-%m-%d"
``` ```

View File

@ -10,3 +10,10 @@ List supported time zones.
```> date list-timezone ``` ```> date list-timezone ```
## Examples
Show timezone(s) that contains 'Shanghai'
```shell
> date list-timezone | where timezone =~ Shanghai
```

View File

@ -10,3 +10,10 @@ Get the current date.
```> date now ``` ```> date now ```
## Examples
Get the current date and display it in a given format string.
```shell
> date now | date format "%Y-%m-%d %H:%M:%S"
```

View File

@ -16,3 +16,15 @@ Define a custom command
- `params`: parameters - `params`: parameters
- `block`: body of the definition - `block`: body of the definition
## Examples
Define a command and run it
```shell
> def say-hi [] { echo 'hi' }; say-hi
```
Define a command and run it with parameter(s)
```shell
> def say-sth [sth: string] { echo $sth }; say-sth hi
```

View File

@ -8,10 +8,22 @@ splits contents across multiple columns via the separator.
## Signature ## Signature
```> detect columns --skip --no_headers``` ```> detect columns --skip --no-headers```
## Parameters ## Parameters
- `--skip {int}`: number of rows to skip before detecting - `--skip {int}`: number of rows to skip before detecting
- `--no_headers`: don't detect headers - `--no-headers`: don't detect headers
## Examples
Splits string across multiple columns
```shell
> echo 'a b c' | detect columns -n
```
Splits a multi-line string into columns with headers detected
```shell
> echo $'c1 c2 c3(char nl)a b c' | detect columns
```

View File

@ -8,11 +8,11 @@ Performs an aggregation operation on a dataframe and groupby object
## Signature ## Signature
```> dfr aggregate (operation-name) --quantile --explicit``` ```> dfr aggregate (operation_name) --quantile --explicit```
## Parameters ## Parameters
- `operation-name`: - `operation_name`:
Dataframes: mean, sum, min, max, quantile, median, var, std Dataframes: mean, sum, min, max, quantile, median, var, std
GroupBy: mean, sum, min, max, first, last, nunique, quantile, median, var, std, count GroupBy: mean, sum, min, max, first, last, nunique, quantile, median, var, std, count
- `--quantile {number}`: quantile value for quantile operation - `--quantile {number}`: quantile value for quantile operation

View File

@ -0,0 +1,24 @@
---
title: dfr drop-duplicates
layout: command
version: 0.59.0
---
Drops duplicate values in dataframe
## Signature
```> dfr drop-duplicates (subset) --maintain```
## Parameters
- `subset`: subset of columns to drop duplicates
- `--maintain`: maintain order
## Examples
drop duplicates
```shell
> [[a b]; [1 2] [3 4] [1 2]] | dfr to-df | dfr drop-duplicates
```

View File

@ -8,12 +8,12 @@ Performs a pivot operation on a groupby object
## Signature ## Signature
```> dfr pivot (pivot-column) (value-column) (operation)``` ```> dfr pivot (pivot_column) (value_column) (operation)```
## Parameters ## Parameters
- `pivot-column`: pivot column to perform pivot - `pivot_column`: pivot column to perform pivot
- `value-column`: value column to perform pivot - `value_column`: value column to perform pivot
- `operation`: aggregate operation - `operation`: aggregate operation
## Examples ## Examples

View File

@ -16,3 +16,15 @@ Run a block
- `...rest`: the parameter(s) for the block - `...rest`: the parameter(s) for the block
- `--ignore-errors`: ignore errors as the block runs - `--ignore-errors`: ignore errors as the block runs
## Examples
Run the block
```shell
> do { echo hello }
```
Run the block and ignore errors
```shell
> do -i { thisisnotarealcommand }
```

View File

@ -14,3 +14,10 @@ Remove the last number of columns. If you want to remove columns by name, try 'r
- `columns`: starting from the end, the number of columns to remove - `columns`: starting from the end, the number of columns to remove
## Examples
Remove the last column of a table
```shell
> echo [[lib, extension]; [nu-lib, rs] [nu-core, rb]] | drop column
```

View File

@ -19,6 +19,6 @@ Runs a block on groups of `group_size` rows of a table at a time.
Echo the sum of each pair Echo the sum of each pair
```shell ```shell
> echo [1 2 3 4] | each group 2 { $it.0 + $it.1 } > echo [1 2 3 4] | each group 2 { |it| $it.0 + $it.1 }
``` ```

View File

@ -20,7 +20,7 @@ Runs a block on window groups of `window_size` that slide by n rows.
A sliding window of two elements A sliding window of two elements
```shell ```shell
> echo [1 2 3 4] | each window 2 { $it.0 + $it.1 } > echo [1 2 3 4] | each window 2 { |it| $it.0 + $it.1 }
``` ```
A sliding window of two elements, with a stride of 3 A sliding window of two elements, with a stride of 3

View File

@ -29,6 +29,6 @@ more than one column
use a block if setting the empty cell contents is wanted use a block if setting the empty cell contents is wanted
```shell ```shell
> [[2020/04/16 2020/07/10 2020/11/16]; ['' [27] [37]]] | empty? 2020/04/16 -b { [33 37] } > [[2020/04/16 2020/07/10 2020/11/16]; ['' [27] [37]]] | empty? 2020/04/16 -b { |_| [33 37] }
``` ```

View File

@ -10,3 +10,20 @@ Display current environment variables
```> env ``` ```> env ```
## Examples
Display current path environment variable
```shell
> env | where name == PATH
```
Check whether the env variable `MY_ENV_ABC` exists
```shell
> env | any? name == MY_ENV_ABC
```
Another way to check whether the env variable `PATH` exists
```shell
> 'PATH' in (env).name
```

View File

@ -8,11 +8,11 @@ Create an error.
## Signature ## Signature
```> error make (error-struct)``` ```> error make (error_struct)```
## Parameters ## Parameters
- `error-struct`: the error to create - `error_struct`: the error to create
## Examples ## Examples

View File

@ -8,10 +8,22 @@ Runs a script file in the current context.
## Signature ## Signature
```> exit (exit-code) --now``` ```> exit (exit_code) --now```
## Parameters ## Parameters
- `exit-code`: Exit code to return immediately with - `exit_code`: Exit code to return immediately with
- `--now`: Exit out of the shell immediately - `--now`: Exit out of the shell immediately
## Examples
Exit the current shell
```shell
> exit
```
Exit all shells (exiting Nu)
```shell
> exit --now
```

View File

@ -39,11 +39,11 @@ Search a char in a list of string
Find the first odd value Find the first odd value
```shell ```shell
> echo [2 4 3 6 5 8] | find --predicate { ($it mod 2) == 1 } > echo [2 4 3 6 5 8] | find --predicate { |it| ($it mod 2) == 1 }
``` ```
Find if a service is not running Find if a service is not running
```shell ```shell
> echo [[version patch]; [0.1.0 $false] [0.1.1 $true] [0.2.0 $false]] | find -p { $it.patch } > echo [[version patch]; [0.1.0 $false] [0.1.1 $true] [0.2.0 $false]] | find -p { |it| $it.patch }
``` ```

View File

@ -8,9 +8,9 @@ Switch to a given shell.
## Signature ## Signature
```> g (shell-number)``` ```> g (shell_number)```
## Parameters ## Parameters
- `shell-number`: shell number to change to - `shell_number`: shell number to change to

View File

@ -8,12 +8,12 @@ base64 encode or decode a value
## Signature ## Signature
```> hash base64 ...rest --character_set --encode --decode``` ```> hash base64 ...rest --character-set --encode --decode```
## Parameters ## Parameters
- `...rest`: optionally base64 encode / decode data by column paths - `...rest`: optionally base64 encode / decode data by column paths
- `--character_set {string}`: specify the character rules for encoding the input. - `--character-set {string}`: specify the character rules for encoding the input.
Valid values are 'standard', 'standard-no-padding', 'url-safe', 'url-safe-no-padding','binhex', 'bcrypt', 'crypt' Valid values are 'standard', 'standard-no-padding', 'url-safe', 'url-safe-no-padding','binhex', 'bcrypt', 'crypt'
- `--encode`: encode the input as base64. This is the default behavior if not specified. - `--encode`: encode the input as base64. This is the default behavior if not specified.
- `--decode`: decode the input from base64 - `--decode`: decode the input from base64

View File

@ -14,3 +14,15 @@ Count the number of elements in the input.
- `--column`: Show the number of columns in a table - `--column`: Show the number of columns in a table
## Examples
Count the number of entries in a list
```shell
> echo [1 2 3 4 5] | length
```
Count the number of columns in the calendar table
```shell
> cal | length -c
```

View File

@ -15,3 +15,10 @@ Create an environment variable and give it a value.
- `var_name`: variable name - `var_name`: variable name
- `initial_value`: equals sign followed by value - `initial_value`: equals sign followed by value
## Examples
Create an environment variable and display it
```shell
> let-env MY_ENV_VAR = 1; $env.MY_ENV_VAR
```

View File

@ -27,3 +27,8 @@ Set a variable to the result of an expression
> let x = 10 + 100 > let x = 10 + 100
``` ```
Set a variable based on the condition
```shell
> let x = if $false { -1 } else { 1 }
```

View File

@ -14,3 +14,10 @@ Converts input to lines
- `--skip-empty`: skip empty lines - `--skip-empty`: skip empty lines
## Examples
Split multi-line string into lines
```shell
> echo $'two(char nl)lines' | lines
```

View File

@ -19,3 +19,20 @@ List the files in a directory.
- `--full-paths`: display paths as absolute paths - `--full-paths`: display paths as absolute paths
- `--du`: Display the apparent directory size in place of the directory metadata size - `--du`: Display the apparent directory size in place of the directory metadata size
## Examples
List all files in the current directory
```shell
> ls
```
List all files in a subdirectory
```shell
> ls subdir
```
List all rust files
```shell
> ls *.rs
```

View File

@ -15,3 +15,15 @@ Make directories, creates intermediary directories as required.
- `...rest`: the name(s) of the path(s) to create - `...rest`: the name(s) of the path(s) to create
- `--show-created-paths`: show the path(s) created. - `--show-created-paths`: show the path(s) created.
## Examples
Make a directory named foo
```shell
> mkdir foo
```
Make multiple directories and show the paths created
```shell
> mkdir -s foo/bar foo2
```

View File

@ -15,3 +15,20 @@ Move files or directories.
- `source`: the location to move files/directories from - `source`: the location to move files/directories from
- `destination`: the location to move files/directories to - `destination`: the location to move files/directories to
## Examples
Rename a file
```shell
> mv before.txt after.txt
```
Move a file into a directory
```shell
> mv test.txt my/subdirectory
```
Move many files into a directory
```shell
> mv *.txt my/subdirectory
```

View File

@ -1,20 +1,35 @@
# post ---
Post content to a URL and retrieve data as a table if possible. title: post
layout: command
version: 0.59.0
---
## Usage Post a body to a URL (HTTP POST operation).
```shell
> post <path> <body> {flags} ## Signature
```
```> post (path) (body) --user --password --content-type --content-length --raw --insecure```
## Parameters ## Parameters
* `<path>` the URL to post to
* `<body>` the contents of the post body
## Flags - `path`: the URL to post to
* -h, --help: Display this help message - `body`: the contents of the post body
* -u, --user <any>: the username when authenticating - `--user {any}`: the username when authenticating
* -p, --password <any>: the password when authenticating - `--password {any}`: the password when authenticating
* -t, --content-type <any>: the MIME type of content to post - `--content-type {any}`: the MIME type of content to post
* -l, --content-length <any>: the length of the content being posted - `--content-length {any}`: the length of the content being posted
* -r, --raw: return values as a string instead of a table - `--raw`: return values as a string instead of a table
- `--insecure`: allow insecure server connections when using SSL
## Examples
Post content to url.com
```shell
> post url.com 'body'
```
Post content to url.com, with username and password
```shell
> post -u myuser -p mypass url.com 'body'
```

28
docs/commands/print.md Normal file
View File

@ -0,0 +1,28 @@
---
title: print
layout: command
version: 0.59.0
---
Prints the values given
## Signature
```> print ...rest```
## Parameters
- `...rest`: the values to print
## Examples
Print 'hello world'
```shell
> print "hello world"
```
Print the sum of 2 and 3
```shell
> print (2 + 3)
```

View File

@ -20,26 +20,26 @@ Aggregate a list table to a single value using an accumulator block.
Sum values of a list (same as 'math sum') Sum values of a list (same as 'math sum')
```shell ```shell
> [ 1 2 3 4 ] | reduce { $it.acc + $it.item } > [ 1 2 3 4 ] | reduce {|it, acc| $it + $acc }
``` ```
Sum values with a starting value (fold) Sum values with a starting value (fold)
```shell ```shell
> [ 1 2 3 4 ] | reduce -f 10 { $it.acc + $it.item } > [ 1 2 3 4 ] | reduce -f 10 {|it, acc| $acc + $it }
``` ```
Replace selected characters in a string with 'X' Replace selected characters in a string with 'X'
```shell ```shell
> [ i o t ] | reduce -f "Arthur, King of the Britons" { $it.acc | str find-replace -a $it.item "X" } > [ i o t ] | reduce -f "Arthur, King of the Britons" {|it, acc| $acc | str find-replace -a $it "X" }
``` ```
Find the longest string and its index Find the longest string and its index
```shell ```shell
> [ one longest three bar ] | reduce -n { > [ one longest three bar ] | reduce -n { |it, acc|
if ($it.item | str length) > ($it.acc | str length) { if ($it.item | str length) > ($acc | str length) {
$it.item $it.item
} else { } else {
$it.acc $acc
} }
} }
``` ```

View File

@ -14,3 +14,15 @@ Remove the given columns from the table. If you want to remove rows, try 'drop'.
- `...rest`: the names of columns to remove from the table - `...rest`: the names of columns to remove from the table
## Examples
Lists the files in a directory without showing the modified column
```shell
> ls | reject modified
```
Reject the specified field in a record
```shell
> echo {a: 1, b: 2} | reject a
```

View File

@ -19,3 +19,25 @@ Remove file(s).
- `--force`: suppress error when no file - `--force`: suppress error when no file
- `--quiet`: supress output showing files deleted - `--quiet`: supress output showing files deleted
## Examples
Delete or move a file to the system trash (depending on 'rm_always_trash' config option)
```shell
> rm file.txt
```
Move a file to the system trash
```shell
> rm --trash file.txt
```
Delete a file permanently
```shell
> rm --permanent file.txt
```
Delete a file, and suppress errors if no file is found
```shell
> rm --force file.txt
```

View File

@ -0,0 +1,17 @@
---
title: run-external
layout: command
version: 0.59.0
---
Runs external command
## Signature
```> run-external ...rest --last-expression```
## Parameters
- `...rest`: external command to run
- `--last-expression`: last-expression

View File

@ -16,3 +16,15 @@ splits contents across multiple columns via the separator.
- `...rest`: column names to give the new columns - `...rest`: column names to give the new columns
- `--collapse-empty`: remove empty columns - `--collapse-empty`: remove empty columns
## Examples
Split a string into columns by the specified separator
```shell
> echo 'a--b--c' | split column '--'
```
Split a string into columns of char and remove the empty columns
```shell
> echo 'abc' | split column -c ''
```

View File

@ -14,3 +14,15 @@ splits contents over multiple rows via the separator.
- `separator`: the character that denotes what separates rows - `separator`: the character that denotes what separates rows
## Examples
Split a string into rows of char
```shell
> echo 'abc' | split row ''
```
Split a string into rows by the specified separator
```shell
> echo 'a--b--c' | split row '--'
```

View File

@ -0,0 +1,12 @@
---
title: str to-datetime
layout: command
version: 0.59.0
---
Deprecated command
## Signature
```> str to-datetime ```

View File

@ -17,3 +17,13 @@ Show info about the system
> sys > sys
``` ```
Show the os system name with get
```shell
> (sys).host | get name
```
Show the os system name
```shell
> (sys).host.name
```

View File

@ -8,9 +8,9 @@ Render the table.
## Signature ## Signature
```> table --start_number``` ```> table --start-number```
## Parameters ## Parameters
- `--start_number {int}`: row number to start viewing from - `--start-number {int}`: row number to start viewing from

View File

@ -8,12 +8,12 @@ Convert table into simple HTML
## Signature ## Signature
```> to html --html_color --no_color --dark --partial --theme --list``` ```> to html --html-color --no-color --dark --partial --theme --list```
## Parameters ## Parameters
- `--html_color`: change ansi colors to html colors - `--html-color`: change ansi colors to html colors
- `--no_color`: remove all ansi colors in output - `--no-color`: remove all ansi colors in output
- `--dark`: indicate your background color is a darker color - `--dark`: indicate your background color is a darker color
- `--partial`: only output the html for the content itself - `--partial`: only output the html for the content itself
- `--theme {string}`: the name of the theme to use (github, blulocolight, ...) - `--theme {string}`: the name of the theme to use (github, blulocolight, ...)

View File

@ -15,3 +15,15 @@ Creates one or more files.
- `filename`: the path of the file you want to create - `filename`: the path of the file you want to create
- `...rest`: additional files to create - `...rest`: additional files to create
## Examples
Creates "fixture.json"
```shell
> touch fixture.json
```
Creates files a, b and c
```shell
> touch a b c
```

View File

@ -16,3 +16,20 @@ Transposes the table contents so rows become columns and columns become rows.
- `--header-row`: treat the first row as column names - `--header-row`: treat the first row as column names
- `--ignore-titles`: don't transpose the column names into values - `--ignore-titles`: don't transpose the column names into values
## Examples
Transposes the table contents with default column names
```shell
> echo [[c1 c2]; [1 2]] | transpose
```
Transposes the table contents with specified column names
```shell
> echo [[c1 c2]; [1 2]] | transpose key val
```
Transposes the table without column names and specify a new column name
```shell
> echo [[c1 c2]; [1 2]] | transpose -i val
```

View File

@ -22,6 +22,11 @@ Update a column value
> echo {'name': 'nu', 'stars': 5} | update name 'Nushell' > echo {'name': 'nu', 'stars': 5} | update name 'Nushell'
``` ```
Use in block form for more involved updating logic
```shell
> echo [[count fruit]; [1 'apple']] | update count {|f| $f.count + 1}
```
Use in block form for more involved updating logic Use in block form for more involved updating logic
```shell ```shell
> echo [[project, authors]; ['nu', ['Andrés', 'JT', 'Yehuda']]] | update authors { get authors | str collect ',' } > echo [[project, authors]; ['nu', ['Andrés', 'JT', 'Yehuda']]] | update authors { get authors | str collect ',' }

View File

@ -14,3 +14,25 @@ Filter values based on a condition.
- `cond`: condition - `cond`: condition
## Examples
List all files in the current directory with sizes greater than 2kb
```shell
> ls | where size > 2kb
```
List only the files in the current directory
```shell
> ls | where type == file
```
List all files with names that contain "Car"
```shell
> ls | where name =~ "Car"
```
List all files that were modified in the last two weeks
```shell
> ls | where modified <= 2wk
```

View File

@ -34,6 +34,6 @@ Set by single row table
Set by row(e.g. `open x.json` or `from json`) Set by row(e.g. `open x.json` or `from json`)
```shell ```shell
> echo '{"X":"Y","W":"Z"}'|from json|with-env $it { echo $env.X $env.W } > echo '{"X":"Y","W":"Z"}'|from json|with-env $in { echo $env.X $env.W }
``` ```

View File

@ -14,3 +14,10 @@ Wrap the value into a column.
- `name`: the name of the column - `name`: the name of the column
## Examples
Wrap a list into a table with a given column name
```shell
> echo [1 2 3] | wrap num
```