nushell/docs/commands/from-tsv.md
Jörn Zaefferer 8ab2b92405
docs/commands: add from.md, update subcommands (#1712)
This adds a top-level document for the new `from` command, with a list of links of all the subcommands.

All the from-* subcommands keep their filename, but the content is updated to use the new subcommand syntax.

Needs matching update for to*

Ref #1709
2020-05-05 09:01:31 +12:00

53 lines
1.4 KiB
Markdown

# from tsv
Parse text as `.tsv` and create table.
Syntax: `from tsv {flags}`
### Flags:
--headerless
don't treat the first row as column names
## Examples
Let's say we have the following file which is formatted like a `tsv` file:
```shell
> open elements.txt
Symbol Element
H Hydrogen
He Helium
Li Lithium
Be Beryllium
```
If we pass the output of the `open` command to `from tsv` we get a correct formatted table:
```shell
> open elements.txt | from tsv
━━━┯━━━━━━━━┯━━━━━━━━━━━
# │ Symbol │ Element
───┼────────┼───────────
0 │ H │ Hydrogen
1 │ He │ Helium
2 │ Li │ Lithium
3 │ Be │ Beryllium
━━━┷━━━━━━━━┷━━━━━━━━━━━
```
Using the `--headerless` flag has the following output:
```shell
> open elements.txt | from tsv --headerless
━━━━┯━━━━━━━━━┯━━━━━━━━━━━
# │ Column1 │ Column2
────┼─────────┼───────────
0 │ Symbol │ Element
1 │ H │ Hydrogen
2 │ He │ Helium
3 │ Li │ Lithium
4 │ Be │ Beryllium
━━━━┷━━━━━━━━━┷━━━━━━━━━━━
```