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_interface 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 client.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.2.tar.gz (842.9 kB view details)

Uploaded Source

Built Distribution

botris_interface-0.1.2-py3-none-any.whl (851.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: botris_interface-0.1.2.tar.gz
  • Upload date:
  • Size: 842.9 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.2.tar.gz
Algorithm Hash digest
SHA256 071cdf0681567ccd1aaff5c9dc4be2a427c69b9066bfb90a48ba7762ee6522b6
MD5 12e749d24e9f8a5319515d9f4553393a
BLAKE2b-256 ff78b40a9b2748aa1a1c877fe7d4ae0dadaf1affe89c3a8a4c03b99d6cc508a7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for botris_interface-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4b61337886373669216ec8e10f0e24f8f3f798a551192328d68bf4f81e0dd333
MD5 c8403c3a8f03c198676000ca7fa9f4e2
BLAKE2b-256 1cf433939658cf3f95d2f06f2b4f15340676942106227ca07c072cf400a696d4

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