nba 0.1.1 → 0.2.0

data/lib/nba/career_stats.rb

@@ -0,0 +1,217 @@
+require "equalizer"
+require "shale"
+
+module NBA
+  # Represents career statistics for a player (season averages)
+  class CareerStats < Shale::Mapper
+    include Equalizer.new(:player_id, :season_id)
+
+    # @!attribute [rw] player_id
+    #   Returns the player ID
+    #   @api public
+    #   @example
+    #     stats.player_id #=> 201939
+    #   @return [Integer] the player ID
+    attribute :player_id, Shale::Type::Integer
+
+    # @!attribute [rw] season_id
+    #   Returns the season ID
+    #   @api public
+    #   @example
+    #     stats.season_id #=> "2024-25"
+    #   @return [String] the season ID
+    attribute :season_id, Shale::Type::String
+
+    # @!attribute [rw] team_id
+    #   Returns the team ID
+    #   @api public
+    #   @example
+    #     stats.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
+    #     stats.team_abbreviation #=> "GSW"
+    #   @return [String] the team abbreviation
+    attribute :team_abbreviation, Shale::Type::String
+
+    # @!attribute [rw] player_age
+    #   Returns the player's age during the season
+    #   @api public
+    #   @example
+    #     stats.player_age #=> 36
+    #   @return [Integer] the player's age
+    attribute :player_age, Shale::Type::Integer
+
+    # @!attribute [rw] gp
+    #   Returns games played
+    #   @api public
+    #   @example
+    #     stats.gp #=> 74
+    #   @return [Integer] games played
+    attribute :gp, Shale::Type::Integer
+
+    # @!attribute [rw] gs
+    #   Returns games started
+    #   @api public
+    #   @example
+    #     stats.gs #=> 74
+    #   @return [Integer] games started
+    attribute :gs, Shale::Type::Integer
+
+    # @!attribute [rw] min
+    #   Returns minutes per game
+    #   @api public
+    #   @example
+    #     stats.min #=> 32.7
+    #   @return [Float] minutes per game
+    attribute :min, Shale::Type::Float
+
+    # @!attribute [rw] fgm
+    #   Returns field goals made per game
+    #   @api public
+    #   @example
+    #     stats.fgm #=> 8.4
+    #   @return [Float] field goals made per game
+    attribute :fgm, Shale::Type::Float
+
+    # @!attribute [rw] fga
+    #   Returns field goals attempted per game
+    #   @api public
+    #   @example
+    #     stats.fga #=> 17.9
+    #   @return [Float] field goals attempted per game
+    attribute :fga, Shale::Type::Float
+
+    # @!attribute [rw] fg_pct
+    #   Returns field goal percentage
+    #   @api public
+    #   @example
+    #     stats.fg_pct #=> 0.473
+    #   @return [Float] field goal percentage
+    attribute :fg_pct, Shale::Type::Float
+
+    # @!attribute [rw] fg3m
+    #   Returns three-pointers made per game
+    #   @api public
+    #   @example
+    #     stats.fg3m #=> 4.8
+    #   @return [Float] three-pointers made per game
+    attribute :fg3m, Shale::Type::Float
+
+    # @!attribute [rw] fg3a
+    #   Returns three-pointers attempted per game
+    #   @api public
+    #   @example
+    #     stats.fg3a #=> 11.7
+    #   @return [Float] three-pointers attempted per game
+    attribute :fg3a, Shale::Type::Float
+
+    # @!attribute [rw] fg3_pct
+    #   Returns three-point percentage
+    #   @api public
+    #   @example
+    #     stats.fg3_pct #=> 0.408
+    #   @return [Float] three-point percentage
+    attribute :fg3_pct, Shale::Type::Float
+
+    # @!attribute [rw] ftm
+    #   Returns free throws made per game
+    #   @api public
+    #   @example
+    #     stats.ftm #=> 4.5
+    #   @return [Float] free throws made per game
+    attribute :ftm, Shale::Type::Float
+
+    # @!attribute [rw] fta
+    #   Returns free throws attempted per game
+    #   @api public
+    #   @example
+    #     stats.fta #=> 4.9
+    #   @return [Float] free throws attempted per game
+    attribute :fta, Shale::Type::Float
+
+    # @!attribute [rw] ft_pct
+    #   Returns free throw percentage
+    #   @api public
+    #   @example
+    #     stats.ft_pct #=> 0.915
+    #   @return [Float] free throw percentage
+    attribute :ft_pct, Shale::Type::Float
+
+    # @!attribute [rw] oreb
+    #   Returns offensive rebounds per game
+    #   @api public
+    #   @example
+    #     stats.oreb #=> 0.5
+    #   @return [Float] offensive rebounds per game
+    attribute :oreb, Shale::Type::Float
+
+    # @!attribute [rw] dreb
+    #   Returns defensive rebounds per game
+    #   @api public
+    #   @example
+    #     stats.dreb #=> 4.0
+    #   @return [Float] defensive rebounds per game
+    attribute :dreb, Shale::Type::Float
+
+    # @!attribute [rw] reb
+    #   Returns total rebounds per game
+    #   @api public
+    #   @example
+    #     stats.reb #=> 4.5
+    #   @return [Float] total rebounds per game
+    attribute :reb, Shale::Type::Float
+
+    # @!attribute [rw] ast
+    #   Returns assists per game
+    #   @api public
+    #   @example
+    #     stats.ast #=> 5.1
+    #   @return [Float] assists per game
+    attribute :ast, Shale::Type::Float
+
+    # @!attribute [rw] stl
+    #   Returns steals per game
+    #   @api public
+    #   @example
+    #     stats.stl #=> 0.7
+    #   @return [Float] steals per game
+    attribute :stl, Shale::Type::Float
+
+    # @!attribute [rw] blk
+    #   Returns blocks per game
+    #   @api public
+    #   @example
+    #     stats.blk #=> 0.4
+    #   @return [Float] blocks per game
+    attribute :blk, Shale::Type::Float
+
+    # @!attribute [rw] tov
+    #   Returns turnovers per game
+    #   @api public
+    #   @example
+    #     stats.tov #=> 3.0
+    #   @return [Float] turnovers per game
+    attribute :tov, Shale::Type::Float
+
+    # @!attribute [rw] pf
+    #   Returns personal fouls per game
+    #   @api public
+    #   @example
+    #     stats.pf #=> 1.8
+    #   @return [Float] personal fouls per game
+    attribute :pf, Shale::Type::Float
+
+    # @!attribute [rw] pts
+    #   Returns points per game
+    #   @api public
+    #   @example
+    #     stats.pts #=> 26.4
+    #   @return [Float] points per game
+    attribute :pts, Shale::Type::Float
+  end
+end

data/lib/nba/cli/display/player_display.rb

@@ -0,0 +1,98 @@
+module NBA
+  class CLI < Thor
+    module Display
+      # Helper methods for displaying player info
+      module PlayerDisplay
+        # Displays a list of players from search
+        #
+        # @api private
+        # @param players_list [Collection] the players to display
+        # @return [void]
+        def display_players(players_list)
+          say("Found #{players_list.size} player(s):")
+          players_list.each { |player| say(format_player_result(player)) }
+        end
+
+        # Displays detailed information for a single player
+        #
+        # @api private
+        # @param player [Player] the player to display
+        # @return [void]
+        def display_player(player)
+          detail = Players.find(player)
+          return say("Player not found") unless detail
+
+          say(format_label("Name", detail.full_name))
+          say(format_label("Status", detail.active? ? "Active" : "Inactive"))
+          display_player_physical(detail)
+          display_player_draft(detail)
+        end
+
+        # Displays player physical info
+        #
+        # @api private
+        # @param player [Player] the player
+        # @return [void]
+        def display_player_physical(player)
+          display_player_position(player)
+          display_player_body(player)
+          display_player_origin(player)
+        end
+
+        # Displays player draft info
+        #
+        # @api private
+        # @param player [Player] the player
+        # @return [void]
+        def display_player_draft(player)
+          return say(format_label("Draft", "Undrafted")) unless player.draft_year
+
+          draft = format_draft_info(player)
+          say(format_label("Draft", draft))
+        end
+
+        private
+
+        # Displays player position
+        #
+        # @api private
+        # @param player [Player] the player
+        # @return [void]
+        def display_player_position(player)
+          say(format_label("Position", player.position&.name))
+        end
+
+        # Displays player body measurements
+        #
+        # @api private
+        # @param player [Player] the player
+        # @return [void]
+        def display_player_body(player)
+          say(format_label("Height", player.height))
+          say(format_label("Weight", format_weight(player.weight)))
+        end
+
+        # Displays player origin info
+        #
+        # @api private
+        # @param player [Player] the player
+        # @return [void]
+        def display_player_origin(player)
+          say(format_label("Country", player.country))
+          say(format_label("College", player.college))
+        end
+
+        # Formats weight with unit if present
+        #
+        # @api private
+        # @param weight [Integer, nil] the weight value
+        # @return [String, nil] formatted weight or nil
+        def format_weight(weight)
+          return unless weight
+
+          "#{weight} lbs"
+        end
+      end
+    end
+  end
+end

data/lib/nba/cli/display.rb

@@ -0,0 +1,178 @@
+require_relative "display/player_display"
+
+module NBA
+  class CLI < Thor
+    # Helper methods for displaying CLI output
+    module Display
+      include PlayerDisplay
+
+      # Displays a list of games in aligned columns
+      #
+      # @api private
+      # @param games_list [Collection] the games to display
+      # @return [void]
+      def display_games(games_list)
+        widths = calculate_game_widths(games_list)
+        games_list.each { |game| say(format_game_row(game, widths)) }
+      end
+
+      # Displays a list of teams
+      #
+      # @api private
+      # @param teams_list [Collection] the teams to display
+      # @param include_roster [Boolean] whether to include roster
+      # @param detailed [Boolean] whether to show detailed info
+      # @return [void]
+      def display_teams(teams_list, include_roster, detailed:)
+        return display_team_names(teams_list) unless detailed
+
+        teams_list.each_with_index do |team, index|
+          say unless index.zero?
+          display_team(team)
+          display_team_roster(team) if include_roster
+        end
+      end
+
+      # Displays team names only in alphabetical order
+      #
+      # @api private
+      # @param teams_list [Collection] the teams to display
+      # @return [void]
+      def display_team_names(teams_list)
+        sorted = teams_list.sort_by { |team| team.full_name.to_s }
+        sorted.each { |team| say(team.full_name) }
+      end
+
+      # Displays a single team
+      #
+      # @api private
+      # @param team [Team] the team to display
+      # @return [void]
+      def display_team(team)
+        detail = TeamDetails.find(team: team)
+        say(format_label("Name", team.full_name))
+        say(format_label("Founded", team.year_founded))
+        display_team_conference(detail)
+        display_team_division(detail)
+        say(format_label("Coach", detail&.head_coach))
+        display_team_championships(team)
+      end
+
+      # Displays team conference info
+      #
+      # @api private
+      # @param detail [TeamDetail] the team detail
+      # @return [void]
+      def display_team_conference(detail)
+        return say(format_label("Conference", nil)) unless detail
+
+        conf = conference_name(detail)
+        say(format_label("Conference", conf))
+      end
+
+      # Displays team division info
+      #
+      # @api private
+      # @param detail [TeamDetail] the team detail
+      # @return [void]
+      def display_team_division(detail)
+        return say(format_label("Division", nil)) unless detail
+
+        div = division_name(detail)
+        say(format_label("Division", div))
+      end
+
+      # Displays team championships
+      #
+      # @api private
+      # @param team [Team] the team
+      # @return [void]
+      def display_team_championships(team)
+        stats = fetch_team_year_stats(team)
+        championships = stats.select { |s| championship_year?(s) }.map(&:year)
+        return if championships.empty?
+
+        say(format_multiline_label("Championships", championships))
+      end
+
+      # Fetches team year-by-year stats safely
+      #
+      # @api private
+      # @param team [Team] the team
+      # @return [Collection] the stats collection
+      def fetch_team_year_stats(team)
+        TeamYearByYearStats.find(team: team)
+      rescue JSON::ParserError
+        Collection.new
+      end
+
+      # Displays the roster for a team
+      #
+      # @api private
+      # @param team [Team] the team
+      # @return [void]
+      def display_team_roster(team)
+        roster_list = Roster.find(team: team)
+        return if roster_list.empty?
+
+        display_players_list(roster_list)
+      end
+
+      # Displays a list of players as team roster
+      #
+      # @api private
+      # @param players [Collection] the players to display
+      # @return [void]
+      def display_players_list(players)
+        say("Players:")
+        players.each { |player| say(format_detailed_roster_player(player)) }
+      end
+
+      # Displays standings in aligned format
+      #
+      # @api private
+      # @param standings_list [Collection] the standings to display
+      # @return [void]
+      def display_standings(standings_list)
+        widths = calculate_standings_widths(standings_list)
+        standings_list.each_with_index do |standing, index|
+          say(format_standing_row(standing, index + 1, widths))
+        end
+      end
+
+      # Displays league leaders in aligned format
+      #
+      # @api private
+      # @param leaders_list [Collection] the leaders to display
+      # @param category [String] the stat category
+      # @return [void]
+      def display_leaders(leaders_list, category)
+        say("League Leaders - #{category.upcase}")
+        widths = calculate_leader_widths(leaders_list)
+        leaders_list.each { |leader| say(format_leader_row(leader, widths)) }
+      end
+
+      # Displays schedule for a team
+      #
+      # @api private
+      # @param schedule_list [Collection] the schedule to display
+      # @param team [Team] the team
+      # @return [void]
+      def display_schedule(schedule_list, team)
+        say("Schedule for #{team.full_name}")
+        schedule_list.each { |game| say(format_schedule_game(game, team)) }
+      end
+
+      # Displays roster for a team
+      #
+      # @api private
+      # @param roster_list [Collection] the roster to display
+      # @param team [Team] the team
+      # @return [void]
+      def display_roster(roster_list, team)
+        say("Roster for #{team.full_name}")
+        roster_list.each { |player| say(format_detailed_roster_player(player)) }
+      end
+    end
+  end
+end

data/lib/nba/cli/formatters/game_formatters.rb

@@ -0,0 +1,86 @@
+module NBA
+  class CLI < Thor
+    module Formatters
+      # Formatters for game-related output
+      module GameFormatters
+        # Formats a game status for display
+        #
+        # @api private
+        # @return [String]
+        def format_game_status(game)
+          status = game.status
+          return "TBD" unless status
+
+          convert_et_to_local(status.strip)
+        end
+
+        # Formats a game row for tabular display
+        #
+        # @api private
+        # @return [String]
+        def format_game_row(game, widths)
+          status = center(format_game_status(game), widths.fetch(:status))
+          teams = format_game_teams(game, widths)
+          scores = format_game_scores(game, widths)
+          "#{status} - #{teams.fetch(:home)} #{scores.fetch(:home)} : #{scores.fetch(:away)} #{teams.fetch(:away)}".rstrip
+        end
+
+        # Formats game team names with padding
+        #
+        # @api private
+        # @return [Hash]
+        def format_game_teams(game, widths)
+          {home: center(team_nickname(game.home_team), widths.fetch(:home)),
+           away: center(team_nickname(game.away_team), widths.fetch(:away))}
+        end
+
+        # Formats game scores with padding
+        #
+        # @api private
+        # @return [Hash]
+        def format_game_scores(game, widths)
+          {home: center(game.home_score || "-", widths.fetch(:home_score)),
+           away: center(game.away_score || "-", widths.fetch(:away_score))}
+        end
+
+        # Calculates column widths for game display
+        #
+        # @api private
+        # @return [Hash]
+        def calculate_game_widths(games)
+          {status: max_length(games.map { |g| format_game_status(g) }),
+           home: max_length(games.map { |g| team_nickname(g.home_team) }),
+           away: max_length(games.map { |g| team_nickname(g.away_team) }),
+           **score_widths(games)}
+        end
+
+        # Calculates score column widths
+        #
+        # @api private
+        # @return [Hash]
+        def score_widths(games)
+          {home_score: max_length(games.map(&:home_score)),
+           away_score: max_length(games.map(&:away_score))}
+        end
+
+        # Formats a scheduled game for display
+        #
+        # @api private
+        # @return [String]
+        def format_schedule_game(game, team)
+          date = game.game_date&.split("T")&.first || "TBD"
+          "#{date}: #{determine_opponent(game, team)}"
+        end
+
+        # Determines the opponent display string
+        #
+        # @api private
+        # @return [String]
+        def determine_opponent(game, team)
+          home_game = game.home_team_tricode.eql?(team.abbreviation)
+          home_game ? "vs #{game.away_team_tricode}" : "@ #{game.home_team_tricode}"
+        end
+      end
+    end
+  end
+end

data/lib/nba/cli/formatters/leaders_formatters.rb

@@ -0,0 +1,26 @@
+module NBA
+  class CLI < Thor
+    module Formatters
+      # Formatters for leaders-related output
+      module LeadersFormatters
+        # Formats a leader row for tabular display
+        #
+        # @api private
+        # @return [String]
+        def format_leader_row(leader, widths)
+          rank = leader.rank.to_s.rjust(widths.fetch(:rank))
+          name = leader.player_name.ljust(widths.fetch(:name))
+          "#{rank}. #{name} #{leader.value}"
+        end
+
+        # Calculates column widths for leader display
+        #
+        # @api private
+        # @return [Hash]
+        def calculate_leader_widths(leaders)
+          {rank: max_length(leaders.map(&:rank)), name: max_length(leaders.map(&:player_name))}
+        end
+      end
+    end
+  end
+end

data/lib/nba/cli/formatters/player_formatters.rb

@@ -0,0 +1,52 @@
+module NBA
+  class CLI < Thor
+    module Formatters
+      # Formatters for player-related output
+      module PlayerFormatters
+        # Formats a roster player with detailed information
+        #
+        # @api private
+        # @return [String]
+        def format_detailed_roster_player(player)
+          jersey = format_jersey_number(player.jersey_number)
+          name = (player.full_name || "Unknown").ljust(25)
+          position = format_position(player.position)
+          "##{jersey} #{name} #{position} #{player.height || "?"}"
+        end
+
+        # Formats a jersey number for display
+        #
+        # @api private
+        # @example
+        #   format_jersey_number(3) #=> " 3"
+        # @return [String]
+        def format_jersey_number(number) = number&.to_s&.rjust(2) || " ?"
+
+        # Formats a position abbreviation for display
+        #
+        # @api private
+        # @example
+        #   format_position(position) #=> "PG "
+        # @return [String]
+        def format_position(position) = (position&.abbreviation || "?").ljust(3)
+
+        # Formats a player search result
+        #
+        # @api private
+        # @return [String]
+        def format_player_result(player)
+          status = player.active? ? "Active" : "Inactive"
+          "#{player.full_name} (#{status})"
+        end
+
+        # Formats player draft information
+        #
+        # @api private
+        # @return [String]
+        def format_draft_info(player)
+          "#{player.draft_year} Round #{player.draft_round}, Pick #{player.draft_number}"
+        end
+      end
+    end
+  end
+end

data/lib/nba/cli/formatters/standings_formatters.rb

@@ -0,0 +1,26 @@
+module NBA
+  class CLI < Thor
+    module Formatters
+      # Formatters for standings-related output
+      module StandingsFormatters
+        # Formats a standing row for tabular display
+        #
+        # @api private
+        # @return [String]
+        def format_standing_row(standing, rank, widths)
+          rank_str = rank.to_s.rjust(widths.fetch(:rank))
+          team = standing.team_name.ljust(widths.fetch(:team))
+          "#{rank_str}. #{team} #{standing.wins}-#{standing.losses}"
+        end
+
+        # Calculates column widths for standings display
+        #
+        # @api private
+        # @return [Hash]
+        def calculate_standings_widths(standings)
+          {rank: standings.size.to_s.length, team: max_length(standings.map(&:team_name))}
+        end
+      end
+    end
+  end
+end