forked from extern/nushell
70 lines
4.6 KiB
Markdown
70 lines
4.6 KiB
Markdown
# pivot
|
|
|
|
Pivots the table contents so rows become columns and columns become rows.
|
|
|
|
## Examples
|
|
|
|
```shell
|
|
> ls docs
|
|
───┬────────────────────┬──────┬────────┬─────────────
|
|
# │ name │ type │ size │ modified
|
|
───┼────────────────────┼──────┼────────┼─────────────
|
|
0 │ docs/commands │ Dir │ 2.7 KB │ 53 mins ago
|
|
1 │ docs/docker.md │ File │ 7.0 KB │ 40 mins ago
|
|
2 │ docs/philosophy.md │ File │ 912 B │ 54 mins ago
|
|
───┴────────────────────┴──────┴────────┴─────────────
|
|
```
|
|
|
|
```shell
|
|
> ls docs | pivot
|
|
───┬──────────┬───────────────┬────────────────┬────────────────────
|
|
# │ Column0 │ Column1 │ Column2 │ Column3
|
|
───┼──────────┼───────────────┼────────────────┼────────────────────
|
|
0 │ name │ docs/commands │ docs/docker.md │ docs/philosophy.md
|
|
1 │ type │ Dir │ File │ File
|
|
2 │ size │ 2.7 KB │ 7.0 KB │ 912 B
|
|
3 │ modified │ 53 mins ago │ 40 mins ago │ 55 mins ago
|
|
───┴──────────┴───────────────┴────────────────┴────────────────────
|
|
```
|
|
|
|
Use `--header-row` to treat the first row as column names:
|
|
|
|
```shell
|
|
> ls docs | pivot --header-row
|
|
───┬───────────────┬────────────────┬────────────────────
|
|
# │ docs/commands │ docs/docker.md │ docs/philosophy.md
|
|
───┼───────────────┼────────────────┼────────────────────
|
|
0 │ Dir │ File │ File
|
|
1 │ 2.7 KB │ 7.0 KB │ 912 B
|
|
2 │ 53 mins ago │ 40 mins ago │ 55 mins ago
|
|
───┴───────────────┴────────────────┴────────────────────
|
|
```
|
|
|
|
Use `--ignore-titles` to prevent pivoting the column names into values:
|
|
|
|
```shell
|
|
> ls docs | pivot --ignore-titles
|
|
───┬───────────────┬────────────────┬────────────────────
|
|
# │ Column0 │ Column1 │ Column2
|
|
───┼───────────────┼────────────────┼────────────────────
|
|
0 │ docs/commands │ docs/docker.md │ docs/philosophy.md
|
|
1 │ Dir │ File │ File
|
|
2 │ 2.7 KB │ 7.0 KB │ 912 B
|
|
3 │ 54 mins ago │ 41 mins ago │ 56 mins ago
|
|
───┴───────────────┴────────────────┴────────────────────
|
|
```
|
|
|
|
Additional arguments are used as column names:
|
|
|
|
```shell
|
|
> ls docs | pivot foo bar baz
|
|
───┬──────────┬───────────────┬────────────────┬────────────────────
|
|
# │ foo │ bar │ baz │ Column3
|
|
───┼──────────┼───────────────┼────────────────┼────────────────────
|
|
0 │ name │ docs/commands │ docs/docker.md │ docs/philosophy.md
|
|
1 │ type │ Dir │ File │ File
|
|
2 │ size │ 2.7 KB │ 7.0 KB │ 912 B
|
|
3 │ modified │ 55 mins ago │ 41 mins ago │ 56 mins ago
|
|
───┴──────────┴───────────────┴────────────────┴────────────────────
|
|
```
|