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.0.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.0-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: lumeview-0.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 83fa8a1c1a187cd7740dada34d88d26cb642348a39fcfe47be3ed012ad51d24d
MD5 662c0e3575993540660e5cbd969c34e7
BLAKE2b-256 e741eb7ad8ec8d1b9a64325a81dd8bafb1253466392e611feda7350c7dd18fc3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: lumeview-0.1.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6f03a434d075fc7d3ab558d99bf8ccb660e6704a5a208f8fc808231664741499
MD5 c4d8a971099144b80dd025bd3f727866
BLAKE2b-256 2fb1aa42dc243888b22fe8e0e52f54a1c9a5e69bead33197efd640bbf8b68634

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