Skip to main content

A MyAnimeListAPI wrapper written in Python.

Project description

mal.py

UPDATE: i am working on a major revision of the project, stay tuned!

Downloads

A MyAnimeList API wrapper written in Python.

The objective for now is to cover queries for the publicly available information, support for taking actions on a user list is not planned.

Features

  • anime and manga search given a keyword
  • fetch details of anime or manga given its id or its url
  • accessing public lists of users
  • retrieving seasonal anime
  • retrieve rankings for anime and manga
  • retrieve forum boards and discussions

The next features that are planned to be implemented are:

  • retrieve more information on recommendations and related entries

Installation

Python 3.8+ is needed.

To use this library:

  • (optional) create a virtual environment python -m venv .venv and activate it
  • install with pip install mal-api.py
  • to perform requests you need an API token log in on MAL -> account settings -> API -> create ID

Usage

from mal import client

cli = client.Client('your token here')

anime = cli.get_anime(16498)
anime.title
>> Shingeki_no_Kyojin

Full documentation available here.

Code samples can be found in the examples folder.

Logging

This library uses the logging module to keep track of configuration changes and possible network errors. If you want to see the logs you need to configure the logging module yourself, for example:

import logging

logging.basicConfig(logging.level=INFO)

For more information on how to use logging refer to the documentation of python:

This project is still a work in progress, if you have problems or find bugs feel free to open an issue or start a discussion.

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

mal-api.py-0.7.1.tar.gz (26.4 kB view hashes)

Uploaded Source

Built Distribution

mal_api.py-0.7.1-py3-none-any.whl (28.7 kB view hashes)

Uploaded Python 3

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