Python Python

Using requests

import requests

resp = requests.get("")
data = resp.json()


Using aiohttp (async)

import aiohttp

async with aiohttp.ClientSession() as session:
    async with session.get("") as resp:
      data = await resp.json()


Using our Wrapper


Make sure to have pip installed in your environement. It will also install all requirements.

pip install -U nekosbest


import asyncio
from typing import Union

from nekosbest import Client, Result

client = Client()

async def get_img(type: str, amount: int = 1) -> Union[Result, list[Result]]:
    result = await client.get_image(type, amount)

loop = asyncio.get_event_loop()

# <Result url= artist_href= artist_name=奥馬 source_url=>
loop.run_until_complete(get_img("neko", 2))
# [<Result url= artist_href= artist_name=こみやひとま source_url=>, <Result url= artist_href= artist_name=ひゅらさん source_url=>]

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.


Made by PredaaA

The source code is available at GitHub

License: AGPL-3.0

NekosBest NekosBest NekosBest