An asynchronous wrapper around the UrbanDictionary API.
Project description
Yet another UrbanDictionary API wrapper.
AsyncUrban is a non-blocking library, using asyncio and aiohttp, which can be used to access UrbanDictionary data.
Installation
Make sure you have Python3.6+ and run py -3 -m pip install AsyncUrban for Windows, or python3 -m pip install AsyncUrban for most other things.
Examples
import asyncio
from asyncurban import UrbanDictionary
loop = asyncio.get_event_loop()
# session and loop are optional kwargs for your convenience if
# You already have them defined for your project
urban = UrbanDictionary(loop=loop)
# Get a word definition
>>> word = loop.run_until_complete(urban.get_word('dank'))
>>> word.definition
'Also an expression requently used by stoners and hippies for something of high quality.'
# Get a random word
>>> random_word = loop.run_until_complete(urban.get_random())
>>> print(random_word)
Orgasm
>>> random_word.definition
"When a woman reaches their 'climax'. It is the most desirable feeling EVER. Its like an explosion inside the body that feels so good."
# You can even search for X matching words and get a list
# The default is 3 but can be specified
>>> word_list = loop.run_until_complete(urban.search('test', limit=5))
>>> print(word_list)
[<Word word=test defid=708924>, <Word word=test defid=2957653>, <Word word=test defid=2573364>, <Word word=test defid=1876232>, <Word word=test defid=1662552>]
>>> word_list[0].definition
'A process for testing things'
Docs coming soon maybeâ„¢
Issues
This is a very preliminary commit for testing purposes for now. If you have any issues, feel free to open one up.
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
asyncurban-0.1.9.tar.gz
(3.7 kB
view hashes)