Skip to main content

A python library for the API.

Project description

# Anipy
[![Build Status](](
[![Codacy Badge](](
[![Codacy Badge](](
[![Python Version](]()
[![Project License](](

Anipy is a python library that wraps and organize the [Anilist] rest api into modules, classes and functions so it can be used quick, easy, and right out of the box. You can take a look at the api [official docs]. **Anilist is a [Josh Star]'s project**

## Table of contents

* [Installation](#installation)
* [Usage](#usage)
* [Authentication](#authentication)
* [Resources](#resources)
* [Roadmap](#roadmap)

## Installation

For now the only available versions are alphas. You can Instaled the las by:
$ git clone
$ cd anipy
$ python # Be sure using Python 3

## Usage

I've tried to keep the developer interface as simple as possible.

### Authentication

Before you can access any Anilist resource you have to get authenticated. Once you have [created a client] you must configure ```auth.AuthenticationProvider``` class with your credentials.

Now you can get authenticated with any of the available [grant types]. Aditionaly, Anipy have a ```GrantType.refreshToken``` in case you have saved a refresh token from a previous authentication. *Note that only code and pin authentication gives you a refresh token.*

from anipy import AuthenticationProvider
from anipy import Authentication
from anipy import GrantType

AuthenticationProvider.config('your-client-id', 'your-client-secret', 'your-redirect-uri')

auth = Authentication.fromCredentials()
# or
auth = Authentication.fromCode('code')
# or
auth = Authentication.fromPin('pin')

# Now you can save the refresh token
refresh_token = auth.refreshToken

auth = Authentication.fromRefreshToken(refresh_token)

Authentication expires after one hour and will refresh automatically, nevertheless you can do it manually at any time, ie.:

if auth.isExpired:


### Resources

Resources are one of the most important parts of the library. They are in charge of go an get the data from the Anilist API. Each domain class have a resource, you can compare them to *Data Access Objects*. All resouces are **Singletons**.

In order to keep things simple you can access the resource from class it serves

# Current logged user
user = User.resource().principal()
# A user for his Id or Display Name
user = User.resource().byId(3225)
user = User.resource().byDisplayName('demo')

Some resources are injected in other classes also in order to keep things simple (ie. ```AnimeListResource```). So if you want to get de watching list of a user you can do:

# The long way
resource = AnimeListResource()
watching_list = resource.byUserId(
# Or the short way
watching_list = user.watching

## Roadmap

Here is a sumary of the project state.

### Next Release: 0.1

- [x] **Authentication**
- [x] Authorization Code
- [x] Authorization Pin
- [x] Client Credentials
- [x] **User**
- [x] Basics
- [ ] **User Lists**
- [ ] Animelist
- [x] Update watched episodes
- [x] Update rewatched
- [x] Update notes
- [x] Update list status
- [ ] Update score (simple)
- [ ] Create a entry
- [ ] Remove entry
- [ ] Mangalist
- [ ] List Scores types
- [ ] **Anime**
- [ ] Basics
- [ ] Airing
- [ ] Search
- [ ] **Manga**
- [ ] Basics
- [ ] Search

### Out of Scope

Thing that I'm going to do soon.

- Advance rating score
- Custom lists

[official docs]:
[Josh Star]:

[created a client]:
[grant types]:

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

anipy-0.1a1.tar.gz (8.7 kB view hashes)

Uploaded source

Built Distribution

anipy-0.1a1-py3-none-any.whl (11.9 kB view hashes)

Uploaded py3

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