Skip to main content

An asynchronous wrapper in python for the https://dictionaryapi.dev API

Project description

asyncdictionary

MIT License PyPI version PyPi Downloads

An asynchronous Python wrapper for https://dictionaryapi.dev/


NOTE: Currently I have only implemented fetching words from English, not other languages. This is because the actual API's implementation of languages other than english is different. Support for different languages coming soon though.


Requirements

  • Python 3.6+
  • aiohttp

Features

  • Asynchronous
  • Typed
  • Easy to use

Installation

Available through PyPi (pip)

$ pip install asyncdictionary

Or through git.

$ pip install git+https://github.com/Ay-355/asyncdictionary

You might have to do python3 -m pip

Documentation

You can find a markdown file here.

Issues

Any issues directly with the API should be reported at the API's repository page.

If there is anything wrong with this package, feel free to open up an issue and explain what happened.

Examples

An example to print out some information about a word

import asyncdictionary
import asyncio

# create an instance of the client
dictionary = asyncdictionary.Client()

async def word_info(word):
    word = await dictionary.get_word(word) # get a Word object
    print(f"Word: {word.word}")
    print(f"Phonetic text: {word.phonetics[0].text}")
    print(f"Part of Speech: {word.meanings[0].part_of_speech}")
    print(f"Definition: {word.meanings[0].definitions[0].definition}")
    print(f"Synonyms: {', '.join(word.meanings[0].definitions[0].synonyms)}")
    print(f"Example: {word.meanings[0].definitions[0].example}")

asyncio.run(word_info("hello"))

Links

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asyncdictionary-1.2.4.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

asyncdictionary-1.2.4-py3-none-any.whl (6.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page