Skip to content

BruceCodesGithub/yarsaw

Repository files navigation

YARSAW

API Coverage PyPI - Downloads PyPI - License Documentation Status



YARSAW (Yet Another Random Stuff API Wrapper) is an Async, Object Oriented and Modern Python API Wrapper for the Random Stuff API. This module makes it simpler for you to interact with the API and is easy to implement into your application.

Make sure to get Random Stuff API Key from here and a RapidAPI Application Key after registering and subscribing to the API here.

Features

  • Tons of things you can do
    1. Get AI Responses (useful for chatbots!)
    2. Get Anime GIFs and Waifu Images
    3. Get Animal images
    4. Get memes from various subreddits, and even create memes with pre-built templates!
    5. Get jokes and fun facts
    6. And so much more!
  • Object-oriented design. YARSAW takes inspiration from randomstuff.py and sends you the data from the API in form of objects instead of plain JSON.
  • Async-ready. YARSAW provides an async client for async enviorments using aiohttp.
  • Easy to use. YARSAW is well-documented, and has utility features to help you with your requests.
  • Saves your time. i) No need to learn about the API itself and its complicated design. ii) No need to enter the credentials again and again. Enter it once, and get coding. YARSAW will take care of the boring stuff for you. iii) No need to handle the unhelpful errors given by requests/aiohttp/RapidAPI. Get human-headable, descriptive and helpful error messages. iv) Common errors and issues are prevented and declared before runtime.

Examples

import yarsaw
import asyncio
client = yarsaw.Client("RSA Key", "RapidAPI Key")
async def joke():
   joke = await client.get_joke() # get the joke
   formatted_joke = yarsaw.format_joke(joke) # format the joke (optional)
   print(formatted_joke) # print the joke
asyncio.get_event_loop().run_until_complete(joke()) # run the joke() function

Installation

python3 -m pip install -U yarsaw

Useful Links

About

YARSAW (Yet Another Random Stuff API Wrapper) is an async API Wrapper for the Random Stuff API.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages