forked from extern/nushell
76 lines
5.4 KiB
Markdown
76 lines
5.4 KiB
Markdown
# pivot
|
|
|
|
Pivots the table contents so rows become columns and columns become rows.
|
|
|
|
## Examples
|
|
|
|
```sh
|
|
> ls docs
|
|
━━━┯━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━
|
|
# │ name │ type │ readonly │ size │ accessed │ modified
|
|
───┼────────────────────┼───────────┼──────────┼────────┼─────────────┼─────────────
|
|
0 │ docs/commands │ Directory │ │ 4.1 KB │ an hour ago │ an hour ago
|
|
1 │ docs/docker.md │ File │ │ 7.0 KB │ an hour ago │ a day ago
|
|
2 │ docs/philosophy.md │ File │ │ 896 B │ an hour ago │ a day ago
|
|
━━━┷━━━━━━━━━━━━━━━━━━━━┷━━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━
|
|
|
|
> ls docs | pivot
|
|
━━━┯━━━━━━━━━━┯━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━
|
|
# │ Column0 │ Column1 │ Column2 │ Column3
|
|
───┼──────────┼───────────────┼────────────────┼────────────────────
|
|
0 │ name │ docs/commands │ docs/docker.md │ docs/philosophy.md
|
|
1 │ type │ Directory │ File │ File
|
|
2 │ readonly │ │ │
|
|
3 │ size │ 4.1 KB │ 7.0 KB │ 896 B
|
|
4 │ accessed │ an hour ago │ an hour ago │ an hour ago
|
|
5 │ modified │ an hour ago │ a day ago │ a day 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 │ Directory │ File │ File
|
|
1 │ │ │
|
|
2 │ 4.1 KB │ 7.0 KB │ 896 B
|
|
3 │ an hour ago │ an hour ago │ an hour ago
|
|
4 │ an hour ago │ a day ago │ a day 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 │ Directory │ File │ File
|
|
2 │ │ │
|
|
3 │ 4.1 KB │ 7.0 KB │ 896 B
|
|
4 │ an hour ago │ an hour ago │ an hour ago
|
|
5 │ an hour ago │ a day ago │ a day 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 │ Directory │ File │ File
|
|
2 │ readonly │ │ │
|
|
3 │ size │ 4.1 KB │ 7.0 KB │ 896 B
|
|
4 │ accessed │ 2 hours ago │ 2 hours ago │ 2 hours ago
|
|
5 │ modified │ 2 hours ago │ a day ago │ a day ago
|
|
━━━┷━━━━━━━━━━┷━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━
|
|
```
|