nba 0.1.1 → 0.2.0

data/lib/nba/box_score_traditional.rb

@@ -0,0 +1,101 @@
+require_relative "client"
+require_relative "response_parser"
+require_relative "box_score"
+require_relative "utils"
+
+module NBA
+  # Provides methods to retrieve traditional box score statistics
+  module BoxScoreTraditional
+    # 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 box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreTraditional.player_stats(game: "0022400001")
+    #   stats.each { |s| puts "#{s.player_name}: #{s.pts} 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 box score stats
+    def self.player_stats(game:, client: CLIENT)
+      path = "boxscoretraditionalv2?GameID=#{Utils.extract_id(game)}"
+      ResponseParser.parse(client.get(path), result_set: PLAYER_STATS) { |data| build_player_stat(data) }
+    end
+
+    # Retrieves team box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreTraditional.team_stats(game: "0022400001")
+    #   stats.each { |s| puts "#{s.team_name}: #{s.pts} 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 box score stats
+    def self.team_stats(game:, client: CLIENT)
+      path = "boxscoretraditionalv2?GameID=#{Utils.extract_id(game)}"
+      ResponseParser.parse(client.get(path), result_set: TEAM_STATS) { |data| build_team_stat(data) }
+    end
+
+    # Builds a player stat object from API data
+    # @api private
+    # @return [BoxScorePlayerStat]
+    def self.build_player_stat(data)
+      BoxScorePlayerStat.new(**player_identity(data), **shooting_stats(data), **counting_stats(data))
+    end
+    private_class_method :build_player_stat
+
+    # Builds a team stat object from API data
+    # @api private
+    # @return [BoxScoreTeamStat]
+    def self.build_team_stat(data)
+      BoxScoreTeamStat.new(**team_identity(data), **shooting_stats(data), **counting_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 shooting statistics from data
+    # @api private
+    # @return [Hash]
+    def self.shooting_stats(data)
+      {fgm: data["FGM"], fga: data["FGA"], fg_pct: data["FG_PCT"],
+       fg3m: data["FG3M"], fg3a: data["FG3A"], fg3_pct: data["FG3_PCT"],
+       ftm: data["FTM"], fta: data["FTA"], ft_pct: data["FT_PCT"]}
+    end
+    private_class_method :shooting_stats
+
+    # Extracts counting statistics from data
+    # @api private
+    # @return [Hash]
+    def self.counting_stats(data)
+      {oreb: data["OREB"], dreb: data["DREB"], reb: data["REB"],
+       ast: data["AST"], stl: data["STL"], blk: data["BLK"],
+       tov: data["TO"], pf: data["PF"], pts: data["PTS"],
+       plus_minus: data["PLUS_MINUS"]}
+    end
+    private_class_method :counting_stats
+  end
+end

data/lib/nba/box_score_traditional_v3.rb

@@ -0,0 +1,195 @@
+require "json"
+require_relative "client"
+require_relative "collection"
+require_relative "box_score_player_stat"
+require_relative "box_score_team_stat"
+require_relative "box_score_starter_bench_stat"
+require_relative "box_score_v3_helpers"
+require_relative "utils"
+
+module NBA
+  # Provides methods to retrieve traditional box score statistics using V3 API
+  module BoxScoreTraditionalV3
+    # @return [String] JSON key for traditional box score data
+    BOX_SCORE_KEY = "boxScoreTraditional".freeze
+    # @return [String] JSON key for player statistics
+    PLAYER_STATS = "PlayerStats".freeze
+    # @return [String] JSON key for team statistics
+    TEAM_STATS = "TeamStats".freeze
+    # @return [String] JSON key for starter/bench statistics
+    STARTER_BENCH_STATS = "TeamStarterBenchStats".freeze
+
+    # Retrieves player box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreTraditionalV3.player_stats(game: "0022400001")
+    #   stats.each { |stat| puts "#{stat.player_name}: #{stat.pts} pts" }
+    # @param game [String, Integer] the game ID
+    # @param start_period [Integer] the starting period
+    # @param end_period [Integer] the ending period
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of player stats
+    def self.player_stats(game:, start_period: 0, end_period: 0, client: CLIENT)
+      game_id = Utils.extract_id(game)
+      response = client.get(build_path(game_id, start_period, end_period))
+      parse_player_response(response, game_id)
+    end
+
+    # Retrieves team box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreTraditionalV3.team_stats(game: "0022400001")
+    #   stats.each { |stat| puts "#{stat.team_abbreviation}: #{stat.pts} pts" }
+    # @param game [String, Integer] the game ID
+    # @param start_period [Integer] the starting period
+    # @param end_period [Integer] the ending period
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of team stats
+    def self.team_stats(game:, start_period: 0, end_period: 0, client: CLIENT)
+      game_id = Utils.extract_id(game)
+      response = client.get(build_path(game_id, start_period, end_period))
+      parse_team_response(response, game_id)
+    end
+
+    # Retrieves starter vs bench breakdown stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreTraditionalV3.starter_bench_stats(game: "0022400001")
+    #   stats.each { |stat| puts "#{stat.team_abbreviation} #{stat.starters_bench}: #{stat.pts} pts" }
+    # @param game [String, Integer] the game ID
+    # @param start_period [Integer] the starting period
+    # @param end_period [Integer] the ending period
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of starter/bench stats
+    def self.starter_bench_stats(game:, start_period: 0, end_period: 0, client: CLIENT)
+      game_id = Utils.extract_id(game)
+      response = client.get(build_path(game_id, start_period, end_period))
+      parse_starter_bench_response(response, game_id)
+    end
+
+    # Builds the API request path
+    # @api private
+    # @return [String] the request path
+    def self.build_path(game_id, start_period, end_period)
+      "boxscoretraditionalv3?GameID=#{game_id}&StartPeriod=#{start_period}" \
+        "&EndPeriod=#{end_period}&StartRange=0&EndRange=0&RangeType=0"
+    end
+    private_class_method :build_path
+
+    # Parses the API response into player stat objects
+    # @api private
+    # @return [Collection] collection of player stats
+    def self.parse_player_response(response, game_id)
+      return Collection.new unless response
+
+      data = JSON.parse(response)
+      players = BoxScoreV3Helpers.extract_players(data, BOX_SCORE_KEY)
+      return Collection.new unless players
+
+      Collection.new(players.map { |p| build_player_stat(p, game_id) })
+    end
+    private_class_method :parse_player_response
+
+    # Parses the API response into team stat objects
+    # @api private
+    # @return [Collection] collection of team stats
+    def self.parse_team_response(response, game_id)
+      return Collection.new unless response
+
+      data = JSON.parse(response)
+      teams = BoxScoreV3Helpers.extract_teams(data, BOX_SCORE_KEY)
+      return Collection.new unless teams
+
+      Collection.new(teams.map { |t| build_team_stat(t, game_id) })
+    end
+    private_class_method :parse_team_response
+
+    # Parses the API response into starter/bench stat objects
+    # @api private
+    # @return [Collection] collection of starter/bench stats
+    def self.parse_starter_bench_response(response, game_id)
+      return Collection.new unless response
+
+      data = JSON.parse(response)
+      stat_data = extract_starter_bench(data)
+      return Collection.new unless stat_data
+
+      Collection.new(stat_data.map { |d| build_starter_bench_stat(d, game_id) })
+    end
+    private_class_method :parse_starter_bench_response
+
+    # Extracts starter/bench data from parsed response
+    # @api private
+    # @return [Array, nil] array of starter/bench data or nil
+    def self.extract_starter_bench(data)
+      box_score = data[BOX_SCORE_KEY]
+      return unless box_score
+
+      stats = []
+      add_team_starter_bench(stats, box_score, "homeTeam")
+      add_team_starter_bench(stats, box_score, "awayTeam")
+      stats
+    end
+    private_class_method :extract_starter_bench
+
+    # Adds starter/bench data for a team
+    # @api private
+    # @return [void]
+    def self.add_team_starter_bench(stats, box_score, team_key)
+      team = box_score[team_key]
+      return unless team
+
+      %w[starters bench].each do |group|
+        group_stats = team.dig("statistics", group)
+        stats << {team: team, group: group, stats: group_stats} if group_stats
+      end
+    end
+    private_class_method :add_team_starter_bench
+
+    # Builds a player stat object from raw data
+    # @api private
+    # @return [BoxScorePlayerStat] the player stat object
+    def self.build_player_stat(player, game_id)
+      stats = player.fetch("statistics", {})
+      BoxScorePlayerStat.new(
+        **BoxScoreV3Helpers.player_identity(player, game_id),
+        min: stats["minutes"],
+        **BoxScoreV3Helpers.shooting_stats(stats),
+        **BoxScoreV3Helpers.counting_stats(stats)
+      )
+    end
+    private_class_method :build_player_stat
+
+    # Builds a team stat object from raw data
+    # @api private
+    # @return [BoxScoreTeamStat] the team stat object
+    def self.build_team_stat(team, game_id)
+      stats = team.fetch("statistics", {})
+      BoxScoreTeamStat.new(
+        **BoxScoreV3Helpers.team_identity(team, game_id),
+        min: stats["minutes"],
+        **BoxScoreV3Helpers.shooting_stats(stats),
+        **BoxScoreV3Helpers.counting_stats(stats)
+      )
+    end
+    private_class_method :build_team_stat
+
+    # Builds a starter/bench stat object from raw data
+    # @api private
+    # @return [BoxScoreStarterBenchStat] the starter/bench stat object
+    def self.build_starter_bench_stat(data, game_id)
+      team = data.fetch(:team)
+      stats = data.fetch(:stats)
+      BoxScoreStarterBenchStat.new(
+        **BoxScoreV3Helpers.team_identity(team, game_id),
+        starters_bench: data.fetch(:group), min: stats["minutes"],
+        **BoxScoreV3Helpers.shooting_stats(stats),
+        **BoxScoreV3Helpers.counting_stats(stats)
+      )
+    end
+    private_class_method :build_starter_bench_stat
+  end
+end

data/lib/nba/box_score_usage.rb

@@ -0,0 +1,102 @@
+require_relative "client"
+require_relative "response_parser"
+require_relative "box_score_usage_player_stat"
+require_relative "box_score_usage_team_stat"
+require_relative "utils"
+
+module NBA
+  # Provides methods to retrieve usage box score statistics
+  module BoxScoreUsage
+    # 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 usage box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreUsage.player_stats(game: "0022400001")
+    #   stats.each { |s| puts "#{s.player_name}: #{s.usg_pct}% usage" }
+    # @param game [String, Game] the game ID or Game object
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of player usage box score stats
+    def self.player_stats(game:, client: CLIENT)
+      path = "boxscoreusagev2?GameID=#{Utils.extract_id(game)}"
+      ResponseParser.parse(client.get(path), result_set: PLAYER_STATS) { |data| build_player_stat(data) }
+    end
+
+    # Retrieves team usage box score stats for a game
+    #
+    # @api public
+    # @example
+    #   stats = NBA::BoxScoreUsage.team_stats(game: "0022400001")
+    #   stats.each { |s| puts "#{s.team_name}: #{s.pct_pts}% of 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 usage box score stats
+    def self.team_stats(game:, client: CLIENT)
+      path = "boxscoreusagev2?GameID=#{Utils.extract_id(game)}"
+      ResponseParser.parse(client.get(path), result_set: TEAM_STATS) { |data| build_team_stat(data) }
+    end
+
+    # Builds a player usage stat from API data
+    # @api private
+    # @return [BoxScoreUsagePlayerStat]
+    def self.build_player_stat(data)
+      BoxScoreUsagePlayerStat.new(**player_identity(data), **shooting_usage(data), **other_usage(data))
+    end
+    private_class_method :build_player_stat
+
+    # Builds a team usage stat from API data
+    # @api private
+    # @return [BoxScoreUsageTeamStat]
+    def self.build_team_stat(data)
+      BoxScoreUsageTeamStat.new(**team_identity(data), **shooting_usage(data), **other_usage(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 shooting usage statistics from data
+    # @api private
+    # @return [Hash]
+    def self.shooting_usage(data)
+      {usg_pct: data["USG_PCT"], pct_fgm: data["PCT_FGM"], pct_fga: data["PCT_FGA"],
+       pct_fg3m: data["PCT_FG3M"], pct_fg3a: data["PCT_FG3A"],
+       pct_ftm: data["PCT_FTM"], pct_fta: data["PCT_FTA"]}
+    end
+    private_class_method :shooting_usage
+
+    # Extracts other usage statistics from data
+    # @api private
+    # @return [Hash]
+    def self.other_usage(data)
+      {pct_oreb: data["PCT_OREB"], pct_dreb: data["PCT_DREB"], pct_reb: data["PCT_REB"],
+       pct_ast: data["PCT_AST"], pct_tov: data["PCT_TOV"], pct_stl: data["PCT_STL"],
+       pct_blk: data["PCT_BLK"], pct_blka: data["PCT_BLKA"],
+       pct_pf: data["PCT_PF"], pct_pfd: data["PCT_PFD"], pct_pts: data["PCT_PTS"]}
+    end
+    private_class_method :other_usage
+  end
+end

data/lib/nba/box_score_usage_player_stat.rb

@@ -0,0 +1,265 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents a player's usage box score statistics for a game
+  class BoxScoreUsagePlayerStat < Shale::Mapper
+    include Equalizer.new(:game_id, :player_id)
+
+    # @!attribute [rw] game_id
+    #   Returns the game ID
+    #   @api public
+    #   @example
+    #     stat.game_id #=> "0022400565"
+    #   @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_abbreviation
+    #   Returns the team abbreviation
+    #   @api public
+    #   @example
+    #     stat.team_abbreviation #=> "GSW"
+    #   @return [String] the team abbreviation
+    attribute :team_abbreviation, Shale::Type::String
+
+    # @!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] player_id
+    #   Returns the player ID
+    #   @api public
+    #   @example
+    #     stat.player_id #=> 201939
+    #   @return [Integer] the player ID
+    attribute :player_id, Shale::Type::Integer
+
+    # @!attribute [rw] player_name
+    #   Returns the player name
+    #   @api public
+    #   @example
+    #     stat.player_name #=> "Stephen Curry"
+    #   @return [String] the player name
+    attribute :player_name, Shale::Type::String
+
+    # @!attribute [rw] start_position
+    #   Returns the starting position
+    #   @api public
+    #   @example
+    #     stat.start_position #=> "G"
+    #   @return [String] the starting position
+    attribute :start_position, Shale::Type::String
+
+    # @!attribute [rw] comment
+    #   Returns any comment (e.g., "DNP - Rest")
+    #   @api public
+    #   @example
+    #     stat.comment #=> "DNP - Rest"
+    #   @return [String] the comment
+    attribute :comment, Shale::Type::String
+
+    # @!attribute [rw] min
+    #   Returns minutes played
+    #   @api public
+    #   @example
+    #     stat.min #=> "35:24"
+    #   @return [String] the minutes played
+    attribute :min, Shale::Type::String
+
+    # @!attribute [rw] usg_pct
+    #   Returns usage percentage
+    #   @api public
+    #   @example
+    #     stat.usg_pct #=> 0.285
+    #   @return [Float] usage percentage
+    attribute :usg_pct, Shale::Type::Float
+
+    # @!attribute [rw] pct_fgm
+    #   Returns percentage of team field goals made
+    #   @api public
+    #   @example
+    #     stat.pct_fgm #=> 0.24
+    #   @return [Float] the percentage
+    attribute :pct_fgm, Shale::Type::Float
+
+    # @!attribute [rw] pct_fga
+    #   Returns percentage of team field goals attempted
+    #   @api public
+    #   @example
+    #     stat.pct_fga #=> 0.27
+    #   @return [Float] the percentage
+    attribute :pct_fga, Shale::Type::Float
+
+    # @!attribute [rw] pct_fg3m
+    #   Returns percentage of team 3-pointers made
+    #   @api public
+    #   @example
+    #     stat.pct_fg3m #=> 0.35
+    #   @return [Float] the percentage
+    attribute :pct_fg3m, Shale::Type::Float
+
+    # @!attribute [rw] pct_fg3a
+    #   Returns percentage of team 3-pointers attempted
+    #   @api public
+    #   @example
+    #     stat.pct_fg3a #=> 0.38
+    #   @return [Float] the percentage
+    attribute :pct_fg3a, Shale::Type::Float
+
+    # @!attribute [rw] pct_ftm
+    #   Returns percentage of team free throws made
+    #   @api public
+    #   @example
+    #     stat.pct_ftm #=> 0.28
+    #   @return [Float] the percentage
+    attribute :pct_ftm, Shale::Type::Float
+
+    # @!attribute [rw] pct_fta
+    #   Returns percentage of team free throws attempted
+    #   @api public
+    #   @example
+    #     stat.pct_fta #=> 0.30
+    #   @return [Float] the percentage
+    attribute :pct_fta, Shale::Type::Float
+
+    # @!attribute [rw] pct_oreb
+    #   Returns percentage of team offensive rebounds
+    #   @api public
+    #   @example
+    #     stat.pct_oreb #=> 0.15
+    #   @return [Float] the percentage
+    attribute :pct_oreb, Shale::Type::Float
+
+    # @!attribute [rw] pct_dreb
+    #   Returns percentage of team defensive rebounds
+    #   @api public
+    #   @example
+    #     stat.pct_dreb #=> 0.22
+    #   @return [Float] the percentage
+    attribute :pct_dreb, Shale::Type::Float
+
+    # @!attribute [rw] pct_reb
+    #   Returns percentage of team total rebounds
+    #   @api public
+    #   @example
+    #     stat.pct_reb #=> 0.19
+    #   @return [Float] the percentage
+    attribute :pct_reb, Shale::Type::Float
+
+    # @!attribute [rw] pct_ast
+    #   Returns percentage of team assists
+    #   @api public
+    #   @example
+    #     stat.pct_ast #=> 0.32
+    #   @return [Float] the percentage
+    attribute :pct_ast, Shale::Type::Float
+
+    # @!attribute [rw] pct_tov
+    #   Returns percentage of team turnovers
+    #   @api public
+    #   @example
+    #     stat.pct_tov #=> 0.18
+    #   @return [Float] the percentage
+    attribute :pct_tov, Shale::Type::Float
+
+    # @!attribute [rw] pct_stl
+    #   Returns percentage of team steals
+    #   @api public
+    #   @example
+    #     stat.pct_stl #=> 0.25
+    #   @return [Float] the percentage
+    attribute :pct_stl, Shale::Type::Float
+
+    # @!attribute [rw] pct_blk
+    #   Returns percentage of team blocks
+    #   @api public
+    #   @example
+    #     stat.pct_blk #=> 0.20
+    #   @return [Float] the percentage
+    attribute :pct_blk, Shale::Type::Float
+
+    # @!attribute [rw] pct_blka
+    #   Returns percentage of team blocked attempts
+    #   @api public
+    #   @example
+    #     stat.pct_blka #=> 0.12
+    #   @return [Float] the percentage
+    attribute :pct_blka, Shale::Type::Float
+
+    # @!attribute [rw] pct_pf
+    #   Returns percentage of team personal fouls
+    #   @api public
+    #   @example
+    #     stat.pct_pf #=> 0.16
+    #   @return [Float] the percentage
+    attribute :pct_pf, Shale::Type::Float
+
+    # @!attribute [rw] pct_pfd
+    #   Returns percentage of team personal fouls drawn
+    #   @api public
+    #   @example
+    #     stat.pct_pfd #=> 0.21
+    #   @return [Float] the percentage
+    attribute :pct_pfd, Shale::Type::Float
+
+    # @!attribute [rw] pct_pts
+    #   Returns percentage of team points
+    #   @api public
+    #   @example
+    #     stat.pct_pts #=> 0.26
+    #   @return [Float] the percentage
+    attribute :pct_pts, Shale::Type::Float
+
+    # Returns the player object
+    #
+    # @api public
+    # @example
+    #   stat.player #=> #<NBA::Player>
+    # @return [Player, nil] the player object
+    def player
+      Players.find(player_id)
+    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 whether the player started the game
+    #
+    # @api public
+    # @example
+    #   stat.starter? #=> true
+    # @return [Boolean] true if the player started
+    def starter?
+      !start_position.nil? && !start_position.empty?
+    end
+
+    # Returns the game object for this box score
+    #
+    # @api public
+    # @example
+    #   stat.game #=> #<NBA::Game>
+    # @return [Game, nil] the game object
+    def game
+      Games.find(game_id)
+    end
+  end
+end