shomykohai / askitsu

🦊 An async API wrapper for Kitsu.io

askitsu

An async wrapper for Kitsu.io API written in Python

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

• aiohttp
• colorama

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

• Docs
• PyPi
• Kitsu.io Docs
• discord.py (bot example)

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