dt-cli-tools

CLI tools for viewing, filtering, and comparing tabular data files
Log | Files | Refs | README | LICENSE

commit 0287d300c262d5078fdb930576a23e680c1c07dd
parent dd4ccccd4c4fde9d0a3765c71a457f61214edf74
Author: Erik Loualiche <eloualic@umn.edu>
Date:   Fri,  3 Apr 2026 19:34:06 -0500

docs: hero GIF at top, individual GIFs in each tool section

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Diffstat:
MREADME.md | 19+++++++------------
Ademo/hero.gif | 0
Ademo/hero.tape | 40++++++++++++++++++++++++++++++++++++++++
Ademo/sales.xlsx | 0
4 files changed, 47 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md @@ -6,18 +6,7 @@ [![Vibecoded](https://img.shields.io/badge/vibecoded-%E2%9C%A8-blueviolet)](https://claude.ai) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) -<table> -<tr> -<td align="center" width="33%"><strong>dtcat</strong> — view</td> -<td align="center" width="33%"><strong>dtfilter</strong> — query</td> -<td align="center" width="33%"><strong>dtdiff</strong> — compare</td> -</tr> -<tr> -<td><img src="demo/dtcat.gif" alt="dtcat demo" /></td> -<td><img src="demo/dtfilter.gif" alt="dtfilter demo" /></td> -<td><img src="demo/dtdiff.gif" alt="dtdiff demo" /></td> -</tr> -</table> +<img src="demo/hero.gif" alt="dt-cli-tools demo" width="80%" /> </div> @@ -81,6 +70,8 @@ Requires Rust 1.85+. ## dtcat — View Data Files +<img src="demo/dtcat.gif" alt="dtcat demo" width="80%" /> + ```bash # Overview: schema + data (<=50 rows all, >50 head/tail 25) dtcat data.parquet @@ -145,6 +136,8 @@ Modes `--schema`, `--describe`, `--info`, and data (default) are mutually exclus ## dtfilter — Query and Filter +<img src="demo/dtfilter.gif" alt="dtfilter demo" width="80%" /> + ```bash # Filter rows by value dtfilter data.csv --filter State=CA @@ -191,6 +184,8 @@ dtfilter data.parquet --filter value>0 --csv ## dtdiff — Compare Two Files +<img src="demo/dtdiff.gif" alt="dtdiff demo" width="80%" /> + ```bash # Positional diff (whole-row comparison) dtdiff old.csv new.csv diff --git a/demo/hero.gif b/demo/hero.gif Binary files differ. diff --git a/demo/hero.tape b/demo/hero.tape @@ -0,0 +1,40 @@ +# VHS tape for recording hero demo GIF — one quick example of each tool. +# Usage: vhs demo/hero.tape +# +# Prerequisites: +# - dtcat, dtfilter, dtdiff binaries built and in PATH +# - Demo files in demo/ + +Output demo/hero.gif + +Set FontSize 14 +Set Width 1100 +Set Height 550 +Set Padding 15 +Set Theme "GruvboxDarkHard" + +Set TypingSpeed 80ms + +Set Shell "bash" + +Hide + Type 'export PS1="> "' + Enter + Type "clear" + Enter +Show + +# ─── VIEW ─── +Type "dtcat demo/sales.xlsx --head 5" +Enter +Sleep 3s + +# ─── FILTER ─── +Type "dtfilter demo/sales.xlsx --filter Region=East --sort Revenue:desc --limit 3" +Enter +Sleep 3s + +# ─── DIFF ─── +Type "dtdiff demo/old.xlsx demo/new.xlsx --key ID" +Enter +Sleep 4s diff --git a/demo/sales.xlsx b/demo/sales.xlsx Binary files differ.