Metadata-Version: 2.5
Name: csvglance
Version: 0.1.0
Summary: Instant terminal snapshot of a CSV: shape and head/tail rows — no pandas required
Project-URL: Homepage, https://github.com/aayan25arts/csvglance
Project-URL: Issues, https://github.com/aayan25arts/csvglance/issues
Author-email: Aayan Qayyum <aayan.frantic@gmail.com>
License: MIT
License-File: LICENSE
Keywords: cli,csv,data,preview,terminal
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# csvglance

Instant terminal snapshot of a CSV file — shape and head/tail rows. No pandas, no Excel, just a fast look at your data.

```
$ csvglance orders.csv
orders.csv  12,483 rows x 6 cols

                                          Preview
┌──────────┬──────────┬────────┬────────────┬─────────┬───────────┐
│ order_id │ customer │ total  │ placed_at  │ status  │ notes     │
├──────────┼──────────┼────────┼────────────┼─────────┼───────────┤
│ 1001     │ Alice    │ 19.99  │ 2024-01-03 │ shipped │           │
│ 1002     │ Bob      │ 42.50  │ 2024-01-04 │ pending │ fragile   │
│ 1003     │ Carol    │ 15.00  │ 2024-01-04 │ shipped │           │
│ ⋮        │ ⋮        │ ⋮      │ ⋮          │ ⋮       │ ⋮         │
│ 12481    │ Xavier   │ 8.25   │ 2024-06-30 │ shipped │           │
│ 12482    │ Yara     │ 61.00  │ 2024-06-30 │ pending │ gift wrap │
│ 12483    │ Zane     │ 33.10  │ 2024-06-30 │ shipped │           │
└──────────┴──────────┴────────┴────────────┴─────────┴───────────┘
```

## Why

Opening a CSV to check its shape or peek at a few rows usually means firing up Excel or writing a throwaway `pandas.read_csv()` script. csvglance skips both — it reads the file with the stdlib `csv` module (no pandas dependency), so it starts instantly and installs light.

## Install

```bash
pip install csvglance
```

## Usage

```bash
csvglance data.csv
```

Options:

```
--head INTEGER   Number of head rows to show. [default: 5]
--tail INTEGER   Number of tail rows to show. [default: 5]
```

## What it shows

- **Shape** — row and column counts
- **Head / tail** — first and last few rows of actual data, like `head`/`tail` for CSVs

Delimiter (comma, tab, semicolon, pipe) is auto-detected.

## Development

```bash
git clone https://github.com/aayan25arts/csvglance.git
cd csvglance
pip install -e ".[dev]"
pytest
```

## License

MIT
