Align-Five

Introduction

This is a two player game, where the users play either black or white stones on a Go board. The objective of the game is to align 5 stones of the same colour in one row, column or across a diagonal. Players take alternating turns to place their stones on the board. The game is played on a 19 x 19 Go board.

Getting started with the package

To get started with this package, clone the repo

git clone https://github.com/mwolinska/Align-Five

Then make sure you are in the right folder

cd Align-Five

Then, simply install all the dependencies using poetry.

poetry install

Using the package

You can either play a single player game (against a bot), where you play the first move, by running:

play_alone

or a two player game (black makes the first move):

play_together

An example run would look like this. First, a clean board is displayed.

The first move is made by the user playing white.

Then the users alternate to play their moves until one of the four outcomes is achieved

• 5 stones of one colour are aligned in a row

• 5 stones of one colour are aligned in a column

• 5 stones of one colour are aligned across a diagonal

• All the moves on the board have been taken and the game is a draw

Benchmarking

You can benchmark your computer by using the benchmark command. For more information about this, please type:

benchmark -h