Metadata-Version: 2.1
Name: kitsu.py
Version: 1.0.0
Summary: kitsu.py is an asynchronous API wrapper for Kitsu written in Python.
Home-page: https://github.com/MrArkon/kitsu.py/
License: MIT
Keywords: kitsu,async kitsu,kitsu.py,kitsu api wrapper
Author: MrArkon
Author-email: mrarkon@outlook.com
Maintainer: MrArkon
Maintainer-email: mrarkon@outlook.com
Requires-Python: >=3.8,<4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: aiohttp (>=3.7.4,<4.0.0)
Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
Project-URL: Bug Tracker, https://github.com/MrArkon/kitsu.py/issues
Project-URL: Changelog, https://github.com/MrArkon/kitsu.py/blob/master/CHANGELOG.md
Project-URL: Repository, https://github.com/MrArkon/kitsu.py/
Description-Content-Type: text/markdown

<h1 align="center">Kitsu.py</h1>
<p align="center">
    <a href="https://pypi.python.org/pypi/kitsu.py">
        <img src="https://img.shields.io/pypi/v/kitsu.py.svg?style=for-the-badge&color=orange&logo=&logoColor=white" />
    </a>
    <a href="https://github.com/MrArkon/kitsu.py/blob/master/LICENSE">
        <img src="https://img.shields.io/pypi/l/kitsu.py?style=for-the-badge" />
    </a>
    <a>
    <a href="https://www.codacy.com/gh/MrArkon/kitsu.py/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=MrArkon/kitsu.py&amp;utm_campaign=Badge_Grade">
        <img src="https://img.shields.io/codacy/grade/a04e4a4edbb84f6ea6d0c5a091a912a5?style=for-the-badge" />
    </a>
    <br> kitsu.py is an asynchronous API wrapper for Kitsu written in Python.
</p>

## Key Features
* Simple and modern Pythonic API using `async/await`
* Fully typed
* Filter & Limit functionality

## Requirements

Python 3.8+
* [aiohttp](https://pypi.org/project/aiohttp/)
* [python-dateutil](https://pypi.org/project/python-dateutil)

## Installing
To install the library, run the following commands:
```shell
# Linux/MacOS
python3 -m pip install -U kitsu.py

# Windows
py -3 -m pip install -U kitsu.py
```

## Usage

Search for an anime:
```python
import kitsu
import asyncio

client = kitsu.Client()

async def main():
    anime = await client.search_anime("jujutsu kaisen", limit=1)
    
    print("Canonical Title: " + anime.canonical_title)
    print("Average Rating: " + str(anime.average_rating))
    
    # Close the internal aiohttp ClientSession
    await client.close()

loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```
This prints:
```
Canonical Title: Jujutsu Kaisen
Average Rating: 85.98
```
You can find more examples in the [examples](https://github.com/MrArkon/kitsu.py/tree/master/examples/) directory.
    
## Contributors
* [Dymattic](https://github.com/dymattic)

## License

This project is distributed under the [MIT](https://github.com/MrArkon/kitsu.py/blob/master/LICENSE.txt) license.

