vyalovvldmr/onx

Noughts & Crosses terminal based, client-server online game with your partner through websockets.

Noughts & Crosses (Tic Tac Toe)

Noughts & Crosses (Tic Tac Toe) terminal based, client-server online game with your partner through websockets.

Requires

Python 3.10

Install

$ pip install onx

or

$ poetry shell
$ poetry add onx

Play Game

For running your game board just type in a terminal:

$ onx

You will see a game board in a waiting for your partner state.

Then ask your partner to run the same cli command with exactly the same cli options. You will be matched to your partner by cli options (size and winning sequence length) on a server side.

If you are running a game with a public server than I'll suggest you to make a shorter delay between running your game board and your partners board. Just for reducing the probability to be matched with somebody else.

There are command line options for changing game board settings. -g or --grid-size changes grid size. -w or --wining-length changes winning sequence length. -h or --help prints help.

$ onx -g14 -w3

Run Server and Client Locally

Set up env variables.

$ export LOCALHOST="0.0.0.0"
$ export PORT=8888

Run server.

$ onx -d

Run client.

$ onx

Run Tests

$ git clone [email protected]:vyalow/onx.git
$ cd onx
$ poetry shell
$ poetry install --no-root
$ pytest --cov

Known Limitations

• onx is currently based on textual TUI framework which is awesome but is at an extremely early development stage. As a result you may be faced with some rendering problem like 711, 710. I'll suggest you to run a game board in a fullscreen mode for now.
• Public server is currently running on a free Heroku app. It means that a good enough SLA is not expected.

Release

make release version=[patch | minor | major]

onx's Issues

Rewrite cookie validation with pydantic

handle errors on server shutdown

How to reproduce:

1. Run server
2. Connect two clients
3. Shutdown server

Better cli options validation

-g3 -w4 is not allowed

Colorize a winning sequence

Change statuses numeration

Change game statuses to

class GameStatus:
    # game is waiting for a player
    awaiting: int = 100
    # game is in progress
    in_progress: int = 200
    # game is finished
    finished: int = 300

Fix aiohttp deprecations

Fix aiohttp deprecations after bumping aiohttp from 1.3 to 3.8

Fix tests stability

Add gameplay with a computer

Automate poetry build

• dependencies
• version
• ect.

Rewrite handler validation with pydantic

Reconnect to the same game after incidental disconnection

Add Dockerfile

Deal with textual rendering issues

711, 710

Migrate from aiohttp to starlette or gRPC or even Blockchain

Just for having fun with different technologies.