A ranking table tennis system
Project description
ranking-table-tennis
Ranking system for table tennis players.
The system keeps a record of championship points and rating points.
Championship points aim at tracking the tournament achievements of players. Their computation is based on the best rounds reached by players in each tournament.
Rating points aim at tracking the relative skill level of players. Their computation is based on the outcomes of one-versus-one matches.
Installation
This system has been developed for a Linux environment.
Poetry installation (recommended)
poetry install
System-wide installation
sudo pip install ranking-table-tennis
Single-user installation
pip install --user ranking-table-tennis
Uninstallation
[sudo] pip uninstall ranking-table-tennis
Authentication for gspread
To start using the upload spreadsheets capabilities, gspread requires authentication. Please, follow the recommended steps to get your system ready to upload.
Update
System-wide update
sudo pip install -U ranking-table-tennis
Single-user update (recommended)
pip install --user -U ranking-table-tennis
Usage
The commands must be run in a bash terminal.
-
Fill a sheet with the tournament matches. It must be saved in the Tournaments spreadsheet (xlsx).
Players and Initial Ranking sheets must be in the same spreadsheet (it is used as a database).
-
Run
rtt preprocess
.The scripts will read the Tournament spreadsheet and will ask for missing information of new players (city, affiliation, initial rating points, and category). This information will be saved in the Players and Initial Ranking sheets.
-
Run
rtt compute
.It will ask for the tournament that you want to process. 0 will compute all from the beggining. The outcome will be saved in the Ranking spreadsheet.
-
Run
rtt publish
.It will ask for the index of the tournament that you want to publish. The outcome will be saved in a new spreadsheet.
Development
Install locally from source (source directory will immediately affect the installed package without needing to re-install):
pip install --user --editable .
sudo apt install graphviz (still required?)
Update version at pyproject.toml
and then create a source distribution
poetry build
Upload to PyPI
poetry publish [--dry-run] [--build]
Upload to TestPyPI
poetry publish -r testpypi [--dry-run] [--build]
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ranking_table_tennis-2024.8.12.tar.gz
.
File metadata
- Download URL: ranking_table_tennis-2024.8.12.tar.gz
- Upload date:
- Size: 40.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.2 CPython/3.8.10 Linux/5.15.0-107-generic
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c3db122f93c94e9cc6f8e9354fe809bf1034c2d63a899767e846cb7f7df265b |
|
MD5 | 2018a5870d5342178e6ae4a02106a445 |
|
BLAKE2b-256 | e38ebdeebe0e068f85ea949b5565bfb80a78ad64f6b83fe975c55e86e97ff4a8 |
File details
Details for the file ranking_table_tennis-2024.8.12-py3-none-any.whl
.
File metadata
- Download URL: ranking_table_tennis-2024.8.12-py3-none-any.whl
- Upload date:
- Size: 56.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.2 CPython/3.8.10 Linux/5.15.0-107-generic
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ddfa04a27e0fb75f234008a93169d39dd1f2d559374c4a3ad43691261120cad5 |
|
MD5 | e23b17db932fedf570c7947427175a68 |
|
BLAKE2b-256 | dbdbdf0b76fcb7e64c4446e00038f7d829f5e5060c8c47f7a74db4bda1fa5059 |