Metadata-Version: 2.4
Name: lumeview
Version: 0.1.0
Summary: Lume - A beautiful JSON viewer CLI
Project-URL: Homepage, https://github.com/dorochadev/lume
Project-URL: Repository, https://github.com/dorochadev/lume
Project-URL: Issues, https://github.com/dorochadev/lume/issues
Author-email: Your Name <your.email@example.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click>=8.1.7
Requires-Dist: httpx>=0.28.1
Requires-Dist: rich>=14.2.0
Requires-Dist: textual>=0.85.0
Description-Content-Type: text/markdown

# Lume 🕯️

Lume is a sleek, modern JSON viewer CLI built for developers who need a better way to explore API responses and local data. It transforms raw JSON into interactive, navigable TUI experiences with a premium aesthetic.

<img src="test-data/lume_tree_demo.gif" width="100%" />

## Features

- **Interactive Tree View**: Browse complex nested structures with a navigable tree.
- **Elegant Box View**: A card-based layout for quick scanning of large datasets.
- **CURL-like Fetching**: Support for custom methods (`-X`), headers (`-H`), and data (`-d`).
- **Fast & Async**: Built on high-performance libraries to handle large responses without freezing.

## Installation

### Local Global Install (Recommended)
If you want to use `lume` or `lumeview` globally in your terminal while developing, run this inside the project directory:

```bash
uv tool install .
```

This will install the package and make both the `lume` and `lumeview` commands available.

### From PyPI (Coming Soon)
Once published, you'll be able to install it using the package name `lumeview`:

```bash
pip install lumeview
# or
uv tool install lumeview
```

## Development

If you just want to run it without installing:

```bash
uv sync
uv run lume --help
```

## Usage

### Fetch from an API
```bash
lume fetch 'https://api.example.com/data' -X POST -d '{"query": "test"}'
```

### Open a local file
```bash
lume open test.json --display box
```

## Built With

- **[Textual](https://github.com/Textualize/textual)** - TUI Framework.
- **[Rich](https://github.com/Textualize/rich)** - Terminal formatting and rendering.
- **[Click](https://click.palletsprojects.com/)** - CLI argument parsing.
- **[HTTPX](https://www.python-httpx.org/)** - Modern, async HTTP client.
- **[UV](https://github.com/astral-sh/uv)** - Extremely fast Python package manager.
