alfetcher

A simple library to help you fetch data from AniList

Description

Welcome to my first python project! This library is aimed at people who might be interested in automatizing their anime library.

Getting Started

Dependencies

• Python(tested on the latest ver.)
• An AniList account
• An AniList developer app

Installing

• Clone this repo

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

• Install it using pip

pip install alfetcher

• 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 alfetcher

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

Setting up the AniList 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

• 1.7.0
  • update_entry: read token from config
  • rewatch
  • repeating support for update_entry
  • 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
  • add time before opening the browser
  • add url tooltip
• 1.6.0
  • allow progress to be 0 again
• 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 authenticated requests
• 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
  • add function to update progress in users list
  • add function to convert from al to mal id
  • dates: Make sure they are not None
  • Formatting changes
• 1.0.0
  • Initial Release

Acknowledgments

Huge thanks to AniList team for their great page and database:

• AniList
• AniList GraphQL