nba_stats 0.9.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in nba_stats.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 TODO: Write your name
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+# NbaStats
+
+A ruby interface for the NBA.com stats JSON API.
+
+## Author
+
+https://twitter.com/dagrz
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'nba_stats'
+
+## Usage
+
+To get started, create a new client:
+
+    require 'nba_stats'
+
+    client = NbaStats::Client.new
+
+Use the client to call a function, which returns a resource:
+
+    my_resource = client.an_nba_stats_function
+
+Get the result set array you want to use:
+
+    my_result_set = my_resource.a_resource_result_set
+
+Get a row from the result set:
+
+    my_row = my_result_set[0]
+
+Get an item value from the row:
+
+    my_item = my_row[:an_item_name]
+
+List of available functions:
+
+    # client.
+    scoreboard
+    box_score
+    box_score_four_factors
+    box_score_usage
+    box_score_scoring
+    box_score_misc
+    box_score_advanced
+    common_all_players
+    common_player_info
+    player_profile
+    player_career_stats
+    team_info_common
+    common_team_roster
+    team_game_log
+    team_year_by_year_stats
+    common_team_years
+    franchise_history
+    shot_chart_detail
+    play_by_play
+    league_dash_lineups
+    league_dash_player_stats
+    home_page_leaders
+    draft_combine_player_anthro
+    draft_combine_drill_results
+    draft_combine_non_stationary_shooting
+    draft_combine_spot_shooting
+    draft_combine_stats

data/Rakefile

@@ -0,0 +1,45 @@
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+require 'nba_stats'
+require 'nba_stats/discovery/discovery'
+desc 'Discover an NBA.com stats API endpoint'
+task :discover do
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/scoreboard?LeagueID=00&gameDate=03%2F05%2F2014&DayOffset=0&date=Wed+Mar+05+2014+00%3A00%3A00+GMT%2B1100+(EST)')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/boxscore?GameID=0021300904&RangeType=0&StartPeriod=0&EndPeriod=0&StartRange=0&EndRange=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/commonallplayers?LeagueID=00&Season=2013-14&IsOnlyCurrentSeason=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/commonplayerinfo?PlayerID=201567&SeasonType=Regular+Season&LeagueID=00')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/playerprofile?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&PlayerID=201567&GraphStartSeason=2008-09&GraphEndSeason=2014-15&GraphStat=PTS')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/teaminfocommon?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&TeamID=1610612746')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/commonteamroster?Season=2013-14&LeagueID=00&TeamID=1610612746')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/teamgamelog?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&TeamID=1610612746')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/teamyearbyyearstats?LeagueID=00&PerMode=Totals&SeasonType=Regular+Season&TeamID=1610612755&Season=2013-14')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/commonteamyears?LeagueID=00')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/shotchartdetail?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&TeamID=1610612755&PlayerID=0&GameID=&Outcome=&Location=&Month=0&SeasonSegment=&DateFrom=&DateTo=&OpponentTeamID=0&VsConference=&VsDivision=&Position=&RookieYear=&GameSegment=&Period=0&LastNGames=0&ContextFilter=&ContextMeasure=FG_PCT')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/playbyplay?GameID=0021300901&StartPeriod=0&EndPeriod=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/boxscorefourfactors?GameID=0021300901&RangeType=0&StartPeriod=0&EndPeriod=0&StartRange=0&EndRange=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/boxscoreusage?GameID=0021300901&RangeType=0&StartPeriod=0&EndPeriod=0&StartRange=0&EndRange=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/boxscorescoring?GameID=0021300901&RangeType=0&StartPeriod=0&EndPeriod=0&StartRange=0&EndRange=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/boxscoremisc?GameID=0021300901&RangeType=0&StartPeriod=0&EndPeriod=0&StartRange=0&EndRange=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/boxscoreadvanced?GameID=0021300901&RangeType=0&StartPeriod=0&EndPeriod=0&StartRange=0&EndRange=0')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/leaguedashlineups?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&TeamID=&MeasureType=Base&PerMode=PerGame&PlusMinus=N&PaceAdjust=N&Rank=N&Outcome=&Location=&Month=0&SeasonSegment=&DateFrom=&DateTo=&OpponentTeamID=0&VsConference=&VsDivision=&GameSegment=&Period=0&LastNGames=0&GroupQuantity=5&GameScope=&PlayerExperience=&PlayerPosition=&StarterBench=')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/leaguedashplayerstats?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&MeasureType=Base&PerMode=PerGame&PlusMinus=N&PaceAdjust=N&Rank=N&Outcome=&Location=&Month=0&SeasonSegment=&DateFrom=&DateTo=&OpponentTeamID=0&VsConference=&VsDivision=&GameSegment=&Period=0&LastNGames=0&GameScope=&PlayerExperience=&PlayerPosition=&StarterBench=&Conf=Both')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/playercareerstats?PlayerID=201609&LeagueID=00&PerMode=Totals')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/homepageleaders?Season=2013-14&SeasonType=Playoffs&LeagueID=00&GameScope=Season&StatCategory=Points&PlayerScope=All+Players&PlayerOrTeam=Team')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/franchisehistory?LeagueID=00')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/draftcombineplayeranthro?LeagueID=00&SeasonYear=2014-15')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/draftcombinedrillresults?LeagueID=00&SeasonYear=2014-15')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/draftcombinenonstationaryshooting?LeagueID=00&SeasonYear=2014-15')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/draftcombinespotshooting?LeagueID=00&SeasonYear=2014-15')
+  puts NbaStats::Discovery.discover('http://stats.nba.com/stats/draftcombinestats?LeagueID=00&SeasonYear=2014-15')
+
+  # These are non standard in some way
+  # puts NbaStats::Discovery.discover('http://stats.nba.com/stats/videoevents?LeagueID=00&Season=2012-13&SeasonType=Regular+Season&TeamID=0&PlayerID=0&GameID=0021300901&Outcome=&Location=&Month=0&SeasonSegment=&DateFrom=&DateTo=&OpponentTeamID=0&VsConference=&VsDivision=&Position=&RookieYear=&GameSegment=&Period=0&LastNGames=0&ClutchTime=&AheadBehind=&PointDiff=&RangeType=1&StartPeriod=1&EndPeriod=10&StartRange=0&EndRange=0&ContextFilter=&ContextMeasure=FG_PCT&GameEventID=4')
+  # puts NbaStats::Discovery.discover('http://stats.nba.com/stats/leaguedashteamstats?Season=2013-14&AllStarSeason=2013-14&SeasonType=All+Star&LeagueID=00&MeasureType=Base&PerMode=Totals&PlusMinus=N&PaceAdjust=N&Rank=N&Outcome=&Location=&Month=0&SeasonSegment=&DateFrom=&DateTo=&OpponentTeamID=0&VsConference=&VsDivision=&GameSegment=&Period=0&LastNGames=0&GameScope=&PlayerExperience=&PlayerPosition=&StarterBench=')
+  # puts NbaStats::Discovery.discover('http://stats.nba.com/stats/leaderstiles?Season=2013-14&SeasonType=Regular+Season&LeagueID=00&Stat=REB&PlayerOrTeam=Player&GameScope=Season&PlayerScope=All+Players')
+  # puts NbaStats::Discovery.discover('http://stats.nba.com/stats/leagueleaders?LeagueID=00&PerMode=PerGame&StatCategory=PTS&Season=All+Time&SeasonType=Regular+Season&Scope=S')
+end
+
+

data/lib/nba_stats/client.rb

@@ -0,0 +1,135 @@
+require 'rest_client'
+require 'addressable/uri'
+require 'nba_stats/configuration'
+require 'nba_stats/stats/scoreboard'
+require 'nba_stats/stats/box_score'
+require 'nba_stats/stats/common_all_players'
+require 'nba_stats/stats/common_player_info'
+require 'nba_stats/stats/player_profile'
+require 'nba_stats/stats/team_info_common'
+require 'nba_stats/stats/common_team_roster'
+require 'nba_stats/stats/team_game_log'
+require 'nba_stats/stats/team_year_by_year_stats'
+require 'nba_stats/stats/common_team_years'
+require 'nba_stats/stats/shot_chart_detail'
+require 'nba_stats/stats/play_by_play'
+require 'nba_stats/stats/box_score_four_factors'
+require 'nba_stats/stats/box_score_usage'
+require 'nba_stats/stats/box_score_scoring'
+require 'nba_stats/stats/box_score_misc'
+require 'nba_stats/stats/box_score_advanced'
+require 'nba_stats/stats/league_dash_lineups'
+require 'nba_stats/stats/league_dash_player_stats'
+require 'nba_stats/stats/player_career_stats'
+require 'nba_stats/stats/home_page_leaders'
+require 'nba_stats/stats/franchise_history'
+require 'nba_stats/stats/draft_combine_player_anthro'
+require 'nba_stats/stats/draft_combine_drill_results'
+require 'nba_stats/stats/draft_combine_non_stationary_shooting'
+require 'nba_stats/stats/draft_combine_spot_shooting'
+require 'nba_stats/stats/draft_combine_stats'
+require 'nba_stats/errors'
+
+module NbaStats
+
+  class Client
+
+    include NbaStats::Scoreboard
+    include NbaStats::BoxScore
+    include NbaStats::CommonAllPlayers
+    include NbaStats::CommonPlayerInfo
+    include NbaStats::PlayerProfile
+    include NbaStats::TeamInfoCommon
+    include NbaStats::CommonTeamRoster
+    include NbaStats::TeamGameLog
+    include NbaStats::TeamYearByYearStats
+    include NbaStats::CommonTeamYears
+    include NbaStats::ShotChartDetail
+    include NbaStats::PlayByPlay
+    include NbaStats::BoxScoreFourFactors
+    include NbaStats::BoxScoreUsage
+    include NbaStats::BoxScoreScoring
+    include NbaStats::BoxScoreMisc
+    include NbaStats::BoxScoreAdvanced
+    include NbaStats::LeagueDashLineups
+    include NbaStats::LeagueDashPlayerStats
+    include NbaStats::PlayerCareerStats
+    include NbaStats::HomePageLeaders
+    include NbaStats::FranchiseHistory
+    include NbaStats::DraftCombinePlayerAnthro
+    include NbaStats::DraftCombineDrillResults
+    include NbaStats::DraftCombineNonStationaryShooting
+    include NbaStats::DraftCombineSpotShooting
+    include NbaStats::DraftCombineStats
+
+    # Define the same set of accessors as the Awesome module
+    attr_accessor *Configuration::VALID_CONFIG_KEYS
+
+    # Initialize a new Client object
+    #
+    # @param options [Hash]
+    # @return [NbaStats::Client]
+    def initialize(options={})
+      # Merge the config values from the module and those passed
+      # to the client.
+      merged_options = NbaStats.options.merge(options)
+
+      # Copy the merged values to this client and ignore those
+      # not part of our configuration
+      Configuration::VALID_CONFIG_KEYS.each do |key|
+        send("#{key}=", merged_options[key])
+      end
+    end
+
+    # @return [Hash]
+    def request_headers
+      @request_headers ||= {
+          :accept => accept,
+          :user_agent => user_agent
+      }
+    end
+
+    # Perform a HTTP GET request
+    #
+    # @param path [String]
+    # @param params [Hash]
+    # @return [Hash]
+    def get(path='/', params={})
+      uri = Addressable::URI.new
+      uri.query_values = params
+      full_path = "#{path}?#{uri.query}"
+      request(:get, full_path)
+    end
+
+    private
+
+      # @return [RestClient::Resource]
+      def resource
+        @resource ||= RestClient::Resource.new(endpoint)
+      end
+
+      # Send the HTTP request
+      #
+      # @param method [String]
+      # @param path [String]
+      # @return [RestClient::Response]
+      def request(method, path)
+        resource[path].send(method.to_sym, request_headers) { |response, request, result, &block|
+          case response.code
+            when 200
+              response
+            when 400
+              if response.include? ' is required'
+                raise ArgumentError.new(response)
+              else
+                raise BadRequestError.new(response)
+              end
+            else
+              response.return!(request, result, &block)
+          end
+        }
+      end
+
+  end # Client
+
+end

data/lib/nba_stats/configuration.rb

@@ -0,0 +1,37 @@
+module NbaStats
+
+  module Configuration
+    VALID_CONNECTION_KEYS = [:endpoint].freeze
+    VALID_OPTIONS_KEYS    = [:user_agent, :accept].freeze
+    VALID_CONFIG_KEYS     = VALID_CONNECTION_KEYS + VALID_OPTIONS_KEYS
+
+    DEFAULT_ENDPOINT    = 'http://stats.nba.com'
+    DEFAULT_USER_AGENT  = "nba_stats/#{NbaStats::VERSION} ruby gem (https://github.com/dagrz/nba_stats)"
+    DEFAULT_ACCEPT      = 'application/json'
+
+    # Build accessor methods for every config options so we can do this
+    attr_accessor *VALID_CONFIG_KEYS
+
+    # Make sure we have the default values set when we get 'extended'
+    def self.extended(base)
+      base.reset
+    end
+
+    # Reset all options to default values
+    def reset
+      self.endpoint   = DEFAULT_ENDPOINT
+      self.user_agent = DEFAULT_USER_AGENT
+      self.accept     = DEFAULT_ACCEPT
+    end
+
+    def configure
+      yield self
+    end
+
+    def options
+      Hash[ * VALID_CONFIG_KEYS.map { |key| [key, send(key)] }.flatten ]
+    end
+
+  end # Configuration
+
+end

data/lib/nba_stats/constants.rb

@@ -0,0 +1,96 @@
+module NbaStats
+
+  module Constants
+    LEAGUE_ID_NBA                   = '00'
+    LEAGUE_ID_WNBA                  = '10'
+    LEAGUE_ID_DLEAGUE               = '20'
+    SEASON_TYPE_REGULAR             = 'Regular Season'
+    SEASON_TYPE_PLAYOFFS            = 'Playoffs'
+    SEASON_TYPE_ALL_STAR            = 'All Star'
+    SEASON_SEGMENT_PRE_ALL_STAR     = 'Pre All-Star'
+    SEASON_SEGMENT_POST_ALL_STAR    = 'Post All-Star'
+    GRAPH_STAT_POINTS               = 'PTS'
+    SEASON_FIRST                    = '1946-47'
+    PER_MODE_TOTALS                 = 'Totals'
+    PER_MODE_GAME                   = 'PerGame'
+    PER_MODE_MINUTES_PER            = 'MinutesPer'
+    PER_MODE_48_MINUTES             = 'Per48'
+    PER_MODE_40_MINUTES             = 'Per40'
+    PER_MODE_36_MINUTES             = 'Per36'
+    PER_MODE_MINUTE                 = 'PerMinute'
+    PER_MODE_POSSESSION             = 'PerPossession'
+    PER_MODE_PLAY                   = 'PerPlay'
+    PER_MODE_100_POSSESSIONS        = 'Per100Possessions'
+    PER_MODE_100_PLAYS              = 'Per100Plays'
+    CONTEXT_MEASURE_FGM             = 'FGM'
+    CONTEXT_MEASURE_FGA             = 'FGA'
+    CONTEXT_MEASURE_FG_PCT          = 'FG_PCT'
+    CONTEXT_MEASURE_FG3M            = 'FG3M'
+    CONTEXT_MEASURE_FG3A            = 'FG3A'
+    CONTEXT_MEASURE_FG3_PCT         = 'FG3_PCT'
+    CONTEXT_MEASURE_PF              = 'PF'
+    CONTEXT_MEASURE_EFG_PCT         = 'EFG_PCT'
+    CONTEXT_MEASURE_TS_PCT          = 'TS_PCT'
+    CONTEXT_MEASURE_PTS_FB          = 'PTS_FB'
+    CONTEXT_MEASURE_PTS_OFF_TOV     = 'PTS_OFF_TOV'
+    CONTEXT_MEASURE_PTS_2ND_CHANCE  = 'PTS_2ND_CHANCE'
+    LOCATION_HOME                   = 'Home'
+    LOCATION_ROAD                   = 'Road'
+    OUTCOME_WIN                     = 'W'
+    OUTCOME_LOSS                    = 'L'
+    VS_CONFERENCE_EAST              = 'East'
+    VS_CONFERENCE_WEST              = 'West'
+    VS_DIVISION_ATLANTIC            = 'Atlantic'
+    VS_DIVISION_CENTRAL             = 'Central'
+    VS_DIVISION_NORTH_WEST          = 'Northwest'
+    VS_DIVISION_PACIFIC             = 'Pacific'
+    VS_DIVISION_SOUTH_EAST          = 'Southeast'
+    VS_DIVISION_SOUTH_WEST          = 'Southwest'
+    VS_DIVISION_EAST                = 'East'
+    VS_DIVISION_WEST                = 'West'
+    POSITION_GUARD                  = 'Guard'
+    POSITION_CENTER                 = 'Center'
+    POSITION_FORWARD                = 'Forward'
+    GAME_SEGMENT_FIRST_HALF         = 'First Half'
+    GAME_SEGMENT_SECOND_HALF        = 'Overtime'
+    GAME_SEGMENT_OVERTIME           = 'Second Half'
+    MEASURE_TYPE_BASE               = 'Base'
+    MEASURE_TYPE_ADVANCED           = 'Advanced'
+    MEASURE_TYPE_MISC               = 'Misc'
+    MEASURE_TYPE_FOUR_FACTORS       = 'Four Factors'
+    MEASURE_TYPE_SCORING            = 'Scoring'
+    MEASURE_TYPE_OPPONENT           = 'Opponent'
+    YES                             = 'Y'
+    NO                              = 'N'
+    GAME_SCOPE_SEASON               = 'Season'
+    GAME_SCOPE_YESTERDAY            = 'Yesterday'
+    GAME_SCOPE_LAST_10              = 'Last 10'
+    PLAYER_EXPERIENCE_ROOKIE        = 'Rookie'
+    PLAYER_EXPERIENCE_SOPHOMORE     = 'Sophomore'
+    PLAYER_EXPERIENCE_VETERAN       = 'Veteran'
+    STARTER_BENCH_STARTERS          = 'Starters'
+    STARTER_BENCH_BENCH             = 'Bench'
+    PLAYER_POSITION_FORWARD         = 'F'
+    PLAYER_POSITION_CENTER          = 'C'
+    PLAYER_POSITION_GUARD           = 'G'
+    PLAYER_POSITION_CENTER_FORWARD  = 'C-F'
+    PLAYER_POSITION_FORWARD_CENTER  = 'F-C'
+    PLAYER_POSITION_FORWARD_GUARD   = 'F-G'
+    PLAYER_POSITION_GUARD_FORWARD   = 'G-F'
+    CONF_BOTH                       = 'Both'
+    PLAYER_OR_TEAM_PLAYER           = 'Player'
+    PLAYER_OR_TEAM_TEAM             = 'Team'
+    PLAYER_SCOPE_ALL_PLAYERS        = 'All Players'
+    PLAYER_SCOPE_ROOKIES            = 'Rookies'
+    STAT_CATEGORY_POINTS            = 'Points'
+    STAT_CATEGORY_REBOUNDS          = 'Rebounds'
+    STAT_CATEGORY_ASSISTS           = 'Assists'
+    STAT_CATEGORY_DEFENSE           = 'Defense'
+    STAT_CATEGORY_CLUTCH            = 'Clutch'
+    STAT_CATEGORY_PLAYMAKING        = 'Playmaking'
+    STAT_CATEGORY_EFFICIENCY        = 'Efficiency'
+    STAT_CATEGORY_FAST_BREAK        = 'Fast Break'
+    STAT_CATEGORY_SCORING_BREAKDOWN = 'Scoring Breakdown'
+  end
+
+end

data/lib/nba_stats/discovery/discovery.rb

@@ -0,0 +1,193 @@
+require 'addressable/uri'
+require 'nba_stats/client'
+
+module NbaStats
+
+  module Discovery
+
+    # Given a full API call URI, generates template resource and stats classes
+    #
+    # @param discovery_uri [String]
+    # @return [String]
+    def self.discover(discovery_uri)
+      uri = Addressable::URI.parse(discovery_uri)
+      client = NbaStats::Client.new
+
+      output = ''
+      output += "Discovering #{class_name(uri.path).upcase}\n"
+      output += "------------------------------------------------\n"
+      output += "Path: #{uri.path}\n"
+      begin
+        client.get(uri.path, {})
+      rescue Exception => e
+        output += "Required parameters: #{e.message}\n"
+      end
+      
+      uri.query_values.each do |key, value|
+        output += "#{key.underscore}=#{value}, "
+      end
+      output += "\n"
+
+      json = JSON.parse(client.get(uri.path, uri.query_values))
+      result_sets = json['resultSets']
+
+      output += stats(uri)
+      output += "\n"
+      output += resources(uri, result_sets)
+      output += "\n"
+      output += spec(uri)
+      output += "\n"
+      output
+    end
+
+    # Returns a best guess at the potential api name given a path
+    #
+    # @param path [String]
+    # @return [String]
+    def self.class_name(path)
+      path.split('/').last
+    end
+
+    # Generates a rough stats ruby file for the api call
+    #
+    # @param uri [String]
+    # @return [String]
+    def self.stats(uri)
+      output = "------------------------------------------------\n"
+      output += "/nba_stats/stats/#{class_name(uri.path)}.rb\n"
+      output += "------------------------------------------------\n"
+      output += "require 'nba_stats/resources/#{class_name(uri.path)}'
+
+module NbaStats
+
+  module #{class_name(uri.path)}
+
+    # The path of the #{class_name(uri.path)} API
+    #{class_name(uri.path).upcase}_PATH   = '#{uri.path}'
+
+    # Calls the #{class_name(uri.path)} API and returns a #{class_name(uri.path)} resource.
+    #
+"
+      uri.query_values.each do |key, value|
+        output += "    # @param #{key.underscore} [xxxxxxxxxx]\n"
+      end
+      output+="    # @return [NbaStats::Resources::#{class_name(uri.path)}]
+    def #{class_name(uri.path)}(\n"
+      uri.query_values.each do |key, value|
+        output += "        #{key.underscore}=#{value},\n"
+      end
+      output += "    )
+      NbaStats::Resources::#{class_name(uri.path)}.new(
+          get(#{class_name(uri.path).upcase}_PATH, {
+"
+      uri.query_values.each do |key, value|
+        output += "              :#{key} => #{key.underscore},\n"
+      end
+      output += "          })
+      )
+    end
+
+  end # #{class_name(uri.path)}
+
+end
+"
+      output += '------------------------------------------------'
+      output
+    end
+
+    # Generates a rough resource ruby file for the api call
+    #
+    # @param uri [String]
+    # @param result_sets [Array]
+    # @return [String]
+    def self.resources(uri, result_sets)
+      output = "------------------------------------------------\n"
+      output += "/nba_stats/resources/#{class_name(uri.path)}.rb\n"
+      output += "------------------------------------------------\n"
+
+      output += "require 'nba_stats/resources/resource_base'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module Resources
+
+    class #{class_name(uri.path)} < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [\n"
+
+      result_sets.each do |result_set|
+        output += "          :#{result_set['name'].underscore},"
+        output += "    #"
+        result_set['headers'].each do |h|
+          output += ":#{h.underscore}, "
+        end
+        output += "\n"
+      end
+
+      output +="      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # #{class_name(uri.path)}
+
+  end
+
+end\n"
+      output += '------------------------------------------------'
+      output
+    end
+
+    # Generates a rough spec ruby file for the api call
+    #
+    # @param uri [String]
+    # @return [String]
+    def self.spec(uri)
+      output = "------------------------------------------------\n"
+      output += "/spec/client/#{class_name(uri.path)}_spec.rb\n"
+      output += "------------------------------------------------\n"
+
+      output += "require 'spec_helper'
+
+describe 'NbaStats' do
+
+  describe 'client' do
+    client = NbaStats::Client.new
+
+    describe '.#{class_name(uri.path)}' do
+      #{class_name(uri.path)} = client.#{class_name(uri.path)}("
+
+      uri.query_values.each do |key, value|
+        output += "#{value}, "
+      end
+
+      output += ")
+      it 'should return a #{class_name(uri.path)} resource' do
+        expect(#{class_name(uri.path)}).to be_a NbaStats::Resources::#{class_name(uri.path)}
+      end
+      it 'should be named #{class_name(uri.path)}' do
+        expect(#{class_name(uri.path)}.name).to eq '#{class_name(uri.path)}'
+      end
+      NbaStats::Resources::#{class_name(uri.path)}::VALID_RESULT_SETS.each do |valid_result_set|
+        describe \".\#{valid_result_set}\" do
+          it 'should return an Array' do
+            expect(#{class_name(uri.path)}.send(valid_result_set)).to be_a Array
+          end
+        end
+      end
+    end # .#{class_name(uri.path)}
+
+  end # client
+
+end\n"
+      output += '------------------------------------------------'
+      output
+    end
+
+  end # Discovery
+
+end

data/lib/nba_stats/errors.rb

@@ -0,0 +1,9 @@
+module NbaStats
+
+  class BadRequestError < StandardError
+  end
+
+  class BadResponseError < StandardError
+  end
+
+end

data/lib/nba_stats/helper.rb

@@ -0,0 +1,10 @@
+class String
+  def underscore
+    self.gsub(/::/, '/').
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr("-", "_").
+        downcase
+  end
+end
+

data/lib/nba_stats/resources/box_score.rb

@@ -0,0 +1,35 @@
+require 'nba_stats/resources/resource_base'
+
+module NbaStats
+
+  module Resources
+
+    class BoxScore < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [
+          :game_summary,      # :game_date_est, :game_sequence, :game_id, :game_status_id, :game_status_text, :gamecode, :home_team_id, :visitor_team_id, :season, :live_period, :live_pc_time, :natl_tv_broadcaster_abbreviation, :live_period_time_bcast, :wh_status
+          :line_score,        # :game_date_est, :game_sequence, :game_id, :team_id, :team_abbreviation, :team_city_name, :team_wins_losses, :pts_qtr1, :pts_qtr2, :pts_qtr3, :pts_qtr4, :pts_ot1, :pts_ot2, :pts_ot3, :pts_ot4, :pts_ot5, :pts_ot6, :pts_ot7, :pts_ot8, :pts_ot9, :pts_ot10, :pts
+          :season_series,     # :game_id, :home_team_id, :visitor_team_id, :game_date_est, :home_team_wins, :home_team_losses, :series_leader
+          :last_meeting,      # :game_id, :last_game_id, :last_game_date_est, :last_game_home_team_id, :last_game_home_team_city, :last_game_home_team_name, :last_game_home_team_abbreviation, :last_game_home_team_points, :last_game_visitor_team_id, :last_game_visitor_team_city, :last_game_visitor_team_name, :last_game_visitor_team_city1, :last_game_visitor_team_points
+          :player_stats,      # :game_id, :team_id, :team_abbreviation, :team_city, :player_id, :player_name, :start_position, :comment, :min, :fgm, :fga, :fg_pct, :fg3_m, :fg3_a, :fg3_pct, :ftm, :fta, :ft_pct, :oreb, :dreb, :reb, :ast, :stl, :blk, :to, :pf, :pts, :plus_minus
+          :team_stats,        # :game_id, :team_id, :team_name, :team_abbreviation, :team_city, :min, :fgm, :fga, :fg_pct, :fg3_m, :fg3_a, :fg3_pct, :ftm, :fta, :ft_pct, :oreb, :dreb, :reb, :ast, :stl, :blk, :to, :pf, :pts, :plus_minus
+          :other_stats,       # :league_id, :season_id, :team_id, :team_abbreviation, :team_city, :pts_paint, :pts_2_nd_chance, :pts_fb, :largest_lead, :lead_changes, :times_tied
+          :officials,         # :official_id, :first_name, :last_name, :jersey_num
+          :game_info,         # :game_date, :attendance, :game_time
+          :inactive_players,  # :player_id, :first_name, :last_name, :jersey_num, :team_id, :team_city, :team_name, :team_abbreviation
+          :available_video,   # :game_id, :video_available_flag, :pt_available
+          :player_track,      # :game_id, :team_id, :team_abbreviation, :team_city, :player_id, :player_name, :start_position, :comment, :min, :spd, :dist, :orbc, :drbc, :rbc, :tchs, :sast, :ftast, :pass, :ast, :cfgm, :cfga, :cfg_pct, :ufgm, :ufga, :ufg_pct, :fg_pct, :dfgm, :dfga, :dfg_pct
+          :player_track_team  # :game_id, :team_id, :team_nickname, :team_abbreviation, :team_city, :min, :dist, :orbc, :drbc, :rbc, :tchs, :sast, :ftast, :pass, :ast, :cfgm, :cfga, :cfg_pct, :ufgm, :ufga, :ufg_pct, :fg_pct, :dfgm, :dfga, :dfg_pct
+      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # BoxScore
+
+  end
+
+end