sportradar-api 0.10.55 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3c4cfafdda0856d7bb6addfe7087c721770048c2
-  data.tar.gz: ae7b4d2a055b7c573c4acc1a166b9da63a931a62
+  metadata.gz: 8dc1a28470e8251e6d07c0a558e1fd4c9477cbb2
+  data.tar.gz: b8b597bd550858c7a6ed853e49eb4be966b0ca06
 SHA512:
-  metadata.gz: bebc71851c241d5c4688bd001021d974a718233bae5e4f93bafae442bc9f41b04f42b35e36af58ee5f7c87592b6cbf9876c66bcf2c3ba99382096379d99228ee
-  data.tar.gz: 763ccaeca88251002d6fc90c916f9e93743b203c8a44cff8a587e835f5c90dcf0859b4b94d97685b72d015ce9f6d31b2576dc179ae2c69f7b11fc2eb0c97903c
+  metadata.gz: a939bf7829663306244b1fc49d6be654d6b94a80323c3c0f52d2faa8b94a7ab96df47968e57e3868c86444aeaa09b40cec734517596f7b3a589ef374e74fb142
+  data.tar.gz: 40ae8b1e37e659dc5dfcacef0a110cab3ff81cf0ba664d8634e178bb3d489fb0f5398f94b38d7e0458e36de66ce16e3def548171cdf4e87a987d40ec207b6466

data/Gemfile.lock

@@ -1,36 +1,37 @@
 PATH
   remote: .
   specs:
-    sportradar-api (0.10.55)
+    sportradar-api (0.11.0)
       activesupport
       httparty (>= 0.14.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.0.2)
+    activesupport (5.1.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (~> 0.7)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-    addressable (2.4.0)
-    codeclimate-test-reporter (0.6.0)
-      simplecov (>= 0.7.1, < 1.0.0)
+    addressable (2.5.1)
+      public_suffix (~> 2.0, >= 2.0.2)
+    codeclimate-test-reporter (1.0.8)
+      simplecov (<= 0.13)
     coderay (1.1.1)
     concurrent-ruby (1.0.5)
-    coveralls (0.8.15)
+    coveralls (0.8.19)
       json (>= 1.8, < 3)
       simplecov (~> 0.12.0)
       term-ansicolor (~> 1.3)
       thor (~> 0.19.1)
-      tins (>= 1.6.0, < 2)
+      tins (~> 1.6)
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
     docile (1.1.5)
-    dotenv (2.1.1)
-    ffi (1.9.14)
+    dotenv (2.2.1)
+    ffi (1.9.18)
     formatador (0.2.5)
-    guard (2.14.0)
+    guard (2.14.1)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
       lumberjack (~> 1.0)
@@ -43,18 +44,18 @@ GEM
     guard-minitest (2.4.6)
       guard-compat (~> 1.2)
       minitest (>= 3.0)
-    hashdiff (0.3.0)
-    httparty (0.14.0)
+    hashdiff (0.3.4)
+    httparty (0.15.5)
       multi_xml (>= 0.5.2)
-    i18n (0.8.1)
-    json (2.0.2)
+    i18n (0.8.4)
+    json (2.1.0)
     listen (3.1.5)
       rb-fsevent (~> 0.9, >= 0.9.4)
       rb-inotify (~> 0.9, >= 0.9.7)
       ruby_dep (~> 1.2)
-    lumberjack (1.0.10)
+    lumberjack (1.0.12)
     method_source (0.8.2)
-    minitest (5.9.1)
+    minitest (5.10.2)
     minitest-focus (1.1.2)
       minitest (>= 4, < 6)
     multi_xml (0.6.0)
@@ -66,28 +67,29 @@ GEM
       coderay (~> 1.1.0)
       method_source (~> 0.8.1)
       slop (~> 3.4)
+    public_suffix (2.0.5)
     rake (10.5.0)
-    rb-fsevent (0.9.7)
-    rb-inotify (0.9.7)
-      ffi (>= 0.5.0)
-    ruby_dep (1.4.0)
+    rb-fsevent (0.9.8)
+    rb-inotify (0.9.10)
+      ffi (>= 0.5.0, < 2)
+    ruby_dep (1.5.0)
     safe_yaml (1.0.4)
     shellany (0.0.1)
     simplecov (0.12.0)
       docile (~> 1.1.0)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.0)
+    simplecov-html (0.10.1)
     slop (3.6.0)
-    term-ansicolor (1.4.0)
+    term-ansicolor (1.6.0)
       tins (~> 1.0)
-    thor (0.19.1)
+    thor (0.19.4)
     thread_safe (0.3.6)
-    tins (1.12.0)
+    tins (1.14.0)
     tzinfo (1.2.3)
       thread_safe (~> 0.1)
     vcr (3.0.3)
-    webmock (2.1.0)
+    webmock (3.0.1)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff
@@ -112,4 +114,4 @@ DEPENDENCIES
   webmock
 
 BUNDLED WITH
-   1.15.0
+   1.15.1

data/README.md

@@ -86,15 +86,16 @@ summary = sim.match_summary(sim.simulation_match)
 boxscore = sim.match_boxscore(sim.simulation_match)
 ```
 
-### NFL
+### Football
 
-It's possible to find the current simulation game:
+It's possible to use simulation games from Sportradar. This allows you to see what data looks like during a game (including non game APIs), useful for development during the offseason.
 
 ```
-Sportradar::Api::Nfl.new('o').active_simulation
-=>
-https://api.sportradar.us/nfl-sim1/games/f45b4a31-b009-4039-8394-42efbc6d5532/boxscore.xml
-Live Game: Green Bay Packers vs Minnesota Vikings. Q2 00:08.  game_id='f45b4a31-b009-4039-8394-42efbc6d5532'
+Sportradar::Api::Football::Nfl.simulations # => returns array of simulation games. Only 1 is inprogress at a time
+Sportradar::Api::Football::Nfl.simulation  # => returns Sportradar::Api::Football::Nfl instance with a sim api. useful for mid season stats, standings, etc
+
+Sportradar::Api::Football::Ncaafb.simulations # => returns array of simulation games. Only 1 is inprogress at a time
+Sportradar::Api::Football::Ncaafb.simulation  # => returns Sportradar::Api::Football::Ncaafb instance with a sim api. useful for mid season stats, standings, etc
 ```
 
 ## Development

data/lib/sportradar/api/baseball/game.rb

@@ -104,7 +104,6 @@ module Sportradar
 
         def update(data, source: nil, **opts)
           # via pbp
-          @title        = data['title']                 if data['title']
           @status       = data['status']                if data['status']
           @coverage     = data['coverage']              if data['coverage']
           @day_night    = data['day_night']             if data['day_night']
@@ -116,9 +115,10 @@ module Sportradar
 
           @scheduled    = Time.parse(data["scheduled"]) if data["scheduled"]
           @venue        = Venue.new(data['venue']) if data['venue']
-          @broadcast    = Broadcast.new(data['broadcast']) if data['broadcast']
+          @broadcast    = Broadcast.new(data['broadcast']) if !data['broadcast'].to_h.empty?
           @home         = Team.new(data['home'], api: api, game: self) if data['home']
           @away         = Team.new(data['away'], api: api, game: self) if data['away']
+          @title        = data['title'] || @title || (home && away && "#{home.full_name} vs #{away.full_name}")
 
           @duration     = data['duration']              if data['duration']
           @attendance   = data['attendance']            if data['attendance']
@@ -289,6 +289,29 @@ module Sportradar
         end
 
         # status helpers
+
+        def realtime_state
+          if future?
+            'Scheduled'
+          elsif delayed?
+            'Delayed'
+          elsif finished?
+            'Final'
+          elsif postponed?
+            'Postponed'
+          else
+            inning_abbr
+          end
+        end
+
+        def inning_abbr
+          if !count.empty?
+            inning_half = self.count['inning_half']
+            inning = self.count['inning']
+            "#{(inning_half == 'B' ? 'Bottom' : 'Top')} #{(inning || 1).ordinalize}"
+          end
+        end
+
         def postponed?
           'postponed' == status
         end
@@ -301,6 +324,10 @@ module Sportradar
           ['unnecessary', 'postponed'].include? status
         end
 
+        def delayed?
+          ['wdelay', 'delayed'].include? status
+        end
+
         def future?
           ['scheduled', 'delayed', 'created', 'time-tbd'].include? status
         end

data/lib/sportradar/api/baseball/mlb/hierarchy.rb

@@ -262,6 +262,7 @@ __END__
 mlb = Sportradar::Api::Baseball::Mlb::Hierarchy.new
 res = mlb.get_daily_summary;
 res = mlb.get_hierarchy;
+res = mlb.get_schedule;
 t = mlb.teams.first;
 t.get_season_stats;
 t.players.sample

data/lib/sportradar/api/baseball/record.rb

@@ -12,10 +12,6 @@ module Sportradar
           update(data, **opts)
         end
 
-        def profile
-          Profile.new(self)
-        end
-
         def update(data, **opts)
           @wins               = data["win"]
           @losses             = data["loss"]

data/lib/sportradar/api/baseball/venue.rb

@@ -2,7 +2,7 @@ module Sportradar
   module Api
     module Baseball
       class Venue < Data
-        attr_accessor :response, :id, :name, :address, :city, :state, :country, :zip, :capacity
+        attr_accessor :response, :id, :name, :address, :city, :state, :country, :zip, :capacity, :timezone
         @all_hash = {}
         def self.new(data, **opts)
           existing = @all_hash[data['id']]
@@ -31,6 +31,7 @@ module Sportradar
           @zip      = data['zip']
           @country  = data['country']
           @capacity = data['capacity']
+          @timezone = data['timezone']
 
           @surface  = data['surface']
 

data/lib/sportradar/api/basketball/game.rb

@@ -80,7 +80,6 @@ module Sportradar
 
         def update(data, source: nil, **opts)
           # via pbp
-          @title        = data['title']                 if data['title']
           @status       = data['status']                if data['status']
           @coverage     = data['coverage']              if data['coverage']
           @home_id      = data['home_team'] || data.dig('home', 'id')   if data['home_team'] || data.dig('home', 'id')
@@ -90,9 +89,10 @@ module Sportradar
 
           @scheduled    = Time.parse(data["scheduled"]) if data["scheduled"]
           @venue        = Venue.new(data['venue']) if data['venue']
-          @broadcast    = Broadcast.new(data['broadcast']) if data['broadcast']
+          @broadcast    = Broadcast.new(data['broadcast']) if !data['broadcast'].to_h.empty?
           @home         = team_class.new(data['home'], api: api, game: self) if data['home']
           @away         = team_class.new(data['away'], api: api, game: self) if data['away']
+          @title        = data['title'] || @title || (home && away && "#{home.full_name} vs #{away.full_name}")
 
           @duration     = data['duration']              if data['duration']
           @clock        = data['clock']                 if data['clock']

data/lib/sportradar/api/basketball/record.rb

@@ -11,10 +11,6 @@ module Sportradar
           update(data, **opts)
         end
 
-        def profile
-          Profile.new(self)
-        end
-
         def update(data, **opts)
           @wins           = data['wins'].to_i
           @losses         = data['losses'].to_i

data/lib/sportradar/api/basketball/venue.rb

@@ -2,7 +2,7 @@ module Sportradar
   module Api
     module Basketball
       class Venue < Data
-        attr_accessor :response, :id, :name, :address, :city, :state, :country, :zip, :capacity
+        attr_accessor :response, :id, :name, :address, :city, :state, :country, :zip, :capacity, :timezone
         @all_hash = {}
         def self.new(data, **opts)
           existing = @all_hash[data['id']]
@@ -31,6 +31,7 @@ module Sportradar
           @zip      = data['zip']
           @country  = data['country']
           @capacity = data['capacity']
+          @timezone = data['timezone']
         end
 
         def location

data/lib/sportradar/api/data.rb

@@ -48,14 +48,14 @@ module Sportradar
 
       # @param existing [Hash{String=>Data}] Existing data hash, ID => entity
       # @param data [Hash, Array] new data to update with
-      def create_data(existing = {}, data, klass: nil, **opts)
+      def create_data(existing = {}, data, klass: nil, identifier: 'id', **opts)
         existing ||= {} # handles nil case, typically during object instantiation
         case data
         when [], {}
           existing
         when Array
           data.each do |hash|
-            current = existing[hash['id']]
+            current = existing[hash[identifier]]
             if current
               current.update(hash, **opts)
             else
@@ -65,7 +65,7 @@ module Sportradar
             existing[current.id]
           end
         when Hash
-          existing[data['id']] = klass.new(data, **opts)
+          existing[data[identifier]] = klass.new(data, **opts)
         else
           # raise
         end

data/lib/sportradar/api/football/README.md

@@ -0,0 +1,62 @@
+# Sportradar Football
+
+![API Reference](https://developer.sportradar.com/files/indexFootball.html)
+
+## NFL
+
+Get started with official NFL api v1:
+
+```ruby
+nfl = Sportradar::Api::Football::Nfl.new
+nfl = Sportradar::Api::Football::Nfl.new(year: 2016)
+res = nfl.get_schedule          # => res is the raw response data hash. the `nfl` object now has weeks present to interact with
+res = nfl.get_weekly_schedule   # => res is the raw response data hash. the `nfl` object now has weeks present to interact with
+nfl.weeks.count                 # => 17
+nfl.games.count                 # => 256
+nfl.weeks.first.games.count     # => 16
+game = nfl.games.sample         # => Sportradar::Api::Football::Nfl::Game
+res = game.get_pbp              # => res is raw response data hash. the `game` object now has quarters/drives/plays to interact with
+game.quarters.size              # => 4 (unless the game went to overtime)
+game.drives.size                # => (20-30) most NFL games have between 20 and 30 drives
+game.plays.size                 # => 150 most NFL games have about 150 total plays
+
+game.get_statistics             # => res is raw response data hash. the `game` object now has team stats to interact with
+game.home.stats.passing         # => Sportradar::Api::Football::StatPack::Passing => passing stats
+game.home.stats.passing.players.first
+```
+
+
+```ruby
+nfl = Marshal.load(File.binread('nfl.bin'));
+ncaafb = Marshal.load(File.binread('ncaafb.bin'));
+g1 = nfl.games.sample;
+g2 = ncaafb.games.sample
+g2.year
+g1.year
+games = [g1, g2]
+games.map(&:year)
+games.map(&:week)
+games.map(&:week_number)
+g1
+g1.year
+g1.week_number
+games.map(&:type)
+games.map(&:path_pbp)
+games.map(&:plays)
+games.map(&:drives).map(&:count)
+games.map(&:plays).map(&:count)
+games.map(&:quarter)
+games.map(&:score)
+games.each(&:get_statistics);
+games.each(&:get_box);
+games.map(&:score)
+games.each(&:get_pbp);
+games.map(&:plays).map(&:count)
+games.map(&:drives).map(&:count)
+
+
+uri = '2015/REG/1/WKY/MSH'
+game = Sportradar::Api::Football::Ncaafb::Game.new('uri' => uri)
+```
+
+

data/lib/sportradar/api/football/drive.rb

@@ -0,0 +1,105 @@
+module Sportradar
+  module Api
+    module Football
+      class Drive < Data
+        attr_accessor :response, :api, :id, :sequence, :start_reason, :end_reason, :play_count, :duration, :first_downs, :gain, :penalty_yards, :scoring_drive, :quarter, :team
+
+        def self.new(data, **opts)
+          if data['type'] == 'event'
+            Event.new(data, **opts)
+          else
+            super
+          end
+        end
+
+        def initialize(data, **opts)
+          @response      = data
+          @id            = data["id"]
+          @api           = opts[:api]
+          @plays_hash    = {}
+          @events_hash   = {}
+
+          update(data, **opts)
+        end
+
+        def update(data, **opts)
+          @type           = data['type']
+          @team           = data['team']
+          @clock          = data['clock']
+
+          @sequence       = data["sequence"]
+          @start_reason   = data["start_reason"]
+          @end_reason     = data["end_reason"]
+          @play_count     = data["play_count"]
+          @duration       = data["duration"]
+          @first_downs    = data["first_downs"]
+          @gain           = data["gain"]
+          @penalty_yards  = data["penalty_yards"]
+          @scoring_drive  = data["scoring_drive"]
+
+          @quarter_data = data['quarter']
+          @team_data    = data['team']
+
+          handle_plays_and_events(data, **opts)
+
+          self
+        end
+
+        def plays
+          @plays_hash.values
+        end
+
+        def events
+          @events_hash.values
+        end
+
+        def end_reason_possibilities
+          [
+            'UNKNOWN',
+            'Touchdown',
+            'Safety',
+            'Field Goal',
+            'Missed FG',
+            'Blocked FG',
+            'Blocked FG, Downs',
+            'Blocked FG, Safety',
+            'Punt',
+            'Blocked Punt',
+            'Blocked Punt, Downs',
+            'Blocked Punt, Safety',
+            'Downs',
+            'Interception',
+            'Fumble',
+            'Fumble, Safety',
+            'Muffed FG',
+            'Muffed Punt',
+            'Muffed Kickoff',
+            'Kickoff',
+            'Own Kickoff',
+            'Onside Kick',
+            'Kickoff, No Play',
+            'End of Half',
+            'End of Game',
+          ]
+        end
+        def normalized_end_reason
+          case end_reason
+          when 'Touchdown'
+            'Touchdown'
+          when 'Field Goal', 'Missed FG', "Blocked FG, Downs", 'Muffed FG', 'Blocked FG, Safety'
+            'Field Goal'
+          when 'Downs'
+            'Downs'
+          when 'Interception', 'Fumble'
+            'Turnover'
+          when 'Punt'
+            'Punt'
+          else
+            'Other'
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/sportradar/api/football/event.rb

@@ -0,0 +1,33 @@
+module Sportradar
+  module Api
+    module Football
+      class Event < Data
+        attr_accessor :response, :id, :sequence, :reference, :clock, :type, :event_type, :description, :alt_description
+
+        def initialize(data, **opts)
+          @response         = data
+          @id               = data["id"]
+          update(data, **opts)
+        end
+        def update(data, **opts)
+          @sequence         = data["sequence"]
+          @reference        = data["reference"]
+          @clock            = data["clock"]
+          @type             = data["type"]
+          @event_type       = data["event_type"]
+          @description      = data["description"] || data["summary"]
+          @alt_description  = data["alt_description"]
+
+          self
+        end
+        def plays
+          []
+        end
+        def events
+          [self]
+        end
+      end
+
+    end
+  end
+end