pyackett 0.1.0__tar.gz

pyackett-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uv build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

pyackett-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,23 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uv python install ${{ matrix.python-version }}
+
+      - run: uv sync --python ${{ matrix.python-version }}
+
+      - run: uv run pytest tests/ -v

pyackett-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+.pytest_cache/
+dist/
+build/
+*.pkl

pyackett-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: pyackett
+Version: 0.1.0
+Summary: Python clean room implementation of a Torznab-compatible indexer proxy
+Project-URL: Homepage, https://github.com/dmarkey/pyackett
+Project-URL: Repository, https://github.com/dmarkey/pyackett
+Project-URL: Issues, https://github.com/dmarkey/pyackett/issues
+Author: David Markey
+License-Expression: MIT
+Keywords: indexer,jackett,proxy,radarr,sonarr,torrent,torznab
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Requires-Python: >=3.12
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: cachetools>=5.5.0
+Requires-Dist: curl-cffi>=0.7.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: jsonpath-ng>=1.6.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: cloudflare
+Requires-Dist: camoufox[geoip]>=0.4.11; extra == 'cloudflare'
+Description-Content-Type: text/markdown
+
+# Pyackett
+
+A Python clean room implementation of a Torznab-compatible indexer proxy. Works as a standalone server (Sonarr/Radarr compatible) and as an importable Python library.
+
+Loads Jackett's 550+ YAML indexer definitions directly. Includes browser-grade TLS fingerprinting and automatic Cloudflare Turnstile bypass.
+
+## Install
+
+```bash
+pip install pyackett
+
+# With Cloudflare challenge support (adds Camoufox browser):
+pip install pyackett[cloudflare]
+```
+
+## Quick Start
+
+### As a server
+
+```bash
+# Download definitions from Jackett GitHub and start the server
+pyackett --from-github jackett --port 9117
+
+# With a SOCKS5 proxy
+pyackett --from-github jackett --proxy socks5://user:pass@host:1080
+
+# With local definitions
+pyackett -d /path/to/definitions
+```
+
+Then point Sonarr/Radarr at `http://localhost:9117/api/v2.0/indexers/{id}/results/torznab/` with the API key shown in the web UI.
+
+### As a Python library
+
+```python
+import asyncio
+from pyackett import Pyackett
+
+async def main():
+    pk = Pyackett(proxy="socks5://user:pass@host:1080")
+    pk.load_definitions_from_github(source="jackett")
+
+    await pk.configure_indexer("1337x", {})
+    await pk.configure_indexer("therarbg", {})
+
+    results = await pk.search("breaking bad", categories=[5000])
+    for r in results:
+        print(f"{r.title} | S:{r.seeders} | {r.size}")
+
+    await pk.close()
+
+asyncio.run(main())
+```
+
+```python
+# Synchronous wrapper for simple scripts
+pk = Pyackett()
+pk.load_definitions_from_github()
+pk.configure_indexer("therarbg", {})
+results = pk.search_sync("ubuntu")
+```
+
+## Features
+
+### Torznab API
+- Full Torznab XML API compatible with Sonarr, Radarr, Prowlarr, qBittorrent
+- TorrentPotato JSON support
+- Capabilities endpoint per indexer
+- Multi-indexer search (`/indexers/all/results/torznab/`)
+
+### Cardigann YAML Engine
+- Loads all 550+ Jackett YAML indexer definitions
+- Go-style template engine (`{{ if }}`, `{{ range }}`, `{{ eq }}`, etc.)
+- CSS selector extraction (BeautifulSoup) and JSONPath
+- 25+ filter functions (replace, dateparse, fuzzytime, regexp, etc.)
+- 6 login methods (form, cookie, header/API key, GET, POST, captcha)
+
+### HTTP Client
+- **curl_cffi** with Chrome/Firefox TLS fingerprint impersonation
+- Built-in SOCKS5/SOCKS4/HTTP proxy support
+- Request delay per indexer definition
+- Automatic Cloudflare detection and bypass
+
+### Cloudflare Bypass (optional)
+- Automatic detection of Cloudflare 403/503 challenges
+- **Camoufox** (anti-detect Firefox) solves Turnstile challenges headlessly
+- Local HTTP CONNECT proxy bridges SOCKS5 auth for browsers
+- Firefox TLS fingerprint matching for cf_clearance cookie reuse
+- Cookies cached per domain for the session
+- Graceful fallback when Camoufox not installed (logs warning, skips CF sites)
+
+### Web UI
+- Bootstrap 5 dashboard at `http://localhost:9117/`
+- Browse and filter all 550+ available indexers
+- Dynamic configuration forms generated from YAML settings
+- Manual search with results table
+- Per-indexer Torznab URL copy, edit, test, delete
+
+## CLI Options
+
+```
+pyackett [OPTIONS]
+
+  --host HOST               Bind address (default: 0.0.0.0)
+  -p, --port PORT           Port (default: 9117)
+  --config-dir DIR          Config/cache directory
+  -d, --definitions-dir DIR Local YAML definitions directory
+  --from-github {jackett,prowlarr}
+                            Download definitions from GitHub
+  --branch BRANCH           GitHub branch (default: master)
+  --update-definitions      Force re-download definitions
+  --proxy URL               Proxy (socks5://host:port, http://host:port)
+  --api-key KEY             API key (auto-generated if not set)
+  --log-level {DEBUG,INFO,WARNING,ERROR}
+```
+
+## Architecture
+
+```
+pyackett/
+  core/
+    models.py          - ReleaseInfo, TorznabQuery, IndexerDefinition
+    manager.py         - IndexerManager (load, configure, concurrent search)
+    http.py            - curl_cffi client + Camoufox CF solver
+    cache.py           - TTL result cache
+    categories.py      - Torznab category mappings
+    definitions_fetcher.py - GitHub tarball downloader
+  engine/
+    cardigann.py       - YAML definition interpreter
+    template.py        - Go-style template engine
+    filters.py         - 25+ data transformation filters
+    selectors.py       - CSS + JSONPath extraction
+  api/
+    torznab.py         - Torznab XML generation + query parsing
+  server/
+    app.py             - FastAPI server + web UI
+  pyackett.py          - Public library API
+  cli.py               - CLI entry point
+```
+
+## Development
+
+```bash
+git clone <repo>
+cd pyackett
+uv sync
+uv run pytest tests/ -v
+```
+
+## License
+
+MIT

pyackett-0.1.0/README.md

@@ -0,0 +1,152 @@
+# Pyackett
+
+A Python clean room implementation of a Torznab-compatible indexer proxy. Works as a standalone server (Sonarr/Radarr compatible) and as an importable Python library.
+
+Loads Jackett's 550+ YAML indexer definitions directly. Includes browser-grade TLS fingerprinting and automatic Cloudflare Turnstile bypass.
+
+## Install
+
+```bash
+pip install pyackett
+
+# With Cloudflare challenge support (adds Camoufox browser):
+pip install pyackett[cloudflare]
+```
+
+## Quick Start
+
+### As a server
+
+```bash
+# Download definitions from Jackett GitHub and start the server
+pyackett --from-github jackett --port 9117
+
+# With a SOCKS5 proxy
+pyackett --from-github jackett --proxy socks5://user:pass@host:1080
+
+# With local definitions
+pyackett -d /path/to/definitions
+```
+
+Then point Sonarr/Radarr at `http://localhost:9117/api/v2.0/indexers/{id}/results/torznab/` with the API key shown in the web UI.
+
+### As a Python library
+
+```python
+import asyncio
+from pyackett import Pyackett
+
+async def main():
+    pk = Pyackett(proxy="socks5://user:pass@host:1080")
+    pk.load_definitions_from_github(source="jackett")
+
+    await pk.configure_indexer("1337x", {})
+    await pk.configure_indexer("therarbg", {})
+
+    results = await pk.search("breaking bad", categories=[5000])
+    for r in results:
+        print(f"{r.title} | S:{r.seeders} | {r.size}")
+
+    await pk.close()
+
+asyncio.run(main())
+```
+
+```python
+# Synchronous wrapper for simple scripts
+pk = Pyackett()
+pk.load_definitions_from_github()
+pk.configure_indexer("therarbg", {})
+results = pk.search_sync("ubuntu")
+```
+
+## Features
+
+### Torznab API
+- Full Torznab XML API compatible with Sonarr, Radarr, Prowlarr, qBittorrent
+- TorrentPotato JSON support
+- Capabilities endpoint per indexer
+- Multi-indexer search (`/indexers/all/results/torznab/`)
+
+### Cardigann YAML Engine
+- Loads all 550+ Jackett YAML indexer definitions
+- Go-style template engine (`{{ if }}`, `{{ range }}`, `{{ eq }}`, etc.)
+- CSS selector extraction (BeautifulSoup) and JSONPath
+- 25+ filter functions (replace, dateparse, fuzzytime, regexp, etc.)
+- 6 login methods (form, cookie, header/API key, GET, POST, captcha)
+
+### HTTP Client
+- **curl_cffi** with Chrome/Firefox TLS fingerprint impersonation
+- Built-in SOCKS5/SOCKS4/HTTP proxy support
+- Request delay per indexer definition
+- Automatic Cloudflare detection and bypass
+
+### Cloudflare Bypass (optional)
+- Automatic detection of Cloudflare 403/503 challenges
+- **Camoufox** (anti-detect Firefox) solves Turnstile challenges headlessly
+- Local HTTP CONNECT proxy bridges SOCKS5 auth for browsers
+- Firefox TLS fingerprint matching for cf_clearance cookie reuse
+- Cookies cached per domain for the session
+- Graceful fallback when Camoufox not installed (logs warning, skips CF sites)
+
+### Web UI
+- Bootstrap 5 dashboard at `http://localhost:9117/`
+- Browse and filter all 550+ available indexers
+- Dynamic configuration forms generated from YAML settings
+- Manual search with results table
+- Per-indexer Torznab URL copy, edit, test, delete
+
+## CLI Options
+
+```
+pyackett [OPTIONS]
+
+  --host HOST               Bind address (default: 0.0.0.0)
+  -p, --port PORT           Port (default: 9117)
+  --config-dir DIR          Config/cache directory
+  -d, --definitions-dir DIR Local YAML definitions directory
+  --from-github {jackett,prowlarr}
+                            Download definitions from GitHub
+  --branch BRANCH           GitHub branch (default: master)
+  --update-definitions      Force re-download definitions
+  --proxy URL               Proxy (socks5://host:port, http://host:port)
+  --api-key KEY             API key (auto-generated if not set)
+  --log-level {DEBUG,INFO,WARNING,ERROR}
+```
+
+## Architecture
+
+```
+pyackett/
+  core/
+    models.py          - ReleaseInfo, TorznabQuery, IndexerDefinition
+    manager.py         - IndexerManager (load, configure, concurrent search)
+    http.py            - curl_cffi client + Camoufox CF solver
+    cache.py           - TTL result cache
+    categories.py      - Torznab category mappings
+    definitions_fetcher.py - GitHub tarball downloader
+  engine/
+    cardigann.py       - YAML definition interpreter
+    template.py        - Go-style template engine
+    filters.py         - 25+ data transformation filters
+    selectors.py       - CSS + JSONPath extraction
+  api/
+    torznab.py         - Torznab XML generation + query parsing
+  server/
+    app.py             - FastAPI server + web UI
+  pyackett.py          - Public library API
+  cli.py               - CLI entry point
+```
+
+## Development
+
+```bash
+git clone <repo>
+cd pyackett
+uv sync
+uv run pytest tests/ -v
+```
+
+## License
+
+MIT

pyackett-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "pyackett"
+version = "0.1.0"
+description = "Python clean room implementation of a Torznab-compatible indexer proxy"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [{name = "David Markey"}]
+keywords = ["torznab", "jackett", "torrent", "indexer", "proxy", "sonarr", "radarr"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+]
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "curl_cffi>=0.7.0",
+    "beautifulsoup4>=4.12.0",
+    "lxml>=5.0.0",
+    "pyyaml>=6.0",
+    "pydantic>=2.0.0",
+    "python-dateutil>=2.9.0",
+    "jsonpath-ng>=1.6.0",
+    "cachetools>=5.5.0",
+]
+
+[project.optional-dependencies]
+cloudflare = ["camoufox[geoip]>=0.4.11"]
+
+[project.urls]
+Homepage = "https://github.com/dmarkey/pyackett"
+Repository = "https://github.com/dmarkey/pyackett"
+Issues = "https://github.com/dmarkey/pyackett/issues"
+
+[project.scripts]
+pyackett = "pyackett.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pyackett"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "camoufox[geoip]>=0.4.11",
+]

pyackett-0.1.0/src/pyackett/__init__.py

@@ -0,0 +1,8 @@
+"""Pyackett - A Python Torznab-compatible indexer proxy."""
+
+from pyackett.core.models import ReleaseInfo, TorznabQuery
+from pyackett.core.manager import IndexerManager
+from pyackett.pyackett import Pyackett
+
+__version__ = "0.1.0"
+__all__ = ["Pyackett", "IndexerManager", "ReleaseInfo", "TorznabQuery"]