animedex.backends.ann

High-level ANN Encyclopedia Python API.

ANN exposes a small anonymous XML surface: api.xml for by-id and substring search, and reports.xml for curated encyclopedia lists. The high-level API parses XML into typed rich models while preserving <warning> rows as data rather than errors.

• animedex.backends.ann.models
  • AnnXmlNode
    • AnnXmlNode
  • AnnInfo
    • AnnInfo
  • AnnPersonRef
    • AnnPersonRef
  • AnnCompanyRef
    • AnnCompanyRef
  • AnnStaff
    • AnnStaff
  • AnnCast
    • AnnCast
  • AnnCredit
    • AnnCredit
  • AnnLink
    • AnnLink
  • AnnEpisode
    • AnnEpisode
  • AnnRelation
    • AnnRelation
  • AnnAnime
    • AnnAnime
  • AnnAnimeResponse
    • AnnAnimeResponse
  • AnnReportItem
    • AnnReportItem
  • AnnReport
    • AnnReport
  • anime_from_node
    • anime_from_node()
  • anime_response_from_root
    • anime_response_from_root()
  • report_from_root
    • report_from_root()
  • selftest
    • selftest()

show

animedex.backends.ann.show(anime_id: int, *, config: Config | None = None, **kw) → AnnAnimeResponse

Fetch one ANN anime encyclopedia entry by ANN ID.

A missing ID returns a response with warnings populated and anime=[]; this mirrors ANN’s 200-OK warning contract.

search

animedex.backends.ann.search(q: str, *, config: Config | None = None, **kw) → AnnAnimeResponse

Search ANN anime entries by title substring.

reports

animedex.backends.ann.reports(id: int = 155, *, type: str | None = 'anime', nlist: int = 10, nskip: int | None = None, search: str | None = None, name: str | None = None, licensed: str | None = None, config: Config | None = None, **kw) → AnnReport

Fetch a curated ANN encyclopedia report by report ID.

selftest

animedex.backends.ann.selftest() → bool

Smoke-test the ANN high-level package without network access.