Metadata-Version: 2.4
Name: chess-tournament
Version: 0.1.2
Summary: A chess tournament software in Python
Author-email: Thi26 <thiiicroon@gmail.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Classifier: Topic :: Games/Entertainment :: Board Games
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-html; extra == "dev"
Requires-Dist: flake8-html; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Dynamic: license-file

# Chess Tournament Software

![Build Dev](https://gitlab.com/thi26/chess-tournament-software/badges/dev/pipeline.svg)
![PyPI](https://img.shields.io/pypi/v/chess-tournament.svg)

## Table of Contents

- [Overview](#overview)
- [Installation (for users)](#installation-for-users)
- [Usage](#usage)
- [Architecture](#architecture)
- [Developer Setup](#developer-setup)
- [Author](#author)

---

## Overview

Chess Tournament Software is a standalone Python CLI application to manage players and tournaments in a chess club.
Data is stored in JSON files. The app is cross-platform and follows the **Model-View-Controller (MVC)** pattern.

---

## Installation (for users)

You’ll need **Python 3.8+** installed.
To avoid system-level issues (PEP 668, etc.), install the app in a virtual environment:

```bash
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install chess-tournament
```

---

## Usage

After installation, simply run:

```bash
chess
```

---

## Architecture

Main directories:

controllers/ – business logic (players, matches)

models/ – data structures

views/ – command-line interface

data/ – local JSON storage

main.py – CLI entry point

See Issue #7 – Code Architecture for a full breakdown.

---

## Developer Setup

Want to contribute or run the app locally?
See: [Developer_Setup_instructions.md](Developer_Setup_instructions.md)

---

## Author

@Thi26, OpenClassrooms student
Training: Python Application Developer
