Skip to main content

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.

  1. 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).

  2. 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.

  3. 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.

  4. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ranking_table_tennis-2024.8.12.tar.gz (40.4 kB view details)

Uploaded Source

Built Distribution

ranking_table_tennis-2024.8.12-py3-none-any.whl (56.2 kB view details)

Uploaded Python 3

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

Hashes for ranking_table_tennis-2024.8.12.tar.gz
Algorithm Hash digest
SHA256 2c3db122f93c94e9cc6f8e9354fe809bf1034c2d63a899767e846cb7f7df265b
MD5 2018a5870d5342178e6ae4a02106a445
BLAKE2b-256 e38ebdeebe0e068f85ea949b5565bfb80a78ad64f6b83fe975c55e86e97ff4a8

See more details on using hashes here.

File details

Details for the file ranking_table_tennis-2024.8.12-py3-none-any.whl.

File metadata

File hashes

Hashes for ranking_table_tennis-2024.8.12-py3-none-any.whl
Algorithm Hash digest
SHA256 ddfa04a27e0fb75f234008a93169d39dd1f2d559374c4a3ad43691261120cad5
MD5 e23b17db932fedf570c7947427175a68
BLAKE2b-256 dbdbdf0b76fcb7e64c4446e00038f7d829f5e5060c8c47f7a74db4bda1fa5059

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page