issamemari / selenium_tutorial

Tennis Booker

Tennis booker is a tool that automatically books a municipal tennis court in Paris.

How it works

Tennis Booker uses Selenium to interact with the tennis court booking website. It uses a headless Chrome browser to simulate a user booking a court. It runs multiple processes in parallel that constantly check whether the required court is available. When a court is available, it books it.

The ideal way to use this tool is to run it before going to sleep and set it to book a court for next week. When the new courts are made available at 8am, the booker will book the first available court that matches the criteria.

Configuring users

A list of usernames and passwords are stored in data.json. The booker requires that the user has bought a carnet of 10 tennis courts, otherwise it will not work as payment would be required.

Installation

Simply build the Docker image:

docker build -t booker .

Options

docker run booker --help
usage: main.py [-h] [--data DATA] [--tennis-facility TENNIS_FACILITY]
               [--location {indoor,outdoor}]
               [--surface-type {synthetique,beton_poreux}]
               [--court-id COURT_ID] [--username USERNAME] --date DATE --time
               TIME [--workers WORKERS] [--headless] [--logger-pretty]

optional arguments:
  -h, --help            show this help message and exit
  --data DATA
  --tennis-facility TENNIS_FACILITY
                        Name of the tennis facility. If not specified, all
                        tennis facilities will be considered.
  --location {indoor,outdoor}
                        Location (indoor or outdoor). If not specified, both
                        will be considered.
  --surface-type {synthetique,beton_poreux}
                        Surface type (synthetique or beton_poreux). If not
                        specified, both will be considered.
  --court-id COURT_ID   Court ID. If not specified, all courts will be
                        considered.
  --username USERNAME   Username. If not specified, all users will be used.
  --date DATE           format: 01/01/2022
  --time TIME           format: 08h
  --workers WORKERS
  --headless
  --logger-pretty

Example

Book an indoor court with synthetic surface on 24/09/2022 at 9pm using 16 workers from user [e-mail]:

docker run booker --date 24/09/2022 --time 21h --location indoor --surface-type synthetique --workers 16 --username [e-mail]

Supported Courts

Tennis Facility	Location	Surface Type	Court ID	Court Name
Elisabeth	Indoor	Béton poreux	1111	Court 6
Elisabeth	Indoor	Béton poreux	1112	Court 7
Elisabeth	Indoor	Synthétique	1113	Court 8
Elisabeth	Indoor	Synthétique	1114	Court 9

New facilities and courts can be added by modifying data.json.