Metadata-Version: 2.4
Name: graphsignal-debug
Version: 0.1.1
Summary: Graphsignal CLI for debug context and API key management
License: Apache-2.0
Author: Graphsignal, Inc.
Author-email: devops@graphsignal.com
Requires-Python: >=3.9,<4
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: click
Requires-Dist: pyyaml
Requires-Dist: requests
Description-Content-Type: text/markdown

# Graphsignal Debug Client

CLI for Graphsignal: login (store API key) and fetch debug context from api.graphsignal.com.

## Install

```bash
pip install graphsignal-debug
```

## Usage

### Login

Store your Graphsignal API key in `~/.graphsignal/config.yml`:

```bash
graphsignal-debug login
```

You will be prompted for your API key.

### Fetch

Fetch debug context (SIGNALS.md + JSON) for a time range. Requires being logged in.

```bash
graphsignal-debug fetch --start 2026-03-10T00:00:00Z --end 2026-03-12T00:00:00Z
```

Optional `--tags` filter (semicolon-separated key:value pairs). Tags must match exactly the tags sent to Graphsignal when the app was instrumented:

```bash
graphsignal-debug fetch --start 2026-03-10T00:00:00Z --end 2026-03-12T00:00:00Z --tags "env:prod"
```

The command calls `GET /api/v1/debug_context/` on `https://api.graphsignal.com` with `start_time_ns`, `end_time_ns`, and optional `tags`, and prints the response `context` field.

