animedex.backends.ghibli

High-level Studio Ghibli Python API.

This backend is fully offline: it reads the committed animedex/data/ghibli.json snapshot and never contacts the live API. The raw passthrough at animedex.api.ghibli remains available for callers who explicitly need live upstream data.

• animedex.backends.ghibli.models
  • GhibliFilm
    • GhibliFilm
  • GhibliPerson
    • GhibliPerson
  • GhibliLocation
    • GhibliLocation
  • GhibliVehicle
    • GhibliVehicle
  • GhibliSpecies
    • GhibliSpecies
  • selftest
    • selftest()

T

animedex.backends.ghibli.T = ~T

Type variable.

Usage:

T = TypeVar('T')  # Can be anything
A = TypeVar('A', str, bytes)  # Must be str or bytes

Type variables exist primarily for the benefit of static type checkers. They serve as the parameters for generic types as well as for generic function definitions. See class Generic for more information on generic types. Generic functions work as follows:

def repeat(x: T, n: int) -> List[T]:

‘’’Return a list containing n references to x.’’’ return [x]*n

def longest(x: A, y: A) -> A:

‘’’Return the longest of two strings.’’’ return x if len(x) >= len(y) else y

The latter example’s signature is essentially the overloading of (str, str) -> str and (bytes, bytes) -> bytes. Also note that if the arguments are instances of some subclass of str, the return type is still plain str.

At runtime, isinstance(x, T) and issubclass(C, T) will raise TypeError.

Type variables defined with covariant=True or contravariant=True can be used to declare covariant or contravariant generic types. See PEP 484 for more details. By default generic types are invariant in all type variables.

Type variables can be introspected. e.g.:

T.__name__ == ‘T’ T.__constraints__ == () T.__covariant__ == False T.__contravariant__ = False A.__constraints__ == (str, bytes)

Note that only type variables defined in global scope can be pickled.

films

animedex.backends.ghibli.films(*, title: str | None = None, director: str | None = None, producer: str | None = None, release_year: int | None = None, min_rt_score: int | None = None, config: Config | None = None, **kw) → List[GhibliFilm]

List films from the bundled snapshot with optional filters.

Parameters:

• title (str or None) – Case-insensitive title substring filter.

• director (str or None) – Case-insensitive director substring filter.

• producer (str or None) – Case-insensitive producer substring filter.

• release_year (int or None) – Exact release year.

• min_rt_score (int or None) – Minimum Rotten Tomatoes score.

Returns:

Matching films in snapshot order.

Return type:

list[GhibliFilm]

film

animedex.backends.ghibli.film(film_id: str, *, config: Config | None = None, **kw) → GhibliFilm

Return one film by Studio Ghibli API UUID.

people

animedex.backends.ghibli.people(*, name: str | None = None, gender: str | None = None, film_id: str | None = None, species_id: str | None = None, config: Config | None = None, **kw) → List[GhibliPerson]

List people from the bundled snapshot with optional filters.

person

animedex.backends.ghibli.person(person_id: str, *, config: Config | None = None, **kw) → GhibliPerson

Return one person by Studio Ghibli API UUID.

locations

animedex.backends.ghibli.locations(*, name: str | None = None, climate: str | None = None, terrain: str | None = None, film_id: str | None = None, config: Config | None = None, **kw) → List[GhibliLocation]

List locations from the bundled snapshot with optional filters.

location

animedex.backends.ghibli.location(location_id: str, *, config: Config | None = None, **kw) → GhibliLocation

Return one location by Studio Ghibli API UUID.

vehicles

animedex.backends.ghibli.vehicles(*, name: str | None = None, vehicle_class: str | None = None, film_id: str | None = None, config: Config | None = None, **kw) → List[GhibliVehicle]

List vehicles from the bundled snapshot with optional filters.

vehicle

animedex.backends.ghibli.vehicle(vehicle_id: str, *, config: Config | None = None, **kw) → GhibliVehicle

Return one vehicle by Studio Ghibli API UUID.

species

animedex.backends.ghibli.species(*, name: str | None = None, classification: str | None = None, film_id: str | None = None, config: Config | None = None, **kw) → List[GhibliSpecies]

List species from the bundled snapshot with optional filters.

species_by_id

animedex.backends.ghibli.species_by_id(species_id: str, *, config: Config | None = None, **kw) → GhibliSpecies

Return one species by Studio Ghibli API UUID.

selftest

animedex.backends.ghibli.selftest() → bool

Smoke-test the offline Ghibli backend.

Loads the bundled snapshot, validates that every expected list is present, checks representative rich-model validation, and confirms single-record lookup returns the same identifier as list lookup.

Returns:

True on success.

Return type:

bool