CHESS CLUB MANAGER - OpenClassrooms Project 04

Develop a Python application

DESCRIPTION

This project was completed as part of the "Python Developer" path at OpenClassrooms.

The goal was to develop a Python offline application capable of:

• Creating and managing a chess tournament and its players for a chess club
• Saving datas in json files
• Displaying / exporting several reports based on tournaments and players

PROJECT STRUCTURE

INSTALLATION

- Clone the repository :

git clone https://github.com/Tit-Co/OpenClassrooms_Project_04.git

- Navigate into the project directory :

cd OpenClassrooms_Project_04

- Create a virtual environment and dependencies :

Option 1 - with uv

uv is an environment and dependencies manager.

- Install environment and dependencies

uv sync

Option 2 - with pip

- Install the virtual env :

python -m venv env

- Activate the virtual env :

source env/bin/activate
Or
env\Scripts\activate on Windows

- Install dependencies

Option 1 - with uv

uv pip install -U -r requirements.txt

Option 2 - with pip

pip install -r requirements.txt

USAGE

Run the main script

python main.py

EXAMPLES

You will be prompted with this menu :

• ▷▷ 1. Tournament
• ▷▷ 2. Players
• ▷▷ 3. Reports
• ▷▷ 4. Quit the app

You will be prompted with a submenu, accordingly to your choice, to:

• Add and display players
• Create, update and display tournaments
• Generate reports

DEPENDENCIES

• colorama
• flake8
• flake8-html
• faker
• jinja2
• mypy
• rich

FLAKE8 Reports

Type the line below to generate reports with flake8-html tool :

flake8 --format=html --htmldir=flake8-report --max-line-length=119 --extend-exclude=env/

AUTHOR

Name: Nicolas MARIE
Track: Python Developer – OpenClassrooms
Project – Develop a Python app : Chess Tournament Manager – October 2025