animedex.backends.quote

High-level AnimeChan Python API.

Thin wrappers over AnimeChan’s anonymous read endpoints. The upstream free tier is limited to 5 requests per hour, so these helpers rely on the dispatcher cache by default and expose the usual no_cache / cache_ttl / rate kwargs for callers that need to override that behaviour.

• animedex.backends.quote.models
  • AnimeChanAnime
    • AnimeChanAnime
  • AnimeChanCharacter
    • AnimeChanCharacter
  • AnimeChanQuote
    • AnimeChanQuote
  • AnimeChanEnvelope
    • AnimeChanEnvelope
  • selftest
    • selftest()

random

animedex.backends.quote.random(*, config: Config | None = None, **kw) → AnimeChanQuote

Return one random AnimeChan quote.

Returns:

Typed quote.

Return type:

AnimeChanQuote

random_by_anime

animedex.backends.quote.random_by_anime(title: str, *, config: Config | None = None, **kw) → AnimeChanQuote

Return one random quote filtered to an anime title.

random_by_character

animedex.backends.quote.random_by_character(name: str, *, config: Config | None = None, **kw) → AnimeChanQuote

Return one random quote filtered to a character name.

quotes_by_anime

animedex.backends.quote.quotes_by_anime(title: str, *, page: int = 1, config: Config | None = None, **kw) → List[AnimeChanQuote]

Return one page of quotes filtered to an anime title.

AnimeChan currently returns five ordered quotes per page.

quotes_by_character

animedex.backends.quote.quotes_by_character(name: str, *, page: int = 1, config: Config | None = None, **kw) → List[AnimeChanQuote]

Return one page of quotes filtered to a character name.

AnimeChan currently returns five ordered quotes per page.

anime

animedex.backends.quote.anime(identifier: str, *, config: Config | None = None, **kw) → AnimeChanAnime

Return AnimeChan’s anime information by ID or name.

The upstream recommends ID lookup for accuracy; name lookup is accepted but may return a fuzzy match.

selftest

animedex.backends.quote.selftest() → bool

Smoke-test the public AnimeChan Python API.

Checks public callable signatures and exercises the default SQLite cache path so platform-specific cache directory resolution and schema creation are covered by the offline smoke test.

Returns:

True on success.

Return type:

bool