A two-player command-line version of chess written with Ruby and tested using RSpec.
The current version enforces international chess rules (see: Rules section below). However, there are a number of items in the pipeline to enhance UX and gameplay options.
Demo of the Fool's Mate - the fastest checkmate in chess!
Play the game online here!
See the 'How to Play' section below if you prefer to download the game.
The game enforces regular international chess rules. See Wikipedia for a refresher and be sure not to forget:
- en passant capture
- pawn promotion
- castling
The game will look different depending on the command line interface used to play and the current version has been optimized for use with repl.it - You can play using repl.it here.
If you are using Windows Subsystem for Linux, you will need to comment/uncomment a number of lines (all marked with a comment including 'line to use with WSL') due to unsupported use of some unicode characters. This WSL correction affects lib/board.rb, lib/game.rb, and spec/chess_spec.rb.
- ruby >= 2.6.5
- bundler >= 2.1.4
- Clone this repo. Instructions
- Navigate into this project's directory
cd chess - Run
bundle install
Run ruby lib/chess.rb
- To run the entire test suite, run
rspec - To run the test suit with detailed output, run
rspec --format documentation