sportradar 0.0.9 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6c0abeead357c8e0c280dd654b0e89bc3e3d4b0a
-  data.tar.gz: 25e340119ea4c0bc2e5f0d8acf40cdd8a1ed99c6
+  metadata.gz: ad27a4a77ec5c04a10b227338f99e7be5d0f806e
+  data.tar.gz: 878f668271b9d63a62c6c5ce6bc1e0a150d85446
 SHA512:
-  metadata.gz: b15be914bc977ea7e03edb0c50b3518a9fdf1086144c7bfe13ad89f21a3cfa379094b8ef67fd5a7653f4f84e9a58e8ca8d800a1a578cec30eca2c4165015b02b
-  data.tar.gz: 8dd02722d3433811bf3b77371ffacd178711e0c7b9a698e2cbe28ec1af8095b3da7965e602232518fd2d5093a4af583747853a4cdca79fd72d56342f1514ae5b
+  metadata.gz: 8f586e5cfe745e9e108f6bc9fc424e2ff8b8339155663145ce0f86fd66a5967451d3adda6758bbd0fb6396c65774daaf58e1c77b43430c2b16b55aef818afe30
+  data.tar.gz: f9c9723b2884974ebea27cafe4123d4cab0bc2b71dac2daad5ef64d15d68f142e30a9e4d7c7be713669f6e5ae67bae322cc90ccefff41f1e4a6dc70c6bf7bb92

data/README.md

@@ -14,7 +14,7 @@ Currently supports
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'sportradar', '>= 0.0.9'
+gem 'sportradar', '>= 0.0.11'
 ```
 
 And then execute:
@@ -137,6 +137,7 @@ Defaults to and supports NFL Classic API feed version 1 only (not Official).
                                     away_team_abbreviation: 'PIT',
                                     home_team_abbreviation: 'NE',
                                     play_id: '4788eac3-c59e-4f82-94ef-d449ac6d6fca').fetch`
+* `Sportradar::Nfl::PlaySummary.new(details: '/2016/REG/1/NE/ARI/plays/4c578712-3589-416c-90aa-76064830fa7e.json').fetch`
 * `Sportradar::Nfl::Boxscore.new(week: 1,
                                  year: 2015,
                                  away_team_abbreviation: 'PIT',
@@ -724,7 +725,25 @@ Curveball = Ball
 Fastball = Foul Ball
 Fastball = Ball
 Curveball = Strike Swinging
+
 ```
+#### Football Play by Play
+
+* `Sportradar::Nfl::Parsers::PlayByPlayParser.new(game_play_by_play: {})`
+
+Given game NFL Play by Play JSON, makes it easy to get the drives, quarters, and plays via a set of convenience methods.
+
+ * quarters - game, number, drives
+
+ * drives - game, quarter, clock, team, plays
+
+ * plays - game, drive, team, participants, summary, yardage, etc.
+
+#### 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.
+
+* `Sportradar::Nfl::Models::PlaySummary.new(attributes: {})`
 
 ## Development
 

data/lib/sportradar/nfl/models/drive.rb

@@ -0,0 +1,89 @@
+module Sportradar
+  module Nfl
+    module Models
+
+      # NOTE: This data structure isn't techincially a single drive as due to the way
+      # Sportradar structures the play by play data and how it will be parsed
+      # a drive could be separated into two sets of info and plays by a TV timeout or
+      # the end of the quarter. The data/drive will continue using the same drive id
+      # in subsequent action data.
+      #
+      # Therefore, it would be incorrect to count the number of plays in the drive
+      # to get the play count.
+      #
+      # In addition, the drive data can contain actions/plays for other teams, such as
+      # when one team kicks off, then a tvtimeout, then the offensive team has their first play.
+      #
+      # To get the offensive plays, you need to compare the drive's team with the play's side.
+
+      class Drive
+        def initialize(quarter:, attributes:)
+          @quarter = quarter
+          @attributes = attributes
+        end
+
+        def to_s
+          "#{quarter.to_s} #{clock}"
+        end
+
+        def game_id
+          quarter.game_id
+        end
+
+        def quarter
+          @quarter
+        end
+
+        def quarter_number
+          @quarter.number
+        end
+
+        def clock
+          @attributes['clock'] || '0'
+        end
+
+        def id
+          @attributes['id']
+        end
+
+        def team
+          @attributes['team']
+        end
+
+        def type
+          @attributes['type']
+        end
+
+        def actions
+          @actions ||= @attributes.dig('actions') || []
+        end
+
+        def plays
+          @plays || build_plays || []
+        end
+
+        def events
+          @events || build_events || []
+        end
+
+        private
+
+        def build_plays
+          actions.each_with_object([]) do |action, _plays|
+            if action['type'] == 'play'
+              _plays << Models::Play.new(drive: self, attributes: action)
+            end
+          end
+        end
+
+        def build_events
+          actions.each_with_object([]) do |action, _events|
+            if action['type'] != 'play'
+              _events << Models::Event.new(drive: self, attributes: action)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+module Sportradar
+  module Nfl
+    module Models
+      class Event
+        def initialize(drive:, attributes:)
+          @drive = drive
+          @attributes = attributes
+        end
+
+        def to_s
+          event_type
+        end
+
+        def team
+          @drive.team
+        end
+
+        def drive_id
+          @drive.id
+        end
+
+        def quarter
+          @drive.quarter
+        end
+
+        def quarter_number
+          quarter.number
+        end
+
+        def clock
+          @attributes['clock'] || '0'
+        end
+
+        def id
+          @attributes['id']
+        end
+
+        def sequence
+          @attributes['sequence'] || 0
+        end
+
+        def event_type
+          @attributes['event_type']
+        end
+
+        def type
+          @attributes['type']
+        end
+
+        def updated_at
+          @attributes['updated']
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nfl/models/play.rb

@@ -0,0 +1,108 @@
+module Sportradar
+  module Nfl
+    module Models
+      class Play
+        def initialize(drive:, attributes:)
+          @drive = drive
+          @attributes = attributes
+        end
+
+        def to_s
+          summary
+        end
+
+        def game_id
+          @drive.game_id
+        end
+
+        def team
+          @drive.team
+        end
+
+        def drive_id
+          @drive.id
+        end
+
+        def quarter
+          @drive.quarter
+        end
+
+        def quarter_number
+          quarter.number
+        end
+
+        def clock
+          @attributes['clock']
+        end
+
+        def id
+          @attributes['id']
+        end
+
+        def details
+          @attributes['details']
+        end
+
+        def down
+          @attributes['down']
+        end
+
+        def participants
+          @attributes['participants']
+        end
+
+        def play_type
+          @attributes['play_type']
+        end
+
+        def sequence
+          @attributes['sequence']
+        end
+
+        def side
+          @attributes['side']
+        end
+
+        def summary
+          @attributes['summary']
+        end
+
+        def type
+          @attributes['type']
+        end
+
+        def updated_at
+          @attributes['updated']
+        end
+
+        def yard_line
+          @attributes['yard_line']
+        end
+
+        def yards_to_first_down
+          @attributes['yfd']
+        end
+
+        def direction
+          @attributes['direction']
+        end
+
+        def distance
+          @attributes['distance']
+        end
+
+        def formation
+          @attributes['formation']
+        end
+
+        def official?
+          @attributes['official']
+        end
+
+        def sequence
+          @attributes['sequence']
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nfl/models/play_advancement.rb

@@ -0,0 +1,60 @@
+module Sportradar
+  module Nfl
+    module Models
+      class PlayAdvancement
+        def initialize(play:, attributes:)
+          @play = play
+          @attributes = attributes
+        end
+
+        def to_s
+          [
+            type,
+            from_side_team,
+            from_yard_line,
+            to_side_team,
+            to_yard_line,
+            yards
+          ].compact.
+            join(' ')
+        end
+
+        def id
+          @play.id
+        end
+
+        def sequence
+          @attributes['sequence']
+        end
+
+        def type
+          @attributes['type']
+        end
+
+        def team
+          @attributes['team']
+        end
+
+        def yards
+          @attributes['yards']
+        end
+
+        def from_side_team
+          @attributes.dig('from', 'side')
+        end
+
+        def from_yard_line
+          @attributes.dig('from', 'yard_line')
+        end
+
+        def to_side_team
+          @attributes.dig('to', 'side')
+        end
+
+        def to_yard_line
+          @attributes.dig('to', 'yard_line')
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,531 @@
+module Sportradar
+  module Nfl
+    module Models
+      class PlayPlayerStat
+        def initialize(play:, attributes:)
+          @play = play
+          @attributes = attributes
+        end
+
+        def to_s
+          [
+            team,
+            name,
+            position,
+            stats,
+          ].join(' ')
+        end
+
+        def play_id
+          @play.id
+        end
+
+        def player_id
+          @attributes.dig('id')
+        end
+
+        def jersey
+          @attributes.dig('jersey')
+        end
+
+        def name
+          @attributes.dig('name')
+        end
+
+        def position
+          @attributes.dig('position')
+        end
+
+        def team
+          @attributes.dig('team')
+        end
+
+        def stats
+          {
+            'blocked_field_goal_return_returns' => blocked_field_goal_return_returns,
+            'blocked_field_goal_return_touchdown' => blocked_field_goal_return_touchdown,
+            'blocked_field_goal_return_yards' => blocked_field_goal_return_yards,
+            'blocked_punt_return_returns' => blocked_punt_return_returns,
+            'blocked_punt_return_touchdown' => blocked_punt_return_touchdown,
+            'blocked_punt_return_yards' => blocked_punt_return_yards,
+            'defense_assist' => defense_assist,
+            'defense_category' => defense_category,
+            'defense_forced_fumble' => defense_forced_fumble,
+            'defense_interception' => defense_interception,
+            'defense_interception_touchdown' => defense_interception_touchdown,
+            'defense_interception_yards' => defense_interception_yards,
+            'defense_sack' => defense_sack,
+            'defense_sack_yards' => defense_sack_yards,
+            'defense_safety' => defense_safety,
+            'defense_tackle' => defense_tackle,
+            'defense_tackle_lost' => defense_tackle_lost,
+            'extra_point_attempt' => extra_point_attempt,
+            'extra_point_blocked' => extra_point_blocked,
+            'extra_point_made' => extra_point_made,
+            'field_goal_attempt' => field_goal_attempt,
+            'field_goal_attempt_yards' => field_goal_attempt_yards,
+            'field_goal_blocked' => field_goal_blocked,
+            'field_goal_made' => field_goal_made,
+            'field_goal_return' => field_goal_return,
+            'field_goal_return_returns' => field_goal_return_returns,
+            'field_goal_return_touchdown' => field_goal_return_touchdown,
+            'field_goal_return_yards' => field_goal_return_yards,
+            'field_goal_yards' => field_goal_yards,
+            'fumble_category' => fumble_category,
+            'fumble_fumble' => fumble_fumble,
+            'fumble_lost' => fumble_lost,
+            'fumble_out_of_bounds' => fumble_out_of_bounds,
+            'fumble_return_category' => fumble_return_category,
+            'fumble_return_opp_recovered' => fumble_return_opp_recovered,
+            'fumble_return_own_recovered' => fumble_return_own_recovered,
+            'fumble_return_returned' => fumble_return_returned,
+            'fumble_return_touchdown' => fumble_return_touchdown,
+            'fumble_return_yards' => fumble_return_yards,
+            'kick_return_fair_catch' => kick_return_fair_catch,
+            'kick_return_returns' => kick_return_returns,
+            'kick_return_touchdown' => kick_return_touchdown,
+            'kick_return_yards' => kick_return_yards,
+            'kickoffs_endzone' => kickoffs_endzone,
+            'kickoffs_inside_20' => kickoffs_inside_20,
+            'kickoffs_kicks' => kickoffs_kicks,
+            'kickoffs_net_yards' => kickoffs_net_yards,
+            'kickoffs_returned' => kickoffs_returned,
+            'kickoffs_touchback' => kickoffs_touchback,
+            'kickoffs_yards' => kickoffs_yards,
+            'passing_attempt' => passing_attempt,
+            'passing_completion' => passing_completion,
+            'passing_first_down' => passing_first_down,
+            'passing_interception' => passing_interception,
+            'passing_red_zone_attempt' => passing_red_zone_attempt,
+            'passing_sacked' => passing_sacked,
+            'passing_sacked_for_yards' => passing_sacked_for_yards,
+            'passing_safety' => passing_safety,
+            'passing_touchdown' => passing_touchdown,
+            'passing_yards' => passing_yards,
+            'penalty_abbreviation' => penalty_abbreviation,
+            'penalty_first_down' => penalty_first_down,
+            'penalty_yards' => penalty_yards,
+            'punt_return_fair_catch' => punt_return_fair_catch,
+            'punt_return_returned' => punt_return_returns,
+            'punt_return_touchdown' => punt_return_touchdown,
+            'punt_return_yards' => punt_return_yards,
+            'punting_blocked' => punting_blocked,
+            'punting_inside_20' => punting_inside_20,
+            'punting_net_yards' => punting_net_yards,
+            'punting_punts' => punting_punts,
+            'punting_returned' => punting_returned,
+            'punting_safety' => punting_safety,
+            'punting_touchback' => punting_touchback,
+            'punting_yards' => punting_yards,
+            'receiving_first_down' => receiving_first_down,
+            'receiving_fumble' => receiving_fumble,
+            'receiving_reception' => receiving_reception,
+            'receiving_red_zone_target' => receiving_red_zone_target,
+            'receiving_target' => receiving_target,
+            'receiving_touchdown' => receiving_touchdown,
+            'receiving_yards' => receiving_yards,
+            'receiving_yards_after_catch' => receiving_yards_after_catch,
+            'rushing_first_down' => rushing_first_down,
+            'rushing_fumble' => rushing_fumble,
+            'rushing_red_zone_attempt' => rushing_red_zone_attempt,
+            'rushing_rush' => rushing_rush,
+            'rushing_safety' => rushing_safety,
+            'rushing_touchdown' => rushing_touchdown,
+            'rushing_yards' => rushing_yards,
+            'two_point_conversion_attempt' => two_point_conversion_attempt,
+            'two_point_conversion_failed' => two_point_conversion_failed,
+            'two_point_conversion_made' => two_point_conversion_made,
+            'two_point_conversion_pass' => two_point_conversion_pass,
+            'two_point_conversion_rececption' => two_point_conversion_rececption,
+            'two_point_conversion_rush' => two_point_conversion_rush,
+
+          }.compact
+        end
+
+        def defense_assist
+          @attributes.dig('defense', 'ast')
+        end
+
+        def defense_category
+          @attributes.dig('defense', 'category')
+        end
+
+        def defense_forced_fumble
+          @attributes.dig('defense', 'fum')
+        end
+
+        def defense_interception
+          @attributes.dig('defense', 'int')
+        end
+
+        def defense_interception_touchdown
+          @attributes.dig('defense', 'int_td')
+        end
+
+        def defense_interception_yards
+          @attributes.dig('defense', 'int_yds')
+        end
+
+        def defense_sack
+          @attributes.dig('defense', 'sack')
+        end
+
+        def defense_sack_yards
+          @attributes.dig('defense', 'yds')
+        end
+
+        def defense_safety
+          @attributes.dig('defense', 'sfty')
+        end
+
+        def defense_tackle
+          @attributes.dig('defense', 'tackle')
+        end
+
+        def defense_tackle_lost
+          @attributes.dig('defense', 'tlost')
+        end
+
+        def rushing_rush
+          @attributes.dig('rushing', 'att')
+        end
+
+        def rushing_first_down
+          @attributes.dig('rushing', 'fd')
+        end
+
+        def rushing_fumble
+          @attributes.dig('rushing', 'fum')
+        end
+
+        def rushing_red_zone_attempt
+          @attributes.dig('rushing', 'rz_att')
+        end
+
+        def rushing_safety
+          @attributes.dig('rushing', 'sfty')
+        end
+
+        def rushing_touchdown
+          @attributes.dig('rushing', 'td')
+        end
+
+        def rushing_yards
+          @attributes.dig('rushing', 'yds')
+        end
+
+        def field_goal_attempt
+          @attributes.dig('field_goal', 'att')
+        end
+
+        def field_goal_attempt_yards
+          @attributes.dig('field_goal', 'att_yds')
+        end
+
+        def field_goal_blocked
+          @attributes.dig('field_goal', 'blk')
+        end
+
+        def field_goal_made
+          @attributes.dig('field_goal', 'made')
+        end
+
+        def field_goal_return
+          @attributes.dig('field_goal', 'ret')
+        end
+
+        def field_goal_yards
+          @attributes.dig('field_goal', 'yds')
+        end
+
+        def passing_attempt
+          @attributes.dig('passing', 'att')
+        end
+
+        def passing_completion
+          @attributes.dig('passing', 'cmp')
+        end
+
+        def passing_first_down
+          @attributes.dig('passing', 'fd')
+        end
+
+        def passing_interception
+          @attributes.dig('passing', 'int')
+        end
+
+        def passing_red_zone_attempt
+          @attributes.dig('passing', 'rz_att')
+        end
+
+        def passing_safety
+          @attributes.dig('passing', 'sfty')
+        end
+
+        def passing_sacked
+          @attributes.dig('passing', 'sk')
+        end
+
+        def passing_sacked_for_yards
+          @attributes.dig('passing', 'sk_yds')
+        end
+
+        def passing_touchdown
+          @attributes.dig('passing', 'td')
+        end
+
+        def passing_yards
+          @attributes.dig('passing', 'yds')
+        end
+
+        def penalty_abbreviation
+          @attributes.dig('penalty', 'abbr')
+        end
+
+        def penalty_first_down
+          @attributes.dig('penalty', 'fd')
+        end
+
+        def penalty_yards
+          @attributes.dig('penalty', 'yds')
+        end
+
+        def receiving_first_down
+          @attributes.dig('receiving', 'fd')
+        end
+
+        def receiving_fumble
+          @attributes.dig('receiving', 'fum')
+        end
+
+        def receiving_reception
+          @attributes.dig('receiving', 'rec')
+        end
+
+        def receiving_red_zone_target
+          @attributes.dig('receiving', 'rz_tar')
+        end
+
+        def receiving_target
+          @attributes.dig('receiving', 'tar')
+        end
+
+        def receiving_touchdown
+          @attributes.dig('receiving', 'td')
+        end
+
+        def receiving_yards_after_catch
+          @attributes.dig('receiving', 'yac')
+        end
+
+        def receiving_yards
+          @attributes.dig('receiving', 'yds')
+        end
+
+        def extra_point_attempt
+          @attributes.dig('extra_point', 'att')
+        end
+
+        def extra_point_blocked
+          @attributes.dig('extra_point', 'blk')
+        end
+
+        def extra_point_made
+          @attributes.dig('extra_point', 'made')
+        end
+
+        def kickoffs_endzone
+          @attributes.dig('kickoffs', 'endzone')
+        end
+
+        def kickoffs_inside_20
+          @attributes.dig('kickoffs', 'in20')
+        end
+
+        def kickoffs_kicks
+          @attributes.dig('kickoffs', 'kicks')
+        end
+
+        def kickoffs_net_yards
+          @attributes.dig('kickoffs', 'net_yds')
+        end
+
+        def kickoffs_returned
+          @attributes.dig('kickoffs', 'ret')
+        end
+
+        def kickoffs_touchback
+          @attributes.dig('kickoffs', 'tb')
+        end
+
+        def kickoffs_yards
+          @attributes.dig('kickoffs', 'yds')
+        end
+
+        def punting_blocked
+          @attributes.dig('punting', 'blk')
+        end
+
+        def punting_inside_20
+          @attributes.dig('punting', 'in20')
+        end
+
+        def punting_net_yards
+          @attributes.dig('punting', 'net_yds')
+        end
+
+        def punting_punts
+          @attributes.dig('punting', 'punts')
+        end
+
+        def punting_returned
+          @attributes.dig('punting', 'ret')
+        end
+
+        def punting_safety
+          @attributes.dig('punting', 'sfty')
+        end
+
+        def punting_touchback
+          @attributes.dig('punting', 'tb')
+        end
+
+        def punting_yards
+          @attributes.dig('punting', 'yds')
+        end
+
+        def punt_return_fair_catch
+          @attributes.dig('punt_return', 'fc')
+        end
+
+        def punt_return_returns
+          @attributes.dig('punt_return', 'returns')
+        end
+
+        def punt_return_touchdown
+          @attributes.dig('punt_return', 'td')
+        end
+
+        def punt_return_yards
+          @attributes.dig('punt_return', 'yds')
+        end
+
+        def fumble_category
+          @attributes.dig('fumble', 'category')
+        end
+
+        def fumble_fumble
+          @attributes.dig('fumble', 'fum')
+        end
+
+        def fumble_lost
+          @attributes.dig('fumble', 'lost')
+        end
+
+        def fumble_out_of_bounds
+          @attributes.dig('fumble', 'oob')
+        end
+
+        def fumble_return_category
+          @attributes.dig('fumble_return', 'category')
+        end
+
+        def fumble_return_opp_recovered
+          @attributes.dig('fumble_return', 'opp_rec')
+        end
+
+        def fumble_return_own_recovered
+          @attributes.dig('fumble_return', 'own_rec')
+        end
+
+        def fumble_return_returned
+          @attributes.dig('fumble_return', 'returns')
+        end
+
+        def fumble_return_touchdown
+          @attributes.dig('fumble_return', 'td')
+        end
+
+        def fumble_return_yards
+          @attributes.dig('fumble_return', 'yds')
+        end
+
+        def two_point_conversion_attempt
+          @attributes.dig('two_point_conversion', 'att')
+        end
+
+        def two_point_conversion_failed
+          @attributes.dig('two_point_conversion', 'failed')
+        end
+
+        def two_point_conversion_made
+          @attributes.dig('two_point_conversion', 'made')
+        end
+
+        def two_point_conversion_pass
+          @attributes.dig('two_point_conversion', 'pass')
+        end
+
+        def two_point_conversion_rececption
+          @attributes.dig('two_point_conversion', 'rec')
+        end
+
+        def two_point_conversion_rush
+          @attributes.dig('two_point_conversion', 'rush')
+        end
+
+        def blocked_field_goal_return_returns
+          @attributes.dig('blocked_field_goal_return', 'returns')
+        end
+
+        def blocked_field_goal_return_yards
+          @attributes.dig('blocked_field_goal_return', 'yds')
+        end
+
+        def blocked_field_goal_return_touchdown
+          @attributes.dig('blocked_field_goal_return', 'td')
+        end
+
+        def blocked_punt_return_returns
+          @attributes.dig('blocked_punt_return', 'returns')
+        end
+
+        def blocked_punt_return_yards
+          @attributes.dig('blocked_punt_return', 'yds')
+        end
+
+        def blocked_punt_return_touchdown
+          @attributes.dig('blocked_punt_return', 'td')
+        end
+
+        def field_goal_return_returns
+          @attributes.dig('field_goal_return', 'returns')
+        end
+
+        def field_goal_return_yards
+          @attributes.dig('field_goal_return', 'yds')
+        end
+
+        def field_goal_return_touchdown
+          @attributes.dig('field_goal_return', 'td')
+        end
+
+        def kick_return_returns
+          @attributes.dig('kick_return', 'returns')
+        end
+
+        def kick_return_yards
+          @attributes.dig('kick_return', 'yds')
+        end
+
+        def kick_return_fair_catch
+          @attributes.dig('kick_return', 'fc')
+        end
+
+        def kick_return_touchdown
+          @attributes.dig('kick_return', 'td')
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nfl/models/play_summary.rb

@@ -0,0 +1,115 @@
+module Sportradar
+  module Nfl
+    module Models
+      class PlaySummary < Play
+        def initialize(attributes:)
+          @attributes = attributes
+        end
+
+        def to_s
+          summary
+        end
+
+        def game_id
+          @attributes['game']
+        end
+
+        def team
+          controller
+        end
+
+        def quarter_number
+          @attributes['quarter']
+        end
+
+        def controller
+          @attributes['controller']
+        end
+
+        def players
+          @attributes['players']
+        end
+
+        def end_situation_down
+          @attributes.dig('end_situation', 'down')
+        end
+
+        def end_situation_side
+          @attributes.dig('end_situation', 'side')
+        end
+
+        def end_situation_team
+          @attributes.dig('end_situation', 'team')
+        end
+
+        def end_situation_yard_line
+          @attributes.dig('end_situation', 'yard_line')
+        end
+
+        def end_situation_yards_to_first_down
+          @attributes.dig('end_situation', 'yfd')
+        end
+
+        def start_situation_down
+          @attributes.dig('start_situation', 'down')
+        end
+
+        def start_situation_side
+          @attributes.dig('start_situation', 'side')
+        end
+
+        def start_situation_team
+          @attributes.dig('start_situation', 'team')
+        end
+
+        def start_situation_yard_line
+          @attributes.dig('start_situation', 'yard_line')
+        end
+
+        def start_situation_yards_to_first_down
+          @attributes.dig('start_situation', 'yfd')
+        end
+
+        def scoring_team
+          @attributes.dig('score', 'team')
+        end
+
+        def score_type
+          @attributes.dig('score', 'type')
+        end
+
+        def points_scored
+          @attributes.dig('score', 'points')
+        end
+
+        def advancements
+          @advancements ||= (@attributes['advancements'] || []).
+                              each_with_object([]) do |attributes, _advancements|
+                                _advancements << PlayAdvancement.new(play: self, attributes: attributes)
+                            end
+        end
+
+        def has_advancements?
+          advancements.count > 0
+        end
+
+        def player_stats
+          @player_stats ||= (@attributes['players'] || []).
+                              each_with_object([]) do |attributes, _player_stats|
+                                _player_stats << PlayPlayerStat.new(play: self, attributes: attributes)
+                            end
+        end
+
+        def has_player_stats?
+          player_stats.count > 0
+        end
+
+        def is_current_drive_team?
+          if controller && team
+            controller == team
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+module Sportradar
+  module Nfl
+    module Models
+      class Quarter
+        def initialize(game_id:, attributes:)
+          @game_id = game_id
+          @attributes = attributes
+        end
+
+        def to_s
+          "Quarter #{number}"
+        end
+
+        def abbreviation
+          "Q#{number}"
+        end
+
+        def game_id
+          @game_id
+        end
+
+        def number
+          @attributes['number'] || 0
+        end
+
+        def pbp
+          @attributes['pbp']
+        end
+
+        def drives
+          @drives ||= build_drives
+        end
+
+        private
+
+        def build_drives
+          pbp.each_with_object([]) do |event, _drives|
+            if event['type'] == 'drive'
+              _drives << Models::Drive.new(quarter: self, attributes: event)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+module Sportradar
+  module Nfl
+    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_team'] || {}
+        end
+
+        def away_team_id
+          away['id']
+        end
+
+        def home
+          game_play_by_play['home_team'] || {}
+        end
+
+        def quarters
+          @quarters ||= build_quarters || []
+        end
+
+        def has_quarters?
+          quarters.count > 0
+        end
+
+        def drives
+          (quarters || []).map(&:drives).flatten
+        end
+
+        def plays
+          (drives || []).map(&:plays)
+        end
+
+        def events
+          (drives || []).map(&:events)
+        end
+
+        private
+
+        attr_reader :game_play_by_play
+
+        def build_quarters
+          game_play_by_play.
+            dig('quarters').
+              map { |attributes| Models::Quarter.new(game_id: game_id, attributes: attributes) }
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/nfl/play_summaries.rb

@@ -0,0 +1,42 @@
+module Sportradar
+  module Nfl
+    class PlaySummaries < Sportradar::Nfl::PlayByPlay
+      def self.perform(year: nil,
+                       interval_type: nil,
+                       week: 1,
+                       away_team_abbreviation:,
+                       home_team_abbreviation:)
+        new(year: year,
+            interval_type: interval_type,
+            week: week,
+            away_team_abbreviation: away_team_abbreviation,
+            home_team_abbreviation: home_team_abbreviation).perform
+      end
+
+      def perform
+        (quarters || []).each do |quarter|
+          (quarter['pbp'] || []).each do |pbp|
+            (pbp['actions'] || []).each do |action|
+              next unless action['type'] == 'play'
+
+              PlaySummary.new(week: @week,
+                              year: @year,
+                              interval_type: @interval_type,
+                              away_team_abbreviation: @away_team_abbreviation,
+                              home_team_abbreviation: @home_team_abbreviation,
+                              play_id: action['id']).save
+            end
+          end
+        end
+
+        nil
+      end
+
+      private
+
+      def quarters
+        fetch['quarters'] || []
+      end
+    end
+  end
+end

data/lib/sportradar/nfl/play_summary.rb

@@ -4,24 +4,32 @@ module Sportradar
       def initialize(year: nil,
                      interval_type: nil,
                      week: 1,
-                     away_team_abbreviation:,
-                     home_team_abbreviation:,
-                     play_id:)
+                     away_team_abbreviation: nil,
+                     home_team_abbreviation: nil,
+                     play_id: nil,
+                     details: nil)
         super(year: year,
               interval_type: interval_type,
               week: week,
               away_team_abbreviation: away_team_abbreviation,
               home_team_abbreviation: home_team_abbreviation)
         @play_id = play_id
+        @details = details
+
+        raise ArgumentError.new('A play_id or details path is required.') unless play_id || details
       end
 
       def path
-        "#{game_path}/plays/#{play_id}.json"
+        if details
+          details
+        else
+          "#{game_path}/plays/#{play_id}.json"
+        end
       end
 
       private
 
-      attr_reader :play_id
+      attr_reader :play_id, :details
     end
   end
 end

data/lib/sportradar/version.rb

@@ -1,3 +1,3 @@
 module Sportradar
-  VERSION = '0.0.9'
+  VERSION = '0.0.11'
 end

data/lib/sportradar.rb

@@ -56,7 +56,16 @@ require 'sportradar/nba/league_hierarchy'
 require 'sportradar/nba/league_schedule'
 require 'sportradar/nba/play_by_play'
 
+require 'sportradar/nfl/models/quarter'
+require 'sportradar/nfl/models/drive'
+require 'sportradar/nfl/models/event'
+require 'sportradar/nfl/models/play'
+require 'sportradar/nfl/models/play_player_stat'
+require 'sportradar/nfl/models/play_advancement'
+require 'sportradar/nfl/models/play_summary'
+
 require 'sportradar/nfl/parsers/boxscore_parser'
+require 'sportradar/nfl/parsers/play_by_play_parser'
 
 require 'sportradar/nfl/league_hierarchy'
 require 'sportradar/nfl/league_schedule'
@@ -73,6 +82,7 @@ require 'sportradar/nfl/game_statistics'
 require 'sportradar/nfl/game_summary'
 require 'sportradar/nfl/play_by_play'
 require 'sportradar/nfl/play_summary'
+require 'sportradar/nfl/play_summaries'
 require 'sportradar/nfl/boxscore'
 require 'sportradar/nfl/extended_boxscore'
 require 'sportradar/nfl/weekly_boxscore'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sportradar
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.11
 platform: ruby
 authors:
 - Stattleship
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-09-04 00:00:00.000000000 Z
+date: 2016-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -213,8 +213,17 @@ files:
 - lib/sportradar/nfl/game_summary.rb
 - lib/sportradar/nfl/league_hierarchy.rb
 - lib/sportradar/nfl/league_schedule.rb
+- lib/sportradar/nfl/models/drive.rb
+- lib/sportradar/nfl/models/event.rb
+- lib/sportradar/nfl/models/play.rb
+- lib/sportradar/nfl/models/play_advancement.rb
+- lib/sportradar/nfl/models/play_player_stat.rb
+- lib/sportradar/nfl/models/play_summary.rb
+- lib/sportradar/nfl/models/quarter.rb
 - lib/sportradar/nfl/parsers/boxscore_parser.rb
+- lib/sportradar/nfl/parsers/play_by_play_parser.rb
 - lib/sportradar/nfl/play_by_play.rb
+- lib/sportradar/nfl/play_summaries.rb
 - lib/sportradar/nfl/play_summary.rb
 - lib/sportradar/nfl/rankings.rb
 - lib/sportradar/nfl/season_statistics.rb