animedex.api.quote

animedex api quote raw passthrough.

AnimeChan is a free, anonymous quote API. The free tier serves random quotes and paginated quote lists filtered by anime or character name. Every successful response is a JSON envelope with a status string and a data field containing either one quote or an array of quotes.

Backend: AnimeChan (api.animechan.io/v1).

Rate limit: 5 req/hour anonymous. Supporter tokens can receive higher limits, but this backend only configures the anonymous free-tier bucket.

— LLM Agent Guidance — Common read paths: /quotes/random, /quotes/random?anime=<title>, /quotes/random?character=<name>, /quotes?anime=<title>&page=N, and /quotes?character=<name>&page=N. The raw method argument is forwarded verbatim. The free tier is very tight (5 req/hour), so prefer cached high-level calls and avoid exploratory live probing unless the user needs fresh quotes. — End —

call

animedex.api.quote.call(path: str, *, method: str = 'GET', headers: Dict[str, str] | None = None, params: dict | None = None, no_cache: bool = False, cache_ttl: int | None = None, rate: str = 'normal', follow_redirects: bool = True, user_agent: str | None = None, timeout_seconds: float | None = None, cache=None, session=None, rate_limit_registry=None, config=None) → RawResponse

Issue an AnimeChan request and return its envelope.

Parameters:

• path (str) – URL path under /v1. Examples: /quotes/random and /quotes.

• headers (dict or None) – Extra request headers.

• params (dict or None) – Query-string parameters such as anime, character, and page.

Returns:

Wire envelope including body, status, headers, redirect chain, request snapshot, timing breakdown, and cache provenance.

Return type:

animedex.api._envelope.RawResponse

selftest

animedex.api.quote.selftest() → bool

Smoke-test the AnimeChan passthrough.

Exercises the shared shim checks: the public call signature retains the cross-cutting transport kwargs.

Returns:

True on success; raises on contract drift.

Return type:

bool