A simple async Python wrapper for nekos.best API.
Project description
nekos-best.py
A simple async Python wrapper for nekos.best API.
Join the official Discord server here.
Requirements
- aiohttp (>=3.6.2)
Installation
Make sure to have pip installed in your environement. It will also install all requirements.
pip install -U nekosbest
Example
import asyncio
from nekosbest import Client
client = Client()
async def get_single_image(category: str):
result = await client.get_image(category)
print(result)
async def get_multiple_images(category: str, amount: int):
result = await client.get_image(category, amount)
print(result)
loop = asyncio.get_event_loop()
loop.run_until_complete(get_single_image("nekos"))
# <Result url=https://nekos.best/nekos/0338.png source_details=<SourceDetails artist_href=https://www.pixiv.net/en/users/28136401 artist_name=PiAn source_url=https://www.pixiv.net/en/artworks/91363666>>
loop.run_until_complete(get_multiple_images("nekos", 5))
# <Results url=['https://nekos.best/nekos/0351.png', 'https://nekos.best/nekos/0442.png', 'https://nekos.best/nekos/0436.png', 'https://nekos.best/nekos/0307.png', 'https://nekos.best/nekos/0009.png'] source_details=[<SourceDetails artist_href=https://www.pixiv.net/en/users/7331947 artist_name=xoaiu source_url=https://www.pixiv.net/en/artworks/87593460>, <SourceDetails artist_href=https://www.pixiv.net/en/users/37889769 artist_name=タン塩 source_url=https://www.pixiv.net/en/artworks/89459198>, <SourceDetails artist_href=https://www.pixiv.net/en/users/38808847 artist_name=Elliot source_url=https://www.pixiv.net/en/artworks/89283107>, <SourceDetails artist_href=https://www.pixiv.net/en/users/43296648 artist_name=楠シノ source_url=https://www.pixiv.net/en/artworks/86584286>, <SourceDetails artist_href=https://www.pixiv.net/en/users/32933178 artist_name=しずりゆき source_url=https://www.pixiv.net/artworks/85664088>]>
Breaking changes
Migrate from 0.x.x to 1.0.0
Client.teardown
has been removed, it is no longer needed to pass it when closing.
Migrate from 1.0.20 to 1.1.0
nekosbest.Result.source_details
has been removed. Source details are now in Result
.
And therefore, nekosbest.Results
and nekosbest.SourceDetails
got removed too.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nekosbest-1.1.0.tar.gz
(16.1 kB
view hashes)
Built Distribution
nekosbest-1.1.0-py3-none-any.whl
(18.8 kB
view hashes)
Close
Hashes for nekosbest-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5dcf52b11229a2c47f67d7a9ffcc5695c3f56cc83b3d7526cf8f75691be6f0ee |
|
MD5 | d5e67d8183a750fe544d50105d32e508 |
|
BLAKE2b-256 | 90eaf78815d6f7a24db2e5fdbcdf72627af3b30440747aca17f14880244113f8 |