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.
Using uv (recommended)
uv venv [-p 3.12]
uv sync
Install the package globally (not recommended):
uv pip install ranking-table-tennis
Using pip (single user)
pip install --user ranking-table-tennis
Uninstallation
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
Using uv (recommended):
uv sync
Using pip (single user):
pip install --user --upgrade ranking-table-tennis
Usage
The commands must be run in a bash terminal. Use uv run ... if you have installed with uv.
-
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 (editable mode):
uv sync --group test
uv run pytest
Install with pip (editable mode):
pip install --editable ".[test]"
pytest
Update version at pyproject.toml and push it to github. We follow date versions like vYYYY.MM.DD
Once it is merged on master you must tag the commit so a github actions will be triggered to do the rest:
uv build
uv publish
1 maintainer
Metadata
1 maintainer
Release files for ranking_table_tennis 2026.5.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ranking_table_tennis-2026.5.21.tar.gz | 52.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ranking_table_tennis-2026.5.21-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 118.1 kB
Release files / ranking_table_tennis-2026.5.21.tar.gz
| Download URL | ranking_table_tennis-2026.5.21.tar.gz |
|---|---|
| Size | 52.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7610b0edcee90b9a77cba7bc4a8eebd7b411a9576e0d953b127727f1ee8dea5e
|
|
BLAKE2b-256 checksum How to use checksums |
4ce09fa19e37d9e2d6c3e5b0a1df6e46046f0abb62ffd53cd0ece5729f8d0f8c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / ranking_table_tennis-2026.5.21-py3-none-any.whl
| Download URL | ranking_table_tennis-2026.5.21-py3-none-any.whl |
|---|---|
| Size | 65.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8d45767746194bf6afbf5df7694488b4a7f72826bb08337f02c8d41deb4dbd6f
|
|
BLAKE2b-256 checksum How to use checksums |
9f2d0872f1690d547a0428d856428e73367dc190c691e74502fc079c95656348
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
