espn_pub 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de842b344e37f8c369d3017ef9e18e8389bc1308d0a09f6b599788972e303355
-  data.tar.gz: ebe944144b60bf498123efa73e71b21a6b1b4b808b8aa5c5e4c00afe79d03ac8
+  metadata.gz: 2313dc03f24eb1a9ece5883a51a186acd8497790d2d6b2b4291cdaa997c4c977
+  data.tar.gz: f2238e3abe174ade734ac70e183d2741e9f11f5fd49a96d6a77000b82086cd75
 SHA512:
-  metadata.gz: 9d078d642a8a0e1c11722a31d8785dba6076d36622d29f032f6e80f9df522c6c95f711df35b03b87494e56f5d450198aec0d17f5fe1db5ccf76b2c383451743c
-  data.tar.gz: 6b2b73144fa2b7345c0e534929926aa92ea6c5762fcf4d1d69479fad809dc9f29bef963503353fd82295bccef66a249eef704f7625f25c3a8b1ac5b5bb0bc0f4
+  metadata.gz: 32011085498d278e9076c1332e53bc6aee395345f30adc547ded45705713e7e358e2c3da8663f3abd0c1ec7f179fc6b4f703f4d84e27c4f6f9ccc3dd79d4eb3f
+  data.tar.gz: 2b4bbf38c0aa43eeee07b4848c7eaaf9bde8d167cacb2890c657ea668ebd5132042a51b815c5485eaece594d7f8a3cab89ae8290f3eec5c99a6e29dce15de9f6

data/lib/espn_pub/entities/base.rb

@@ -24,6 +24,10 @@ module EspnPub
           version: Client::API_VERSION
         )
       end
+
+      def normalize_name(name)
+        name.gsub(/[^a-zA-Z0-9]/i, '_').downcase
+      end
     end
   end
 end

data/lib/espn_pub/entities/game.rb

@@ -4,7 +4,19 @@ module EspnPub
   module Entities
     # Represents a game between two teams.
     class Game < Base
-      attr_reader :id, :home_team, :away_team, :date
+      module Type
+        PRESEASON = 'preseason'
+        REGULAR = 'regular'
+        POSTSEASON = 'postseason'
+      end
+
+      GAME_TYPES = {
+        1 => Type::PRESEASON,
+        2 => Type::REGULAR,
+        3 => Type::POSTSEASON
+      }.freeze
+
+      attr_reader :id, :home_team, :away_team, :date, :type
 
       # Initialize a Game entity.
       #
@@ -12,11 +24,13 @@ module EspnPub
       # @param home_team [EspnPub::Entities::Team] The home team.
       # @param away_team [EspnPub::Entities::Team] The away team.
       # @param date [DateTime] The scheduled game date.
-      def initialize(id:, home_team:, away_team:, date:)
+      # @param type [String] The type of the game.
+      def initialize(id:, home_team:, away_team:, date:, type: nil)
         @id = id
         @home_team = home_team
         @away_team = away_team
         @date = date
+        @type = type
         super()
       end
     end

data/lib/espn_pub/entities/league.rb

@@ -20,13 +20,31 @@ module EspnPub
         'nfl' => 'football'
       }.freeze
 
-      attr_reader :name
+      attr_reader :league_name
+
+      def self.fetch_season_details(league_name, season_year)
+        raise ArgumentError, "Unknown league name: #{league_name}" unless NAME_TO_SPORT.key?(league_name)
+        raise ArgumentError, 'Season year must be an integer' unless season_year.to_i.positive?
+
+        path = format GAMES_PATH, EspnPub::Client::API_VERSION, NAME_TO_SPORT[league_name], league_name
+        path += "?dates=#{Time.new(season_year).strftime('%Y%m%d')}"
+        resp = EspnPub::Client.new.send_request(path)
+        season = resp.dig('leagues', 0, 'season')
+
+        return {} unless season
+
+        {
+          year: season['year'],
+          start_date: Date.parse(season['startDate']),
+          end_date: Date.parse(season['endDate'])
+        }
+      end
 
       # Initialize a League instance.
       #
-      # @param name [String] The league identifier string.
-      def initialize(name)
-        @name = name
+      # @param league_name [String] The league identifier string.
+      def initialize(league_name)
+        @league_name = normalize_name(league_name)
         super()
       end
 
@@ -36,7 +54,7 @@ module EspnPub
       def teams
         unless defined?(@teams)
           begin
-            path = format TEAMS_PATH, client.version, sport, name
+            path = format TEAMS_PATH, client.version, sport, league_name
             teams_resp = client.send_request(path)
             @teams = (teams_resp.dig('sports', 0, 'leagues', 0, 'teams') || []).map do |team_data|
               EspnPub::Entities::Team.new(
@@ -45,11 +63,11 @@ module EspnPub
                 location: team_data.dig('team', 'location'),
                 abbreviation: team_data.dig('team', 'abbreviation'),
                 sport: sport,
-                league: name
+                league_name: league_name
               )
             end
           rescue Client::UnexpectedResponseCodeError => e
-            warn "Failed to fetch teams for league #{name}: #{e.message}"
+            warn "Failed to fetch teams for league #{league_name}: #{e.message}"
             return []
           end
         end
@@ -62,27 +80,28 @@ module EspnPub
       # @param date [Date, DateTime, nil] An optional date to filter games.
       # @return [Array<EspnPub::Entities::Game>]
       def games(date: nil)
-        path = format GAMES_PATH, client.version, sport, name
+        path = format GAMES_PATH, client.version, sport, league_name
         path += "?dates=#{date.strftime('%Y%m%d')}" if date
         games_resp = client.send_request(path)
         (games_resp['events'] || []).map do |game_data|
           EspnPub::Entities::Game.new(
             id: game_data['id'],
+            type: Game::GAME_TYPES[game_data.dig('season', 'type')],
             home_team: EspnPub::Entities::Team.fetch_by_id(
               id: game_data.dig('competitions', 0, 'competitors', 0, 'id'),
               sport: sport,
-              league: name
+              league_name: league_name
             ),
             away_team: EspnPub::Entities::Team.fetch_by_id(
               id: game_data.dig('competitions', 0, 'competitors', 1, 'id'),
               sport: sport,
-              league: name
+              league_name: league_name
             ),
             date: DateTime.parse(game_data['date'])
           )
         end
       rescue Client::UnexpectedResponseCodeError => e
-        warn "Failed to fetch games for league #{name}: #{e.message}"
+        warn "Failed to fetch games for league #{league_name}: #{e.message}"
         []
       end
 
@@ -90,7 +109,7 @@ module EspnPub
       #
       # @return [String, nil] The sport name or nil when unknown.
       def sport
-        NAME_TO_SPORT[name]
+        NAME_TO_SPORT[league_name]
       end
     end
   end

data/lib/espn_pub/entities/player.rb

@@ -10,7 +10,7 @@ module EspnPub
 
       attr_reader :id,
                   :sport,
-                  :league,
+                  :league_name,
                   :first_name,
                   :last_name,
                   :position,
@@ -27,7 +27,7 @@ module EspnPub
       #
       # @param id [String] The player identifier.
       # @param sport [String] The sport name.
-      # @param league [String] The league identifier.
+      # @param league_name [String] The league identifier.
       # @param first_name [String, nil] The player's first name.
       # @param last_name [String, nil] The player's last name.
       # @param position [String, nil] The player's position abbreviation.
@@ -39,11 +39,11 @@ module EspnPub
       # @param height [String, nil] The player's listed height.
       # @param weight [String, nil] The player's listed weight.
       # @param debut_year [Integer, nil] The year the player made their debut.
-      def initialize(id:, sport:, league:, first_name: nil, last_name: nil, position: nil, team_id: nil,
+      def initialize(id:, sport:, league_name:, first_name: nil, last_name: nil, position: nil, team_id: nil,
                      date_of_birth: nil, birth_city: nil, birth_state: nil, birth_country: nil, height: nil, weight: nil, debut_year: nil)
         @id = id
         @sport = sport
-        @league = league
+        @league_name = league_name
         @first_name = first_name
         @last_name = last_name
         @position = position
@@ -64,9 +64,9 @@ module EspnPub
       # @param sport [String] The sport name.
       # @param league [String] The league identifier.
       # @return [Player, nil] The player, or nil when the request fails or data is missing.
-      def self.fetch_by_id(id:, sport:, league:)
+      def self.fetch_by_id(id:, sport:, league_name:)
         client = EspnPub::Client.new
-        path = format ATHLETE_PATH, sport, league, id
+        path = format ATHLETE_PATH, sport, league_name, id
         begin
           athlete_data = client.send_request(path)['athlete']
         rescue Client::UnexpectedResponseCodeError => e
@@ -79,7 +79,7 @@ module EspnPub
         new(
           id: athlete_data['id'],
           sport: sport,
-          league: league,
+          league_name: league_name,
           first_name: athlete_data['firstName'],
           last_name: athlete_data['lastName'],
           position: athlete_data.dig('position', 'abbreviation'),

data/lib/espn_pub/entities/team.rb

@@ -12,7 +12,7 @@ module EspnPub
                   :location,
                   :abbreviation,
                   :sport,
-                  :league,
+                  :league_name,
                   :venue
 
       # Initialize a Team entity.
@@ -22,24 +22,24 @@ module EspnPub
       # @param location [String] The team location.
       # @param abbreviation [String] The team abbreviation.
       # @param sport [String] The sport name.
-      # @param league [String] The league identifier.
+      # @param league_name [String] The league identifier.
       # @param venue [EspnPub::Entities::Venue, nil] The team's home venue.
-      def initialize(id:, name:, location:, abbreviation:, sport:, league:, venue: nil)
+      def initialize(id:, name:, location:, abbreviation:, sport:, league_name:, venue: nil)
         @id = id
         @name = name
         @location = location
         @abbreviation = abbreviation
         @sport = sport
-        @league = league
+        @league_name = league_name
         @venue = venue
         super()
       end
 
-      def self.fetch_by_id(id:, sport:, league:, user_agent: nil)
+      def self.fetch_by_id(id:, sport:, league_name:, user_agent: nil)
         client = EspnPub::Client.new
         client.user_agent = user_agent if user_agent
 
-        path = format TEAM_PATH, client.version, sport, league, id
+        path = format TEAM_PATH, client.version, sport, league_name, id
         begin
           team_data = client.send_request(path)['team']
         rescue Client::UnexpectedResponseCodeError => e
@@ -55,7 +55,7 @@ module EspnPub
           location: team_data['location'],
           abbreviation: team_data['abbreviation'],
           sport: sport,
-          league: league,
+          league_name: league_name,
           venue: EspnPub::Entities::Venue.from_api(team_data.dig('franchise', 'venue'))
         )
       end
@@ -66,13 +66,13 @@ module EspnPub
       def players
         unless defined?(@roster)
           begin
-            path = format ROSTER_PATH, client.version, sport, league, id
+            path = format ROSTER_PATH, client.version, sport, league_name, id
             roster_resp = client.send_request(path)
             @roster = (roster_resp['athletes'] || []).map do |athlete_data|
               EspnPub::Entities::Player.new(
                 id: athlete_data['id'],
                 sport: sport,
-                league: league,
+                league_name: league_name,
                 first_name: athlete_data['firstName'],
                 last_name: athlete_data['lastName'],
                 position: athlete_data['position']['abbreviation'],

data/lib/espn_pub/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EspnPub
-  VERSION = '0.1.6'
+  VERSION = '0.1.8'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: espn_pub
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Jeffrey Bowman