Metadata-Version: 2.4
Name: config-lens
Version: 0.1.0
Summary: A stunning terminal inspector for JSON, CSV, and environment files.
Author-email: Your Name <your.email@example.com>
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: rich>=13.0.0
Description-Content-Type: text/markdown

# config-lens

**config-lens** (`clens`) is a lightweight, high-performance command-line utility designed to inspect `JSON`, `CSV`, and environment (`.env`) files instantly inside your terminal with gorgeous, color-coded tables.

---

## Features

* **Instant Visual Previews:** Automatically detects file types and renders them into clean, structured tables.
* **Rich Styling:** Built with `rich` for vibrant, readable terminal formatting.
* **Smart Truncation:** Gracefully previews large CSV datasets (showing the first 25 rows by default) to prevent terminal flooding.
* **Zero Bloat:** Minimal dependencies focused purely on fast, friction-free configuration and data inspection.

---

## Installation

Install the package directly from PyPI:

```bash
pip install config-lens
```

Or install it locally in editable mode for development:

```bash
git clone https://github.com/yourusername/config-lens.git
cd config-lens
pip install -e .
```

---

## Usage

Run the `clens` command followed by the path to the configuration or data file you want to inspect:

```bash
# Inspect an environment configuration file
clens .env

# Inspect a structured JSON configuration
clens config.json

# Preview a tabular CSV dataset
clens data.csv
```

---

## Project Structure

```text
config-lens/
├── pyproject.toml
├── README.md
└── src/
    └── config_lens/
        ├── __init__.py
        ├── cli.py
        └── parser.py
```

---

## License

Distributed under the **MIT License**. See `LICENSE` for more information.
