Metadata-Version: 2.4
Name: csv-mini
Version: 0.1.0
Summary: Display and filter CSV, pipe-delimited, or gzipped files in the terminal
Author: mabayan
License-Expression: MIT
Project-URL: Homepage, https://github.com/mabayan/csv-mini
Project-URL: Repository, https://github.com/mabayan/csv-mini
Project-URL: Issues, https://github.com/mabayan/csv-mini/issues
Keywords: csv,terminal,cli,viewer,pager
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# csv-mini

A fast, minimal CSV viewer for the terminal. Displays CSV, pipe-delimited, and gzipped files with a sticky-header curses pager.

## Install

```bash
pip install csv-mini
```

Or copy directly to `~/bin`:

```bash
./install.sh
```

## Usage

```
csv <file> [search] [-head N] [-tail N] [-cols COL1,COL2,...]
```

**Examples:**

```bash
csv data.csv                    # view entire file
csv data.csv "smith"            # filter rows containing "smith"
csv data.csv -head 20           # first 20 rows
csv data.csv -tail 10           # last 10 rows
csv data.csv -cols name,email   # select columns
csv data.csv.gz                 # gzipped files work too
```

**Pager controls** (activates automatically for large output):

| Key | Action |
|---|---|
| `j`/`k` or arrows | scroll up/down |
| `f`/`b` or PgDn/PgUp | page down/up |
| `h`/`l` or arrows | scroll left/right |
| `g`/`G` | jump to top/bottom |
| `q` or Esc | quit |

## License

MIT
