Skip to content

shomykohai/askitsu

Repository files navigation

askitsu

TwitterShomy askitsu Documentation Status

An async wrapper for Kitsu.io API written in Python

askitsu

IMPORTANT

💡 UPDATE:
The master branch is now in a status where it can be used.
For any issue you may encounter, please make a new issue.
You can check the projects tab to see current progress.

Key features

  • Fully typed
  • Use of async/await
  • Support most of primary Kitsu entries -- Anime, Manga, Characters and much more
  • Can be used with discord bots

Currently avaiable endpoints

  • 🎞️ Anime (Anime, Episodes and Streaming Links)
  • 📖 Manga (Manga and Chapters)
  • 👥 Characters
  • 📰 Reviews
  • 👤 User (Profile and Profile Links)
  • 🗞️ Posts
  • 📚 User Libraries

Coming soon:

  • 🗨️ Comments

Installing

Requires python 3.8+

To install the package, you can simply run

#Linux/MacOS
python3 -m pip install askitsu


#Windows
py -3 -m pip install askitsu

Or to get the latest dev version

#Linux/MacOS
python3 -m pip install git+https://github.com/ShomyKohai/askitsu.git

  

#Windows
py -3 -m pip install git+https://github.com/ShomyKohai/askitsu.git

Requirements

Examples

import askitsu
import asyncio

async def search():
    client = askitsu.Client()
    anime = await client.search_anime("attack on titan")
    print(anime.episode_count)
    print(anime.status)
    await client.close()

loop = asyncio.get_event_loop()
loop.run_until_complete(search())

More examples can be found inside the example directory -> Here

Links & Credits

"Kitsu" name and the "Kitsu logo" are property of Kitsu