sportradar 0.0.16 → 0.0.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d618af8c09b32a16644cd1673b14d728bbedbf05
-  data.tar.gz: 1aba7b631b32a205df2391746fc96eb1021393c7
+  metadata.gz: dfed0edeb60ac981cfc75a3090b9fae031fc829a
+  data.tar.gz: 0c0d9cb9998c042bbf34f5234f979f72a1786675
 SHA512:
-  metadata.gz: ec6e864fab845c50b3f52fd21988b384c63801872f6acd95cf7c92ae39007a768af3241c0d5cd9e9b78f536899a71d663137d32d6518430119ecfc86ca3020ce
-  data.tar.gz: 4e4f27be1b02dd699d46b7fcc5b2eaba33b18f31173a393abe461d1e4a6ebd6235f0187f16ba814da23e6cbfbf1d4bc78bbfeb40014c0ca5f477d55f595f5936
+  metadata.gz: 39c8209083d999e230aabecb122cb0f82fcda2a88f7c4ce68131e2e83d0891f8c50008ee507a9533fecc3be42f28cce923c9301287dc912cbc1177b3c09b417e
+  data.tar.gz: 40246f8814f4adf35bf1a7105b1709a134ff66380456bf63d04fc94a99f0dde06bed43fcaf71200dd42e9ffc90c57c46b818dd0526d780e6ce3c85487e1b1fd1

data/README.md

@@ -4,9 +4,9 @@ Simple API client for [Sportradar API](http://developer.sportradar.us/).
 
 Currently supports
 
-* a subset of [Major League Baseball API](http://developer.sportradar.us/docs/MLB_API) endpoints
-* a subset of [NBA Feed API](http://developer.sportradar.us/docs/read/NBA_API) endpoints
-* a subset of [NHL Classic Feed API](http://developer.sportradar.us/docs/read/NHL_Classic) endpoints
+* a major set of [Major League Baseball API](http://developer.sportradar.us/docs/MLB_API) endpoints
+* a major set of [NBA Feed API](http://developer.sportradar.us/docs/read/NBA_API) endpoints
+* a major set of [NHL Classic Feed API](http://developer.sportradar.us/docs/read/NHL_Classic) endpoints
 * complete set of [NFL Classic Feed API](http://developer.sportradar.us/docs/read/NFL_Classic) endpoints
 
 ## Installation
@@ -14,7 +14,7 @@ Currently supports
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'sportradar', '>= 0.0.11'
+gem 'sportradar', '>= 0.0.18'
 ```
 
 And then execute:
@@ -101,6 +101,8 @@ Some helpers will call .save for each response as separate items.
 
 Defaults to and supports NBA Classic API feed version 3 only (not Official).
 
+Models and parsers can get plays, scoring plays, players on court, stoppages from NBA Play by Play json data.
+
 #### API Requests
 
 * `Sportradar::Nba::DailySchedule.new(date: Date.today).fetch`
@@ -110,12 +112,22 @@ Defaults to and supports NBA Classic API feed version 3 only (not Official).
 * `Sportradar::Nba::Boxscore.new(event_id: '<game_guid>').fetch`
 * `Sportradar::Nba::GameSummary.new(event_id: '<game_guid>').fetch`
 
-
-
 * `Sportradar::Nba::TeamRosters.perform`
 * `Sportradar::Nba::TeamRoster.new(team_id: '44151f7a-0f24-11e2-8525-18a905767e44').fetch`
 * `Sportradar::Nba::Injuries.new().fetch`
 
+#### Bulk Saves
+
+To fetch and save all Play by Play for a season, one can:
+
+```
+json = Sportradar::Nba::LeagueSchedule.new(year: '2016', interval_type: 'pre').fetch
+
+Sportradar::Nba::LeagueSchedule.games(json: json).each do |g|
+  Sportradar::Nba::PlayByPlay.new(event_id: g['id']).save
+end
+```
+
 ### Football/NFL
 
 Defaults to and supports NFL Classic API feed version 1 only (not Official).
@@ -188,6 +200,8 @@ Some helpers will call `.save` for each response as separate items.
 
 Defaults to and supports NHL Classic API feed version 3 only (not Official).
 
+Models and parsers can get plays, scoring plays, players on court, stoppages from NHL Play by Play json data.
+
 #### API Requests
 
 * `Sportradar::Nhl::LeagueHierarchy.new().fetch`
@@ -760,6 +774,18 @@ Given game NFL Play by Play JSON, makes it easy to get the drives, quarters, and
 
  * plays - game, drive, team, participants, summary, yardage, etc.
 
+#### Hockey Play by Play
+
+* `Sportradar::Nhl::Parsers::PlayByPlayParser.new(game_play_by_play: {})`
+
+Given game NHL Play by Play JSON, makes it easy to get the periods, events, plays (with player stat), stoppages and scoring plays via a set of convenience methods.
+
+#### Basketball Play by Play
+
+* `Sportradar::Nba::Parsers::PlayByPlayParser.new(game_play_by_play: {})`
+
+Given game NBA Play by Play JSON, makes it easy to get the quarters, events, plays (with player stat), stoppages, players on court for each play, and scoring plays via a set of convenience methods.
+
 #### Play Summary Model
 
 Given game NFL Play Summary JSON, makes it easy to get at the start and end situations, players, scroing info for each play summmary.

data/lib/sportradar/nba/models/event.rb

@@ -0,0 +1,302 @@
+module Sportradar
+  module Nba
+    module Models
+      class Event
+        def initialize(quarter:, attributes:)
+          @quarter = quarter
+          @attributes = attributes
+          build_statistics
+        end
+
+        def to_s
+          [].tap do |sentence_parts|
+            sentence_parts << quarter_number
+            sentence_parts << clock
+            sentence_parts << team_name if has_team?
+            sentence_parts << team_basket if has_team?
+            sentence_parts << event_type
+            sentence_parts << description
+            sentence_parts << free_throw_attempt
+            sentence_parts << free_throw_attempt_of
+            sentence_parts << turnover_type
+            sentence_parts << "[#{coordinate_x}, #{coordinate_y}]" if coordinates?
+          end.compact.
+            join(' - ')
+        end
+
+        def id
+          @attributes['id']
+        end
+
+        def game_id
+          quarter.game_id
+        end
+
+        def possession?
+          possession.present?
+        end
+
+        def possession
+          @attributes['possession'] || {}
+        end
+
+        def possession_team_id
+          possession.dig('id')
+        end
+
+        def possession_team_name
+          possession.dig('name')
+        end
+
+        def team
+          @attributes['attribution'] || {}
+        end
+
+        def team_id
+          team.dig('id')
+        end
+
+        def team_name
+          team.dig('name')
+        end
+
+        def team_basket
+          team.dig('team_basket')
+        end
+
+        def has_team?
+          !team_id.nil?
+        end
+
+        def quarter
+          @quarter
+        end
+
+        def quarter_id
+          @quarter.id
+        end
+
+        def quarter_number
+          @quarter.number
+        end
+
+        def time_code
+          min, sec = clock.split(':').map(&:to_i)
+          "PT#{min}M#{sec}S"
+        end
+
+        def clock
+          @attributes['clock'] || '0'
+        end
+
+        def clock_secs
+          begin
+            if clock && clock.include?(':')
+              mins, secs = clock.split(':').map(&:to_i)
+              Time.parse("00:#{mins}:#{secs}").
+                 seconds_since_midnight.to_i
+            end
+          rescue => e
+            return 0
+          end
+        end
+        alias_method :quarter_seconds, :clock_secs
+
+        def id
+          @attributes['id']
+        end
+
+        def attempt_in_words
+          @attributes['attempt']
+        end
+
+        def attempt_matches
+          /(\d) of (\d)/.match(attempt_in_words)
+        end
+
+        def free_throw_attempt
+          if matches = attempt_matches
+            matches[0].to_i
+          end
+        end
+
+        def free_throw_attempt_of
+          if matches = attempt_matches
+            matches[1].to_i
+          end
+        end
+
+        def description
+          @attributes['description'] || 0
+        end
+
+        def event_type
+          @attributes['event_type']
+        end
+
+        def coordinates
+          @attributes['location'] || {}
+        end
+
+        def coordinates?
+          @attributes['location'].present?
+        end
+
+        def coordinate_x
+          coordinates['coord_x']
+        end
+
+        def coordinate_y
+          coordinates['coord_y']
+        end
+
+        def turnover_type
+          @attributes['turnover_type']
+        end
+
+        def updated_at
+          @attributes['updated']
+        end
+
+        def statistics
+          @attributes['statistics'] || []
+        end
+
+        def field_goal?
+          two_pointer? || three_pointer?
+        end
+
+        def field_goal
+          self if field_goal?
+        end
+
+        def three_pointer?
+          event_type.include?('threepoint')
+        end
+
+        def three_pointer
+          self if three_pointer?
+        end
+
+        def two_pointer?
+          event_type.include?('twopoint')
+        end
+
+        def two_pointer
+          self if two_pointer?
+        end
+
+        def foul?
+          event_type.include?('foul') || event_type.include?('flagrant')
+        end
+
+        def foul
+          self if foul?
+        end
+
+        def free_throw?
+          event_type.include?('free_throw')
+        end
+
+        def free_throw
+          self if free_throw?
+        end
+
+        def made?
+          event_type.include?('made')
+        end
+
+        def miss?
+          event_type.include?('miss')
+        end
+
+        def scoring_play?
+          event_type.include?('made')
+        end
+
+        def scoring_play
+          self if scoring_play?
+        end
+
+        def stoppage?
+          %w(endperiod delay officialtimeout review teamtimeout tvtimeout).include?(event_type)
+        end
+
+        def stoppage
+          self if stoppage?
+        end
+
+        def turnover?
+          event_type.include?('turnover')
+        end
+
+        def turnover
+          self if turnover?
+        end
+
+        def play_player_stats
+          @play_player_stats ||= []
+        end
+
+        def scoring_players
+          @scoring_players ||= []
+        end
+
+        def on_court_players
+          @on_court_players ||= on_court_away_players + on_court_home_players
+        end
+
+        def on_court_away_team_id
+          @on_court_away_team_id ||= @attributes.dig('on_court', 'away', 'id')
+        end
+
+        def on_court_away_team_name
+          @on_court_away_team_name ||= @attributes.dig('on_court', 'away', 'name')
+        end
+
+        def on_court_away_players
+          (@attributes.dig('on_court', 'away', 'players') || {}).map do |player|
+            Models::OnCourtPlayer.new(
+              player.reverse_merge({
+                                     'event_id' => id,
+                                     'player_id' => player['id'],
+                                     'team_id' => on_court_away_team_id,
+                                     'team_name' =>  on_court_away_team_name,
+                                    })
+              )
+          end
+        end
+
+        def on_court_home_team_id
+          @on_court_home_team_id ||= @attributes.dig('on_court', 'home', 'id')
+        end
+
+        def on_court_home_team_name
+          @on_court_home_team_name ||= @attributes.dig('on_court', 'home', 'name')
+        end
+
+        def on_court_home_players
+          (@attributes.dig('on_court', 'home', 'players') || {}).map do |player|
+            Models::OnCourtPlayer.new(
+              player.reverse_merge({
+                                     'event_id' => id,
+                                     'player_id' => player['id'],
+                                     'team_id' => on_court_home_team_id,
+                                     'team_name' =>  on_court_home_team_name,
+                                    })
+              )
+          end
+        end
+
+        private
+
+        def build_statistics
+          statistics.each do |statistic|
+            play_player_stats << Models::PlayPlayerStat.new(event: self, attributes: statistic)
+            scoring_players << Models::ScoringPlayer.new(event: self, attributes: statistic) if scoring_play?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nba/models/on_court_player.rb

@@ -0,0 +1,41 @@
+module Sportradar
+  module Nba
+    module Models
+      class OnCourtPlayer
+        def initialize(attributes = {})
+          @attributes = attributes
+        end
+
+        def to_s
+          [].tap do |sentence_parts|
+            sentence_parts << event_id
+            sentence_parts << player_id
+            sentence_parts << full_name
+            sentence_parts << team_id
+            sentence_parts << team_name
+          end.join(' - ')
+        end
+
+        def event_id
+          @attributes.dig('event_id')
+        end
+
+        def player_id
+          @attributes.dig('player_id')
+        end
+
+        def full_name
+          @attributes.dig('full_name')
+        end
+
+        def team_id
+          @attributes.dig('team_id')
+        end
+
+        def team_name
+          @attributes.dig('team_name')
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nba/models/play_player_stat.rb

@@ -0,0 +1,171 @@
+module Sportradar
+  module Nba
+    module Models
+      class PlayPlayerStat
+        def initialize(event:, attributes:)
+          @event = event
+          @attributes = attributes
+        end
+
+        def to_s
+          [
+            quarter_number,
+            clock,
+            description,
+            team_name,
+            full_name,
+            stat,
+          ].join(' ')
+        end
+
+        def event
+          @event
+        end
+
+        def event_id
+          @event.id
+        end
+
+        def description
+          @event.description
+        end
+
+        def quarter
+          @event.quarter
+        end
+
+        def quarter_number
+          quarter.number
+        end
+
+        def clock
+          @event.clock
+        end
+
+        def player
+          @attributes.dig('player') || {}
+        end
+
+        def player_id
+          player.dig('id')
+        end
+
+        def jersey
+          player.dig('jersey')
+        end
+
+        def full_name
+          player.dig('full_name')
+        end
+
+        def team
+          @attributes.dig('team') || {}
+        end
+
+        def team_id
+          team.dig('id')
+        end
+
+        def team_market
+          team.dig('market')
+        end
+
+        def team_name
+          team.dig('name')
+        end
+
+        def stat
+          {
+            player_id: player_id,
+            team_id: team_id,
+            made: made?,
+            free_throw_type: free_throw_type,
+            free_throw: free_throw?,
+            regular_free_throw: regular_free_throw?,
+            technical_free_throw: technical_free_throw?,
+            points: points,
+            rebound_type: rebound_type,
+            defensive_rebound: defensive_rebound?,
+            offensive_rebound: offensive_rebound?,
+            shot_type: shot_type,
+            shot_type_desc: shot_type_desc,
+            three_point_shot: three_point_shot?,
+            type: type,
+          }.compact
+        end
+
+        def made?
+          @attributes.dig('made') == true
+        end
+
+        def free_throw_type
+          @attributes.dig('free_throw_type')
+        end
+
+        def free_throw?
+          type == 'freethrow'
+        end
+
+        def regular_free_throw?
+          free_throw_type == 'regular'
+        end
+
+        def technical_free_throw?
+          free_throw_type == 'technical'
+        end
+
+        def points
+          @attributes.dig('points')
+        end
+
+        def defensive_rebound?
+          rebound_type == 'defensive'
+        end
+
+        def offensive_rebound?
+          rebound_type == 'offensive'
+        end
+
+        def rebound_type
+          @attributes.dig('rebound_type')
+        end
+
+        def shot_type
+          @attributes.dig('shot_type')
+        end
+
+        def shot_type_desc
+          @attributes.dig('shot_type_desc')
+        end
+
+        def three_point_shot?
+          @attributes.dig('three_point_shot') == true
+        end
+
+        def type
+          @attributes.dig('type')
+        end
+
+        def jump_shot?
+          shot_type == 'jump shot'
+        end
+
+        def layup?
+          shot_type == 'layup'
+        end
+
+        def dunk?
+          shot_type == 'dunk'
+        end
+
+        def hook?
+          shot_type == 'hook shot'
+        end
+
+        def tip?
+          shot_type == 'tip shot'
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nba/models/quarter.rb

@@ -0,0 +1,65 @@
+module Sportradar
+  module Nba
+    module Models
+      class Quarter
+        def initialize(game_id:, attributes:)
+          @game_id = game_id
+          @attributes = attributes
+          build_events
+        end
+
+        def to_s
+          "Quarter #{number}"
+        end
+
+        def abbreviation
+          "#{number}"
+        end
+
+        def game_id
+          @game_id
+        end
+
+        def id
+          @id
+        end
+
+        def number
+          @attributes['number'] || 0
+        end
+
+        def events
+          @events ||= []
+        end
+
+        def events_data
+          @actions ||= @attributes.dig('events') || []
+        end
+
+        def fouls
+          events.collect(&:foul).compact
+        end
+
+        def scoring_plays
+          events.collect(&:scoring_play).compact
+        end
+
+        def stoppages
+          events.collect(&:stoppage).compact
+        end
+
+        def on_court_players
+          events.map(&:on_court_players).flatten
+        end
+
+        private
+
+        def build_events
+          events_data.each do |event_data|
+            events << Models::Event.new(quarter: self, attributes: event_data)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nba/models/scoring_play.rb

@@ -0,0 +1,35 @@
+module Sportradar
+  module Nba
+    module Models
+      class ScoringPlay < Event
+        def scored_at
+          updated_at
+        end
+
+        def scoring_method
+          shot_type
+        end
+
+        def scoring_type
+          event_type
+        end
+
+        def scoring_how
+          event_type
+        end
+
+        def to_h
+          {
+            id: id,
+            game_id: game_id,
+            points: points,
+            scored_at: scored_at,
+            scoring_method: scoring_method,
+            scoring_type: scoring_type,
+            scoring_how: scoring_how,
+          }.compact
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nba/models/scoring_player.rb

@@ -0,0 +1,19 @@
+module Sportradar
+  module Nba
+    module Models
+      class ScoringPlayer < PlayPlayerStat
+        def role
+          type
+        end
+
+        def scoring_play_id
+          event.id
+        end
+
+        def to_s
+          "#{super} - #{role}"
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nba/parsers/play_by_play_parser.rb

@@ -0,0 +1,68 @@
+module Sportradar
+  module Nba
+    module Parsers
+      class PlayByPlayParser
+        def initialize(game_play_by_play: {})
+          @game_play_by_play = game_play_by_play['game'] || game_play_by_play
+        end
+
+        def game_id
+          game_play_by_play['id']
+        end
+
+        def away
+          game_play_by_play['away'] || {}
+        end
+
+        def away_team_id
+          away['id']
+        end
+
+        def home
+          game_play_by_play['home'] || {}
+        end
+
+        def quarters
+          @quarters ||= build_quarters || []
+        end
+
+        def has_quarters?
+          quarters.count > 0
+        end
+
+        def events
+          (quarters || []).map(&:events).flatten
+        end
+
+        def fouls
+          (quarters || []).map(&:fouls).flatten
+        end
+
+        def scoring_plays
+          (quarters || []).map(&:scoring_plays).flatten
+        end
+
+        def stoppages
+          (quarters || []).map(&:stoppages).flatten
+        end
+
+        def on_court_players
+          (quarters || []).map(&:on_court_players).flatten
+        end
+
+        private
+
+        attr_reader :game_play_by_play
+
+        def game_play_by_play_quarters
+          game_play_by_play.dig('periods') || []
+        end
+
+        def build_quarters
+          game_play_by_play_quarters.
+            map { |attributes| Models::Quarter.new(game_id: game_id, attributes: attributes) }
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nhl/parsers/boxscore_parser.rb

@@ -139,23 +139,24 @@ module Sportradar
 
             data.map do |scoring_data|
               if period = scoring_data['number'].to_i
-                if period > 0 && period <= 3
+                period_type = (scoring_data['type'] || 'period').downcase
+
+                if (period > 0 && period <= 3) && (period_type == 'period')
                   key = "goals_period_#{period}".to_sym
                   scoring_periods[key] =
                     scoring_data['points'].to_i
                 elsif period > 3
-                  period_type = (scoring_data['type'] || 'period').downcase
                   if period_type == 'overtime'
                     key = "goals_#{period_type}_#{scoring_data['number'].to_i}".to_sym
                     scoring_periods[key] =
                       scoring_data['points'].to_i
                     overtime_points += scoring_data['points'].to_i
                     scoring_periods[:goals_overtime] = overtime_points
-                  elsif period_type == 'shootout'
-                    key = "goals_#{period_type}".to_sym
-                    scoring_periods[key] =
-                      scoring_data['points'].to_i
                   end
+                elsif period_type == 'shootout'
+                  key = "goals_#{period_type}".to_sym
+                  scoring_periods[key] =
+                    scoring_data['points'].to_i
                 end
               end
             end

data/lib/sportradar/version.rb

@@ -1,3 +1,3 @@
 module Sportradar
-  VERSION = '0.0.16'
+  VERSION = '0.0.18'
 end

data/lib/sportradar.rb

@@ -52,7 +52,15 @@ require 'sportradar/mlb/team_rosters'
 require 'sportradar/mlb/team_statistics'
 require 'sportradar/mlb/venues'
 
+require 'sportradar/nba/models/event'
+require 'sportradar/nba/models/quarter'
+require 'sportradar/nba/models/on_court_player'
+require 'sportradar/nba/models/play_player_stat'
+require 'sportradar/nba/models/scoring_player'
+require 'sportradar/nba/models/scoring_play'
+
 require 'sportradar/nba/parsers/boxscore_parser'
+require 'sportradar/nba/parsers/play_by_play_parser'
 
 require 'sportradar/nba/daily_schedule'
 require 'sportradar/nba/league_hierarchy'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sportradar
 version: !ruby/object:Gem::Version
-  version: 0.0.16
+  version: 0.0.18
 platform: ruby
 authors:
 - Stattleship
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-10-15 00:00:00.000000000 Z
+date: 2016-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -206,7 +206,14 @@ files:
 - lib/sportradar/nba/injuries.rb
 - lib/sportradar/nba/league_hierarchy.rb
 - lib/sportradar/nba/league_schedule.rb
+- lib/sportradar/nba/models/event.rb
+- lib/sportradar/nba/models/on_court_player.rb
+- lib/sportradar/nba/models/play_player_stat.rb
+- lib/sportradar/nba/models/quarter.rb
+- lib/sportradar/nba/models/scoring_play.rb
+- lib/sportradar/nba/models/scoring_player.rb
 - lib/sportradar/nba/parsers/boxscore_parser.rb
+- lib/sportradar/nba/parsers/play_by_play_parser.rb
 - lib/sportradar/nba/play_by_play.rb
 - lib/sportradar/nba/team_roster.rb
 - lib/sportradar/nba/team_rosters.rb