Skip to main content

Lume - A beautiful JSON viewer CLI

Project description

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.

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:

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:

pip install lumeview
# or
uv tool install lumeview

Development

If you just want to run it without installing:

uv sync
uv run lume --help

Usage

Fetch from an API

lume fetch 'https://api.example.com/data' -X POST -d '{"query": "test"}'

Open a local file

lume open test.json --display box

Built With

  • Textual - TUI Framework.
  • Rich - Terminal formatting and rendering.
  • Click - CLI argument parsing.
  • HTTPX - Modern, async HTTP client.
  • UV - Extremely fast Python package manager.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lumeview-0.1.1.tar.gz (4.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lumeview-0.1.1-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file lumeview-0.1.1.tar.gz.

File metadata

  • Download URL: lumeview-0.1.1.tar.gz
  • Upload date:
  • Size: 4.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for lumeview-0.1.1.tar.gz
Algorithm Hash digest
SHA256 50583b11d3f833e030a52a9bc37b9308029a2c27f050cc2d5dae184614b53c49
MD5 b837eccbd43a3caa3426493fcf59fe38
BLAKE2b-256 bcf38634f3d1ed660bf8a325b981e0ff7a5d2026a12230a47eb436eb09365aff

See more details on using hashes here.

File details

Details for the file lumeview-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: lumeview-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for lumeview-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 238390e0f7c182f7e5eb2720a1e8833a2ef9b91b941ba2336d97b4eb20c3dc34
MD5 695eb8130e09df9bba7ee8cc9dcb07b9
BLAKE2b-256 969cf8d1dfe08cd21475787fbf9347b608d876c984ae6e06190ec7e527c0746f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page