Metadata-Version: 2.4
Name: config-lens
Version: 0.1.1
Summary: A stunning terminal inspector for JSON, CSV, and environment files.
Project-URL: Homepage, https://github.com/yourusername/config-lens
Project-URL: Repository, https://github.com/yourusername/config-lens.git
Project-URL: Issues, https://github.com/yourusername/config-lens/issues
Author-email: Your Name <your.email@example.com>
Maintainer-email: Your Name <your.email@example.com>
License: MIT
Keywords: cli,csv,developer-tools,env,inspector,json,rich,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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 :: Python Modules
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: rich>=13.0.0
Description-Content-Type: text/markdown

# config-lens

[![PyPI version](https://img.shields.io/pypi/v/config-lens.svg)](https://pypi.org/project/config-lens/)
[![Python Versions](https://img.shields.io/pypi/pyversions/config-lens.svg)](https://pypi.org/project/config-lens/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://static.pepy.tech/badge/config-lens)](https://pepy.tech/project/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.
