malfetcher

A simple library to help you fetch data from MyAnimeList

Description

This library is aimed at people who might be interested in automatizing their anime library.

Getting Started

Dependencies

• Python(tested on the latest ver.)
• A MyAnimeList account
• A MyAnimeList developer app

Installing

• Clone this repo

git clone https://github.com/prochy-exe/malfetcher /path/to/desired/folder

• Install it using pip

pip install malfetcher

• Install it using pip locally

cd /path/to/desired/folder
pip install .

• If you want to make modifications to the library install it in the edit mode:

cd /path/to/desired/folder
pip install -e .

Using the library

• To import the library into your code use:

import malfetcher

• When importing this library for the first time, you will be taken through the setup process

Setting up the MyAnilist developer app

• When the setup process starts, you will be automatically taken to required pages. This process is really simple.
• When asked for the Client ID, you will be taken to the account developer page.
• If not logged in, log in first.
• Then create a new client
• Choose whatever name you fancy, and for the redirect URL use http://localhost:8888/auth
• After you save the client, copy the ID and paste it into the terminal
• After entering the ID you will be taken to an auth page, where you need to allow the app to access your account.
• Afterwards you will be taken to a redirect page that will automatically send the token to the library.
• After that the library is successfully set-up and ready for use.

Help

If you encounter any issues, feel free to open a new issue. If you have any new ideas or fixes, please open a pull request, they are more than welcome!

Version History

• 2.0.0
  • allow client_id to be an ENV var
  • fix media_type path
  • fix padding in config_utils
• 1.9.0
  • amount and format support, general improvements
  • return empty dict instead of none
• 1.8.0
  • update_entry: read token from config
  • fix sorting of the list, along with the amount of anime
  • rebrand request function to mal
  • add a feature that allows specifying episodes from another season
  • fix a bug that marks anime as planning while having an episode watched
  • introduce a function that returns list of all seasons
  • repeating support
  • setup flow qol imporvements
  • fix mal auth and add url tooltip
• 1.7.0
  • implement caching and 429 error handling
• 1.6.0
  • fix up updating entries
• 1.5.0
  • guard against excessive updates
  • make sure the id is a str
  • simply function and variable names
• 1.4.0
  • add env to minimize output
• 1.3.0
  • don't cache empty searches
• 1.2.0
  • fix light init
• 1.1.0
  • fix typo
  • allow some functions to not require user token
  • use local ip address instead of localhost
  • print list name when no anime found
  • drop user list caching
  • allow the mal_to_al_id function to be imported easily
  • add function to update progress in users list
  • regenerate token when expired
  • add state to requests
  • rotate useragents in hopes to avoid captcha
  • fetch unreleased info all the time
  • make sure we have a day in the dates
  • Formatting changes
• 1.0.0
  • Initial Release

Acknowledgments

• MyAnimeList