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.3.tar.gz
(16.2 kB
view hashes)
Built Distribution
nekosbest-1.1.3-py3-none-any.whl
(18.9 kB
view hashes)
Close
Hashes for nekosbest-1.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ba018aaa19079bd307d78b5c5fbb49b08651fcd4bf3e8f2bbe559fae81f713b |
|
MD5 | e83ed63505275e9ecbdc7214f643b439 |
|
BLAKE2b-256 | bd339d27cc1d3af7d58c7b653e98e40dcaf3bab86b6d1bc31a4c2ffcc0e9a046 |