Skip to content

Collaborative university project featuring a fully implemented chess game, complete with detailed documentation and comprehensive test coverage, using python programming language.

License

Notifications You must be signed in to change notification settings

PierluvaAmaro/Python-Chess-game

Repository files navigation

Python Chess Game

A university project implementing a Chess game in Python using Ruff and the UV environment.
This project is designed to demonstrate programming skills, algorithmic thinking, and use of Python for game logic development.


🎮 Game Description

This is a fully playable Chess game implemented in Python. The game includes:

  • Standard 8x8 chessboard
  • Complete set of pieces for both players
  • Turn-based gameplay enforcing standard chess rules
  • Basic AI support (depending on configuration in Ruff)
  • Text-based interface compatible with the UV environment

Note: This project is created for academic purposes. Some advanced features may not be fully implemented.


⚙️ Implemented Chess Functions

The game implements the following functionalities:

  • Move Validation – Ensures that all moves follow standard chess rules for each piece.
  • Check & Checkmate Detection – Detects when a king is under threat and determines checkmate conditions.
  • Castling – Implements short and long castling rules.
  • Pawn Promotion – Allows pawns to be promoted when reaching the opposite rank.
  • En Passant – Supports en passant captures for pawns.
  • Turn Management – Alternates moves between white and black players.
  • Game State Tracking – Keeps track of moves, captured pieces, and the current board state.

For a complete description of all features and instructions on gameplay, please refer to the User Manual included in the project.


🧩 How to Run

Requirements

  • Python 3.x
  • Ruff package installed
  • UV environment properly set up

Steps

  1. Clone the repository:
    git clone https://github.com/YourUsername/Python-Chess-Game.git
    cd Python-Chess-Game

About

Collaborative university project featuring a fully implemented chess game, complete with detailed documentation and comprehensive test coverage, using python programming language.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 7