sportrefpy 0.1.8

pull sports stats

SPORTREFPY

Sportrefpy is package that pulls data from the Sports-Reference family of sites. Currently, only NBA is working but NHL, NFL, MLB, and College Basketball and Football will be supported as soon as possible.

Installation

pip install sportrefpy

Usage

Below are some examples for ways that you can use Sports Stats.

Initialize a league, team, and player

from sportrefpy.nba.league import NBA
from sportrefpy.nba.team import NBAFranchise
from sportrefpy.nba.player import NBAPlayer

nba = NBA()
phi = NBAFranchise('PHI')
the_answer = NBAPlayer('Allen Iverson')

Print out Franchise Codes (needed for initializing a team)

from sportrefpy.nba.league import NBA

nba = NBA()
nba.franchise_codes()

Find the career totals (regular + playoffs) of a specific player

from sportrefpy.nba.player import NBAPlayer

# For all stats
king = NBAPlayer('LeBron James')
king.career_totals()

# For a specific stats
beard = NBAPlayer('James Harden')
beard.career_totals(stats=['PTS', 'G'])

• stats is None by default. If provide, it must be a list even if only using 1.

Compare players stat totals

from sportrefpy.nba.analysis import compare_players

showtime = compare_players(["Shaquille O'Neal", "Kobe Bryant"], 
                            stats=['PTS', 'TRB'],
                            total='career')

• stats must be a list, with as many stats as you'd like. Required.
• total defaults to 'career', but can also be 'post' or 'reg'.

Compare Franchise W/L records

from sportrefpy.nba.analysis import compare_franchises

compare_franchises(['NYK', 'BOS'])

• must be a list of teams, even if only using 1.

Get stats of players/coaches for a specific Franchise

from sportrefpy.nba.team import NBAFranchise

# Players
bulls = NBAFranchise('CHI')

# All players that have ever played for the team
bulls.players_all_time_stats()

# Or just the GOAT
bulls.players_all_time_stats('Michael Jordan')


# Coaches
spurs = NBAFranchise('SAS')

# All coaches that have ever coached the team
spurs.coaches_all_time_data()

# Or just Pop
spurs.coaches_all_time_data('Gregg Popovich')

Get roster for a given season

from sportrefpy.nba.team import NBAFranchise

warriors = NBAFranchise('GSW')
warriors.roster(2016)

• use integer year that season ends in. This example returns the 2015-16 Golden State Warriors.