nba 0.1.1 → 0.2.0

data/lib/nba/draft_board.rb

@@ -0,0 +1,126 @@
+require "json"
+require_relative "client"
+require_relative "collection"
+require_relative "draft_board_pick"
+
+module NBA
+  # Provides methods to retrieve draft board data
+  module DraftBoard
+    # Result set name
+    # @return [String] the result set name
+    RESULTS = "DraftBoard".freeze
+
+    # Retrieves draft board picks for a season
+    #
+    # @api public
+    # @example
+    #   picks = NBA::DraftBoard.all(season: 2023)
+    #   picks.each { |p| puts "#{p.player_name}: Pick #{p.overall_pick}" }
+    # @param season [Integer] the draft season year
+    # @param league [String, League] the league ID or League object (default NBA)
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of draft board picks
+    def self.all(season:, league: League::NBA, client: CLIENT)
+      league_id = Utils.extract_league_id(league)
+      path = build_path(season, league_id)
+      response = client.get(path)
+      parse_response(response)
+    end
+
+    # Builds the API request path
+    # @api private
+    # @return [String] the request path
+    def self.build_path(season, league_id)
+      "draftboard?LeagueID=#{league_id}&SeasonYear=#{season}"
+    end
+    private_class_method :build_path
+
+    # Parses the API response into pick objects
+    # @api private
+    # @return [Collection] collection of picks
+    def self.parse_response(response)
+      return Collection.new unless response
+
+      data = JSON.parse(response)
+      result_set = find_result_set(data)
+      return Collection.new unless result_set
+
+      headers = result_set["headers"]
+      rows = result_set["rowSet"]
+      return Collection.new unless headers && rows
+
+      picks = rows.map { |row| build_pick(headers, row) }
+      Collection.new(picks)
+    end
+    private_class_method :parse_response
+
+    # Finds the result set in the response
+    # @api private
+    # @return [Hash, nil] the result set hash
+    def self.find_result_set(data)
+      result_sets = data["resultSets"]
+      return unless result_sets
+
+      result_sets.find { |rs| rs["name"].eql?(RESULTS) }
+    end
+    private_class_method :find_result_set
+
+    # Builds a DraftBoardPick object from raw data
+    # @api private
+    # @return [DraftBoardPick] the pick object
+    def self.build_pick(headers, row)
+      data = headers.zip(row).to_h
+      DraftBoardPick.new(**PickAttributes.extract(data))
+    end
+    private_class_method :build_pick
+
+    # Extracts pick attributes from data
+    # @api private
+    module PickAttributes
+      # Extracts all pick attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] extracted attributes
+      def self.extract(data)
+        player(data).merge(draft_info(data)).merge(team(data)).merge(physical(data))
+      end
+
+      # Extracts player attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] player attributes
+      def self.player(data)
+        {person_id: data["PERSON_ID"], player_name: data["PLAYER_NAME"]}
+      end
+
+      # Extracts draft info attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] draft info attributes
+      def self.draft_info(data)
+        {season: data["SEASON"], round_number: data["ROUND_NUMBER"],
+         round_pick: data["ROUND_PICK"], overall_pick: data["OVERALL_PICK"]}
+      end
+
+      # Extracts team attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] team attributes
+      def self.team(data)
+        {team_id: data["TEAM_ID"], team_city: data["TEAM_CITY"],
+         team_name: data["TEAM_NAME"], team_abbreviation: data["TEAM_ABBREVIATION"],
+         organization: data["ORGANIZATION"], organization_type: data["ORGANIZATION_TYPE"]}
+      end
+
+      # Extracts physical attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] physical attributes
+      def self.physical(data)
+        {height: data["HEIGHT"], weight: data["WEIGHT"],
+         position: data["POSITION"], jersey_number: data["JERSEY_NUMBER"],
+         birthdate: data["BIRTHDATE"], age: data["AGE"]}
+      end
+    end
+  end
+end

data/lib/nba/draft_board_pick.rb

@@ -0,0 +1,173 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents a draft board pick
+  class DraftBoardPick < Shale::Mapper
+    include Equalizer.new(:person_id)
+
+    # @!attribute [rw] person_id
+    #   Returns the person ID
+    #   @api public
+    #   @example
+    #     pick.person_id #=> 1630162
+    #   @return [Integer] the person ID
+    attribute :person_id, Shale::Type::Integer
+
+    # @!attribute [rw] player_name
+    #   Returns the player name
+    #   @api public
+    #   @example
+    #     pick.player_name #=> "Victor Wembanyama"
+    #   @return [String] the player name
+    attribute :player_name, Shale::Type::String
+
+    # @!attribute [rw] season
+    #   Returns the draft season
+    #   @api public
+    #   @example
+    #     pick.season #=> "2023"
+    #   @return [String] the season
+    attribute :season, Shale::Type::String
+
+    # @!attribute [rw] round_number
+    #   Returns the draft round number
+    #   @api public
+    #   @example
+    #     pick.round_number #=> 1
+    #   @return [Integer] the round number
+    attribute :round_number, Shale::Type::Integer
+
+    # @!attribute [rw] round_pick
+    #   Returns the pick number in the round
+    #   @api public
+    #   @example
+    #     pick.round_pick #=> 1
+    #   @return [Integer] the round pick
+    attribute :round_pick, Shale::Type::Integer
+
+    # @!attribute [rw] overall_pick
+    #   Returns the overall pick number
+    #   @api public
+    #   @example
+    #     pick.overall_pick #=> 1
+    #   @return [Integer] the overall pick
+    attribute :overall_pick, Shale::Type::Integer
+
+    # @!attribute [rw] team_id
+    #   Returns the team ID
+    #   @api public
+    #   @example
+    #     pick.team_id #=> 1610612759
+    #   @return [Integer] the team ID
+    attribute :team_id, Shale::Type::Integer
+
+    # @!attribute [rw] team_city
+    #   Returns the team city
+    #   @api public
+    #   @example
+    #     pick.team_city #=> "San Antonio"
+    #   @return [String] the team city
+    attribute :team_city, Shale::Type::String
+
+    # @!attribute [rw] team_name
+    #   Returns the team name
+    #   @api public
+    #   @example
+    #     pick.team_name #=> "Spurs"
+    #   @return [String] the team name
+    attribute :team_name, Shale::Type::String
+
+    # @!attribute [rw] team_abbreviation
+    #   Returns the team abbreviation
+    #   @api public
+    #   @example
+    #     pick.team_abbreviation #=> "SAS"
+    #   @return [String] the team abbreviation
+    attribute :team_abbreviation, Shale::Type::String
+
+    # @!attribute [rw] organization
+    #   Returns the organization name
+    #   @api public
+    #   @example
+    #     pick.organization #=> "Metropolitans 92"
+    #   @return [String] the organization
+    attribute :organization, Shale::Type::String
+
+    # @!attribute [rw] organization_type
+    #   Returns the organization type
+    #   @api public
+    #   @example
+    #     pick.organization_type #=> "International"
+    #   @return [String] the organization type
+    attribute :organization_type, Shale::Type::String
+
+    # @!attribute [rw] height
+    #   Returns the player height
+    #   @api public
+    #   @example
+    #     pick.height #=> "7-4"
+    #   @return [String] the height
+    attribute :height, Shale::Type::String
+
+    # @!attribute [rw] weight
+    #   Returns the player weight
+    #   @api public
+    #   @example
+    #     pick.weight #=> "210"
+    #   @return [String] the weight
+    attribute :weight, Shale::Type::String
+
+    # @!attribute [rw] position
+    #   Returns the player position
+    #   @api public
+    #   @example
+    #     pick.position #=> "C"
+    #   @return [String] the position
+    attribute :position, Shale::Type::String
+
+    # @!attribute [rw] jersey_number
+    #   Returns the jersey number
+    #   @api public
+    #   @example
+    #     pick.jersey_number #=> "1"
+    #   @return [String] the jersey number
+    attribute :jersey_number, Shale::Type::String
+
+    # @!attribute [rw] birthdate
+    #   Returns the birthdate
+    #   @api public
+    #   @example
+    #     pick.birthdate #=> "2004-01-04"
+    #   @return [String] the birthdate
+    attribute :birthdate, Shale::Type::String
+
+    # @!attribute [rw] age
+    #   Returns the player age
+    #   @api public
+    #   @example
+    #     pick.age #=> 19.0
+    #   @return [Float] the age
+    attribute :age, Shale::Type::Float
+
+    # Returns the player object
+    #
+    # @api public
+    # @example
+    #   pick.player #=> #<NBA::Player>
+    # @return [Player, nil] the player object
+    def player
+      Players.find(person_id)
+    end
+
+    # Returns the team object
+    #
+    # @api public
+    # @example
+    #   pick.team #=> #<NBA::Team>
+    # @return [Team, nil] the team object
+    def team
+      Teams.find(team_id)
+    end
+  end
+end

data/lib/nba/draft_combine_anthro_measurement.rb

@@ -0,0 +1,163 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents a draft combine anthropometric measurement
+  class DraftCombineAnthroMeasurement < Shale::Mapper
+    include Equalizer.new(:player_id)
+
+    # @!attribute [rw] temp_player_id
+    #   Returns the temporary player ID
+    #   @api public
+    #   @example
+    #     measurement.temp_player_id #=> 123456
+    #   @return [Integer] the temporary player ID
+    attribute :temp_player_id, Shale::Type::Integer
+
+    # @!attribute [rw] player_id
+    #   Returns the player ID
+    #   @api public
+    #   @example
+    #     measurement.player_id #=> 1630162
+    #   @return [Integer] the player ID
+    attribute :player_id, Shale::Type::Integer
+
+    # @!attribute [rw] first_name
+    #   Returns the player's first name
+    #   @api public
+    #   @example
+    #     measurement.first_name #=> "Victor"
+    #   @return [String] the first name
+    attribute :first_name, Shale::Type::String
+
+    # @!attribute [rw] last_name
+    #   Returns the player's last name
+    #   @api public
+    #   @example
+    #     measurement.last_name #=> "Wembanyama"
+    #   @return [String] the last name
+    attribute :last_name, Shale::Type::String
+
+    # @!attribute [rw] player_name
+    #   Returns the player name
+    #   @api public
+    #   @example
+    #     measurement.player_name #=> "Victor Wembanyama"
+    #   @return [String] the player name
+    attribute :player_name, Shale::Type::String
+
+    # @!attribute [rw] position
+    #   Returns the player's position
+    #   @api public
+    #   @example
+    #     measurement.position #=> "C"
+    #   @return [String] the position
+    attribute :position, Shale::Type::String
+
+    # @!attribute [rw] height_wo_shoes
+    #   Returns the height without shoes in inches
+    #   @api public
+    #   @example
+    #     measurement.height_wo_shoes #=> 85.5
+    #   @return [Float] height without shoes
+    attribute :height_wo_shoes, Shale::Type::Float
+
+    # @!attribute [rw] height_wo_shoes_ft_in
+    #   Returns the height without shoes in feet and inches
+    #   @api public
+    #   @example
+    #     measurement.height_wo_shoes_ft_in #=> "7' 1.5\""
+    #   @return [String] height without shoes in feet and inches
+    attribute :height_wo_shoes_ft_in, Shale::Type::String
+
+    # @!attribute [rw] height_w_shoes
+    #   Returns the height with shoes in inches
+    #   @api public
+    #   @example
+    #     measurement.height_w_shoes #=> 86.5
+    #   @return [Float] height with shoes
+    attribute :height_w_shoes, Shale::Type::Float
+
+    # @!attribute [rw] height_w_shoes_ft_in
+    #   Returns the height with shoes in feet and inches
+    #   @api public
+    #   @example
+    #     measurement.height_w_shoes_ft_in #=> "7' 2.5\""
+    #   @return [String] height with shoes in feet and inches
+    attribute :height_w_shoes_ft_in, Shale::Type::String
+
+    # @!attribute [rw] weight
+    #   Returns the weight in pounds
+    #   @api public
+    #   @example
+    #     measurement.weight #=> 209.0
+    #   @return [Float] weight in pounds
+    attribute :weight, Shale::Type::Float
+
+    # @!attribute [rw] wingspan
+    #   Returns the wingspan in inches
+    #   @api public
+    #   @example
+    #     measurement.wingspan #=> 96.0
+    #   @return [Float] wingspan in inches
+    attribute :wingspan, Shale::Type::Float
+
+    # @!attribute [rw] wingspan_ft_in
+    #   Returns the wingspan in feet and inches
+    #   @api public
+    #   @example
+    #     measurement.wingspan_ft_in #=> "8' 0\""
+    #   @return [String] wingspan in feet and inches
+    attribute :wingspan_ft_in, Shale::Type::String
+
+    # @!attribute [rw] standing_reach
+    #   Returns the standing reach in inches
+    #   @api public
+    #   @example
+    #     measurement.standing_reach #=> 114.5
+    #   @return [Float] standing reach in inches
+    attribute :standing_reach, Shale::Type::Float
+
+    # @!attribute [rw] standing_reach_ft_in
+    #   Returns the standing reach in feet and inches
+    #   @api public
+    #   @example
+    #     measurement.standing_reach_ft_in #=> "9' 6.5\""
+    #   @return [String] standing reach in feet and inches
+    attribute :standing_reach_ft_in, Shale::Type::String
+
+    # @!attribute [rw] body_fat_pct
+    #   Returns the body fat percentage
+    #   @api public
+    #   @example
+    #     measurement.body_fat_pct #=> 4.8
+    #   @return [Float] body fat percentage
+    attribute :body_fat_pct, Shale::Type::Float
+
+    # @!attribute [rw] hand_length
+    #   Returns the hand length in inches
+    #   @api public
+    #   @example
+    #     measurement.hand_length #=> 10.25
+    #   @return [Float] hand length in inches
+    attribute :hand_length, Shale::Type::Float
+
+    # @!attribute [rw] hand_width
+    #   Returns the hand width in inches
+    #   @api public
+    #   @example
+    #     measurement.hand_width #=> 12.0
+    #   @return [Float] hand width in inches
+    attribute :hand_width, Shale::Type::Float
+
+    # Returns the player object
+    #
+    # @api public
+    # @example
+    #   measurement.player #=> #<NBA::Player>
+    # @return [Player, nil] the player object
+    def player
+      Players.find(player_id)
+    end
+  end
+end

data/lib/nba/draft_combine_drill_result.rb

@@ -0,0 +1,115 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents a draft combine drill result
+  class DraftCombineDrillResult < Shale::Mapper
+    include Equalizer.new(:player_id)
+
+    # @!attribute [rw] temp_player_id
+    #   Returns the temporary player ID
+    #   @api public
+    #   @example
+    #     result.temp_player_id #=> 1630162
+    #   @return [Integer] the temporary player ID
+    attribute :temp_player_id, Shale::Type::Integer
+
+    # @!attribute [rw] player_id
+    #   Returns the player ID
+    #   @api public
+    #   @example
+    #     result.player_id #=> 1630162
+    #   @return [Integer] the player ID
+    attribute :player_id, Shale::Type::Integer
+
+    # @!attribute [rw] first_name
+    #   Returns the player's first name
+    #   @api public
+    #   @example
+    #     result.first_name #=> "Victor"
+    #   @return [String] the first name
+    attribute :first_name, Shale::Type::String
+
+    # @!attribute [rw] last_name
+    #   Returns the player's last name
+    #   @api public
+    #   @example
+    #     result.last_name #=> "Wembanyama"
+    #   @return [String] the last name
+    attribute :last_name, Shale::Type::String
+
+    # @!attribute [rw] player_name
+    #   Returns the player name
+    #   @api public
+    #   @example
+    #     result.player_name #=> "Victor Wembanyama"
+    #   @return [String] the player name
+    attribute :player_name, Shale::Type::String
+
+    # @!attribute [rw] position
+    #   Returns the player's position
+    #   @api public
+    #   @example
+    #     result.position #=> "C"
+    #   @return [String] the position
+    attribute :position, Shale::Type::String
+
+    # @!attribute [rw] standing_vertical_leap
+    #   Returns the standing vertical leap measurement in inches
+    #   @api public
+    #   @example
+    #     result.standing_vertical_leap #=> 30.5
+    #   @return [Float] standing vertical leap in inches
+    attribute :standing_vertical_leap, Shale::Type::Float
+
+    # @!attribute [rw] max_vertical_leap
+    #   Returns the maximum vertical leap measurement in inches
+    #   @api public
+    #   @example
+    #     result.max_vertical_leap #=> 37.0
+    #   @return [Float] maximum vertical leap in inches
+    attribute :max_vertical_leap, Shale::Type::Float
+
+    # @!attribute [rw] lane_agility_time
+    #   Returns the lane agility drill time in seconds
+    #   @api public
+    #   @example
+    #     result.lane_agility_time #=> 10.5
+    #   @return [Float] lane agility time in seconds
+    attribute :lane_agility_time, Shale::Type::Float
+
+    # @!attribute [rw] modified_lane_agility_time
+    #   Returns the modified lane agility drill time in seconds
+    #   @api public
+    #   @example
+    #     result.modified_lane_agility_time #=> 10.2
+    #   @return [Float] modified lane agility time in seconds
+    attribute :modified_lane_agility_time, Shale::Type::Float
+
+    # @!attribute [rw] three_quarter_sprint
+    #   Returns the three-quarter court sprint time in seconds
+    #   @api public
+    #   @example
+    #     result.three_quarter_sprint #=> 3.2
+    #   @return [Float] three-quarter sprint time in seconds
+    attribute :three_quarter_sprint, Shale::Type::Float
+
+    # @!attribute [rw] bench_press
+    #   Returns the number of bench press repetitions
+    #   @api public
+    #   @example
+    #     result.bench_press #=> 12
+    #   @return [Integer] bench press repetitions
+    attribute :bench_press, Shale::Type::Integer
+
+    # Returns the player object
+    #
+    # @api public
+    # @example
+    #   result.player #=> #<NBA::Player>
+    # @return [Player, nil] the player object
+    def player
+      Players.find(player_id)
+    end
+  end
+end

data/lib/nba/draft_combine_drill_results.rb

@@ -0,0 +1,112 @@
+require "json"
+require_relative "client"
+require_relative "collection"
+require_relative "draft_combine_drill_result"
+
+module NBA
+  # Provides methods to retrieve draft combine drill results data
+  module DraftCombineDrillResults
+    # Result set name
+    # @return [String] the result set name
+    RESULTS = "Results".freeze
+
+    # Retrieves draft combine drill results for a season
+    #
+    # @api public
+    # @example
+    #   results = NBA::DraftCombineDrillResults.all(season: 2019)
+    #   results.each { |r| puts "#{r.player_name}: #{r.max_vertical_leap}" }
+    # @param season [Integer] the draft combine season year
+    # @param league [String, League] the league ID or League object (default NBA)
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of draft combine drill results
+    def self.all(season:, league: League::NBA, client: CLIENT)
+      league_id = Utils.extract_league_id(league)
+      path = build_path(season, league_id)
+      response = client.get(path)
+      parse_response(response)
+    end
+
+    # Builds the API request path
+    # @api private
+    # @return [String] the request path
+    def self.build_path(season, league_id)
+      "draftcombinedrillresults?LeagueID=#{league_id}&SeasonYear=#{season}"
+    end
+    private_class_method :build_path
+
+    # Parses the API response into result objects
+    # @api private
+    # @return [Collection] collection of results
+    def self.parse_response(response)
+      return Collection.new unless response
+
+      data = JSON.parse(response)
+      result_set = find_result_set(data)
+      return Collection.new unless result_set
+
+      headers = result_set["headers"]
+      rows = result_set["rowSet"]
+      return Collection.new unless headers && rows
+
+      results = rows.map { |row| build_result(headers, row) }
+      Collection.new(results)
+    end
+    private_class_method :parse_response
+
+    # Finds the result set in the response
+    # @api private
+    # @return [Hash, nil] the result set hash
+    def self.find_result_set(data)
+      result_sets = data["resultSets"]
+      return unless result_sets
+
+      result_sets.find { |rs| rs["name"].eql?(RESULTS) }
+    end
+    private_class_method :find_result_set
+
+    # Builds a DraftCombineDrillResult object from raw data
+    # @api private
+    # @return [DraftCombineDrillResult] the result object
+    def self.build_result(headers, row)
+      data = headers.zip(row).to_h
+      DraftCombineDrillResult.new(**ResultAttributes.extract(data))
+    end
+    private_class_method :build_result
+
+    # Extracts result attributes from data
+    # @api private
+    module ResultAttributes
+      # Extracts all result attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] extracted attributes
+      def self.extract(data)
+        player(data).merge(drills(data))
+      end
+
+      # Extracts player attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] player attributes
+      def self.player(data)
+        {temp_player_id: data["TEMP_PLAYER_ID"], player_id: data["PLAYER_ID"],
+         first_name: data["FIRST_NAME"], last_name: data["LAST_NAME"],
+         player_name: data["PLAYER_NAME"], position: data["POSITION"]}
+      end
+
+      # Extracts drill result attributes from data
+      # @api private
+      # @param data [Hash] the row data
+      # @return [Hash] drill result attributes
+      def self.drills(data)
+        {standing_vertical_leap: data["STANDING_VERTICAL_LEAP"],
+         max_vertical_leap: data["MAX_VERTICAL_LEAP"],
+         lane_agility_time: data["LANE_AGILITY_TIME"],
+         modified_lane_agility_time: data["MODIFIED_LANE_AGILITY_TIME"],
+         three_quarter_sprint: data["THREE_QUARTER_SPRINT"],
+         bench_press: data["BENCH_PRESS"]}
+      end
+    end
+  end
+end