animedex.transport

HTTP transport layer for animedex backends.

This package owns every wire-level concern that backend modules must honour but should never have to reimplement: the User-Agent string (animedex.transport.useragent), per-backend rate limiting (animedex.transport.ratelimit), the advisory method classifier (animedex.transport.read_only), and the HttpClient wrapper that composes them on top of requests.Session.

Per plans/02 the rate-limit caps and the User-Agent / Via header contracts are hard P1 obligations: violating them gets the user punished by a third party (4xx, ban, or worse). The transport layer is therefore the one place in the codebase where these obligations are configured; nothing outside transport should touch them.

• animedex.transport.http
  • HttpClient
    • HttpClient
  • selftest
    • selftest()
• animedex.transport.ratelimit
  • TokenBucket
    • TokenBucket
  • RateLimitRegistry
    • RateLimitRegistry
  • default_registry
    • default_registry()
  • selftest
    • selftest()
• animedex.transport.read_only
  • known_backends
    • known_backends()
  • classify_read_only
    • classify_read_only()
  • selftest
    • selftest()
• animedex.transport.useragent
  • default_user_agent
    • default_user_agent()
  • compose_user_agent
    • compose_user_agent()
  • selftest
    • selftest()