extern/nushell
1
0
Fork 1
mirror of https://github.com/nushell/nushell.git synced 2024-10-08 11:23:20 +02:00
Code Issues Packages Projects Releases Wiki Activity
b94a32e523
nushell/docs/commands/pivot.md
R.T. Lechow 036860770b
Document pivot command 
Part of https://github.com/nushell/nushell/issues/711
2019-11-14 16:59:39 -05:00

5.4 KiB
Raw Blame History

pivot

Pivots the table contents so rows become columns and columns become rows.

Examples

> 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:

> 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:

> 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:

> 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
━━━┷━━━━━━━━━━┷━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━