Skip to main content

Python library to calculate standings for football and handball

Project description

Python library to calculate standings for football and handball

Getting Started

pip install standings

Alternatively: copy the standings package to your project.


Should work with Python 2.7 and up or 3. Possibly other versions (untested).


It’s best to see for reference.

Basic usage is as follows:

# Handball 3. Liga Herren, Saison 2015/16, 17. Spieltag
# Create ranking calculation oject with scope, sports type and mode

# add your matches / fixtures (upto desired match day or all)
t1.add_match(_Match('DHK Flensborg', 35551, 'SC Magdeburg II', 35561, 41, 23))
t1.add_match(_Match('SV Meck.-Schwerin', 35651, 'TS Großburgwedel', 35661, 26, 17))

tb = t1.get_table()
# tb is now the sorted table

_Match may be replaced with your own object but as a minimum requires a team name and id for both participiants and goals for the home and away team.

The module supports two modes for calculation: CALCULATION_MODE_GOAL_DIFFERENCE and CALCULATION_MODE_DIRECT_COMPARE. The first one uses points, followed by goal difference and then goals scored as sort order (as used in German Bundesliga for example).

CALCULATION_MODE_DIRECT_COMPARE will first sort by points, then the result of direct comparison between teams with equal points (often used in handball or the Spanish La Liga).


Some tests are supplied and can be run like this:

python -m unittest standings
python -m unittest standings.teampoint



This project is licensed under the MIT License - see the LICENSE.txt file for details

Project details

Release history Release notifications

This version


Download files

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

Files for standings, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size standings-1.0.4-py2.py3-none-any.whl (15.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size standings-1.0.4.tar.gz (9.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page