Skip to main content

A performant library designed for creating and managing bots in a Tetris-like game environment. This library offers various tools and features to build, test, and deploy bots efficiently to Botris.

Project description

botris-interface

GitHub license GitHub issues GitHub stars GitHub forks

botris-interface is a performant library designed for creating and managing bots in a Tetris-like game environment. This library offers various tools and features to build, test, and deploy bots efficiently to Botris.

Installation

To install the library, use the following command:

pip install botris-interface

Usage

Creating a Bot

To create a bot, you need to implement the Bot interface provided by the library. Here is an example:

from botris.bots import Bot

class CoolBot(Bot):
    async def analyze(
        self, game_state: GameState, players: List[PlayerData]
    ) -> Awaitable[List[Command]]:
        # Implement your bot logic here
        pass

Running the TetrisGame

You can run the TetrisGame using the following code:

from botris import TetrisGame
from botris.engine import Move

gs = TetrisGame()
gs.execute_move(Move.move_left)

Connecting a Bot to the Server

To connect your bot to the server, use the following code:

import asyncio
from botris import Interface

async def main():
    bot = MyBot()
    itf = Interface.create(TOKEN, ROOM_KEY, bot)
    await itf.connect()

asyncio.run(main())

License

This project is licensed under the MIT License - see the LICENSE file for details.

GitHub Repository

For more information, visit our GitHub repository.

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

botris_interface-0.1.10.tar.gz (19.3 kB view details)

Uploaded Source

Built Distribution

botris_interface-0.1.10-py3-none-any.whl (24.1 kB view details)

Uploaded Python 3

File details

Details for the file botris_interface-0.1.10.tar.gz.

File metadata

  • Download URL: botris_interface-0.1.10.tar.gz
  • Upload date:
  • Size: 19.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.1 Windows/11

File hashes

Hashes for botris_interface-0.1.10.tar.gz
Algorithm Hash digest
SHA256 002f5bfb0cdbf87ae63f67026daf6ad8b87b20457144fa61dcbc6f9626bbb03c
MD5 4aa91e6e08e3acec9727f26d1463b8d1
BLAKE2b-256 be6f40a767fd5434cd839ac91befc80228af66acfcf62b67a2bc42083c7af6db

See more details on using hashes here.

File details

Details for the file botris_interface-0.1.10-py3-none-any.whl.

File metadata

File hashes

Hashes for botris_interface-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 78fce5dd88076c9bd70ee02c8f85cbbac7d4b01553d8a48159c0be159056c7f3
MD5 89e4d244ed80e39a8ac3de6585cc8f8c
BLAKE2b-256 81dcb304756b911094f6f47c2d577b1279f421f2b120fdf30ae45464388017f2

See more details on using hashes here.

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