django-openrouter 0.1.0b1__tar.gz

django_openrouter-0.1.0b1/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+*.egg
+
+# Virtualenv
+.venv/
+venv/
+env/
+
+# Test / lint
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# Django
+*.sqlite3
+db.sqlite3
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

django_openrouter-0.1.0b1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 django-openrouter contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_openrouter-0.1.0b1/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.5
+Name: django-openrouter
+Version: 0.1.0b1
+Summary: Reusable Django app for managing OpenRouter models, budgets and usage via the admin.
+Project-URL: Homepage, https://github.com/django-openrouter/django-openrouter
+Project-URL: Documentation, https://github.com/django-openrouter/django-openrouter#readme
+Author: django-openrouter contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: chat,django,llm,openai,openrouter
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: django>=4.2
+Requires-Dist: httpx>=0.27
+Provides-Extra: async
+Requires-Dist: httpx>=0.27; extra == 'async'
+Provides-Extra: dev
+Requires-Dist: django-stubs>=5.0; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-django>=4.8; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# django-openrouter
+
+Reusable Django application for managing [OpenRouter](https://openrouter.ai) models, usage profiles, budgets and request logs from Django admin.
+
+Your product code (translation, chat, summarization, …) talks to OpenRouter through this library instead of hardcoded `settings.py` keys and model ids. An operator picks active models, sets daily/monthly limits, and inspects spend in admin.
+
+## Why not `settings.py`?
+
+Hardcoding `OPENROUTER_MODEL = "anthropic/claude-3.5-sonnet"` means a deploy to change models, budgets or a kill switch. `django-openrouter` stores that runtime policy in the database, caches it, and enforces limits before every request.
+
+API keys can still come from the environment (`OPENROUTER_API_KEY`) if you prefer not to keep them in the database.
+
+## Quickstart
+
+### 1. Install
+
+```bash
+pip install django-openrouter
+```
+
+### 2. Enable the app and migrate
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...,
+    "django_openrouter",
+]
+```
+
+```bash
+python manage.py migrate
+```
+
+### 3. Configure in Django admin
+
+1. Open **OpenRouter → OpenRouter settings**. Paste an API key *or* leave it empty and set `OPENROUTER_API_KEY` in the environment.
+2. Run `python manage.py sync_models` to pull the model catalog (`GET /api/v1/models`).
+3. Create a **Usage profile** (slug `translation`, `chat`, …), pick a model, optional fallbacks, limits and budgets.
+4. Set that profile as **default profile** if you want `chat(messages=...)` without a name.
+
+## Usage
+
+```python
+from django_openrouter import chat
+
+result = chat(
+    "translation",
+    messages=[{"role": "user", "content": "Translate to French: hello"}],
+)
+print(result.content)
+print(result.model_used, result.cost_usd, result.latency_ms)
+```
+
+Sync client:
+
+```python
+from django_openrouter import OpenRouterClient
+
+client = OpenRouterClient("chat")
+result = client.chat(messages=[{"role": "user", "content": "Hello"}])
+```
+
+Async:
+
+```python
+from django_openrouter import achat
+
+result = await achat("chat", messages=[{"role": "user", "content": "Hello"}])
+```
+
+If a profile’s limit or budget is exhausted, `chat()` raises `BudgetExceeded` or `RateLimitExceeded` and **does not** silently fall back. Fallback models are only used when OpenRouter returns `402`, `429` or `5xx`.
+
+Streaming (`stream=True`) raises `NotImplementedError` in this MVP.
+
+## Management command
+
+```bash
+python manage.py sync_models
+python manage.py sync_models --api-key sk-or-...
+```
+
+Upserts the catalog, never deletes rows, and sets `is_active=False` on models that disappeared from OpenRouter.
+
+## `settings.OPENROUTER`
+
+| Key | Default | Description |
+| --- | --- | --- |
+| `CACHE_TIMEOUT` | `60` | Seconds to keep runtime config in Django’s cache |
+| `CACHE_ALIAS` | `"default"` | Cache alias (`django.core.cache`) |
+| `API_KEY` | unset | Fallback API key if the admin field is empty |
+| `HTTP_REFERER` | unset | Sent as `HTTP-Referer` (OpenRouter app attribution) |
+| `X_TITLE` | unset | Sent as `X-Title` |
+
+Also accepted, in this order, when the admin API key is empty:
+
+1. `settings.OPENROUTER["API_KEY"]`
+2. `settings.OPENROUTER_API_KEY`
+3. Environment variable `OPENROUTER_API_KEY`
+
+Example:
+
+```python
+OPENROUTER = {
+    "CACHE_TIMEOUT": 60,
+    "CACHE_ALIAS": "default",
+    "HTTP_REFERER": "https://my-app.example",
+    "X_TITLE": "My App",
+}
+```
+
+The default cache backend (`LocMemCache`) is enough. Redis/Memcached are optional.
+
+## Limits
+
+Usage is aggregated from `RequestLog` for the current calendar day and month (`UsageProfile.get_usage("day"|"month")`). Null limit fields mean “unlimited”.
+
+## License
+
+MIT

django_openrouter-0.1.0b1/README.md

@@ -0,0 +1,120 @@
+# django-openrouter
+
+Reusable Django application for managing [OpenRouter](https://openrouter.ai) models, usage profiles, budgets and request logs from Django admin.
+
+Your product code (translation, chat, summarization, …) talks to OpenRouter through this library instead of hardcoded `settings.py` keys and model ids. An operator picks active models, sets daily/monthly limits, and inspects spend in admin.
+
+## Why not `settings.py`?
+
+Hardcoding `OPENROUTER_MODEL = "anthropic/claude-3.5-sonnet"` means a deploy to change models, budgets or a kill switch. `django-openrouter` stores that runtime policy in the database, caches it, and enforces limits before every request.
+
+API keys can still come from the environment (`OPENROUTER_API_KEY`) if you prefer not to keep them in the database.
+
+## Quickstart
+
+### 1. Install
+
+```bash
+pip install django-openrouter
+```
+
+### 2. Enable the app and migrate
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...,
+    "django_openrouter",
+]
+```
+
+```bash
+python manage.py migrate
+```
+
+### 3. Configure in Django admin
+
+1. Open **OpenRouter → OpenRouter settings**. Paste an API key *or* leave it empty and set `OPENROUTER_API_KEY` in the environment.
+2. Run `python manage.py sync_models` to pull the model catalog (`GET /api/v1/models`).
+3. Create a **Usage profile** (slug `translation`, `chat`, …), pick a model, optional fallbacks, limits and budgets.
+4. Set that profile as **default profile** if you want `chat(messages=...)` without a name.
+
+## Usage
+
+```python
+from django_openrouter import chat
+
+result = chat(
+    "translation",
+    messages=[{"role": "user", "content": "Translate to French: hello"}],
+)
+print(result.content)
+print(result.model_used, result.cost_usd, result.latency_ms)
+```
+
+Sync client:
+
+```python
+from django_openrouter import OpenRouterClient
+
+client = OpenRouterClient("chat")
+result = client.chat(messages=[{"role": "user", "content": "Hello"}])
+```
+
+Async:
+
+```python
+from django_openrouter import achat
+
+result = await achat("chat", messages=[{"role": "user", "content": "Hello"}])
+```
+
+If a profile’s limit or budget is exhausted, `chat()` raises `BudgetExceeded` or `RateLimitExceeded` and **does not** silently fall back. Fallback models are only used when OpenRouter returns `402`, `429` or `5xx`.
+
+Streaming (`stream=True`) raises `NotImplementedError` in this MVP.
+
+## Management command
+
+```bash
+python manage.py sync_models
+python manage.py sync_models --api-key sk-or-...
+```
+
+Upserts the catalog, never deletes rows, and sets `is_active=False` on models that disappeared from OpenRouter.
+
+## `settings.OPENROUTER`
+
+| Key | Default | Description |
+| --- | --- | --- |
+| `CACHE_TIMEOUT` | `60` | Seconds to keep runtime config in Django’s cache |
+| `CACHE_ALIAS` | `"default"` | Cache alias (`django.core.cache`) |
+| `API_KEY` | unset | Fallback API key if the admin field is empty |
+| `HTTP_REFERER` | unset | Sent as `HTTP-Referer` (OpenRouter app attribution) |
+| `X_TITLE` | unset | Sent as `X-Title` |
+
+Also accepted, in this order, when the admin API key is empty:
+
+1. `settings.OPENROUTER["API_KEY"]`
+2. `settings.OPENROUTER_API_KEY`
+3. Environment variable `OPENROUTER_API_KEY`
+
+Example:
+
+```python
+OPENROUTER = {
+    "CACHE_TIMEOUT": 60,
+    "CACHE_ALIAS": "default",
+    "HTTP_REFERER": "https://my-app.example",
+    "X_TITLE": "My App",
+}
+```
+
+The default cache backend (`LocMemCache`) is enough. Redis/Memcached are optional.
+
+## Limits
+
+Usage is aggregated from `RequestLog` for the current calendar day and month (`UsageProfile.get_usage("day"|"month")`). Null limit fields mean “unlimited”.
+
+## License
+
+MIT

django_openrouter-0.1.0b1/pyproject.toml

@@ -0,0 +1,134 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "django-openrouter"
+dynamic = ["version"]
+description = "Reusable Django app for managing OpenRouter models, budgets and usage via the admin."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "django-openrouter contributors" }]
+keywords = ["django", "openrouter", "llm", "openai", "chat"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+    "Framework :: Django :: 5.1",
+    "Framework :: Django :: 5.2",
+    "Framework :: Django :: 6.0",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Typing :: Typed",
+]
+dependencies = [
+    "django>=4.2",
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+async = ["httpx>=0.27"]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "pytest-cov>=5.0",
+    "pytest-django>=4.8",
+    "respx>=0.21",
+    "ruff>=0.6",
+    "mypy>=1.11",
+    "django-stubs>=5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/django-openrouter/django-openrouter"
+Documentation = "https://github.com/django-openrouter/django-openrouter#readme"
+
+[tool.hatch.version]
+path = "src/django_openrouter/__init__.py"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/django_openrouter"]
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+pythonpath = ["src", "."]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = "-q --strict-markers"
+filterwarnings = [
+    "error",
+    "ignore::DeprecationWarning",
+    "ignore::PendingDeprecationWarning",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["django_openrouter"]
+omit = [
+    "*/migrations/*",
+    "*/tests/*",
+]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = false
+fail_under = 85
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 99
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "DJ", "RUF"]
+ignore = ["RUF012", "RUF002"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["django_openrouter"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/django_openrouter/migrations/*" = ["E501", "I001"]
+"tests/*" = ["DJ01"]
+
+[tool.mypy]
+python_version = "3.11"
+plugins = ["mypy_django_plugin.main"]
+pretty = true
+show_error_codes = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+exclude = ["src/django_openrouter/migrations/"]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+
+[tool.django-stubs]
+django_settings_module = "tests.settings"

django_openrouter-0.1.0b1/src/django_openrouter/__init__.py

@@ -0,0 +1,50 @@
+"""django-openrouter — reusable Django app for OpenRouter models, budgets and usage logs."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+__version__ = "0.1.0b1"
+default_app_config = "django_openrouter.apps.DjangoOpenRouterConfig"
+
+if TYPE_CHECKING:
+    from django_openrouter.client import (
+        AsyncOpenRouterClient as AsyncOpenRouterClient,
+    )
+    from django_openrouter.client import (
+        ChatResult as ChatResult,
+    )
+    from django_openrouter.client import (
+        OpenRouterClient as OpenRouterClient,
+    )
+    from django_openrouter.client import (
+        achat as achat,
+    )
+    from django_openrouter.client import (
+        chat as chat,
+    )
+
+__all__ = [
+    "AsyncOpenRouterClient",
+    "ChatResult",
+    "OpenRouterClient",
+    "__version__",
+    "achat",
+    "chat",
+]
+
+
+def __getattr__(name: str) -> Any:
+    # Ленивый импорт, чтобы версия пакета читалась без django.setup().
+    if name in {"AsyncOpenRouterClient", "ChatResult", "OpenRouterClient", "achat", "chat"}:
+        from django_openrouter import client as client_module
+
+        mapping = {
+            "AsyncOpenRouterClient": client_module.AsyncOpenRouterClient,
+            "ChatResult": client_module.ChatResult,
+            "OpenRouterClient": client_module.OpenRouterClient,
+            "achat": client_module.achat,
+            "chat": client_module.chat,
+        }
+        return mapping[name]
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")