sportradar 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5f88f788cb220bf4ab4d8f2faa5e16245382fddc
-  data.tar.gz: 733899ea36a23e926e9445d272132c7546ec1073
+  metadata.gz: c1f3fa66ced94299bc569c3795968b49dc74c375
+  data.tar.gz: e4494583fb6d9ed659501121a7f012017d0586eb
 SHA512:
-  metadata.gz: b23372cf42c84e4070e2426c57014ceba9c23ccd6072c18c68d23993543f3bf6998f244ccb640570539ffdabea766ad587a636d152bf78f6b2d22e697b333db9
-  data.tar.gz: 3b22d8831551cae9493b17b9d7e07a7aaafe935604b0cb13c896135d552f630ede8c7b2ec50963e04188be0f9a7054aceee71a0b56ccd40a7ee69118af8bcf0f
+  metadata.gz: 22e3e0a3382d81b641d4e4aaf3f884396a4f5346ea7ac82273d131ec636237136f25f486c69494dea51fcc1576894fea2b0a21083455fe7ad5e65e94dd367b61
+  data.tar.gz: 1046595d90d3ee7320f3ff5b80e149211474f692329f11e3a799eb1a1efd4383c0f45909953d816eb9dfb41377ca9b68f3c4f11d7c680c922c9d22da9378741d

data/README.md

@@ -1,8 +1,8 @@
 # Sportradar
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/sportradar`. To experiment with that code, run `bin/console` for an interactive prompt.
+Simple API client for [Sportradar API](http://developer.sportradar.us/).
 
-TODO: Delete this and the text above, and describe your gem
+Currently supports [Major League Baseball API](http://developer.sportradar.us/docs/MLB_API) endpoints.
 
 ## Installation
 
@@ -32,6 +32,124 @@ SPORTRADAR_API_KEY_MLB=YOUR_API_KEY
 SPORTRADAR_API_KEY_NBA=YOUR_API_KEY
 SPORTRADAR_API_KEY_NFL=YOUR_API_KEY
 SPORTRADAR_API_KEY_NHL=YOUR_API_KEY
+SPORTRADAR_FILE_PATH=/path/to/save/responses
+```
+
+`SPORTRADAR_ACCESS_LEVEL` is `t` or 'p'
+
+### Console
+
+`bin/console`
+
+### Baseball/MLB
+
+Defaults to and supports API version 5 only.
+
+#### API Requests
+
+* `Sportradar::Mlb::Boxscore.new(event_id: '<game_guid>').fetch`
+* `Sportradar::Mlb::DailyBoxscore.new(date: Date.today).fetch`
+* `Sportradar::Mlb::DailyGameSummary.new(date: Date.today).fetch`
+* `Sportradar::Mlb::DailyPlayByPlay.new(date: Date.today).fetch`
+* `Sportradar::Mlb::DailySchedule.new(date: Date.today).fetch`
+* `Sportradar::Mlb::DailySummary.new(date: Date.today).fetch`
+* `Sportradar::Mlb::GameSummary.new(event_id: '<game_guid>').fetch`
+* `Sportradar::Mlb::Glossary.new().fetch`
+* `Sportradar::Mlb::Injuries.new().fetch`
+* `Sportradar::Mlb::LeagueHierarchy.new().fetch`
+* `Sportradar::Mlb::LeagueSchedule.new(year: '2016', interval_type: <reg|pre|pst>).fetch`
+* `Sportradar::Mlb::PlayByPlay.new(event_id: '<game_guid>').fetch`
+* `Sportradar::Mlb::PlayerProfile.new(player_id: '<player_guid>').fetch`
+* `Sportradar::Mlb::TeamActiveRosters.new().fetch`
+* `Sportradar::Mlb::TeamProfile.new(player_id: '<team_guid>').fetch`
+* `Sportradar::Mlb::TeamRosters.new().fetch`
+* `Sportradar::Mlb::Venues.new().fetch`
+
+Note: `.save` vs `.fetch` will store in the path specified in `SPORTRADAR_FILE_PATH`. However, you need to have a directory created for each request within that path.
+
+For example:
+
+* `boxscore`
+* `daily_boxscore`
+* `daily_game_summary`
+* `daily_play_by_play`
+* `daily_schedule`
+* `daily_summary`
+* `game_summary`
+* `glossary`
+* `injuries`
+* `league_hierarchy`
+* `league_schedule`
+* `play_by_play`
+* `player_profile`
+* `team_active_rosters`
+* `team_profile`
+* `team_rosters`
+* `venues`
+
+#### Bulk Saves
+
+Some helpers will call `.save` for each response as separate items.
+
+* `Sportradar::Mlb::DailyGameSummary.new(date: Date.today).perform`
+* `Sportradar::Mlb::DailyPlayByPlay.new(date: Date.today).perform`
+
+### Model Helpers
+
+#### Boxscore and Scoring Plays
+
+* `Sportradar::Mlb::ScoringPlays.new(game_boxscore: {})`
+
+Given game boxscore JSON, makes it easy to get the events and runners as scoring plays and players via a set of convenience methods.
+
+For example:
+
+```
+sp = Sportradar::Mlb::ScoringPlays.new(game_boxscore: g.game_boxscore)
+
+sp.first.scoring_players
+=> [{:player_id=>"66c43b7f-760a-446c-9f50-671915570227", :player_info=>nil, :role=>"pitcher"},
+ {:player_id=>"e1633ff9-8c46-4698-9bea-3eecd478fa94", :player_info=>nil, :role=>"hitter"},
+ {:player_id=>"e1633ff9-8c46-4698-9bea-3eecd478fa94",
+  :player_info=>
+   #<Sportradar::Mlb::Models::Runner:0x007fabc82ba748
+    @runner=
+     {"id"=>"e1633ff9-8c46-4698-9bea-3eecd478fa94",
+      "starting_base"=>0,
+      "first_name"=>"Kristopher",
+      "last_name"=>"Bryant",
+      "preferred_name"=>"Kris",
+      "jersey_number"=>"17"}>,
+  :role=>"runner"}]
+
+sp.runner_ids
+=> ["e1633ff9-8c46-4698-9bea-3eecd478fa94",
+ "898c62b6-95bf-4973-a435-c6cb42a52158",
+ "6ef878e2-1f2d-4855-a250-2ec7c97f961c",
+ "9baf07d4-b1cb-4494-8c95-600d9e8de1a9",
+ "084d2514-9ffb-414e-ae16-3bc690aaad51",
+ "8ec56596-5b8b-41f8-88a7-384f20b8b6a7"]
+
+sp.first.runner_ids
+=> ["e1633ff9-8c46-4698-9bea-3eecd478fa94"]
+
+sp.first.inning_label
+=> "Top of 1st"
+
+sp.first.scoring_method
+=> "Homerun"
+
+sp.away_team_hitter_ids
+=> ["e1633ff9-8c46-4698-9bea-3eecd478fa94", "57f0a40f-e0f5-4e76-bd59-b8c4de7a680c"]
+
+sp.home_team_pitcher_ids
+=> ["1a574c70-eb33-4202-ab97-548645a4d15e", "29e9830d-b31a-4246-998c-6ca6f5a73ee8"]
+
+sp.home_team_runner_ids
+=> ["6ef878e2-1f2d-4855-a250-2ec7c97f961c",
+ "9baf07d4-b1cb-4494-8c95-600d9e8de1a9",
+ "084d2514-9ffb-414e-ae16-3bc690aaad51",
+ "8ec56596-5b8b-41f8-88a7-384f20b8b6a7"]
 ```
 
 ## Development
@@ -42,10 +160,10 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/sportradar.
+Bug reports and pull requests are welcome on GitHub at https://github.com/stattleship/sportradar.
 
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+None.
 

data/lib/sportradar.rb

@@ -15,6 +15,12 @@ require 'sportradar/client/daily_api_request'
 require 'sportradar/client/client'
 require 'sportradar/client/configuration'
 
+require 'sportradar/mlb/models/pitch_outcome'
+require 'sportradar/mlb/models/runner'
+require 'sportradar/mlb/models/scoring_play'
+
+require 'sportradar/mlb/scoring_plays'
+
 require 'sportradar/mlb/boxscore'
 require 'sportradar/mlb/daily_boxscore'
 require 'sportradar/mlb/daily_schedule'
@@ -33,4 +39,6 @@ require 'sportradar/mlb/team_profile'
 require 'sportradar/mlb/team_rosters'
 require 'sportradar/mlb/venues'
 
+Oj.default_options = {}
+
 Dotenv.load

data/lib/sportradar/mlb/models/pitch_outcome.rb

@@ -0,0 +1,104 @@
+module Sportradar
+  module Mlb
+    module Models
+      class PitchOutcome
+        def initialize(outcome:)
+          @outcome = outcome
+        end
+
+        def to_s
+          outcomes[outcome] || ''
+        end
+
+        private
+
+        attr_reader :outcome
+
+        def outcomes
+          {
+            "aBK" => "Balk",
+            "aCI" => "Catcher Interference",
+            "aD" => "Double",
+            "aDAD3" => "Double - Adv 3rd",
+            "aDAD4" => "Double - Adv Home",
+            "aFCAD2" => "Fielders Choice - Adv 2nd",
+            "aFCAD3" => "Fielders Choice - Adv 3rd",
+            "aFCAD4" => "Fielders Choice - Adv Home",
+            "aHBP" => "Hit By Pitch",
+            "aHR" => "Homerun",
+            "aKLAD1" => "Strike Looking - Adv 1st",
+            "aKLAD2" => "Strike Looking - Adv 2nd",
+            "aKLAD3" => "Strike Looking - Adv 3rd",
+            "aKLAD4" => "Strike Looking - Adv Home",
+            "aKSAD1" => "Strike Swinging - Adv 1st",
+            "aKSAD2" => "Strike Swinging - Adv 2nd",
+            "aKSAD3" => "Strike Swinging - Adv 3rd",
+            "aKSAD4" => "Strike Swinging - Adv Home",
+            "aROE" => "Reached On Error",
+            "aROEAD2" => "Reached On Error - Adv 2nd",
+            "aROEAD3" => "Reached On Error - Adv 3rd",
+            "aROEAD4" => "Reached On Error - Adv Home",
+            "aS" => "Single",
+            "aSAD2" => "Single - Adv 2nd",
+            "aSAD3" => "Single - Adv 3rd",
+            "aSAD4" => "Single - Adv Home",
+            "aSBAD1" => "Sacrifice Bunt - Adv 1st",
+            "aSBAD2" => "Sacrifice Bunt - Adv 2nd",
+            "aSBAD3" => "Sacrifice Bunt - Adv 3rd",
+            "aSBAD4" => "Sacrifice Bunt - Adv Home",
+            "aSFAD1" => "Sacrifice Fly - Adv 1st",
+            "aSFAD2" => "Sacrifice Fly - Adv 2nd",
+            "aSFAD3" => "Sacrifice Fly - Adv 3rd",
+            "aSFAD4" => "Sacrifice Fly - Adv Home",
+            "aT" => "Triple",
+            "aTAD4" => "Triple - Adv Home",
+            "bB" => "Ball",
+            "bDB" => "Dirt Ball",
+            "bIB" => "iBall",
+            "bPO" => "Pitchout",
+            "kF" => "Foul Ball",
+            "kFT" => "Foul Tip",
+            "kKL" => "Strike Looking",
+            "kKS" => "Strike Swinging",
+            "oBI" => "Batter Interference",
+            "oDT3" => "Double - Out at 3rd",
+            "oDT4" => "Double - Out at Home",
+            "oFC" => "Fielders Choice",
+            "oFCT2" => "Fielders Choice - Out at 2nd",
+            "oFCT3" => "Fielders Choice - Out at 3rd",
+            "oFCT4" => "Fielders Choice - Out at Home",
+            "oFO" => "Fly Out",
+            "oGO" => "Ground Out",
+            "oKLT1" => "Strike Looking - Out at 1st",
+            "oKLT2" => "Strike Looking - Out at 2nd",
+            "oKLT3" => "Strike Looking - Out at 3rd",
+            "oKLT4" => "Strike Looking - Out at Home",
+            "oKST1" => "Strike Swinging - Out at 1st",
+            "oKST2" => "Strike Swinging - Out at 2nd",
+            "oKST3" => "Strike Swinging - Out at 3rd",
+            "oKST4" => "Strike Swinging - Out at Home",
+            "oLO" => "Line Out",
+            "oOBB" => "Out of Batters Box",
+            "oOP" => "Out on Appeal",
+            "oPO" => "Pop Out",
+            "oROET2" => "Reached On Error - Out at 2nd",
+            "oROET3" => "Reached On Error - Out at 3rd",
+            "oROET4" => "Reached On Error - Out at Home",
+            "oSB" => "Sacrifice Bunt",
+            "oSBT2" => "Sacrifice Bunt - Out at 2nd",
+            "oSBT3" => "Sacrifice Bunt - Out at 3rd",
+            "oSBT4" => "Sacrifice Bunt - Out at Home",
+            "oSF" => "Sacrifice Fly",
+            "oSFT2" => "Sacrifice Fly - Out at 2nd",
+            "oSFT3" => "Sacrifice Fly - Out at 3rd",
+            "oSFT4" => "Sacrifice Fly - Out at Home",
+            "oST2" => "Single - Out at 2nd",
+            "oST3" => "Single - Out at 3rd",
+            "oST4" => "Single - Out at Home",
+            "oTT4" => "Triple - Out at Home",
+          }
+        end
+      end
+    end
+  end
+end

data/lib/sportradar/mlb/models/runner.rb

@@ -0,0 +1,59 @@
+module Sportradar
+  module Mlb
+    module Models
+      class Runner
+        def initialize(runner: {})
+          @runner = runner
+        end
+
+        def id
+          runner['id']
+        end
+
+        def first_name
+          runner['first_name']
+        end
+
+        def jersey_number
+          runner['jersey_number']
+        end
+
+        def last_name
+          runner['last_name']
+        end
+
+        def preferred_name
+          runner['preferred_name']
+        end
+
+        def starting_base
+          runner['starting_base']
+        end
+
+        def starting_base_name
+          if starting_base
+            if starting_base == 0
+              'Home'
+            else
+              "#{ActiveSupport::Inflector.ordinalize(starting_base)} base"
+            end
+          end
+        end
+
+        def starting_base_label
+          if starting_base
+            if starting_base == 0
+              'HP'
+            else
+              "#{starting_base}B"
+            end
+          end
+        end
+
+        private
+
+        attr_reader :runner
+      end
+    end
+  end
+end

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

@@ -0,0 +1,166 @@
+module Sportradar
+  module Mlb
+    module Models
+      class ScoringPlay
+        def initialize(game_id:, team_id:, event:)
+          @game_id = game_id
+          @team_id = team_id
+          @event = event
+        end
+
+        def id
+          event['id']
+        end
+
+        def hitter_id
+          event['hitter_id']
+        end
+
+        def hitter_outcome
+          event['hitter_outcome']
+        end
+
+        def inning
+          event['inning']
+        end
+
+        def oridinal_inning
+          ActiveSupport::Inflector.ordinalize(inning)
+        end
+
+        def inning_half
+          event['inning_half']
+        end
+
+        def inning_half_label
+          case inning_half
+          when 'B'
+            'Bottom of'
+          when 'T'
+            'Top of'
+          else
+            ''
+          end
+        end
+
+        def inning_label
+          if inning
+            "#{inning_half_label} #{oridinal_inning}"
+          end
+        end
+
+        def pitcher_id
+          event['pitcher_id']
+        end
+
+        def runners
+          (event['runners'] || []).map do |runner|
+            Runner.new(runner: runner)
+          end
+        end
+
+        def runner_ids
+          (runners || []).map(&:id)
+        end
+
+        def play_type
+          event['type']
+        end
+
+        def pitch?
+            play_type == 'pitch'
+        end
+
+        def period_number
+          inning
+        end
+
+        def points
+          runners.count
+        end
+
+        def scored_at
+        end
+
+        def scoring_conversion
+        end
+
+        def scoring_conversion_points
+        end
+
+        def scoring_method
+          PitchOutcome.new(outcome: hitter_outcome).
+            to_s
+        end
+
+        def scoring_how
+          play_type
+        end
+
+        def scoring_type
+          hitter_outcome
+        end
+
+        def time_code
+          "#{inning_half}#{inning}"
+        end
+
+        def period_seconds
+          0
+        end
+
+        def empty_net
+          false
+        end
+
+        def conversion
+        end
+
+        def conversion_points
+          0
+        end
+
+        def yards
+          0
+        end
+
+        def pitcher_role
+          {
+            player_id: pitcher_id,
+            player_info: nil,
+            role: 'pitcher',
+          }
+        end
+
+        def hitter_role
+          {
+            player_id: hitter_id,
+            player_info: nil,
+            role: 'hitter',
+          }
+        end
+
+        def runner_roles
+          runners.map do |runner|
+            {
+              player_id: runner.id,
+              player_info: runner,
+              role: 'runner',
+            }
+          end
+        end
+
+        def scoring_players
+          [
+            pitcher_role,
+            hitter_role,
+            runner_roles,
+          ].compact.
+            flatten
+        end
+
+        attr_reader :event, :game_id, :team_id
+      end
+    end
+  end
+end

data/lib/sportradar/mlb/scoring_plays.rb

@@ -0,0 +1,125 @@
+module Sportradar
+  module Mlb
+    class ScoringPlays
+      def initialize(game_boxscore: {})
+        @game_boxscore = game_boxscore['game'] || game_boxscore
+      end
+
+      def game_id
+        game_boxscore['id']
+      end
+
+      def away
+        game_boxscore['away'] || {}
+      end
+
+      def away_team_id
+        away['id']
+      end
+
+      def home
+        game_boxscore['home'] || {}
+      end
+
+      def home_team_id
+        home['id']
+      end
+
+      def away_events
+        away['events'] || []
+      end
+
+      def home_events
+        home['events'] || []
+      end
+
+      def events
+        away_events + home_events
+      end
+
+      def away_team_plays
+        away_events.map do |event|
+          build_scoring_play(team_id: away_team_id,
+                             event: event)
+        end
+      end
+
+      def home_team_plays
+        home_events.map do |event|
+          build_scoring_play(team_id: home_team_id,
+                             event: event)
+        end
+      end
+
+      def all
+        away_team_plays + home_team_plays
+      end
+
+      def away_team_hitter_ids
+        away_team_plays.map(&:hitter_id).
+          uniq
+      end
+
+      def home_team_hitter_ids
+        home_team_plays.map(&:pitcher_id).
+          uniq
+      end
+
+      def away_team_pitcher_ids
+        away_team_plays.map(&:pitcher_id).
+          uniq
+      end
+
+      def home_team_pitcher_ids
+        home_team_plays.map(&:pitcher_id).
+          uniq
+      end
+
+      def away_team_runner_ids
+        away_team_plays.map(&:runner_ids).
+          flatten.
+          uniq
+      end
+
+      def home_team_runner_ids
+        home_team_plays.map(&:runner_ids).
+          flatten.
+          uniq
+      end
+
+      def pitcher_ids
+        all.map(&:pitcher_id)
+      end
+
+      def hitter_ids
+        all.map(&:hitter_id)
+      end
+
+      def runner_ids
+        all.map(&:runner_ids).
+          flatten.
+          uniq
+      end
+
+      def first
+        all.
+          first
+      end
+
+      def last
+        all.
+          last
+      end
+
+      private
+
+      attr_reader :game_boxscore
+
+      def build_scoring_play(team_id:, event:)
+        Sportradar::Mlb::Models::ScoringPlay.new(game_id: game_id,
+                                                 team_id: team_id,
+                                                 event: event)
+      end
+    end
+  end
+end

data/lib/sportradar/version.rb

@@ -1,3 +1,3 @@
 module Sportradar
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sportradar
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Stattleship
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-07-12 00:00:00.000000000 Z
+date: 2016-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -180,8 +180,12 @@ files:
 - lib/sportradar/mlb/injuries.rb
 - lib/sportradar/mlb/league_hierarchy.rb
 - lib/sportradar/mlb/league_schedule.rb
+- lib/sportradar/mlb/models/pitch_outcome.rb
+- lib/sportradar/mlb/models/runner.rb
+- lib/sportradar/mlb/models/scoring_play.rb
 - lib/sportradar/mlb/play_by_play.rb
 - lib/sportradar/mlb/player_profile.rb
+- lib/sportradar/mlb/scoring_plays.rb
 - lib/sportradar/mlb/team_active_rosters.rb
 - lib/sportradar/mlb/team_profile.rb
 - lib/sportradar/mlb/team_rosters.rb