Skip to content

Commit

Permalink
Added build directory in docs back in
Browse files Browse the repository at this point in the history
  • Loading branch information
HarryShomer committed Dec 20, 2017
1 parent 14e361d commit cf8cc63
Show file tree
Hide file tree
Showing 37 changed files with 16,835 additions and 0 deletions.
Binary file added docs/build/doctrees/environment.pickle
Binary file not shown.
Binary file added docs/build/doctrees/hockey_scraper.doctree
Binary file not shown.
Binary file added docs/build/doctrees/index.doctree
Binary file not shown.
Binary file added docs/build/doctrees/license_link.doctree
Binary file not shown.
4 changes: 4 additions & 0 deletions docs/build/html/.buildinfo
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 09036852b3471979817369ae25cb8a8e
tags: 645f666f9bcd5a90fca523b33c5a78b7
174 changes: 174 additions & 0 deletions docs/build/html/_sources/hockey_scraper.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,174 @@
hockey_scraper
==============

The hockey_scraper module contains all of the functions used for scraping.

Scraping
--------

There are three ways to scrape games:

\1. *Scrape by Season*:

Scrape games on a season by season level (Note: A given season is referred to by the first of the two years it spans.
So you would refer to the 2016-2017 season as 2016).
::

import hockey_scraper

# Scrapes the 2015 & 2016 season with shifts and stores the data in a Csv file (both are equivalent!!!)
hockey_scraper.scrape_seasons([2015, 2016], True)
hockey_scraper.scrape_seasons([2015, 2016], True, data_format='Csv')

# Scrapes the 2008 season without shifts and returns a json string of the data
scraped_data = hockey_scraper.scrape_seasons([2008], False, data_format='Json')

# Scrapes 2014 season without shifts including preseason games
hockey_scraper.scrape_seasons([2014], False, preseason=True)

\2. *Scrape by Game*:

Scrape a list of games provided. All game ID's can be found using `this link
<https://statsapi.web.nhl.com/api/v1/schedule?startDate=2016-10-03&endDate=2017-06-20>`_
(you need to play around with the dates in the url).
::

import hockey_scraper

# Scrapes the first game of 2014, 2015, and 2016 seasons with shifts and stores the data in a Csv file
hockey_scraper.scrape_games([2014020001, 2015020001, 2016020001], True)

# Scrapes the first game of 2007, 2008, and 2009 seasons with shifts and returns a Json string of the data
scraped_data = hockey_scraper.scrape_games([2007020001, 2008020001, 2009020001], True, data_format='Json')

\3. *Scrape by Date Range*:

Scrape all games between a specified date range. All dates must be written in a "yyyy-mm-dd" format.
::

import hockey_scraper

# Scrapes all games between date range without shifts and stores the data in a Csv file (both are equivalent!!!)
hockey_scraper.scrape_date_range('2016-10-10', '2016-10-20', False)
hockey_scraper.scrape_date_range('2016-10-10', '2016-10-20', False, preseason=False)

# Scrapes all games between 2015-1-1 and 2015-1-15 without shifts and returns a Json string of the data
scraped_data = hockey_scraper.scrape_date_range('2015-1-1', '2015-1-15', False, data_format='Json')

# Scrapes all games from 2014-09-15 to 2014-11-01 with shifts including preseason games
hockey_scraper.scrape_date_range('2014-09-15', '2014-11-01', True, preseason=True)


**Notes**:

\1. For all three functions you must specify if you want to also scrape shifts (TOI tables) with a boolean. The Play by
Play is automatically scraped.

\2. When scraping by date range or by season, preseason games aren't scraped unless otherwise specified.

\3. For all three functions the scraped data is deposited into a Csv file unless it's specified to return it as a Json string.

\4. The Json string returned is structured like so:
::


# When scraping by game or date range
{
'pbp': [
Plays
],
'shifts': [
Shifts
]
}

# When scraping by season
{
'pbp': {
'Seasons': [
Plays
]
},
'shifts': {
'Seasons': [
Plays
]
}
}


# For example, if you scraped the 2008 and 2009 seasons the Json will look like this:
{
'pbp': {
'2008': [
Plays
],
'2009': [
Plays
]
},
'shifts': {
'2008': [
Shifts
],
'2009': [
Shifts
]
}
}



Functions
---------
.. _Functions:

Scrape Functions
~~~~~~~~~~~~~~~~
.. automodule:: hockey_scraper.scrape_functions
:members:

Game Scraper
~~~~~~~~~~~~
.. automodule:: hockey_scraper.game_scraper
:members:

Html PBP
~~~~~~~~
.. automodule:: hockey_scraper.html_pbp
:members:

Json PBP
~~~~~~~~
.. automodule:: hockey_scraper.json_pbp
:members:

Espn PBP
~~~~~~~~
.. automodule:: hockey_scraper.espn_pbp
:members:

Json Shifts
~~~~~~~~~~~
.. automodule:: hockey_scraper.json_shifts
:members:

Html Shifts
~~~~~~~~~~~
.. automodule:: hockey_scraper.html_shifts
:members:

Schedule
~~~~~~~~
.. automodule:: hockey_scraper.json_schedule
:members:

Playing Roster
~~~~~~~~~~~~~~
.. automodule:: hockey_scraper.playing_roster
:members:

Shared Functions
~~~~~~~~~~~~~~~~
.. automodule:: hockey_scraper.shared
:members:
21 changes: 21 additions & 0 deletions docs/build/html/_sources/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
Hockey-Scraper
==============

Contents
--------
.. toctree::
:maxdepth: 1

hockey_scraper
license_link


.. include:: ../../README.rst
:start-after: inclusion-marker-for-sphinx

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
1 change: 1 addition & 0 deletions docs/build/html/_sources/license_link.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
.. include:: ../../LICENSE.rst
Binary file added docs/build/html/_static/ajax-loader.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit cf8cc63

Please sign in to comment.