Skip to main content

Asynchronous API Wrapper for the OpenTDB Api. (https://opentdb.com/)

Project description

aiotrivia

Async Wrapper for the OpenTDB API

Installation

$ pip install git+https://github.com/niztg/aiotrivia

Example Usage

import asyncio
import aiotrivia

client = aiotrivia.TriviaClient()

async def main():
    data = await client.get_specific_question(category=20)
    for i in data:
        print('%s | %s' % (i.question, i.responses))
    await client.close() # after you're done with everything

asyncio.get_event_loop().run_until_complete(main())

Returns:

Which figure from Greek mythology traveled to the underworld to return his wife Eurydice to the land of the living? | ['Daedalus', 'Hercules', 'Perseus', 'Orpheus']

discord.py command usage

from aiotrivia import TriviaClient, AiotriviaException
from discord.ext import commands
import asyncio
import random

class TriviaCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        self.trivia = TriviaClient()

    @commands.command()
    async def trivia(self, ctx, difficulty):
        try:
            question = await self.trivia.get_random_question(difficulty)
        except AiotriviaException as error:
            return await ctx.send(f"{error.__class__.__name__}: {error}")
        answers = question.responses
        random.shuffle(answers)
        final_answers = '\n'.join([f"{index}. {value}" for index, value in enumerate(answers, 1)])
        message = await ctx.send(f"**{question.question}**\n{final_answers}\n{question.type.capitalize()} Question about {question.category}")
        answer = answers.index(question.answer)+1
        await self.trivia.close() # cleaning up
        try:
            while True:
                msg = await self.client.wait_for('message', timeout=15, check=lambda m: m.id != message.id)
                if str(answer) in msg.content:
                    return await ctx.send(f"{answer} was correct! ({question.answer})")
        except asyncio.TimeoutError:
            await ctx.send(f"The correct answer was {question.answer}")

def setup(bot):
    bot.add_cog(TriviaCog(bot))

For more info, read the documentation

Or join the discord server

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

aiotrivia-2.0.1.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aiotrivia-2.0.1-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file aiotrivia-2.0.1.tar.gz.

File metadata

  • Download URL: aiotrivia-2.0.1.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3rc1

File hashes

Hashes for aiotrivia-2.0.1.tar.gz
Algorithm Hash digest
SHA256 ef057c2765b0c6167edbacd284e919fd8c5827c46f142ffc8eb177282cc22a49
MD5 c55a324dff637bdef10afe77b3e7f141
BLAKE2b-256 d27ff41a91f67bd700444dc3767fec27fa78f50f44fad2ddb4a165e6c789cb92

See more details on using hashes here.

File details

Details for the file aiotrivia-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: aiotrivia-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3rc1

File hashes

Hashes for aiotrivia-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1fce48405eed4eabdf5ce7076d9c7cdac9cf8fc527656ca14eb9c687658cc71d
MD5 d241422723cfae572cfda4fd5a27fca0
BLAKE2b-256 741c831284bf4e9048f95645ebaf21eb7108e2631e66a94c0d5ba68fbb58d91f

See more details on using hashes here.

Supported by

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