In this project, we are building a Tic Tac Toe game. The main goal is to put into practice the main concepts of Object Oriented Programming. Particularly, classes, modules and objects and access their attributes.
For this project, we wrote a Ruby executable script main.rb that allows the user to play the game of Tic, Tac, Toe in the Terminal.
'Tic, Tac, Toe' is a traditional game for two players played on a board with 9 squares.
Each player is represented by a symbol, either 'X' or 'O'. The players then take turns to place their respective symbols in an empty square on the board, with O's going first - in our version of the game, these squares are represented by the numbers 1 to 9.
The aim of the game is to have three of your symbols form a line, be it vertically, horizontally or diagonally, as illustrated in the image below.
In the event that all 9 squares are taken without either player getting three of their symbols in a line, a draw is declared.
-
To quickly play the game, follow the link in the Live Demo section and hit the Run button in the header. The game will begin in the window on the right.
-
To download the contents of this repository and play the game locally, follow the steps in the 'Local Installation' section.
- Ruby
- VSCode
- Rubocop
To quickly see our project in action, visit the live demo on repl.it.
There are no pre-requisites for enjoying the game through this method.
If you intend to download the project, you will need to have Ruby already installed on your machine. For more information on how to install Ruby, follow this link.
To get your own copy of our project simply clone the repository to your local machine.
Step 1: Using the Command Line, navigate into the location where you would like to have the repository. Then enter the following line of code:
git clone <git@github.com:cristianCeamatu/microverse-ruby-tic-tac-toe.git>
Step 2: Once the repo has been cloned, navigate inside it by entering the following command:
cd microverse-ruby-tic-tac-toe
Step 3: Once in the root directory of the repository, simply enter the following line of code to start a game:
bin/main.rb
From there, the game will begin, and the user need only follow the subsequent instructions that appear in the Terminal.
The code for the project is divided into two main directories: ./bin and ./lib.
The ./bin folder contains the executable main.rb file. This is the only file that contains the Kernel.puts and Kernel.gets methods, allowing for interaction with the game via the Terminal. This is the only file that should be run if you want to play the game.
The ./lib folder contains subsidiary files that set up all of the classes and methods used in bin/main.rb
- player.rb, where the Player class is defined.
- game.rb, where the Game class is defined.
- board.rb, where the Board class is defined.
- utils.rb, where the Utils module is defined.
In addition to the above, the repo also contains .rubocop.yml for linting.
-
Open Terminal
-
Install RSpec on your system by running:
gem install rspec -
Run the tests with the command:
rspec
👤 Cristian Viorel Ceamatu
- Github: @cristianCeamatu
- Twitter: @CeamatuV
- Linkedin: Ceamatu Cristian Viorel
👤 Amita Roy
- Github: @Amita-Roy
- Twitter: @AmitaRoy14
- Linkedin: Amita Roy
Our favourite contributions are those that help us improve the project, whether with a contribution, an issue, or a feature request!
Feel free to check the issues page to either create an issue or help us out by fixing an existing one.
If you've read this far....give us a ⭐️!
This project is licensed by Microverse and the Odin Project