tetr.io api wrapper
Project description
Tetry
A simple python library for interacting with the TETR.IO API.
contents
About
This library is a simple wrapper around the TETR.IO API. It uses trio to provide a simple async interface.
Installation
installing from pip
python3 -m pip install tetry
installing from source
git clone https://github.com/apes0/tetry
cd tetry
python3 -m pip install -U .
Documentation
Coming soon!
Examples
Here you will find code examples for the library.
General api
from tetry import api
def printRecords(username):
records = api.getRecords(username).records
for name, record in records.items():
print(f'{name}: {record}')
while (name := input()):
printRecords(name)
Chat commands
from tetry import bot
bot = bot.Bot(token='token', commandPrefix='>')
@bot.chatCommand()
async def ping(_msg):
ping = bot.getPing()
await bot.room.send(f'The bot\'s ping is {round(ping*1000, 2)}ms')
bot.run()
Simple auto-host bot
import trio
from tetry.bot import Bot
bot = Bot(token='token')
@bot.event
async def ready():
await bot.createRoom(False)
@bot.event
async def joinedRoom(room):
print(room.invite)
@bot.event
async def userLeave(user):
name = user['username']
print(f'{name} has left')
await bot.room.send(f'Goodbye {name}, hope to see you here again soon!')
async def start(room):
delay = 20 # seconds
needed = 2 # players
if len(room.getPlaying()) >= needed:
await room.send(f'Starting in {delay} seconds!')
await trio.sleep(delay)
if len(room.getPlaying()) >= needed:
await room.startGame()
else:
await room.send('Not enough players!')
else:
await room.send('Not enough players!')
@bot.event
async def userJoin(user):
room = bot.room
name = user['username']
await room.send(f'Welcome to this room, {name}!')
await start(room)
@bot.event
async def gameEnd():
room = bot.room
print('the game has ended')
await start(room)
bot.run()
Contribution
You can feel free to contribute to the this project by making a PR, making suggestions and opening issues for bugs/questions.
Notice
This library is NOT affiliated with, endorsed by, or otherwise associated with TETR.IO or osk.
Helpful links
- TETR.IO bot docs - documentation for the bot api
- tetr.js - a javascript library for interacting with the TETR.IO API
- TETR.IO public api docs - the official TETR.IO API documentation
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 Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
tetry-1.3.2-py3-none-any.whl
(45.6 kB
view hashes)