Skip to main content

python interface for communication with AniDB API

Project description

zenchi

zenchi is a python3 application that communicates with AniDB UDP API. It provides an interface to convert raw responses strings into python objects. It does very little by itself and its only intention is to parse data for other applications to use.

Currently, only Data commands are supported.

Installing

pip install -U zenchi

Usage

Fairly straightforward:

>>> import zenchi
>>> zenchi.create_socket(anidb_server='api.anidb.net', anidb_port=9000)
<socket.socket ...>
>>> zenchi.ping(nat=1)
({'port': 25065}, 300)

Every command response is a tuple (data, code). data is a dictionary of variable keys containing the parsed response, and code is the response code.

Environment variables

ZENCHI_CLIENTNAME and ZENCHI_CLIENTVERSION should be replaced by your own keys generated at AniDB site. (no guarantee these values are valid at the time of your reading!)

ZENCHI_CLIENTNAME=devel
ZENCHI_CLIENTVERSION=1

ANIDB_SERVER=api.anidb.net
ANIDB_PORT=9000

ANIDB_USERNAME=xXGodKillerXx
ANIDB_PASSWORD=hunter2

If these values are set, the socket is created automatically and it's much simpler. You can skip the call for create_socket entirely and just call the commands:

>>> import zenchi
>>> zenchi.auth()
({'session': 'ELahj'}, 200)
>>> zenchi.character(1)
(..., 235)

Anime masks

The ANIME command receives a mask as parameter to filter the anime data. zenchi provides an easy way to create these masks with the module zenchi.mappings.anime.mask.

>>> import zenchi.mappings.anime.mask as amask
>>> zenchi.anime(amask.aid | amask.romaji_name | amask.english_name | amask.short_name | amask.year, aid=3433)
({'aid': 3433, 'english_name': 'Mushi-Shi', 'romaji_name': 'Mushishi', 'short_name': ['Mushi'], 'updated_at': datetime.datetime(2019, 11, 10, 19, 55, 18, 1000), 'year': '2005-2006'}, 230)

Cache

zenchi uses a very basic optional MongoDB database as cache, named anidb_cache. It uses the environment variable MONGODB_URI to check the connection string. If the variable is not set, a warning will be issued and all cache usage will be ignored (highly unadvised, as per AniDB specifications).

Any operations that use the cache have the parameter use_cache that defaults to True. You can set this to False to skip the cache for that specific command (for example, when you want to update the cached data). All cached data also returns a updated_at key (see example above), which is the last time that data was updated in the database.

If you don't want to use anidb_cache or MONGODB_URI, manually call zenchi.cache.setup with the appropriate values before sending requests to the API.

Features

It's actually fairly simple to add new commands to zenchi, and I just wrote what I personally intend to use. Feel free to send PRs or request something in the issues.

License

This project is under MIT License.

For data collection and usage, make sure to read AniDB Policies

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zenchi-1.2.0.tar.gz (16.4 kB view details)

Uploaded Source

File details

Details for the file zenchi-1.2.0.tar.gz.

File metadata

  • Download URL: zenchi-1.2.0.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.6.8

File hashes

Hashes for zenchi-1.2.0.tar.gz
Algorithm Hash digest
SHA256 0371e35b7be37b1331e4de8a586cc007a0cb3a207235e889b3743a77ad5a68bc
MD5 f06c672cea603d8ca1f3f4ed922e85a0
BLAKE2b-256 27232086d1e1824cd7df32129123ffba4c920c1ab07a9d10a2e21329b382ec1f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page