An asynchronous wrapper for the Open Trivia DB API.
This is an unofficial wrapper, and is not affiliated with PIXELTAIL GAMES LLC.
To install the latest stable version of OpenTriviaDB, use the following command:
pip install opentriviadbYou can also install the latest development version using the following command:
pip install git+https://github.com/parafoxia/opentriviadbYou may need to prefix these commands with a call to the Python interpreter depending on your OS and Python configuration.
Before you can pull questions from the API, you first need to create a client:
from opentriviadb import Client
client = Client()
# You can also use the client via a context manager.
async with Client() as client:
...To prevent duplicate questions being pulled, request a session token:
await client.request_token()You can now run a round of trivia!
Questions are yielded one at a time when needed, though you can use the list() built-in function if you need them all available at once.
See the Question docs for more information.
async for q in client.round():
# Yields `Question` objects.
...Once you're done, you need to tear the client down:
await client.teardown()If you use the client via the context manager, the teardown method is called automatically.
Contributions are very much welcome! To get started:
- Familiarise yourself with the code of conduct
- Have a look at the contributing guide
The OpenTriviaDB module for Python is licensed under the BSD 3-Clause License.