doc: Remove ideas for full tabular data plans.
This commit is contained in:
@@ -60,9 +60,23 @@ selection. Useful for live preview pipelines.
|
||||
|
||||
### CSV / TSV
|
||||
|
||||
`--input-format csv` or `--input-format tsv` parses columnar
|
||||
input. First row is headers, which become field names. Maps
|
||||
naturally to table/column display mode.
|
||||
`--input-format csv` or `--input-format tsv` parses delimited
|
||||
input. First row is always headers, which become field names.
|
||||
|
||||
Each row becomes a JSON object. Known fields (`label`,
|
||||
`sublabel`, `icon`, `group`) are promoted to the top level.
|
||||
Everything else goes into a `meta` object. If no column
|
||||
matches the label key, the first column is used as `label`.
|
||||
|
||||
```sh
|
||||
# CSV rows become normal Items, so filtering, hooks, and
|
||||
# multi-select all work unchanged.
|
||||
echo "name,age,city\nalice,30,toronto" | pikl --input-format csv
|
||||
```
|
||||
|
||||
When `--input-format csv` or `tsv` is used without
|
||||
`--columns`, column config is auto-generated from the CSV
|
||||
headers.
|
||||
|
||||
## Event Hooks
|
||||
|
||||
@@ -441,11 +455,26 @@ pikl --format '{icon} {label} <dim>{sublabel}</dim>'
|
||||
### Table / Column Mode
|
||||
|
||||
```sh
|
||||
pikl --columns label,meta.res,meta.size --column-separator ' │ '
|
||||
pikl --columns label,meta.res:Resolution,meta.size
|
||||
```
|
||||
|
||||
Auto-aligns columns. Sortable per-column with keybinds.
|
||||
CSV/TSV input maps naturally here.
|
||||
`--columns` takes a comma-separated list of field paths.
|
||||
Each column can have a display alias after a colon
|
||||
(`meta.res:Resolution`). Auto-aligns columns by computing
|
||||
widths from header names and cell values (capped at 60
|
||||
chars). Column widths are computed in core and included in
|
||||
`ViewState`, so the GUI frontend gets them for free.
|
||||
|
||||
The header row renders bold/underlined with `│` separators.
|
||||
Item rows pad cells to column widths within the same `List`
|
||||
widget, so cursor/selection/visual-mode highlighting stays
|
||||
identical to the non-table path.
|
||||
|
||||
When `--input-format csv` is used without `--columns`,
|
||||
columns are auto-generated from the CSV headers.
|
||||
|
||||
**Future:** column sorting keybinds, cell/column selection,
|
||||
horizontal scrolling for wide tables.
|
||||
|
||||
### Preview Pane
|
||||
|
||||
@@ -757,8 +786,14 @@ find-walls --json | pikl \
|
||||
--on-cancel 'restore-wallpaper' \
|
||||
--on-hover-debounce 100
|
||||
|
||||
# Process killer with table view
|
||||
ps aux --no-headers | pikl --input-format tsv --columns 1,10,2 --multi
|
||||
# CSV table view
|
||||
echo "name,age,city\nalice,30,toronto\nbob,25,vancouver" | pikl --input-format csv
|
||||
|
||||
# CSV with column subset and aliases
|
||||
cat data.csv | pikl --input-format csv --columns "name,meta.age:Age"
|
||||
|
||||
# TSV table view
|
||||
ps aux --no-headers | pikl --input-format tsv --multi
|
||||
|
||||
# Drill-down file browser
|
||||
pikl --manifest ~/.config/pikl/filebrowser.toml --session filebrowser
|
||||
|
||||
Reference in New Issue
Block a user