Skip to main content

A menu-driven console-based application for analyzing NHL hockey games.

Project description


A menu-driven console-based application for analyzing NHL hockey games.


This app was created to assist with making hockey pics for a so-called 'confidence pool' (such as this NHL Pick 'Em Pool), where a pool participant must pick the outcome of several games and rank them in order of how confident they are that the chosen team in each matchup will win.


  • Python >= 3.6
  • decorest
  • ansicolors


pip install hockeyjockey


from hockeyjockey import Jockey

# hockeyjockey will automatically download stats and games from the internet
jockey = Jockey()

# you can choose to load the cached copy of games and stats data from disk
# by answering the prompts
jockey = Jockey(suppress_prompt=False)


When hockeyjockey first loads, you will be given the option to load NHL statistics and games which have been cached to disk. If the local cache does not exist, or you elect not to use cached data, new data will be fetched from the internet.

The default is to fetch hockey games for the closest Friday and Saturday.

Games Menu

  1. Load Today's Games - Loads the NHL games that are taking place today into memory.
  2. Load Upcoming Friday/Saturday - If today is a Friday or Saturday, loads the current Friday/Saturday's games, otherwise loads next weekend's Friday/Saturday games.
  3. Load Custom Date Range - Prompts for a start and end date and loads the games between those dates inclusive.
  4. Print Games - Echoes the currently loaded games to the console.

Teams Menu

  1. Print Teams - Prints a list of the NHL teams in alphabetical order.

Stats Menu

  1. Reload Stats - Fetches a fresh copy of the latest NHL statistics for all teams and stores it in memory. The stats stored in memory are the basis for hockeyjockey's ranking analysis.
  2. Rank Games by Single Statistic - Requires that a set of NHL games and statistics have been loaded. This option provides the main purpose for hockeyjockey - ranking a set of NHL games by a single stat which is chosen from the stats provided. For example, if the user of the program chooses 'wins', hockey jockey will output a list of games with the team with the most wins in each matchup highlighted green. The amplitude difference between the team with the greater number of wins and the team with the lesser number of wins is the key on which the games are ranked.
  3. Rank Games by All Statistics - The same as the above option, but will rank the games by every statistic in memory.
  4. Print Stats - Echoes the currently loaded NHL statistics for all teams to the console.


Special thanks to Drew Hynes for documenting the NHL Stats API, here.



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

hockeyjockey-1.2.tar.gz (15.3 kB view hashes)

Uploaded source

Built Distribution

hockeyjockey-1.2-py3-none-any.whl (32.2 kB view hashes)

Uploaded py3

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