nba 0.1.1 → 0.2.0

data/lib/nba/box_score_matchup_stat.rb

@@ -0,0 +1,417 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents a player matchup statistic from the BoxScoreMatchupsV3 endpoint
+  class BoxScoreMatchupStat < Shale::Mapper
+    include Equalizer.new(:game_id, :person_id_off, :person_id_def)
+
+    # @!attribute [rw] game_id
+    #   Returns the game ID
+    #   @api public
+    #   @example
+    #     stat.game_id #=> "0022400350"
+    #   @return [String] the game ID
+    attribute :game_id, Shale::Type::String
+
+    # @!attribute [rw] team_id
+    #   Returns the team ID
+    #   @api public
+    #   @example
+    #     stat.team_id #=> 1610612744
+    #   @return [Integer] the team ID
+    attribute :team_id, Shale::Type::Integer
+
+    # @!attribute [rw] team_city
+    #   Returns the team city
+    #   @api public
+    #   @example
+    #     stat.team_city #=> "Golden State"
+    #   @return [String] the team city
+    attribute :team_city, Shale::Type::String
+
+    # @!attribute [rw] team_name
+    #   Returns the team name
+    #   @api public
+    #   @example
+    #     stat.team_name #=> "Warriors"
+    #   @return [String] the team name
+    attribute :team_name, Shale::Type::String
+
+    # @!attribute [rw] team_tricode
+    #   Returns the team tricode
+    #   @api public
+    #   @example
+    #     stat.team_tricode #=> "GSW"
+    #   @return [String] the team tricode
+    attribute :team_tricode, Shale::Type::String
+
+    # @!attribute [rw] team_slug
+    #   Returns the team slug
+    #   @api public
+    #   @example
+    #     stat.team_slug #=> "warriors"
+    #   @return [String] the team slug
+    attribute :team_slug, Shale::Type::String
+
+    # @!attribute [rw] person_id_off
+    #   Returns the offensive player ID
+    #   @api public
+    #   @example
+    #     stat.person_id_off #=> 201939
+    #   @return [Integer] the offensive player ID
+    attribute :person_id_off, Shale::Type::Integer
+
+    # @!attribute [rw] first_name_off
+    #   Returns the offensive player first name
+    #   @api public
+    #   @example
+    #     stat.first_name_off #=> "Stephen"
+    #   @return [String] the offensive player first name
+    attribute :first_name_off, Shale::Type::String
+
+    # @!attribute [rw] family_name_off
+    #   Returns the offensive player family name
+    #   @api public
+    #   @example
+    #     stat.family_name_off #=> "Curry"
+    #   @return [String] the offensive player family name
+    attribute :family_name_off, Shale::Type::String
+
+    # @!attribute [rw] name_i_off
+    #   Returns the offensive player name initial format
+    #   @api public
+    #   @example
+    #     stat.name_i_off #=> "S. Curry"
+    #   @return [String] the offensive player name initial format
+    attribute :name_i_off, Shale::Type::String
+
+    # @!attribute [rw] player_slug_off
+    #   Returns the offensive player slug
+    #   @api public
+    #   @example
+    #     stat.player_slug_off #=> "stephen-curry"
+    #   @return [String] the offensive player slug
+    attribute :player_slug_off, Shale::Type::String
+
+    # @!attribute [rw] jersey_num_off
+    #   Returns the offensive player jersey number
+    #   @api public
+    #   @example
+    #     stat.jersey_num_off #=> "30"
+    #   @return [String] the offensive player jersey number
+    attribute :jersey_num_off, Shale::Type::String
+
+    # @!attribute [rw] person_id_def
+    #   Returns the defensive player ID
+    #   @api public
+    #   @example
+    #     stat.person_id_def #=> 203507
+    #   @return [Integer] the defensive player ID
+    attribute :person_id_def, Shale::Type::Integer
+
+    # @!attribute [rw] first_name_def
+    #   Returns the defensive player first name
+    #   @api public
+    #   @example
+    #     stat.first_name_def #=> "Giannis"
+    #   @return [String] the defensive player first name
+    attribute :first_name_def, Shale::Type::String
+
+    # @!attribute [rw] family_name_def
+    #   Returns the defensive player family name
+    #   @api public
+    #   @example
+    #     stat.family_name_def #=> "Antetokounmpo"
+    #   @return [String] the defensive player family name
+    attribute :family_name_def, Shale::Type::String
+
+    # @!attribute [rw] name_i_def
+    #   Returns the defensive player name initial format
+    #   @api public
+    #   @example
+    #     stat.name_i_def #=> "G. Antetokounmpo"
+    #   @return [String] the defensive player name initial format
+    attribute :name_i_def, Shale::Type::String
+
+    # @!attribute [rw] player_slug_def
+    #   Returns the defensive player slug
+    #   @api public
+    #   @example
+    #     stat.player_slug_def #=> "giannis-antetokounmpo"
+    #   @return [String] the defensive player slug
+    attribute :player_slug_def, Shale::Type::String
+
+    # @!attribute [rw] position_def
+    #   Returns the defensive player position
+    #   @api public
+    #   @example
+    #     stat.position_def #=> "F"
+    #   @return [String] the defensive player position
+    attribute :position_def, Shale::Type::String
+
+    # @!attribute [rw] comment_def
+    #   Returns the defensive player comment
+    #   @api public
+    #   @example
+    #     stat.comment_def #=> ""
+    #   @return [String] the defensive player comment
+    attribute :comment_def, Shale::Type::String
+
+    # @!attribute [rw] jersey_num_def
+    #   Returns the defensive player jersey number
+    #   @api public
+    #   @example
+    #     stat.jersey_num_def #=> "34"
+    #   @return [String] the defensive player jersey number
+    attribute :jersey_num_def, Shale::Type::String
+
+    # @!attribute [rw] matchup_minutes
+    #   Returns the matchup minutes in display format
+    #   @api public
+    #   @example
+    #     stat.matchup_minutes #=> "05:30"
+    #   @return [String] the matchup minutes
+    attribute :matchup_minutes, Shale::Type::String
+
+    # @!attribute [rw] matchup_minutes_sort
+    #   Returns the matchup minutes as sortable float
+    #   @api public
+    #   @example
+    #     stat.matchup_minutes_sort #=> 5.5
+    #   @return [Float] the matchup minutes sortable
+    attribute :matchup_minutes_sort, Shale::Type::Float
+
+    # @!attribute [rw] partial_possessions
+    #   Returns the partial possessions
+    #   @api public
+    #   @example
+    #     stat.partial_possessions #=> 12.5
+    #   @return [Float] the partial possessions
+    attribute :partial_possessions, Shale::Type::Float
+
+    # @!attribute [rw] percentage_defender_total_time
+    #   Returns the percentage of defender's total time
+    #   @api public
+    #   @example
+    #     stat.percentage_defender_total_time #=> 0.15
+    #   @return [Float] the percentage of defender's total time
+    attribute :percentage_defender_total_time, Shale::Type::Float
+
+    # @!attribute [rw] percentage_offensive_total_time
+    #   Returns the percentage of offensive player's total time
+    #   @api public
+    #   @example
+    #     stat.percentage_offensive_total_time #=> 0.18
+    #   @return [Float] the percentage of offensive player's total time
+    attribute :percentage_offensive_total_time, Shale::Type::Float
+
+    # @!attribute [rw] percentage_total_time_both_on
+    #   Returns the percentage of time both players were on court
+    #   @api public
+    #   @example
+    #     stat.percentage_total_time_both_on #=> 0.25
+    #   @return [Float] the percentage of time both players were on
+    attribute :percentage_total_time_both_on, Shale::Type::Float
+
+    # @!attribute [rw] switches_on
+    #   Returns the number of switches onto the matchup
+    #   @api public
+    #   @example
+    #     stat.switches_on #=> 3
+    #   @return [Integer] the switches on
+    attribute :switches_on, Shale::Type::Integer
+
+    # @!attribute [rw] player_points
+    #   Returns the points scored by the offensive player
+    #   @api public
+    #   @example
+    #     stat.player_points #=> 8
+    #   @return [Integer] the player points
+    attribute :player_points, Shale::Type::Integer
+
+    # @!attribute [rw] team_points
+    #   Returns the team points while in matchup
+    #   @api public
+    #   @example
+    #     stat.team_points #=> 12
+    #   @return [Integer] the team points
+    attribute :team_points, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_assists
+    #   Returns the assists in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_assists #=> 2
+    #   @return [Integer] the matchup assists
+    attribute :matchup_assists, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_potential_assists
+    #   Returns the potential assists in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_potential_assists #=> 3
+    #   @return [Integer] the matchup potential assists
+    attribute :matchup_potential_assists, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_turnovers
+    #   Returns the turnovers in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_turnovers #=> 1
+    #   @return [Integer] the matchup turnovers
+    attribute :matchup_turnovers, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_blocks
+    #   Returns the blocks in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_blocks #=> 0
+    #   @return [Integer] the matchup blocks
+    attribute :matchup_blocks, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_field_goals_made
+    #   Returns the field goals made in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_field_goals_made #=> 3
+    #   @return [Integer] the matchup field goals made
+    attribute :matchup_field_goals_made, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_field_goals_attempted
+    #   Returns the field goals attempted in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_field_goals_attempted #=> 6
+    #   @return [Integer] the matchup field goals attempted
+    attribute :matchup_field_goals_attempted, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_field_goals_percentage
+    #   Returns the field goal percentage in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_field_goals_percentage #=> 0.5
+    #   @return [Float] the matchup field goal percentage
+    attribute :matchup_field_goals_percentage, Shale::Type::Float
+
+    # @!attribute [rw] matchup_three_pointers_made
+    #   Returns the three pointers made in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_three_pointers_made #=> 1
+    #   @return [Integer] the matchup three pointers made
+    attribute :matchup_three_pointers_made, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_three_pointers_attempted
+    #   Returns the three pointers attempted in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_three_pointers_attempted #=> 3
+    #   @return [Integer] the matchup three pointers attempted
+    attribute :matchup_three_pointers_attempted, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_three_pointers_percentage
+    #   Returns the three point percentage in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_three_pointers_percentage #=> 0.333
+    #   @return [Float] the matchup three point percentage
+    attribute :matchup_three_pointers_percentage, Shale::Type::Float
+
+    # @!attribute [rw] help_blocks
+    #   Returns the help blocks in the matchup
+    #   @api public
+    #   @example
+    #     stat.help_blocks #=> 1
+    #   @return [Integer] the help blocks
+    attribute :help_blocks, Shale::Type::Integer
+
+    # @!attribute [rw] help_field_goals_made
+    #   Returns the help field goals made in the matchup
+    #   @api public
+    #   @example
+    #     stat.help_field_goals_made #=> 2
+    #   @return [Integer] the help field goals made
+    attribute :help_field_goals_made, Shale::Type::Integer
+
+    # @!attribute [rw] help_field_goals_attempted
+    #   Returns the help field goals attempted in the matchup
+    #   @api public
+    #   @example
+    #     stat.help_field_goals_attempted #=> 4
+    #   @return [Integer] the help field goals attempted
+    attribute :help_field_goals_attempted, Shale::Type::Integer
+
+    # @!attribute [rw] help_field_goals_percentage
+    #   Returns the help field goal percentage in the matchup
+    #   @api public
+    #   @example
+    #     stat.help_field_goals_percentage #=> 0.5
+    #   @return [Float] the help field goal percentage
+    attribute :help_field_goals_percentage, Shale::Type::Float
+
+    # @!attribute [rw] matchup_free_throws_made
+    #   Returns the free throws made in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_free_throws_made #=> 2
+    #   @return [Integer] the matchup free throws made
+    attribute :matchup_free_throws_made, Shale::Type::Integer
+
+    # @!attribute [rw] matchup_free_throws_attempted
+    #   Returns the free throws attempted in the matchup
+    #   @api public
+    #   @example
+    #     stat.matchup_free_throws_attempted #=> 2
+    #   @return [Integer] the matchup free throws attempted
+    attribute :matchup_free_throws_attempted, Shale::Type::Integer
+
+    # @!attribute [rw] shooting_fouls
+    #   Returns the shooting fouls drawn in the matchup
+    #   @api public
+    #   @example
+    #     stat.shooting_fouls #=> 1
+    #   @return [Integer] the shooting fouls
+    attribute :shooting_fouls, Shale::Type::Integer
+
+    # Returns the offensive player object
+    #
+    # @api public
+    # @example
+    #   stat.offensive_player #=> #<NBA::Player>
+    # @return [Player, nil] the offensive player object
+    def offensive_player
+      Players.find(person_id_off)
+    end
+
+    # Returns the defensive player object
+    #
+    # @api public
+    # @example
+    #   stat.defensive_player #=> #<NBA::Player>
+    # @return [Player, nil] the defensive player object
+    def defensive_player
+      Players.find(person_id_def)
+    end
+
+    # Returns the team object
+    #
+    # @api public
+    # @example
+    #   stat.team #=> #<NBA::Team>
+    # @return [Team, nil] the team object
+    def team
+      Teams.find(team_id)
+    end
+
+    # Returns the game object for this matchup
+    #
+    # @api public
+    # @example
+    #   stat.game #=> #<NBA::Game>
+    # @return [Game, nil] the game object
+    def game
+      Games.find(game_id)
+    end
+  end
+end

data/lib/nba/box_score_matchups_v3.rb

@@ -0,0 +1,184 @@
+require "json"
+require_relative "client"
+require_relative "collection"
+require_relative "box_score_matchup_stat"
+require_relative "utils"
+
+module NBA
+  # Provides methods to retrieve player matchup statistics using V3 API
+  module BoxScoreMatchupsV3
+    # @return [String] JSON key for matchup box score data
+    BOX_SCORE_KEY = "boxScoreMatchups".freeze
+    # @return [String] JSON key for player stats result set
+    PLAYER_STATS = "PlayerStats".freeze
+
+    # Retrieves player matchup stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreMatchupsV3.find(game: "0022400001")
+    #   stats.each { |stat| puts "#{stat.first_name_off} vs #{stat.first_name_def}" }
+    # @param game [String, Integer, Game] the game ID or Game object
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of player matchup stats
+    def self.find(game:, client: CLIENT)
+      game_id = Utils.extract_id(game)
+      response = client.get(build_path(game_id))
+      parse_response(response, game_id)
+    end
+
+    # Builds the API request path
+    # @api private
+    # @return [String] the request path
+    def self.build_path(game_id)
+      "boxscorematchupsv3?GameID=#{game_id}"
+    end
+    private_class_method :build_path
+
+    # Parses the API response into matchup stat objects
+    # @api private
+    # @return [Collection] collection of matchup stats
+    def self.parse_response(response, game_id)
+      return Collection.new unless response
+
+      data = JSON.parse(response)
+      matchups = extract_matchups(data)
+      return Collection.new unless matchups
+
+      Collection.new(matchups.map { |m| build_matchup_stat(m, game_id) })
+    end
+    private_class_method :parse_response
+
+    # Extracts matchups from box score data
+    # @api private
+    # @param data [Hash] parsed JSON response
+    # @return [Array, nil] array of matchup data or nil if not found
+    def self.extract_matchups(data)
+      box_score = data[BOX_SCORE_KEY]
+      return unless box_score
+
+      home = box_score.dig("homeTeam", "players") || []
+      away = box_score.dig("awayTeam", "players") || []
+      home + away
+    end
+    private_class_method :extract_matchups
+
+    # Builds a matchup stat object from raw data
+    # @api private
+    # @return [BoxScoreMatchupStat] the matchup stat object
+    def self.build_matchup_stat(matchup, game_id)
+      BoxScoreMatchupStat.new(game_id: game_id, **team_identity(matchup), **player_identities(matchup),
+        **matchup_stats(matchup))
+    end
+    private_class_method :build_matchup_stat
+
+    # Extracts team identity attributes from matchup data
+    # @api private
+    # @return [Hash] team identity attributes
+    def self.team_identity(matchup)
+      {team_id: matchup["teamId"], team_city: matchup["teamCity"],
+       team_name: matchup["teamName"], team_tricode: matchup["teamTricode"],
+       team_slug: matchup["teamSlug"]}
+    end
+    private_class_method :team_identity
+
+    # Extracts both offensive and defensive player identity attributes
+    # @api private
+    # @return [Hash] player identity attributes
+    def self.player_identities(matchup)
+      offensive_player_identity(matchup).merge(defensive_player_identity(matchup))
+    end
+    private_class_method :player_identities
+
+    # Extracts offensive player identity attributes from matchup data
+    # @api private
+    # @return [Hash] offensive player identity attributes
+    def self.offensive_player_identity(matchup)
+      {person_id_off: matchup["personIdOff"], first_name_off: matchup["firstNameOff"],
+       family_name_off: matchup["familyNameOff"], name_i_off: matchup["nameIOff"],
+       player_slug_off: matchup["playerSlugOff"], jersey_num_off: matchup["jerseyNumOff"]}
+    end
+    private_class_method :offensive_player_identity
+
+    # Extracts defensive player identity attributes from matchup data
+    # @api private
+    # @return [Hash] defensive player identity attributes
+    def self.defensive_player_identity(matchup)
+      {person_id_def: matchup["personIdDef"], first_name_def: matchup["firstNameDef"],
+       family_name_def: matchup["familyNameDef"], name_i_def: matchup["nameIDef"],
+       player_slug_def: matchup["playerSlugDef"], position_def: matchup["positionDef"],
+       comment_def: matchup["commentDef"], jersey_num_def: matchup["jerseyNumDef"]}
+    end
+    private_class_method :defensive_player_identity
+
+    # Extracts all matchup statistics
+    # @api private
+    # @return [Hash] combined matchup statistics
+    def self.matchup_stats(matchup)
+      matchup_time_stats(matchup).merge(matchup_counting_stats(matchup), matchup_shooting_stats(matchup))
+    end
+    private_class_method :matchup_stats
+
+    # Extracts matchup time statistics from matchup data
+    # @api private
+    # @return [Hash] matchup time statistics
+    def self.matchup_time_stats(matchup)
+      {matchup_minutes: matchup["matchupMinutes"], matchup_minutes_sort: matchup["matchupMinutesSort"],
+       partial_possessions: matchup["partialPossessions"],
+       percentage_defender_total_time: matchup["percentageDefenderTotalTime"],
+       percentage_offensive_total_time: matchup["percentageOffensiveTotalTime"],
+       percentage_total_time_both_on: matchup["percentageTotalTimeBothOn"], switches_on: matchup["switchesOn"]}
+    end
+    private_class_method :matchup_time_stats
+
+    # Extracts matchup counting statistics from matchup data
+    # @api private
+    # @return [Hash] matchup counting statistics
+    def self.matchup_counting_stats(matchup)
+      {player_points: matchup["playerPoints"], team_points: matchup["teamPoints"],
+       matchup_assists: matchup["matchupAssists"], matchup_potential_assists: matchup["matchupPotentialAssists"],
+       matchup_turnovers: matchup["matchupTurnovers"], matchup_blocks: matchup["matchupBlocks"]}
+    end
+    private_class_method :matchup_counting_stats
+
+    # Extracts all matchup shooting statistics from matchup data
+    # @api private
+    # @return [Hash] matchup shooting statistics
+    def self.matchup_shooting_stats(matchup)
+      fg_stats(matchup).merge(three_pt_stats(matchup), help_and_ft_stats(matchup))
+    end
+    private_class_method :matchup_shooting_stats
+
+    # Extracts field goal statistics from matchup data
+    # @api private
+    # @return [Hash] field goal statistics
+    def self.fg_stats(data)
+      {matchup_field_goals_made: data["matchupFieldGoalsMade"],
+       matchup_field_goals_attempted: data["matchupFieldGoalsAttempted"],
+       matchup_field_goals_percentage: data["matchupFieldGoalsPercentage"]}
+    end
+    private_class_method :fg_stats
+
+    # Extracts three-pointer statistics from matchup data
+    # @api private
+    # @return [Hash] three-pointer statistics
+    def self.three_pt_stats(data)
+      {matchup_three_pointers_made: data["matchupThreePointersMade"],
+       matchup_three_pointers_attempted: data["matchupThreePointersAttempted"],
+       matchup_three_pointers_percentage: data["matchupThreePointersPercentage"]}
+    end
+    private_class_method :three_pt_stats
+
+    # Extracts help defense and free throw statistics from matchup data
+    # @api private
+    # @return [Hash] help defense and free throw statistics
+    def self.help_and_ft_stats(data)
+      {help_blocks: data["helpBlocks"], help_field_goals_made: data["helpFieldGoalsMade"],
+       help_field_goals_attempted: data["helpFieldGoalsAttempted"],
+       help_field_goals_percentage: data["helpFieldGoalsPercentage"],
+       matchup_free_throws_made: data["matchupFreeThrowsMade"],
+       matchup_free_throws_attempted: data["matchupFreeThrowsAttempted"], shooting_fouls: data["shootingFouls"]}
+    end
+    private_class_method :help_and_ft_stats
+  end
+end

data/lib/nba/box_score_misc.rb

@@ -0,0 +1,100 @@
+require_relative "client"
+require_relative "response_parser"
+require_relative "box_score_misc_player_stat"
+require_relative "box_score_misc_team_stat"
+require_relative "utils"
+
+module NBA
+  # Provides methods to retrieve miscellaneous box score statistics
+  module BoxScoreMisc
+    # Result set name for player stats
+    # @return [String] the result set name
+    PLAYER_STATS = "PlayerStats".freeze
+
+    # Result set name for team stats
+    # @return [String] the result set name
+    TEAM_STATS = "TeamStats".freeze
+
+    # Retrieves player miscellaneous box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreMisc.player_stats(game: "0022400001")
+    #   stats.each { |s| puts "#{s.player_name}: #{s.pts_paint} paint pts" }
+    # @param game [String, Game] the game ID or Game object
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of player miscellaneous box score stats
+    def self.player_stats(game:, client: CLIENT)
+      path = "boxscoremiscv2?GameID=#{Utils.extract_id(game)}"
+      ResponseParser.parse(client.get(path), result_set: PLAYER_STATS) { |data| build_player_stat(data) }
+    end
+
+    # Retrieves team miscellaneous box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreMisc.team_stats(game: "0022400001")
+    #   stats.each { |s| puts "#{s.team_name}: #{s.pts_fb} fast break pts" }
+    # @param game [String, Game] the game ID or Game object
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of team miscellaneous box score stats
+    def self.team_stats(game:, client: CLIENT)
+      path = "boxscoremiscv2?GameID=#{Utils.extract_id(game)}"
+      ResponseParser.parse(client.get(path), result_set: TEAM_STATS) { |data| build_team_stat(data) }
+    end
+
+    # Builds a player miscellaneous stat from API data
+    # @api private
+    # @return [BoxScoreMiscPlayerStat]
+    def self.build_player_stat(data)
+      BoxScoreMiscPlayerStat.new(**player_identity(data), **scoring_stats(data), **defense_stats(data))
+    end
+    private_class_method :build_player_stat
+
+    # Builds a team miscellaneous stat from API data
+    # @api private
+    # @return [BoxScoreMiscTeamStat]
+    def self.build_team_stat(data)
+      BoxScoreMiscTeamStat.new(**team_identity(data), **scoring_stats(data), **defense_stats(data))
+    end
+    private_class_method :build_team_stat
+
+    # Extracts player identity attributes from data
+    # @api private
+    # @return [Hash]
+    def self.player_identity(data)
+      {game_id: data["GAME_ID"], team_id: data["TEAM_ID"], team_abbreviation: data["TEAM_ABBREVIATION"],
+       team_city: data["TEAM_CITY"], player_id: data["PLAYER_ID"], player_name: data["PLAYER_NAME"],
+       start_position: data["START_POSITION"], comment: data["COMMENT"], min: data["MIN"]}
+    end
+    private_class_method :player_identity
+
+    # Extracts team identity attributes from data
+    # @api private
+    # @return [Hash]
+    def self.team_identity(data)
+      {game_id: data["GAME_ID"], team_id: data["TEAM_ID"], team_name: data["TEAM_NAME"],
+       team_abbreviation: data["TEAM_ABBREVIATION"], team_city: data["TEAM_CITY"], min: data["MIN"]}
+    end
+    private_class_method :team_identity
+
+    # Extracts scoring statistics from data
+    # @api private
+    # @return [Hash]
+    def self.scoring_stats(data)
+      {pts_off_tov: data["PTS_OFF_TOV"], pts_2nd_chance: data["PTS_2ND_CHANCE"],
+       pts_fb: data["PTS_FB"], pts_paint: data["PTS_PAINT"],
+       opp_pts_off_tov: data["OPP_PTS_OFF_TOV"], opp_pts_2nd_chance: data["OPP_PTS_2ND_CHANCE"],
+       opp_pts_fb: data["OPP_PTS_FB"], opp_pts_paint: data["OPP_PTS_PAINT"]}
+    end
+    private_class_method :scoring_stats
+
+    # Extracts defense statistics from data
+    # @api private
+    # @return [Hash]
+    def self.defense_stats(data)
+      {blk: data["BLK"], blka: data["BLKA"], pf: data["PF"], pfd: data["PFD"]}
+    end
+    private_class_method :defense_stats
+  end
+end