Metadata-Version: 2.1
Name: oc-chess-club
Version: 1.0.1
Summary: CLI to manage tournaments and players for a chess club
Home-page: https://github.com/PabloLec/oc_chess_club
License: MIT
Keywords: cli,chess,typer
Author: PabloLec
Author-email: pablo.lecolinet@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Games/Entertainment :: Board Games
Requires-Dist: PyYAML (>=5.4.1,<6.0.0)
Requires-Dist: colorama (>=0.4.4,<0.5.0)
Requires-Dist: shellingham (>=1.4.0,<2.0.0)
Requires-Dist: tinydb (>=4.4.0,<5.0.0)
Requires-Dist: typer (>=0.3.2,<0.4.0)
Project-URL: Documentation, https://pablolec.github.io/oc_chess_club
Project-URL: Repository, https://github.com/PabloLec/oc_chess_club
Description-Content-Type: text/markdown

# oc_chess_club [![GitHub release (latest by date)](https://img.shields.io/github/v/release/pablolec/oc_chess_club)](https://github.com/PabloLec/oc_chess_club/releases/) [![GitHub](https://img.shields.io/github/license/pablolec/oc_chess_club)](https://github.com/PabloLec/oc_chess_club/blob/main/LICENCE) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

:books: Made for an [OpenClassrooms](https://openclassrooms.com) studies project.

oc_chess_club manages tournaments and players for a chess club.

---

<p align="center"><b>
<img class="emoji" title=":fr:" alt=":fr:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f1eb-1f1f7.png" data-canonical-src="https://github.githubassets.com/images/icons/emoji/unicode/1f1eb-1f1f7.png" width="20" height="20" align="absmiddle"> Have a look at the <a href=https://pablolec.github.io/oc_chess_club>documentation</a> <img class="emoji" title=":fr:" alt=":fr:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f1eb-1f1f7.png" data-canonical-src="https://github.githubassets.com/images/icons/emoji/unicode/1f1eb-1f1f7.png" width="20" height="20" align="absmiddle">
</b></p>

---

## Demo

<p align="center">
    <img src="docs/images/demo.gif">
</p>

## Dependencies

Main dependencies are [typer](https://github.com/tiangolo/typer/) for the CLI part and [TinyDB](https://github.com/msiemens/tinydb) for the lightweight database.

You will need **Python 3.9+** as the project type hints generics from standard collections. (See [PEP 585](https://www.python.org/dev/peps/pep-0585/))

## Installation

#### :penguin: Linux / :apple: macOS

```console
python3 -m venv env
source env/bin/activate
python3 -m pip install oc-chess-club
```

#### :framed_picture: Windows
```console
py3 -m venv env
.\env\Scripts\activate
py3 -mpip install oc-chess-club
```

## Usage

To start the CLI, simply type:

```console
python3 -m oc_chess_club
```

To learn more, please refer to the [documentation](https://pablolec.github.io/oc_chess_club) (:fr:).

## Flake8

To generate a Flake8 HTML report you will need [flake8](https://github.com/PyCQA/flake8) and [flake8-html](https://github.com/lordmauve/flake8-html). Both are present in this project's dev dependencies.

Then, go to project's main directory and type:

```console
python3 -m flake8 --format=html --htmldir=docs/flake-report
```

## License

This project is licensed under the terms of the MIT license.

