valhook/tennis

Tennis Roster Generator

Tennis Roster Generator

Running the generator

Online

The latest public version is hosted on ValHook's GitHub.

Locally

To use it locally, you will need to serve it. All the logic runs in the browser; there is no backend.

The easiest way is to serve the site is by executing the following from the project's root directory:

python3 -m http.server

You can then visit your locally served website at http://localhost:8000.

Compiling

Dependencies

For Google APIs, used for exporting Google Sheets, you will need to pull in the following dependencies through npm:

npm install --save bootstrap @types/bootstrap @types/gapi @types/gapi.auth2 @types/gapi.client.sheets-v4

For compiling, you will need Typescript and a linter. To install them through npm, execute:

npm install -g typescript prettier

Writing changes

Write your changes in ts/ and compile them by executing:

./ts/compile.sh

While doesn't matter which directory you execute the shell script from, note that this script for Mac and Linux only. Windows users may want to use WSL.

This regenerates the ts/generated directory which the index.html page is configured to load.

tennis's Issues

Human-readable UI

The JSON output is great, but if you just want to follow the roster on the court, a human-readable version would be nice.

Use a previous roster as a template for a new one

Since entering all values is rather cumbersome, it would be nice to be able to create a new roster with values prefilled from an existing one (but still allowing the values to be adjusted).

Export to Google Sheets

Awesome that it generates machine readable JSON, but allowing it to export to Google Sheets would make it convenient in use.

Rosters should be permalinks so they can be shared

Currently, rosters must be generated each time as there doesn't appear to be any persistence. It would be nice to be able to share a link to the roster without it needing to be regenerated.

Allow inputs to be provided from a spreadsheet

It's cumbersome to enter all inputs through dialogs and it would be much more convenient to use a spreadsheet or CSV file as a template.

Allow editing of rosters

Sometimes you make a mistake when entering values. It would be nice to be able to adjust the inputs after creating a roster.

Preferential matching based on skill level

Sometimes you end up playing singles against a really good player, or doubles where it's unbalanced in terms of skill level. Perhaps optimale, players can have a skill level value to optimize pairing?