Metadata-Version: 2.4
Name: django-scope
Version: 0.1.0
Summary: An elegant debug assistant for Django, inspired by Laravel Telescope
Author: cosmic
License-Expression: MIT
License-File: LICENSE
Keywords: debug,django,monitoring,profiling,telescope
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 6
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Debuggers
Requires-Python: >=3.10
Requires-Dist: build>=1.4.2
Requires-Dist: channels>=4.0
Requires-Dist: daphne>=4.2.1
Requires-Dist: django>=4.2
Requires-Dist: setuptools>=82.0.1
Requires-Dist: twine>=6.2.0
Requires-Dist: wheel>=0.46.3
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-asyncio; extra == 'dev'
Requires-Dist: pytest-django; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# django-telescope

An elegant debug assistant for Django, inspired by Laravel Telescope.

## Installation

```bash
pip install django-telescope
```

Add to your Django settings:

```python
INSTALLED_APPS = [
    "daphne",
    "telescope",
    # ... your apps
]

TELESCOPE = {
    "ENABLED": True,
}
```

Add the middleware:

```python
MIDDLEWARE = [
    "telescope.middleware.TelescopeMiddleware",
    # ... other middleware
]
```

Add URL routing:

```python
from django.urls import include, path

urlpatterns = [
    path("telescope/", include("telescope.urls")),
]
```

## Features

- Real-time monitoring via WebSockets
- 17 watchers: requests, queries, exceptions, models, logs, cache, mail, Redis, views, events, commands, dumps, HTTP client, gates, notifications, schedules, batches
- N+1 query detection
- Beautiful Vue.js dashboard with dark/light themes
- Request-scoped buffering with bulk writes
