aa-meta 0.1.0__tar.gz

aa_meta-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.3
+Name: aa-meta
+Version: 0.1.0
+Summary: Search and download books from Anna's Archive
+Author: Maxwell Ludden
+Author-email: Maxwell Ludden <maxludden@me.com>
+Requires-Dist: beautifulsoup4>=4.15.0
+Requires-Dist: browser-cookie3>=0.20.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: rich>=15.0.0
+Requires-Dist: rich-gradient>=0.3.13
+Requires-Dist: typer>=0.27.3
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+

aa_meta-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "aa-meta"
+version = "0.1.0"
+description = "Search and download books from Anna's Archive"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "beautifulsoup4>=4.15.0",
+    "browser-cookie3>=0.20.1",
+    "httpx>=0.28.1",
+    "loguru>=0.7.3",
+    "rich>=15.0.0",
+    "rich-gradient>=0.3.13",
+    "typer>=0.27.3",
+]
+
+[[project.authors]]
+name = "Maxwell Ludden"
+email = "maxludden@me.com"
+
+[project.scripts]
+aa = "aa_meta.cli:app"
+
+[build-system]
+requires = ["uv_build>=0.12.22,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.4.0",
+    "pytest>=9.1.1",
+    "respx>=0.23.1",
+    "ruff>=0.17.0",
+    "types-beautifulsoup4>=4.12.0.20250516",
+]
+
+[[tool.mypy.overrides]]
+module = "browser_cookie3"
+ignore_missing_imports = true

aa_meta-0.1.0/pyproject.toml.orig

@@ -0,0 +1,38 @@
+[project]
+name = "aa-meta"
+version = "0.1.0"
+description = "Search and download books from Anna's Archive"
+readme = "README.md"
+authors = [
+    { name = "Maxwell Ludden", email = "maxludden@me.com" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "beautifulsoup4>=4.15.0",
+    "browser-cookie3>=0.20.1",
+    "httpx>=0.28.1",
+    "loguru>=0.7.3",
+    "rich>=15.0.0",
+    "rich-gradient>=0.3.13",
+    "typer>=0.27.3",
+]
+
+[project.scripts]
+aa = "aa_meta.cli:app"
+
+[build-system]
+requires = ["uv_build>=0.12.22,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.4.0",
+    "pytest>=9.1.1",
+    "respx>=0.23.1",
+    "ruff>=0.17.0",
+    "types-beautifulsoup4>=4.12.0.20250516",
+]
+
+[[tool.mypy.overrides]]
+module = "browser_cookie3"
+ignore_missing_imports = true

aa_meta-0.1.0/src/aa_meta/__init__.py

@@ -0,0 +1,3 @@
+"""aa-meta: search and download books from Anna's Archive."""
+
+__version__ = "0.1.0"

aa_meta-0.1.0/src/aa_meta/api.py

@@ -0,0 +1,55 @@
+"""Client for the Anna's Archive fast-download JSON API."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+import httpx
+
+from .config import USER_AGENT, Settings
+
+
+class ApiError(RuntimeError):
+    """Raised when the API returns an error or no download URL."""
+
+
+@dataclass(frozen=True)
+class FastDownload:
+    """Successful fast-download response."""
+
+    url: str
+    info: dict[str, Any]
+
+
+def fast_download(
+    client: httpx.Client,
+    settings: Settings,
+    md5: str,
+    key: str,
+    path_index: int | None = None,
+    domain_index: int | None = None,
+) -> FastDownload:
+    """Resolve a member fast-download URL for ``md5``.
+
+    Raises:
+        ApiError: on a non-2xx response or a null ``download_url``.
+    """
+    params: dict[str, str | int] = {"md5": md5, "key": key}
+    if path_index is not None:
+        params["path_index"] = path_index
+    if domain_index is not None:
+        params["domain_index"] = domain_index
+    resp = client.get(
+        f"{settings.origin}/dyn/api/fast_download.json",
+        params=params,
+        headers={"User-Agent": USER_AGENT},
+    )
+    try:
+        data: dict[str, Any] = resp.json()
+    except ValueError as exc:
+        raise ApiError(f"HTTP {resp.status_code}: non-JSON response") from exc
+    url = data.get("download_url")
+    if resp.status_code not in (200, 204) or not url:
+        raise ApiError(data.get("error") or f"HTTP {resp.status_code}")
+    return FastDownload(url=url, info=data.get("account_fast_download_info") or {})

aa_meta-0.1.0/src/aa_meta/authors.py

@@ -0,0 +1,69 @@
+"""Colour-code the authors of search results with a ``rich_gradient`` Spectrum."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from rich.style import Style
+from rich.text import Text
+from rich_gradient.spectrum import COLOR_STOPS, Spectrum
+
+
+def split_authors(raw: str) -> list[str]:
+    """Split a site author string into individual names (heuristic).
+
+    The site separates authors with ``;``. Some sources use commas instead, which
+    is ambiguous with ``Last, First``: a single comma is treated as one
+    ``Last, First`` name, two or more as a comma-separated list.
+    """
+    if ";" in raw:
+        parts = raw.split(";")
+    elif raw.count(",") >= 2:
+        parts = raw.split(",")
+    else:
+        parts = [raw]
+    return [p.strip() for p in parts if p.strip()]
+
+
+def author_key(name: str) -> str:
+    """Normalise a name so ``Herbert, Frank`` and ``Frank Herbert`` match."""
+    if "," in name:
+        last, _, first = name.partition(",")
+        name = f"{first} {last}"
+    return " ".join(name.replace(".", "").casefold().split())
+
+
+def format_authors(raw_authors: Sequence[str], *, seed: int = 0) -> list[Text]:
+    """Return one colour-coded :class:`~rich.text.Text` per author string.
+
+    Every distinct author (by :func:`author_key`) gets one colour from a
+    :class:`~rich_gradient.spectrum.Spectrum`, so the same person looks the same
+    in every row. ``Spectrum`` yields consecutive colours around the ring, so the
+    full ring is built and colours are picked evenly spaced to keep a handful of
+    authors visually distinct; with more authors than colours, colours repeat.
+
+    Args:
+        raw_authors: The author field of each result, in row order.
+        seed: Rotates where the colour ring starts; same seed, same colours.
+
+    Returns:
+        A list the same length as ``raw_authors``; empty authors render as a dim
+        ``Unknown``.
+    """
+    rows = [split_authors(raw) for raw in raw_authors]
+    keys = list(dict.fromkeys(author_key(n) for names in rows for n in names))
+    ring = Spectrum(hues=len(COLOR_STOPS), seed=seed).styles
+    step = max(len(ring) / max(len(keys), 1), 1.0)
+    style_of = {k: ring[int(i * step) % len(ring)] for i, k in enumerate(keys)}
+
+    texts: list[Text] = []
+    for names in rows:
+        text = Text(no_wrap=False)
+        if not names:
+            text.append("Unknown", style="dim")
+        for i, name in enumerate(names):
+            if i:
+                text.append("; ", style="dim")
+            text.append(name, style=style_of[author_key(name)] + Style(bold=True))
+        texts.append(text)
+    return texts