lens-debug 1.1.0

Lens - send debug payloads to the Lens desktop app and Lens Cloud

Lens for Python

Send debug payloads to the Lens desktop app and Lens Cloud from any Python project (Django, Flask, FastAPI or plain scripts). No dependencies, just the standard library.

Install

pip install lens-debug

Use

from lens_debug import lens

lens("hello", user)                 # send any values
lens([1, 2, 3]).label("my array")   # add a label
lens("careful").red()               # colour the entry
lens.clear()                        # clear the Lens window

Colours: red, green, blue, orange, purple, gray.

Lens Cloud (optional)

To send events straight to Lens Cloud, no desktop app required, set both in your environment:

LENS_PROJECT_KEY=your-project-key-from-lens-cloud
LENS_CLOUD_URL=https://app.lensapp.eu

The project key links events to the right project; the cloud URL is where they are sent. With both set, every event goes to Lens Cloud (and to the desktop app too, if it is running). You can also configure it in code:

lens.configure(cloud_url="https://app.lensapp.eu", key="your-project-key")

Each event also carries context (Python version, OS, hostname and detected framework) which shows up as tags in Lens Cloud.

Caught exceptions

try:
    risky()
except Exception as err:
    lens.exception(err)

The exception (with its stack trace) shows up in Lens and can be picked up by the built-in "Summarize errors" AI button.

Configuration

Lens listens on 127.0.0.1:23600 by default. Override it in code or via environment variables:

lens.configure(host="127.0.0.1", port=23600)

export LENS_HOST=127.0.0.1
export LENS_PORT=23600

Safety

Debugging never blocks or crashes your program: every payload is sent on a daemon thread and all transmission errors are swallowed silently. If the Lens app is not running, calls are simply no-ops.

MIT licensed.