Metadata-Version: 1.2
Name: sportsreference
Version: 0.1.0
Summary: A free sports API written for python
Home-page: https://github.com/roclark/sportsreference
Author: Robert Clark
Author-email: robdclark@outlook.com
License: MIT
Description: Sportsreference: A free sports API written for python
        ######################################################
        .. image:: https://travis-ci.org/roclark/sportsreference.svg?branch=master
            :target: https://travis-ci.org/roclark/sportsreference
        .. image:: https://readthedocs.org/projects/sportsreference/badge/?version=latest
            :target: https://sportsreference.readthedocs.io/en/latest/?badge=latest
            :alt: Documentation Status
        
        .. contents::
        
        Sportsreference is a free python API that pulls the stats from
        www.sports-reference.com and allows them to be easily be used in python-based
        applications, especially ones involving data analytics and machine learning.
        
        Sportsreference exposes a plethora of sports information from major sports
        leagues in North America, such as the MLB, NBA, College Football and Basketball,
        NFL, and NHL. Every sport has its own set of valid API queries ranging from the
        list of teams in a league, to the date and time of a game, to the total number
        of wins a team has secured during the season, and many, many more metrics that
        paint a more detailed picture of how a team has performed during a game or
        throughout a season.
        
        Examples
        ========
        
        The following are a few examples showcasing how easy it can be to collect
        an abundance of metrics and information from all of the tracked leagues. The
        examples below are only a miniscule subset of the total number of statistics
        that can be pulled using sportsreference. Visit the documentation on
        `Read The Docs <http://sportsreference.readthedocs.io/en/latest/>`_ for a
        complete list of all information exposed by the API.
        
        Get instances of all NHL teams for the 2018 season
        --------------------------------------------------
        
        .. code-block:: python
        
            from sportsreference.nhl.teams import Teams
        
            teams = Teams(2018)
        
        Print every NBA team's name and abbreviation
        --------------------------------------------
        
        .. code-block:: python
        
            from sportsreference.nba.teams import Teams
        
            teams = Teams()
            for team in teams:
                print(team.name, team.abbreviation)
        
        Get a specific NFL team's season information
        --------------------------------------------
        
        .. code-block:: python
        
            from sportsreference.nfl.teams import Teams
        
            teams = Teams()
            lions = teams('DET')
        
        Print the date of every game for a NCAA Men's Basketball team
        -------------------------------------------------------------
        
        .. code-block:: python
        
            from sportsreference.ncaab.schedule import Schedule
        
            purdue_schedule = Schedule('purdue')
            for game in purdue_schedule:
                print(game.date)
        
        Print the number of interceptions by the away team in a NCAA Football game
        --------------------------------------------------------------------------
        
        .. code-block:: python
        
            from sportsreference.ncaaf.boxscore import Boxscore
        
            championship_game = Boxscore('2018-01-08-georgia')
            print(championship_game.away_interceptions)
        
        Get a Pandas DataFrame of all stats for a MLB game
        --------------------------------------------------
        
        .. code-block:: python
        
            from sportsreference.mlb.boxscore import Boxscore
        
            game = Boxscore('BOS201806070')
            df = game.dataframe
        
        Documentation
        =============
        
        Complete documentation is hosted on
        `readthedocs.org <http://sportsreference.readthedocs.io/en/latest>`_. Refer to
        the documentation for a full list of all metrics and information exposed by
        sportsreference. The documentation is auto-generated using Sphinx based on the
        docstrings in the sportsreference package.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
