nba_stats 0.9.0

data/lib/nba_stats/resources/resource_base.rb

@@ -0,0 +1,86 @@
+require 'nba_stats/helper'
+require 'nba_stats/errors'
+
+module NbaStats
+
+  module Resources
+
+    class ResourceBase
+
+      attr_reader :json, :name, :params, :result_sets
+
+      # Initialize a new ResourceBase object
+      #
+      # @param resource_json [String]
+      # @return [NbaStats::Resources::ResourceBase]
+      def initialize(resource_json)
+        @json = JSON.parse(resource_json)
+        parse_base
+      end
+
+      # Provide the object JSON as a pretty printed string
+      #
+      # @return [String]
+      def to_s
+        JSON.pretty_generate(@json)
+      end
+
+      # Must be implemented by sub classes
+      #
+      # @return [Array]
+      def valid_result_sets
+        Array.new
+      end
+
+      private
+
+      # Parse the returned API object.do
+      # Initialize instance variables and define accessors.
+      def parse_base
+        @name = json['resource']
+        @params = json['parameters']
+        @result_sets = json['resultSets']
+
+        result_sets.each do |result_set|
+          result_set_name = result_set['name'].underscore
+          # puts "#{result_set_name}"
+          # heads = "    "
+          # result_set['headers'].each do |h|
+          #   heads += ":#{h.underscore}, "
+          # end
+          # puts heads
+          if valid_result_sets.include? result_set_name.to_sym
+            instance_variable_set "@#{result_set_name}", row_set_to_array_of_hashes(result_set['headers'], result_set['rowSet'])
+            singleton_class.class_eval do; attr_accessor result_set_name; end
+          else
+            raise BadResponseError.new("Unexpected result set name #{result_set_name}.")
+          end
+        end
+      end
+
+      # Convert a returned API row set into an array of hashes
+      #
+      # @param headers [Array]
+      # @param row_set [Array]
+      # @return [Hash]
+      def row_set_to_array_of_hashes(headers, row_set)
+        result = Array.new
+        row_set.each do |row|
+          if row.count == headers.count
+            row_hash = Hash.new
+            headers.zip(row).each do |header, value|
+              row_hash[header.underscore.to_sym] = value
+            end
+            result.push row_hash
+          else
+            raise BadResponseError.new("Row set header count (#{headers.count}) doesn't match row item count (#{row.count}).")
+          end
+        end
+        result
+      end
+
+    end # ResourceBase
+
+  end
+
+end

data/lib/nba_stats/resources/scoreboard.rb

@@ -0,0 +1,29 @@
+require 'nba_stats/resources/resource_base'
+
+module NbaStats
+
+  module Resources
+
+    class Scoreboard < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [
+          :game_header,                 # :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, :fg_pct, :ft_pct, :fg3_pct, :ast, :reb, :tov
+          :series_standings,            # :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
+          :east_conf_standings_by_day,  # :team_id, :league_id, :season_id, :standingsdate, :conference, :team, :g, :w, :l, :w_pct, :home_record, :road_record
+          :west_conf_standings_by_day,  # :team_id, :league_id, :season_id, :standingsdate, :conference, :team, :g, :w, :l, :w_pct, :home_record, :road_record
+          :available                    # :game_id, :pt_available
+      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # Scoreboard
+
+  end
+
+end

data/lib/nba_stats/resources/shot_chart_detail.rb

@@ -0,0 +1,25 @@
+require 'nba_stats/resources/resource_base'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module Resources
+
+    class ShotChartDetail < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [
+          :shot_chart_detail,   # :grid_type, :game_id, :game_event_id, :player_id, :player_name, :team_id, :team_name, :period, :minutes_remaining, :seconds_remaining, :event_type, :action_type, :shot_type, :shot_zone_basic, :shot_zone_area, :shot_zone_range, :shot_distance, :loc_x, :loc_y, :shot_attempted_flag, :shot_made_flag,
+          :league_averages      # :grid_type, :shot_zone_basic, :shot_zone_area, :shot_zone_range, :fga, :fgm, :fg_pct,
+      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # ShotChartDetail
+
+  end
+
+end

data/lib/nba_stats/resources/team_game_log.rb

@@ -0,0 +1,23 @@
+require 'nba_stats/resources/resource_base'
+
+module NbaStats
+
+  module Resources
+
+    class TeamGameLog < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [
+          :team_game_log    #:team_id, :game_id, :game_date, :matchup, :wl, :min, :fgm, :fga, :fg_pct, :fg3_m, :fg3_a, :fg3_pct, :ftm, :fta, :ft_pct, :oreb, :dreb, :reb, :ast, :stl, :blk, :tov, :pf, :pts, :video_available,
+      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # TeamGameLog
+
+  end
+
+end

data/lib/nba_stats/resources/team_info_common.rb

@@ -0,0 +1,24 @@
+require 'nba_stats/resources/resource_base'
+
+module NbaStats
+
+  module Resources
+
+    class TeamInfoCommon < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [
+          :team_info_common,  #:team_id, :season_year, :team_city, :team_name, :team_abbreviation, :team_conference, :team_division, :team_code, :w, :l, :pct, :conf_rank, :div_rank,
+          :team_season_ranks  #:league_id, :season_id, :team_id, :pts_rank, :pts_pg, :reb_rank, :reb_pg, :ast_rank, :ast_pg, :opp_pts_rank, :opp_pts_pg,
+      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # TeamInfoCommon
+
+  end
+
+end

data/lib/nba_stats/resources/team_year_by_year_stats.rb

@@ -0,0 +1,24 @@
+require 'nba_stats/resources/resource_base'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module Resources
+
+    class TeamYearByYearStats < ResourceBase
+
+      # Array of valid result set names for this resource
+      VALID_RESULT_SETS = [
+          :team_stats   #:team_id, :team_city, :team_name, :year, :gp, :wins, :losses, :win_pct, :conf_rank, :div_rank, :fgm, :fga, :fg_pct, :fg3_m, :fg3_a, :fg3_pct, :ftm, :fta, :ft_pct, :oreb, :dreb, :reb, :ast, :pf, :stl, :tov, :blk, :pts,
+      ].freeze
+
+      # @return [Array]
+      def valid_result_sets
+        VALID_RESULT_SETS
+      end
+
+    end # TeamYearByYearStats
+
+  end
+
+end

data/lib/nba_stats/stats/box_score.rb

@@ -0,0 +1,42 @@
+require 'nba_stats/resources/box_score'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module BoxScore
+
+    # The path of the boxscore API
+    BOX_SCORE_PATH   = '/stats/boxscore'
+
+    # Calls the boxscore API and returns a BoxScore resource.
+    #
+    # @param game_id [String]
+    # @param range_type [Integer]
+    # @param start_period [Integer]
+    # @param end_period [Integer]
+    # @param start_range [Integer]
+    # @param end_range [Integer]
+    # @return [NbaStats::Resources::BoxScore]
+    def box_score(
+        game_id,
+        range_type=0,
+        start_period=0,
+        end_period=0,
+        start_range=0,
+        end_range=0
+    )
+      NbaStats::Resources::BoxScore.new(
+          get(BOX_SCORE_PATH, {
+              :GameID => game_id,
+              :RangeType => range_type,
+              :StartPeriod => start_period,
+              :EndPeriod => end_period,
+              :StartRange => start_range,
+              :EndRange => end_range
+          })
+      )
+    end
+
+  end # BoxScore
+
+end

data/lib/nba_stats/stats/box_score_advanced.rb

@@ -0,0 +1,41 @@
+require 'nba_stats/resources/box_score_advanced'
+
+module NbaStats
+
+  module BoxScoreAdvanced
+
+    # The path of the boxscoreadvanced API
+    BOX_SCORE_ADVANCED_PATH   = '/stats/boxscoreadvanced'
+
+    # Calls the boxscoreadvanced API and returns a BoxScoreAdvanced resource.
+    #
+    # @param game_id [String]
+    # @param range_type [Integer]
+    # @param start_period [Integer]
+    # @param end_period [Integer]
+    # @param start_range [Integer]
+    # @param end_range [xxxxxxxxxx]
+    # @return [NbaStats::Resources::BoxScoreAdvanced]
+    def box_score_advanced(
+        game_id,
+        range_type=0,
+        start_period=0,
+        end_period=0,
+        start_range=0,
+        end_range=0
+    )
+      NbaStats::Resources::BoxScoreAdvanced.new(
+          get(BOX_SCORE_ADVANCED_PATH, {
+              :GameID => game_id,
+              :RangeType => range_type,
+              :StartPeriod => start_period,
+              :EndPeriod => end_period,
+              :StartRange => start_range,
+              :EndRange => end_range
+          })
+      )
+    end
+
+  end # BoxScoreAdvanced
+
+end

data/lib/nba_stats/stats/box_score_four_factors.rb

@@ -0,0 +1,41 @@
+require 'nba_stats/resources/box_score_four_factors'
+
+module NbaStats
+
+  module BoxScoreFourFactors
+
+    # The path of the boxscorefourfactors API
+    BOX_SCORE_FOUR_FACTORS_PATH   = '/stats/boxscorefourfactors'
+
+    # Calls the boxscorefourfactors API and returns a BoxScoreFourFactors resource.
+    #
+    # @param game_id [String]
+    # @param range_type [Integer]
+    # @param start_period [Integer]
+    # @param end_period [Integer]
+    # @param start_range [Integer]
+    # @param end_range [Integer]
+    # @return [NbaStats::Resources::BoxScoreFourFactors]
+    def box_score_four_factors(
+        game_id,
+        range_type=0,
+        start_period=0,
+        end_period=0,
+        start_range=0,
+        end_range=0
+    )
+      NbaStats::Resources::BoxScoreFourFactors.new(
+          get(BOX_SCORE_FOUR_FACTORS_PATH, {
+              :GameID => game_id,
+              :RangeType => range_type,
+              :StartPeriod => start_period,
+              :EndPeriod => end_period,
+              :StartRange => start_range,
+              :EndRange => end_range
+          })
+      )
+    end
+
+  end # BoxScoreFourFactors
+
+end

data/lib/nba_stats/stats/box_score_misc.rb

@@ -0,0 +1,41 @@
+require 'nba_stats/resources/box_score_misc'
+
+module NbaStats
+
+  module BoxScoreMisc
+
+    # The path of the boxscoremisc API
+    BOX_SCORE_MISC_PATH   = '/stats/boxscoremisc'
+
+    # Calls the boxscoremisc API and returns a BoxScoreMisc resource.
+    #
+    # @param game_id [String]
+    # @param range_type [Integer]
+    # @param start_period [Integer]
+    # @param end_period [Integer]
+    # @param start_range [Integer]
+    # @param end_range [Integer]
+    # @return [NbaStats::Resources::BoxScoreMisc]
+    def box_score_misc(
+        game_id,
+        range_type=0,
+        start_period=0,
+        end_period=0,
+        start_range=0,
+        end_range=0
+    )
+      NbaStats::Resources::BoxScoreMisc.new(
+          get(BOX_SCORE_MISC_PATH, {
+              :GameID => game_id,
+              :RangeType => range_type,
+              :StartPeriod => start_period,
+              :EndPeriod => end_period,
+              :StartRange => start_range,
+              :EndRange => end_range
+          })
+      )
+    end
+
+  end # BoxScoreMisc
+
+end

data/lib/nba_stats/stats/box_score_scoring.rb

@@ -0,0 +1,41 @@
+require 'nba_stats/resources/box_score_scoring'
+
+module NbaStats
+
+  module BoxScoreScoring
+
+    # The path of the boxscorescoring API
+    BOX_SCORE_SCORING_PATH   = '/stats/boxscorescoring'
+
+    # Calls the boxscorescoring API and returns a BoxScoreScoring resource.
+    #
+    # @param game_id [String]
+    # @param range_type [Integer]
+    # @param start_period [Integer]
+    # @param end_period [Integer]
+    # @param start_range [Integer]
+    # @param end_range [Integer]
+    # @return [NbaStats::Resources::BoxScoreScoring]
+    def box_score_scoring(
+        game_id,
+        range_type=0,
+        start_period=0,
+        end_period=0,
+        start_range=0,
+        end_range=0
+    )
+      NbaStats::Resources::BoxScoreScoring.new(
+          get(BOX_SCORE_SCORING_PATH, {
+              :GameID => game_id,
+              :RangeType => range_type,
+              :StartPeriod => start_period,
+              :EndPeriod => end_period,
+              :StartRange => start_range,
+              :EndRange => end_range
+          })
+      )
+    end
+
+  end # BoxScoreScoring
+
+end

data/lib/nba_stats/stats/box_score_usage.rb

@@ -0,0 +1,41 @@
+require 'nba_stats/resources/box_score_usage'
+
+module NbaStats
+
+  module BoxScoreUsage
+
+    # The path of the boxscoreusage API
+    BOX_SCORE_USAGE_PATH   = '/stats/boxscoreusage'
+
+    # Calls the boxscoreusage API and returns a BoxScoreUsage resource.
+    #
+    # @param game_id [String]
+    # @param range_type [Integer]
+    # @param start_period [Integer]
+    # @param end_period [Integer]
+    # @param start_range [Integer]
+    # @param end_range [Integer]
+    # @return [NbaStats::Resources::BoxScoreUsage]
+    def box_score_usage(
+        game_id,
+        range_type=0,
+        start_period=0,
+        end_period=0,
+        start_range=0,
+        end_range=0
+    )
+      NbaStats::Resources::BoxScoreUsage.new(
+          get(BOX_SCORE_USAGE_PATH, {
+              :GameID => game_id,
+              :RangeType => range_type,
+              :StartPeriod => start_period,
+              :EndPeriod => end_period,
+              :StartRange => start_range,
+              :EndRange => end_range
+          })
+      )
+    end
+
+  end # BoxScoreUsage
+
+end

data/lib/nba_stats/stats/common_all_players.rb

@@ -0,0 +1,33 @@
+require 'nba_stats/resources/common_all_players'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module CommonAllPlayers
+
+    # The path of the commonallplayers API
+    COMMON_ALL_PLAYERS_PATH   = '/stats/commonallplayers'
+
+    # Calls the commonallplayers API and returns a CommonAllPlayers resource.
+    #
+    # @param season [String]
+    # @param is_only_current_season [Integer]
+    # @param league_id [String]
+    # @return [NbaStats::Resources::CommonAllPlayers]
+    def common_all_players(
+        season,
+        is_only_current_season=0,
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::CommonAllPlayers.new(
+          get(COMMON_ALL_PLAYERS_PATH, {
+              :LeagueID => league_id,
+              :Season => season,
+              :IsOnlyCurrentSeason => is_only_current_season
+          })
+      )
+    end
+
+  end # CommonAllPlayers
+
+end

data/lib/nba_stats/stats/common_player_info.rb

@@ -0,0 +1,33 @@
+require 'nba_stats/resources/common_player_info'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module CommonPlayerInfo
+
+    # The path of the commonplayerinfo API
+    COMMON_PLAYER_INFO_PATH   = '/stats/commonplayerinfo'
+
+    # Calls the commonplayerinfo API and returns a CommonPlayerInfo resource.
+    #
+    # @param player_id [Integer]
+    # @param season_type [String]
+    # @param league_id [String]
+    # @return [NbaStats::Resources::CommonPlayerInfo]
+    def common_player_info(
+        player_id,
+        season_type=NbaStats::Constants::SEASON_TYPE_REGULAR,
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::CommonPlayerInfo.new(
+          get(COMMON_PLAYER_INFO_PATH, {
+              :PlayerID => player_id,
+              :SeasonType => season_type,
+              :LeagueID => league_id
+          })
+    )
+    end
+
+  end # CommonPlayerInfo
+
+end

data/lib/nba_stats/stats/common_team_roster.rb

@@ -0,0 +1,33 @@
+require 'nba_stats/resources/common_team_roster'
+require 'nba_stats/constants'
+
+module NbaStats
+
+  module CommonTeamRoster
+
+    # The path of the commonteamroster API
+    COMMON_TEAM_ROSTER_PATH   = '/stats/commonteamroster'
+
+    # Calls the commonteamroster API and returns a CommonTeamRoster resource.
+    #
+    # @param team_id [Integer]
+    # @param season [String]
+    # @param league_id [String]
+    # @return [NbaStats::Resources::CommonTeamRoster]
+    def common_team_roster(
+        team_id,
+        season,
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::CommonTeamRoster.new(
+          get(COMMON_TEAM_ROSTER_PATH, {
+              :Season => season,
+              :LeagueID => league_id,
+              :TeamID => team_id
+          })
+      )
+    end
+
+  end # CommonTeamRoster
+
+end

data/lib/nba_stats/stats/common_team_years.rb

@@ -0,0 +1,26 @@
+require 'nba_stats/resources/common_team_years'
+
+module NbaStats
+
+  module CommonTeamYears
+
+    # The path of the commonteamyears API
+    COMMON_TEAM_YEARS_PATH   = '/stats/commonteamyears'
+
+    # Calls the commonteamyears API and returns a CommonTeamYears resource.
+    #
+    # @param league_id [String]
+    # @return [NbaStats::Resources::CommonTeamYears]
+    def common_team_years(
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::CommonTeamYears.new(
+          get(COMMON_TEAM_YEARS_PATH, {
+              :LeagueID => league_id
+          })
+      )
+    end
+
+  end # CommonTeamYears
+
+end

data/lib/nba_stats/stats/draft_combine_drill_results.rb

@@ -0,0 +1,29 @@
+require 'nba_stats/resources/draft_combine_drill_results'
+
+module NbaStats
+
+  module DraftCombineDrillResults
+
+    # The path of the draftcombinedrillresults API
+    DRAFT_COMBINE_DRILL_RESULTS_PATH   = '/stats/draftcombinedrillresults'
+
+    # Calls the draftcombinedrillresults API and returns a DraftCombineDrillResults resource.
+    #
+    # @param season_year [String]
+    # @param league_id [String]
+    # @return [NbaStats::Resources::DraftCombineDrillResults]
+    def draft_combine_drill_results(
+        season_year,
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::DraftCombineDrillResults.new(
+          get(DRAFT_COMBINE_DRILL_RESULTS_PATH, {
+              :LeagueID => league_id,
+              :SeasonYear => season_year
+          })
+      )
+    end
+
+  end # DraftCombineDrillResults
+
+end

data/lib/nba_stats/stats/draft_combine_non_stationary_shooting.rb

@@ -0,0 +1,29 @@
+require 'nba_stats/resources/draft_combine_non_stationary_shooting'
+
+module NbaStats
+
+  module DraftCombineNonStationaryShooting
+
+    # The path of the draftcombinenonstationaryshooting API
+    DRAFT_COMBINE_NON_STATIONARY_SHOOTING_PATH   = '/stats/draftcombinenonstationaryshooting/'
+
+    # Calls the draftcombinenonstationaryshooting API and returns a DraftCombineNonStationaryShooting resource.
+    #
+    # @param season_year [String]
+    # @param league_id [String]
+    # @return [NbaStats::Resources::DraftCombineNonStationaryShooting]
+    def draft_combine_non_stationary_shooting(
+        season_year,
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::DraftCombineNonStationaryShooting.new(
+          get(DRAFT_COMBINE_NON_STATIONARY_SHOOTING_PATH, {
+              :LeagueID => league_id,
+              :SeasonYear => season_year
+          })
+      )
+    end
+
+  end # DraftCombineNonStationaryShooting
+
+end

data/lib/nba_stats/stats/draft_combine_player_anthro.rb

@@ -0,0 +1,29 @@
+require 'nba_stats/resources/draft_combine_player_anthro'
+
+module NbaStats
+
+  module DraftCombinePlayerAnthro
+
+    # The path of the draftcombineplayeranthro API
+    DRAFT_COMBINE_PLAYER_ANTHRO_PATH   = '/stats/draftcombineplayeranthro'
+
+    # Calls the draftcombineplayeranthro API and returns a DraftCombinePlayerAnthro resource.
+    #
+    # @param season_year [String]
+    # @param league_id [String]
+    # @return [NbaStats::Resources::DraftCombinePlayerAnthro]
+    def draft_combine_player_anthro(
+        season_year,
+        league_id=NbaStats::Constants::LEAGUE_ID_NBA
+    )
+      NbaStats::Resources::DraftCombinePlayerAnthro.new(
+          get(DRAFT_COMBINE_PLAYER_ANTHRO_PATH, {
+              :LeagueID => league_id,
+              :SeasonYear => season_year
+          })
+      )
+    end
+
+  end # DraftCombinePlayerAnthro
+
+end