dataframe-toolkit 0.11.3__tar.gz → 0.13.0__tar.gz

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dataframe-toolkit
-Version: 0.11.3
+Version: 0.13.0
 Summary: A command-line toolkit for DataFrame analysis and manipulation
 Keywords: dataframe,statistics,data analysis,CLI,TSV,pandas
 Author: Gunnar Pálsson
@@ -77,17 +77,20 @@ uv tool install .
 
 ### Skill for coding agents
 
-`skills/dftk/` is an agent skill: a short guide that coding agents such as
-Codex and Claude Code load when a task involves dftk. It covers the piping
+dftk ships an agent skill: a short guide that coding agents such as Codex
+and Claude Code load when a task involves dftk. It covers the piping
 conventions, which command to use for what, and patterns for Snakemake and
-Make. Copy it into your agent's skills directory, for example:
+Make. Install it with:
 
 ```bash
-cp -r skills/dftk ~/.codex/skills/     # Codex
-cp -r skills/dftk ~/.claude/skills/    # Claude Code
+dftk skill install            # every agent found: ~/.claude and/or ~/.codex
+dftk skill install --codex    # only one (--claude or --codex; creates the folder)
+dftk skill install --dir DIR  # another agent's skills folder
 ```
 
-Copy it again after upgrading dftk so it matches the installed version.
+It prints where it installed the skill. Run it again after upgrading dftk
+so the skill matches the installed version; it replaces only the earlier
+dftk skill. The source is in `src/dftk/skills/dftk/`.
 
 ## Quick example
 
@@ -95,15 +98,15 @@ Copy it again after upgrading dftk so it matches the installed version.
 dftk dataset tips | dftk stat - -c tip total_bill -g day
 ```
 
-Chain commands with `-o` (write to a temp parquet, print its path) and `...`
-(read a parquet path from stdin) instead of piping TSV text directly — faster
-for large data, and the recommended pattern once a pipeline has more than one
-step:
+Chain commands with a bare `-o` (write a temp parquet, print its path)
+instead of piping TSV text: the next command sees the path on stdin and reads
+that file. It's faster for large data, keeps column types exact, and is the
+recommended pattern once a pipeline has more than one step:
 
 ```bash
 dftk dataset tips -o \
-  | dftk pivot ... -i day -v tip -f mean -o \
-  | dftk print ...
+  | dftk pivot -i day -v tip -f mean -o \
+  | dftk print
 ```
 
 ## Subcommands
@@ -163,7 +166,7 @@ publication-quality output.
 | `sample`   | Random row sampling (with or without replacement, by count or fraction)   |
 | `split`    | Split a dataframe into one file per group                                 |
 | `annotate` | Read and write provenance metadata (genome, source, …) in parquet files  |
-| `print`    | Read any dftk input (TSV, stdin, `...` parquet pipe) and write TSV     |
+| `print`    | Read any dftk input (TSV, parquet, stdin) and write TSV                |
 | `clean`    | Remove leftover temp parquet pipe files from interrupted pipelines       |
 | `help`     | List all subcommands or show full help for one: `dftk help stat`       |
 
@@ -174,8 +177,8 @@ publication-quality output.
 ```bash
 # z-score sepal_length within species, then fit against petal_length
 dftk dataset iris -o \
-  | dftk scale ... -c sepal_length -g species -o \
-  | dftk fit ... -f "sepal_length_scaled ~ petal_length" -g species
+  | dftk scale -c sepal_length -g species -o \
+  | dftk fit -f "sepal_length_scaled ~ petal_length" -g species
 ```
 
 ### Clean up spreadsheet headers
@@ -184,8 +187,8 @@ Headers such as `Country Name` or `1960` need quoting in SQL. `cleannames` turns
 
 ```bash
 dftk dataset fertility -o \
-  | dftk cleannames ... -o \
-  | dftk query ... --sql "SELECT country_name, x1960, x2000 FROM data LIMIT 3"
+  | dftk cleannames -o \
+  | dftk query --sql "SELECT country_name, x1960, x2000 FROM data LIMIT 3"
 ```
 
 For your own export, `dftk cleannames data.tsv --backend duckdb -o data.parquet` also keeps integer columns with empty cells as integers.
@@ -196,7 +199,7 @@ With tens of thousands of points a scatter plot is a solid blob. `--hexbin` coun
 
 ```bash
 dftk dataset diamonds -o \
-  | dftk scat ... -x carat -y price --hexbin --hexlog --logx --logy -f diamonds.png
+  | dftk scat -x carat -y price --hexbin --hexlog --logx --logy -f diamonds.png
 ```
 
 `--colorcol COL` colours each hexagon by the mean of `COL` instead of the count; with `--subgraphcol` all panels share one colour scale.
@@ -205,8 +208,8 @@ dftk dataset diamonds -o \
 
 ```bash
 dftk dataset tips -o \
-  | dftk stat ... -c tip -g day -o \
-  | dftk line ... -x day -y mean --yerr sem -f fig.png
+  | dftk stat -c tip -g day -o \
+  | dftk line -x day -y mean --yerr sem -f fig.png
 ```
 
 ### Wide-to-long then plot overlaid histograms
@@ -250,18 +253,18 @@ suffix `_r` from `merge`; fill from it, then drop it. Here the defaults are
 each species' median body mass:
 
 ```bash
-dftk dataset penguins -o | dftk pivot ... -i species -v body_mass_g \
+dftk dataset penguins -o | dftk pivot -i species -v body_mass_g \
   -f median --move median_body_mass_g:body_mass_g -o defaults.parquet
 dftk dataset penguins -o \
-  | dftk merge ... -r defaults.parquet -k species -t left -o \
-  | dftk eval ... -f "body_mass_g = body_mass_g.fillna(body_mass_g_r)" \
+  | dftk merge -r defaults.parquet -k species -t left -o \
+  | dftk eval -f "body_mass_g = body_mass_g.fillna(body_mass_g_r)" \
       --drop body_mass_g_r
 ```
 
 **From neighbouring rows** (`co2` is a weekly series with gaps):
 
 ```bash
-dftk dataset co2 -o | dftk eval ... -f "ffill = co2.ffill()" \
+dftk dataset co2 -o | dftk eval -f "ffill = co2.ffill()" \
   -f "bfill = co2.bfill()" -f "linear = co2.interpolate()"
 ```
 
@@ -279,9 +282,9 @@ to be next to each other, but within each group they must be in order:
 
 ```bash
 dftk dataset healthexp -o \
-  | dftk eval ... -f "le = Life_Expectancy.where(Year % 10 != 5)" \
+  | dftk eval -f "le = Life_Expectancy.where(Year % 10 != 5)" \
       --sortasc Country Year -o \
-  | dftk eval ... -f "le_filled = le.groupby(Country).ffill()"
+  | dftk eval -f "le_filled = le.groupby(Country).ffill()"
 ```
 
 `interpolate()` has no grouped form. Once each group's rows are together,
@@ -291,9 +294,9 @@ with something before and after them in the same group:
 
 ```bash
 dftk dataset healthexp -o \
-  | dftk eval ... -f "le = Life_Expectancy.where(Year % 10 != 5)" \
+  | dftk eval -f "le = Life_Expectancy.where(Year % 10 != 5)" \
       --sortasc Country Year -o \
-  | dftk eval ... -f "before = le.groupby(Country).ffill().notna()" \
+  | dftk eval -f "before = le.groupby(Country).ffill().notna()" \
       -f "after = le.groupby(Country).bfill().notna()" \
       -f "le_linear = le.interpolate().where(before & after)" \
       --drop before after
@@ -306,8 +309,8 @@ pandas `diff()` and `pct_change()`, also within groups. They use the rows
 in their order, so sort first, in a step of its own:
 
 ```bash
-dftk dataset healthexp -o | dftk eval ... --sortasc Country Year -o \
-  | dftk eval ... -f "change = Spending_USD.groupby(Country).diff().round(1)" \
+dftk dataset healthexp -o | dftk eval --sortasc Country Year -o \
+  | dftk eval -f "change = Spending_USD.groupby(Country).diff().round(1)" \
       -f "pct = (Spending_USD.groupby(Country).pct_change() * 100).round(1)" \
       -f "years = Year.groupby(Country).diff()"
 ```
@@ -372,9 +375,9 @@ confidence interval:
 
 ```bash
 dftk dataset tips -o \
-  | dftk stat ... -c tip -g day --bootstrap 1000 --randomseed 42 -o \
-  | dftk pivot ... -i day -v mean -f mean cilo cihi -o \
-  | dftk print ...
+  | dftk stat -c tip -g day --bootstrap 1000 --randomseed 42 -o \
+  | dftk pivot -i day -v mean -f mean cilo cihi -o \
+  | dftk print
 ```
 
 ## Input/output
@@ -382,15 +385,21 @@ dftk dataset tips -o \
 All commands accept:
 
 - A TSV filename as a positional argument
-- `-` to read TSV from stdin
-- `...` to receive a parquet path from stdin (written by a previous `-o` command)
 - A `.parquet` filename to read a named parquet file directly
+- Nothing, or `-`, to read stdin: either TSV, or the parquet path printed by
+  a previous command's bare `-o` (that temp file is then read and deleted)
+- A pipe as the filename, e.g. `<(grep -v '^#' data.tsv)` or `<(dftk … -o)`,
+  read the same way as stdin
 
-> **`-` vs `...`** — these are not interchangeable. Use `-` when the previous
-> command in the pipe wrote plain TSV to stdout (the default). Use `...` when
-> the previous command used bare `-o` (pipe mode), which writes a temp
-> parquet and prints *its path* to stdout — `-` would try to parse that path
-> as TSV and fail.
+```bash
+dftk dataset tips -o | dftk stat -c tip -g day        # parquet path on stdin
+dftk dataset tips | dftk stat -c tip -g day           # TSV on stdin
+dftk merge -l tips.tsv -r <(dftk pivot tips.tsv -i day -v tip -f mean -o) -k day
+```
+
+Older scripts give `...` as the file to read a parquet path from stdin; that
+still works. In zsh with Oh My Zsh an unquoted `...` becomes `../..`, so
+leave it out (or use `-`) in scripts you share.
 
 ### Comment lines and preambles
 
@@ -407,6 +416,20 @@ dftk print <(grep -v '^#' data.tsv)          # the same, as a filename
 With `--backend duckdb`, a whole-line `#` comment below the header is an
 error, and `#` lines above the header are skipped.
 
+### Files without a header
+
+`--noheader` reads the first line as data and names the columns `V1`,
+`V2`, …. It only describes the input: the output gets a header (`V1 V2 …`)
+unless you add `--removeheader`. Name the columns with `--move`:
+
+```bash
+dftk print data.txt --noheader --move V1:chr V2:begin V3:end -o named.tsv
+dftk eval data.txt --noheader -f "len = V3 - V2" --removeheader   # no header out
+```
+
+Parquet always has column names, so `--removeheader` with `-o` and
+`--noheader` on parquet input do nothing (dftk warns).
+
 Standard output options (available on all tabular commands):
 
 - `-o` / `--output` — controls where output goes; takes an *optional* value:
@@ -418,6 +441,8 @@ Standard output options (available on all tabular commands):
 - `--drop col1 col2 …` — remove these columns
 - `--round N` — round numeric output
 - `--postquery EXPR` — filter output rows after processing
+- `--move OLD:NEW …` — rename columns
+- `--removeheader` — leave out the header row in TSV output
 - `--meta KEY=VALUE` — embed provenance metadata in parquet output (repeatable)
 
 ### Provenance annotations

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/README.md

@@ -47,17 +47,20 @@ uv tool install .
 
 ### Skill for coding agents
 
-`skills/dftk/` is an agent skill: a short guide that coding agents such as
-Codex and Claude Code load when a task involves dftk. It covers the piping
+dftk ships an agent skill: a short guide that coding agents such as Codex
+and Claude Code load when a task involves dftk. It covers the piping
 conventions, which command to use for what, and patterns for Snakemake and
-Make. Copy it into your agent's skills directory, for example:
+Make. Install it with:
 
 ```bash
-cp -r skills/dftk ~/.codex/skills/     # Codex
-cp -r skills/dftk ~/.claude/skills/    # Claude Code
+dftk skill install            # every agent found: ~/.claude and/or ~/.codex
+dftk skill install --codex    # only one (--claude or --codex; creates the folder)
+dftk skill install --dir DIR  # another agent's skills folder
 ```
 
-Copy it again after upgrading dftk so it matches the installed version.
+It prints where it installed the skill. Run it again after upgrading dftk
+so the skill matches the installed version; it replaces only the earlier
+dftk skill. The source is in `src/dftk/skills/dftk/`.
 
 ## Quick example
 
@@ -65,15 +68,15 @@ Copy it again after upgrading dftk so it matches the installed version.
 dftk dataset tips | dftk stat - -c tip total_bill -g day
 ```
 
-Chain commands with `-o` (write to a temp parquet, print its path) and `...`
-(read a parquet path from stdin) instead of piping TSV text directly — faster
-for large data, and the recommended pattern once a pipeline has more than one
-step:
+Chain commands with a bare `-o` (write a temp parquet, print its path)
+instead of piping TSV text: the next command sees the path on stdin and reads
+that file. It's faster for large data, keeps column types exact, and is the
+recommended pattern once a pipeline has more than one step:
 
 ```bash
 dftk dataset tips -o \
-  | dftk pivot ... -i day -v tip -f mean -o \
-  | dftk print ...
+  | dftk pivot -i day -v tip -f mean -o \
+  | dftk print
 ```
 
 ## Subcommands
@@ -133,7 +136,7 @@ publication-quality output.
 | `sample`   | Random row sampling (with or without replacement, by count or fraction)   |
 | `split`    | Split a dataframe into one file per group                                 |
 | `annotate` | Read and write provenance metadata (genome, source, …) in parquet files  |
-| `print`    | Read any dftk input (TSV, stdin, `...` parquet pipe) and write TSV     |
+| `print`    | Read any dftk input (TSV, parquet, stdin) and write TSV                |
 | `clean`    | Remove leftover temp parquet pipe files from interrupted pipelines       |
 | `help`     | List all subcommands or show full help for one: `dftk help stat`       |
 
@@ -144,8 +147,8 @@ publication-quality output.
 ```bash
 # z-score sepal_length within species, then fit against petal_length
 dftk dataset iris -o \
-  | dftk scale ... -c sepal_length -g species -o \
-  | dftk fit ... -f "sepal_length_scaled ~ petal_length" -g species
+  | dftk scale -c sepal_length -g species -o \
+  | dftk fit -f "sepal_length_scaled ~ petal_length" -g species
 ```
 
 ### Clean up spreadsheet headers
@@ -154,8 +157,8 @@ Headers such as `Country Name` or `1960` need quoting in SQL. `cleannames` turns
 
 ```bash
 dftk dataset fertility -o \
-  | dftk cleannames ... -o \
-  | dftk query ... --sql "SELECT country_name, x1960, x2000 FROM data LIMIT 3"
+  | dftk cleannames -o \
+  | dftk query --sql "SELECT country_name, x1960, x2000 FROM data LIMIT 3"
 ```
 
 For your own export, `dftk cleannames data.tsv --backend duckdb -o data.parquet` also keeps integer columns with empty cells as integers.
@@ -166,7 +169,7 @@ With tens of thousands of points a scatter plot is a solid blob. `--hexbin` coun
 
 ```bash
 dftk dataset diamonds -o \
-  | dftk scat ... -x carat -y price --hexbin --hexlog --logx --logy -f diamonds.png
+  | dftk scat -x carat -y price --hexbin --hexlog --logx --logy -f diamonds.png
 ```
 
 `--colorcol COL` colours each hexagon by the mean of `COL` instead of the count; with `--subgraphcol` all panels share one colour scale.
@@ -175,8 +178,8 @@ dftk dataset diamonds -o \
 
 ```bash
 dftk dataset tips -o \
-  | dftk stat ... -c tip -g day -o \
-  | dftk line ... -x day -y mean --yerr sem -f fig.png
+  | dftk stat -c tip -g day -o \
+  | dftk line -x day -y mean --yerr sem -f fig.png
 ```
 
 ### Wide-to-long then plot overlaid histograms
@@ -220,18 +223,18 @@ suffix `_r` from `merge`; fill from it, then drop it. Here the defaults are
 each species' median body mass:
 
 ```bash
-dftk dataset penguins -o | dftk pivot ... -i species -v body_mass_g \
+dftk dataset penguins -o | dftk pivot -i species -v body_mass_g \
   -f median --move median_body_mass_g:body_mass_g -o defaults.parquet
 dftk dataset penguins -o \
-  | dftk merge ... -r defaults.parquet -k species -t left -o \
-  | dftk eval ... -f "body_mass_g = body_mass_g.fillna(body_mass_g_r)" \
+  | dftk merge -r defaults.parquet -k species -t left -o \
+  | dftk eval -f "body_mass_g = body_mass_g.fillna(body_mass_g_r)" \
       --drop body_mass_g_r
 ```
 
 **From neighbouring rows** (`co2` is a weekly series with gaps):
 
 ```bash
-dftk dataset co2 -o | dftk eval ... -f "ffill = co2.ffill()" \
+dftk dataset co2 -o | dftk eval -f "ffill = co2.ffill()" \
   -f "bfill = co2.bfill()" -f "linear = co2.interpolate()"
 ```
 
@@ -249,9 +252,9 @@ to be next to each other, but within each group they must be in order:
 
 ```bash
 dftk dataset healthexp -o \
-  | dftk eval ... -f "le = Life_Expectancy.where(Year % 10 != 5)" \
+  | dftk eval -f "le = Life_Expectancy.where(Year % 10 != 5)" \
       --sortasc Country Year -o \
-  | dftk eval ... -f "le_filled = le.groupby(Country).ffill()"
+  | dftk eval -f "le_filled = le.groupby(Country).ffill()"
 ```
 
 `interpolate()` has no grouped form. Once each group's rows are together,
@@ -261,9 +264,9 @@ with something before and after them in the same group:
 
 ```bash
 dftk dataset healthexp -o \
-  | dftk eval ... -f "le = Life_Expectancy.where(Year % 10 != 5)" \
+  | dftk eval -f "le = Life_Expectancy.where(Year % 10 != 5)" \
       --sortasc Country Year -o \
-  | dftk eval ... -f "before = le.groupby(Country).ffill().notna()" \
+  | dftk eval -f "before = le.groupby(Country).ffill().notna()" \
       -f "after = le.groupby(Country).bfill().notna()" \
       -f "le_linear = le.interpolate().where(before & after)" \
       --drop before after
@@ -276,8 +279,8 @@ pandas `diff()` and `pct_change()`, also within groups. They use the rows
 in their order, so sort first, in a step of its own:
 
 ```bash
-dftk dataset healthexp -o | dftk eval ... --sortasc Country Year -o \
-  | dftk eval ... -f "change = Spending_USD.groupby(Country).diff().round(1)" \
+dftk dataset healthexp -o | dftk eval --sortasc Country Year -o \
+  | dftk eval -f "change = Spending_USD.groupby(Country).diff().round(1)" \
       -f "pct = (Spending_USD.groupby(Country).pct_change() * 100).round(1)" \
       -f "years = Year.groupby(Country).diff()"
 ```
@@ -342,9 +345,9 @@ confidence interval:
 
 ```bash
 dftk dataset tips -o \
-  | dftk stat ... -c tip -g day --bootstrap 1000 --randomseed 42 -o \
-  | dftk pivot ... -i day -v mean -f mean cilo cihi -o \
-  | dftk print ...
+  | dftk stat -c tip -g day --bootstrap 1000 --randomseed 42 -o \
+  | dftk pivot -i day -v mean -f mean cilo cihi -o \
+  | dftk print
 ```
 
 ## Input/output
@@ -352,15 +355,21 @@ dftk dataset tips -o \
 All commands accept:
 
 - A TSV filename as a positional argument
-- `-` to read TSV from stdin
-- `...` to receive a parquet path from stdin (written by a previous `-o` command)
 - A `.parquet` filename to read a named parquet file directly
+- Nothing, or `-`, to read stdin: either TSV, or the parquet path printed by
+  a previous command's bare `-o` (that temp file is then read and deleted)
+- A pipe as the filename, e.g. `<(grep -v '^#' data.tsv)` or `<(dftk … -o)`,
+  read the same way as stdin
 
-> **`-` vs `...`** — these are not interchangeable. Use `-` when the previous
-> command in the pipe wrote plain TSV to stdout (the default). Use `...` when
-> the previous command used bare `-o` (pipe mode), which writes a temp
-> parquet and prints *its path* to stdout — `-` would try to parse that path
-> as TSV and fail.
+```bash
+dftk dataset tips -o | dftk stat -c tip -g day        # parquet path on stdin
+dftk dataset tips | dftk stat -c tip -g day           # TSV on stdin
+dftk merge -l tips.tsv -r <(dftk pivot tips.tsv -i day -v tip -f mean -o) -k day
+```
+
+Older scripts give `...` as the file to read a parquet path from stdin; that
+still works. In zsh with Oh My Zsh an unquoted `...` becomes `../..`, so
+leave it out (or use `-`) in scripts you share.
 
 ### Comment lines and preambles
 
@@ -377,6 +386,20 @@ dftk print <(grep -v '^#' data.tsv)          # the same, as a filename
 With `--backend duckdb`, a whole-line `#` comment below the header is an
 error, and `#` lines above the header are skipped.
 
+### Files without a header
+
+`--noheader` reads the first line as data and names the columns `V1`,
+`V2`, …. It only describes the input: the output gets a header (`V1 V2 …`)
+unless you add `--removeheader`. Name the columns with `--move`:
+
+```bash
+dftk print data.txt --noheader --move V1:chr V2:begin V3:end -o named.tsv
+dftk eval data.txt --noheader -f "len = V3 - V2" --removeheader   # no header out
+```
+
+Parquet always has column names, so `--removeheader` with `-o` and
+`--noheader` on parquet input do nothing (dftk warns).
+
 Standard output options (available on all tabular commands):
 
 - `-o` / `--output` — controls where output goes; takes an *optional* value:
@@ -388,6 +411,8 @@ Standard output options (available on all tabular commands):
 - `--drop col1 col2 …` — remove these columns
 - `--round N` — round numeric output
 - `--postquery EXPR` — filter output rows after processing
+- `--move OLD:NEW …` — rename columns
+- `--removeheader` — leave out the header row in TSV output
 - `--meta KEY=VALUE` — embed provenance metadata in parquet output (repeatable)
 
 ### Provenance annotations

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dataframe-toolkit"
-version = "0.11.3"
+version = "0.13.0"
 description = "A command-line toolkit for DataFrame analysis and manipulation"
 readme = "README.md"
 keywords = [

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dataframe-toolkit"
-version = "0.11.3"
+version = "0.13.0"
 description = "A command-line toolkit for DataFrame analysis and manipulation"
 readme = "README.md"
 authors = [

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/__init__.py

@@ -73,6 +73,7 @@ COMMAND_GROUPS: list[tuple[str, list[tuple[str, str]]]] = [
             ("annotate", "annotate_cmd:AnnotateCommand"),
             ("print", "print_cmd:PrintCommand"),
             ("clean", "clean_cmd:CleanCommand"),
+            ("skill", "skill_cmd:SkillCommand"),
         ],
     ),
 ]

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/annotate_cmd.py

@@ -26,7 +26,7 @@ Usage examples:
       --meta genome=hg38 --meta source=my_pipeline
 
   # Same, built from a bundled dataset:
-  dftk dataset iris -o | dftk eval ... -f "z = sepal_length + petal_length" \\
+  dftk dataset iris -o | dftk eval -f "z = sepal_length + petal_length" \\
       -o result.parquet --meta genome=hg38 --meta source=my_pipeline
 
 Annotations propagate through the parquet pipe: a file annotated at

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/binx_cmd.py

@@ -74,10 +74,10 @@ USEVALUE (--usevalue)
 EXAMPLES
 --------
   dftk binx data.tsv -c age -b 0:100:10
-  dftk dataset tips -o | dftk binx ... -c total_bill -b 0:60:10
-  dftk dataset tips -o | dftk binx ... -c tip -b 0,2,4,6,10 -d tip_bracket --usevalue m
-  dftk dataset tips -o | dftk binx ... -c total_bill -b 0:60:10 -d bill_bin -o \\
-      | dftk stat ... -c tip -g bill_bin
+  dftk dataset tips -o | dftk binx -c total_bill -b 0:60:10
+  dftk dataset tips -o | dftk binx -c tip -b 0,2,4,6,10 -d tip_bracket --usevalue m
+  dftk dataset tips -o | dftk binx -c total_bill -b 0:60:10 -d bill_bin -o \\
+      | dftk stat -c tip -g bill_bin
 """
 
 

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/chi_cmd.py

@@ -116,21 +116,21 @@ EXAMPLES
 Basic chi-plot:
 
   dftk chi data.tsv -x recomb_rate -y gc_content
-  dftk dataset tips -o | dftk chi ... -x total_bill -y tip
+  dftk dataset tips -o | dftk chi -x total_bill -y tip
 
 Split into a subplot grid by category, to check whether tail dependence is
 consistent across the whole dataset or driven by a few subgroups (e.g.
 chromosome, sector, region — here, diamond cut quality):
 
-  dftk dataset diamonds -o | dftk chi ... -x carat -y price --subgraphcol cut
+  dftk dataset diamonds -o | dftk chi -x carat -y price --subgraphcol cut
 
 Colour-code by group instead of splitting into subplots:
 
-  dftk dataset diamonds -o | dftk chi ... -x carat -y price -g cut
+  dftk dataset diamonds -o | dftk chi -x carat -y price -g cut
 
 Publication figure (Nature single column, PDF):
 
-  dftk dataset tips -o | dftk chi ... -x total_bill -y tip \\
+  dftk dataset tips -o | dftk chi -x total_bill -y tip \\
       --size single --fontsize publication -f fig.pdf
 """
 

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/cleannames_cmd.py

@@ -57,13 +57,13 @@ column per year (1960, 1961, ...); after cleaning they can be used
 unquoted in SQL:
 
   dftk dataset fertility -o \\
-      | dftk cleannames ... -o \\
-      | dftk query ... --sql "SELECT country_name, x1960, x2000 FROM data LIMIT 3"
+      | dftk cleannames -o \\
+      | dftk query --sql "SELECT country_name, x1960, x2000 FROM data LIMIT 3"
 
 Write the old and new names to a TSV file, e.g. for a data dictionary:
 
   dftk dataset fertility -o \\
-      | dftk cleannames ... --mapping names.tsv -o fertility.parquet
+      | dftk cleannames --mapping names.tsv -o fertility.parquet
 """
 
 # Letters that Unicode does not decompose into ASCII letter + accent

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/concat_cmd.py

@@ -12,7 +12,7 @@ Examples
     dftk concat penguins.tsv penguins.tsv --sourcecol source
     dftk dataset penguins -o penguins.parquet
     dftk concat penguins.parquet penguins.parquet -o
-    dftk dataset penguins -o | dftk eval ... -f "x=1" -o | dftk concat ... penguins.tsv
+    dftk dataset penguins -o | dftk eval -f "x=1" -o | dftk concat - penguins.tsv
 """
 
 import argparse
@@ -51,7 +51,7 @@ EXAMPLES
   dftk concat penguins.tsv penguins.tsv --sourcecol source
   dftk dataset penguins -o penguins.parquet
   dftk concat penguins.parquet penguins.parquet -o result.parquet
-  dftk dataset penguins -o | dftk eval ... -f "x=1" -o | dftk concat ... penguins.tsv
+  dftk dataset penguins -o | dftk eval -f "x=1" -o | dftk concat - penguins.tsv
 
 Mismatched columns are outer-joined and filled (NaN by default, or --fill):
 
@@ -65,7 +65,7 @@ Mismatched columns are outer-joined and filled (NaN by default, or --fill):
             metavar="FILE",
             help=(
                 "Input files to concatenate (TSV or .parquet).  "
-                "Use - for TSV stdin or ... for a parquet pipe path on stdin.  "
+                "Use - for stdin (TSV, or a parquet path from -o).  "
                 "At most one stdin source is allowed."
             ),
         )

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/corr_cmd.py

@@ -195,7 +195,7 @@ COLUMN PAIRS (-c)
   Pairs are specified as col1:col2.  Multiple pairs may be given:
 
     dftk corr data.tsv -c x:y
-    dftk dataset tips -o | dftk corr ... -c total_bill:tip tip:size
+    dftk dataset tips -o | dftk corr -c total_bill:tip tip:size
 
 METHODS (--method)
 ------------------
@@ -261,13 +261,13 @@ TAIL DEPENDENCE (--tail / --tail-q)
 EXAMPLES
 --------
   dftk corr data.tsv -c x:y
-  dftk dataset tips -o | dftk corr ... -c total_bill:tip
-  dftk dataset tips -o | dftk corr ... -c total_bill:tip -g day --method spearman
-  dftk dataset tips -o | dftk corr ... -c total_bill:tip --ci
+  dftk dataset tips -o | dftk corr -c total_bill:tip
+  dftk dataset tips -o | dftk corr -c total_bill:tip -g day --method spearman
+  dftk dataset tips -o | dftk corr -c total_bill:tip --ci
   dftk dataset tips -o \\
-      | dftk corr ... -c total_bill:tip --method spearman \\
+      | dftk corr -c total_bill:tip --method spearman \\
             --bootstrap 2000 --randomseed 42
-  dftk dataset diamonds -o | dftk corr ... -c carat:price --tail --tail-q 0.02 0.05 0.1
+  dftk dataset diamonds -o | dftk corr -c carat:price --tail --tail-q 0.02 0.05 0.1
 """
 
 

{dataframe_toolkit-0.11.3 → dataframe_toolkit-0.13.0}/src/dftk/commands/describe_cmd.py

@@ -37,7 +37,7 @@ Optional flags
 Example
 -------
     dftk describe data.tsv
-    dftk dataset iris -o | dftk describe ... --summary --correlations
+    dftk dataset iris -o | dftk describe --summary --correlations
 """
 
 import argparse
@@ -314,9 +314,9 @@ NOTES FLAGS
 EXAMPLES
 --------
   dftk describe data.tsv
-  dftk dataset iris -o | dftk describe ...
-  dftk dataset iris -o | dftk describe ... --summary --correlations
-  dftk dataset iris -o | dftk describe ... --summary --correlations --corr-threshold 0.5
+  dftk dataset iris -o | dftk describe
+  dftk dataset iris -o | dftk describe --summary --correlations
+  dftk dataset iris -o | dftk describe --summary --correlations --corr-threshold 0.5
 """
         io.parser_read(parser)