nba 0.1.1 → 0.2.0

data/lib/nba/estimated_metrics_stat.rb

@@ -0,0 +1,152 @@
+module NBA
+  # Represents player estimated metrics
+  class EstimatedMetricsStat < Shale::Mapper
+    include Equalizer.new(:player_id)
+
+    # @!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] gp
+    #   Returns games played
+    #   @api public
+    #   @example
+    #     stat.gp #=> 74
+    #   @return [Integer] games played
+    attribute :gp, Shale::Type::Integer
+
+    # @!attribute [rw] w
+    #   Returns wins
+    #   @api public
+    #   @example
+    #     stat.w #=> 46
+    #   @return [Integer] wins
+    attribute :w, Shale::Type::Integer
+
+    # @!attribute [rw] l
+    #   Returns losses
+    #   @api public
+    #   @example
+    #     stat.l #=> 28
+    #   @return [Integer] losses
+    attribute :l, Shale::Type::Integer
+
+    # @!attribute [rw] w_pct
+    #   Returns win percentage
+    #   @api public
+    #   @example
+    #     stat.w_pct #=> 0.622
+    #   @return [Float] win percentage
+    attribute :w_pct, Shale::Type::Float
+
+    # @!attribute [rw] min
+    #   Returns minutes per game
+    #   @api public
+    #   @example
+    #     stat.min #=> 32.7
+    #   @return [Float] minutes
+    attribute :min, Shale::Type::Float
+
+    # @!attribute [rw] e_off_rating
+    #   Returns estimated offensive rating
+    #   @api public
+    #   @example
+    #     stat.e_off_rating #=> 117.5
+    #   @return [Float] estimated offensive rating
+    attribute :e_off_rating, Shale::Type::Float
+
+    # @!attribute [rw] e_def_rating
+    #   Returns estimated defensive rating
+    #   @api public
+    #   @example
+    #     stat.e_def_rating #=> 110.2
+    #   @return [Float] estimated defensive rating
+    attribute :e_def_rating, Shale::Type::Float
+
+    # @!attribute [rw] e_net_rating
+    #   Returns estimated net rating
+    #   @api public
+    #   @example
+    #     stat.e_net_rating #=> 7.3
+    #   @return [Float] estimated net rating
+    attribute :e_net_rating, Shale::Type::Float
+
+    # @!attribute [rw] e_ast_ratio
+    #   Returns estimated assist ratio
+    #   @api public
+    #   @example
+    #     stat.e_ast_ratio #=> 25.5
+    #   @return [Float] estimated assist ratio
+    attribute :e_ast_ratio, Shale::Type::Float
+
+    # @!attribute [rw] e_oreb_pct
+    #   Returns estimated offensive rebound percentage
+    #   @api public
+    #   @example
+    #     stat.e_oreb_pct #=> 2.5
+    #   @return [Float] estimated offensive rebound percentage
+    attribute :e_oreb_pct, Shale::Type::Float
+
+    # @!attribute [rw] e_dreb_pct
+    #   Returns estimated defensive rebound percentage
+    #   @api public
+    #   @example
+    #     stat.e_dreb_pct #=> 15.5
+    #   @return [Float] estimated defensive rebound percentage
+    attribute :e_dreb_pct, Shale::Type::Float
+
+    # @!attribute [rw] e_reb_pct
+    #   Returns estimated rebound percentage
+    #   @api public
+    #   @example
+    #     stat.e_reb_pct #=> 9.5
+    #   @return [Float] estimated rebound percentage
+    attribute :e_reb_pct, Shale::Type::Float
+
+    # @!attribute [rw] e_tov_pct
+    #   Returns estimated turnover percentage
+    #   @api public
+    #   @example
+    #     stat.e_tov_pct #=> 11.5
+    #   @return [Float] estimated turnover percentage
+    attribute :e_tov_pct, Shale::Type::Float
+
+    # @!attribute [rw] e_usg_pct
+    #   Returns estimated usage percentage
+    #   @api public
+    #   @example
+    #     stat.e_usg_pct #=> 31.5
+    #   @return [Float] estimated usage percentage
+    attribute :e_usg_pct, Shale::Type::Float
+
+    # @!attribute [rw] e_pace
+    #   Returns estimated pace
+    #   @api public
+    #   @example
+    #     stat.e_pace #=> 101.5
+    #   @return [Float] estimated pace
+    attribute :e_pace, 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
+  end
+end

data/lib/nba/fantasy_profile_stat.rb

@@ -0,0 +1,142 @@
+require "equalizer"
+require "shale"
+require_relative "players"
+
+module NBA
+  # Represents a player's fantasy profile statistics
+  #
+  # @api public
+  class FantasyProfileStat < Shale::Mapper
+    include Equalizer.new(:player_id, :player_name)
+
+    # @!attribute [rw] player_id
+    #   Returns the player ID
+    #   @api public
+    #   @example
+    #     stat.player_id #=> 201939
+    #   @return [Integer, nil] the player's 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, nil] the player's name
+    attribute :player_name, Shale::Type::String
+
+    # @!attribute [rw] team_id
+    #   Returns the team ID
+    #   @api public
+    #   @example
+    #     stat.team_id #=> 1610612744
+    #   @return [Integer, nil] the team's ID
+    attribute :team_id, Shale::Type::Integer
+
+    # @!attribute [rw] team_abbreviation
+    #   Returns the team abbreviation
+    #   @api public
+    #   @example
+    #     stat.team_abbreviation #=> "GSW"
+    #   @return [String, nil] the team's abbreviation
+    attribute :team_abbreviation, Shale::Type::String
+
+    # @!attribute [rw] fan_duel_pts
+    #   Returns FanDuel fantasy points
+    #   @api public
+    #   @example
+    #     stat.fan_duel_pts #=> 45.2
+    #   @return [Float, nil] FanDuel fantasy points
+    attribute :fan_duel_pts, Shale::Type::Float
+
+    # @!attribute [rw] nba_fantasy_pts
+    #   Returns NBA Fantasy points
+    #   @api public
+    #   @example
+    #     stat.nba_fantasy_pts #=> 52.1
+    #   @return [Float, nil] NBA Fantasy points
+    attribute :nba_fantasy_pts, Shale::Type::Float
+
+    # @!attribute [rw] pts
+    #   Returns points per game
+    #   @api public
+    #   @example
+    #     stat.pts #=> 26.4
+    #   @return [Float, nil] points per game
+    attribute :pts, Shale::Type::Float
+
+    # @!attribute [rw] reb
+    #   Returns rebounds per game
+    #   @api public
+    #   @example
+    #     stat.reb #=> 5.7
+    #   @return [Float, nil] rebounds per game
+    attribute :reb, Shale::Type::Float
+
+    # @!attribute [rw] ast
+    #   Returns assists per game
+    #   @api public
+    #   @example
+    #     stat.ast #=> 6.1
+    #   @return [Float, nil] assists per game
+    attribute :ast, Shale::Type::Float
+
+    # @!attribute [rw] fg3m
+    #   Returns 3-point field goals made
+    #   @api public
+    #   @example
+    #     stat.fg3m #=> 4.8
+    #   @return [Float, nil] 3-point field goals made
+    attribute :fg3m, Shale::Type::Float
+
+    # @!attribute [rw] fg_pct
+    #   Returns field goal percentage
+    #   @api public
+    #   @example
+    #     stat.fg_pct #=> 0.472
+    #   @return [Float, nil] field goal percentage
+    attribute :fg_pct, Shale::Type::Float
+
+    # @!attribute [rw] ft_pct
+    #   Returns free throw percentage
+    #   @api public
+    #   @example
+    #     stat.ft_pct #=> 0.908
+    #   @return [Float, nil] free throw percentage
+    attribute :ft_pct, Shale::Type::Float
+
+    # @!attribute [rw] stl
+    #   Returns steals per game
+    #   @api public
+    #   @example
+    #     stat.stl #=> 1.2
+    #   @return [Float, nil] steals per game
+    attribute :stl, Shale::Type::Float
+
+    # @!attribute [rw] blk
+    #   Returns blocks per game
+    #   @api public
+    #   @example
+    #     stat.blk #=> 0.3
+    #   @return [Float, nil] blocks per game
+    attribute :blk, Shale::Type::Float
+
+    # @!attribute [rw] tov
+    #   Returns turnovers per game
+    #   @api public
+    #   @example
+    #     stat.tov #=> 3.1
+    #   @return [Float, nil] turnovers per game
+    attribute :tov, Shale::Type::Float
+
+    # Returns the player
+    #
+    # @api public
+    # @example
+    #   stat.player #=> #<NBA::Player id=201939 ...>
+    # @return [Player, nil] the player object
+    def player
+      Players.find(player_id)
+    end
+  end
+end

data/lib/nba/fantasy_widget.rb

@@ -0,0 +1,72 @@
+require "json"
+require_relative "client"
+require_relative "collection"
+require_relative "fantasy_widget_player"
+require_relative "league"
+require_relative "response_parser"
+require_relative "utils"
+
+module NBA
+  # Provides methods to retrieve NBA fantasy widget statistics
+  module FantasyWidget
+    # Result set name for fantasy widget
+    # @return [String] the result set name
+    RESULT_SET = "FantasyWidgetResult".freeze
+
+    # Retrieves fantasy widget player statistics
+    #
+    # @api public
+    # @example
+    #   players = NBA::FantasyWidget.all(season: 2023)
+    #   players.each { |p| puts "#{p.player_name}: #{p.fan_duel_pts}" }
+    # @param season [Integer] the season year (defaults to current season)
+    # @param season_type [String] the season type (Regular Season, Playoffs, etc.)
+    # @param active_players [String] active players filter (Y, N)
+    # @param last_n_games [Integer] filter to last N games
+    # @param league [String, League] the league ID or League object
+    # @param client [Client] the API client to use
+    # @return [Collection] a collection of fantasy widget players
+    def self.all(season: Utils.current_season, season_type: "Regular Season",
+      active_players: "Y", last_n_games: 0, league: League::NBA, client: CLIENT)
+      league_id = Utils.extract_league_id(league)
+      opts = {season: season, season_type: season_type, active_players: active_players,
+              last_n_games: last_n_games, league_id: league_id}
+      ResponseParser.parse(client.get(build_path(opts)), result_set: RESULT_SET) do |data|
+        build_player(data)
+      end
+    end
+
+    # Builds the API request path
+    # @api private
+    # @return [String] the request path
+    def self.build_path(opts)
+      "fantasywidget?ActivePlayers=#{opts[:active_players]}&LastNGames=#{opts[:last_n_games]}" \
+        "&LeagueID=#{opts[:league_id]}&Season=#{Utils.format_season(opts[:season])}" \
+        "&SeasonType=#{opts[:season_type]}"
+    end
+    private_class_method :build_path
+
+    # Builds a FantasyWidgetPlayer object from raw data
+    # @api private
+    # @param data [Hash] the row data
+    # @return [FantasyWidgetPlayer] the player object
+    def self.build_player(data)
+      FantasyWidgetPlayer.new(**player_attributes(data))
+    end
+    private_class_method :build_player
+
+    # Extracts player attributes from data
+    # @api private
+    # @param data [Hash] the row data
+    # @return [Hash] player attributes
+    def self.player_attributes(data)
+      {player_id: data["PLAYER_ID"], player_name: data["PLAYER_NAME"],
+       player_position: data["PLAYER_POSITION"], team_id: data["TEAM_ID"],
+       team_abbreviation: data["TEAM_ABBREVIATION"], gp: data["GP"],
+       min: data["MIN"], fan_duel_pts: data["FAN_DUEL_PTS"],
+       nba_fantasy_pts: data["NBA_FANTASY_PTS"], pts: data["PTS"],
+       reb: data["REB"], ast: data["AST"]}
+    end
+    private_class_method :player_attributes
+  end
+end

data/lib/nba/fantasy_widget_player.rb

@@ -0,0 +1,98 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents a player's fantasy statistics from the fantasy widget
+  #
+  # @api public
+  # @example
+  #   player.player_name #=> "Stephen Curry"
+  #   player.fan_duel_pts #=> 45.2
+  class FantasyWidgetPlayer < Shale::Mapper
+    include Equalizer.new(:player_id)
+
+    #   Returns the player ID
+    #   @api public
+    #   @example
+    #     player.player_id #=> 201939
+    #   @return [Integer, nil] the player ID
+    attribute :player_id, Shale::Type::Integer
+
+    #   Returns the player name
+    #   @api public
+    #   @example
+    #     player.player_name #=> "Stephen Curry"
+    #   @return [String, nil] the player name
+    attribute :player_name, Shale::Type::String
+
+    #   Returns the player position
+    #   @api public
+    #   @example
+    #     player.player_position #=> "G"
+    #   @return [String, nil] the player position
+    attribute :player_position, Shale::Type::String
+
+    #   Returns the team ID
+    #   @api public
+    #   @example
+    #     player.team_id #=> 1610612744
+    #   @return [Integer, nil] the team ID
+    attribute :team_id, Shale::Type::Integer
+
+    #   Returns the team abbreviation
+    #   @api public
+    #   @example
+    #     player.team_abbreviation #=> "GSW"
+    #   @return [String, nil] the team abbreviation
+    attribute :team_abbreviation, Shale::Type::String
+
+    #   Returns games played
+    #   @api public
+    #   @example
+    #     player.gp #=> 74
+    #   @return [Integer, nil] games played
+    attribute :gp, Shale::Type::Integer
+
+    #   Returns minutes played
+    #   @api public
+    #   @example
+    #     player.min #=> 32.7
+    #   @return [Float, nil] minutes played
+    attribute :min, Shale::Type::Float
+
+    #   Returns FanDuel points
+    #   @api public
+    #   @example
+    #     player.fan_duel_pts #=> 45.2
+    #   @return [Float, nil] FanDuel points
+    attribute :fan_duel_pts, Shale::Type::Float
+
+    #   Returns NBA fantasy points
+    #   @api public
+    #   @example
+    #     player.nba_fantasy_pts #=> 52.8
+    #   @return [Float, nil] NBA fantasy points
+    attribute :nba_fantasy_pts, Shale::Type::Float
+
+    #   Returns points
+    #   @api public
+    #   @example
+    #     player.pts #=> 26.4
+    #   @return [Float, nil] points
+    attribute :pts, Shale::Type::Float
+
+    #   Returns rebounds
+    #   @api public
+    #   @example
+    #     player.reb #=> 5.1
+    #   @return [Float, nil] rebounds
+    attribute :reb, Shale::Type::Float
+
+    #   Returns assists
+    #   @api public
+    #   @example
+    #     player.ast #=> 6.3
+    #   @return [Float, nil] assists
+    attribute :ast, Shale::Type::Float
+  end
+end