stattleship-ruby 0.1.25 → 0.1.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 685dbf9557b8b271f793009f0c6ade2344c610a7
-  data.tar.gz: fd1bb152c890497a2559ac18a3bc42b82fa050f0
+  metadata.gz: bf08d27f1671847b7e291b133334a1d5c5507214
+  data.tar.gz: 5974518881f4d88800e48d534962a7d83da92b92
 SHA512:
-  metadata.gz: ca3affac64edb274799e2bdbf245a5e7e3ec3496221f6dae29c6f9dc418c26555f15df606668aadbf1f4bf7a36bf06ae1c009082325621c5552a4363f3bbc615
-  data.tar.gz: ff7713955d8c90986b2aef8eb05c65a70f65a6227b8534bcad35cad6ae8b8909618d9b80662803fcf7981fa59177d4e82ac03f889f03112e2e86f5ec8902861f
+  metadata.gz: 6fb0d73cb513109c77d66cc2403f7f657d73873b82069a01d8961dde5f6b52833e9c5acd2bec64a78e745e367fe2d818065ac4767e56c95db93a4953d8f09891
+  data.tar.gz: f515e94d71525cee607b59f0b1be0147dceb34fa0c5b723572947bc16849c49f38d132871854e759fe5a84a47b424ecc7a4c427f598775a476ef5e62df086412

data/README.md

@@ -9,7 +9,7 @@ Check out the [Stattleship API](https://api.stattleship.com) - The Sports Data A
 
 Meaningful. Developer-Friendly.
 
-:football: :basketball: and :black_circle: :ice_hockey_stick_and_puck: :snowflake: and :baseball: !
+:football: :basketball: and :black_circle: :black_circle: :snowflake: and :baseball: !
 
 We're gonna need a bigger :boat:!
 
@@ -22,7 +22,7 @@ gem install stattleship-ruby
 ## Usage
 
 ```
-gem 'stattleship-ruby', '~> 0.1.24'
+gem 'stattleship-ruby', '~> 0.1.25'
 ```
 
 ### Build
@@ -33,8 +33,8 @@ gem build stattleship-ruby.gemspec
 
 ### Install
 
-```
-gem install stattleship-ruby-0.1.24.gem
+```rb
+gem install stattleship-ruby-0.1.25.gem
 ```
 ## Prerequisites
 
@@ -46,7 +46,7 @@ You'll need
 
 There are two ways to configure the gem.
 
-```
+```rb
 Stattleship.configure do |config|
   config.api_token = YOUR_TOKEN
 end
@@ -74,7 +74,7 @@ It's dead simple.
 
 The pattern is pretty much as follows:
 
-```
+```rb
 query_params = Stattleship::Params::BasketballGameLogsParams.new
 query_params.player_id = 'nba-stephen-curry'
 query_params.since = '1 week ago'

data/examples/README.md

@@ -30,6 +30,8 @@ You'll need
 
 * Stattleship API Access Token from https://www.stattleship.com
 * Set that in your `.env` file as `STATTLESHIP_ACCESS_TOKEN=your_token`
+* To build the gem: `gem build stattleship-ruby.gemspec`
+* To install the gem (with the current version of the gem file): `gem install stattleship-ruby-0.1.xx.gem`
 * To run examples, that .env file should be in the `/examples` dir.
 * Copy the `sample.env` file, insert your token and save as `examples/.env`
 * The `cd` to the `/examples` directory and `ruby <example>.rb` such that the .env loads
@@ -64,7 +66,7 @@ You'll need
 
 * [Football Players](football_players.rb)
   * Uses `FootballPlayersParams` and makes a `FootballPlayers` request
-  * Uses `team_id` and `level_up` parameters to return Denver Broncos players
+  * Uses `team_id` parameters to return Denver Broncos players
   * Demonstrates ability to filter and sort on a numeric `salary` to get list of players making more than $5M and where they went to `school`
 
 * [Hockey Scoring Plays](hockey_scoring_plays.rb)

data/examples/at_bats.rb

@@ -0,0 +1,25 @@
+# Set your STATTLESHIP_ACCESS_TOKEN from https://www.stattleship.com in the examples/.env file
+
+require 'dotenv'
+Dotenv.load
+
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'stattleship')
+require 'pp'
+
+# Construct params for the fetch
+query_params = Stattleship::Params::AtBatsParams.new
+
+query_params.season_id = 'mlb-2016'
+query_params.interval_type = 'regularseason'
+query_params.hitter_id = 'mlb-mike-trout'
+query_params.hit_type = 'GB'
+
+# fetch will automatically traverse the paginated response links
+at_bats = Stattleship::AtBats.fetch(params: query_params)
+
+pp at_bats.map(&:to_sentence)
+
+at_bats.each do |at_bat|
+  pp at_bat.pitches.map(&:to_sentence)
+end

data/examples/baseball_games.rb

@@ -16,6 +16,7 @@ query_params.team_id = 'mlb-bos'
 # may need to adjust this depending on time of year
 query_params.season_id = 'mlb-2016'
 query_params.status = 'upcoming'
+query_params.on = 'today'
 
 # fetch will automatically traverse the paginated response links
 games = Stattleship::BaseballGames.fetch(params: query_params)
@@ -28,5 +29,5 @@ pp games.first.started_at.strftime('%b %e, %l:%M %p')
 
 # or, individual attributes
 games.each do |game|
-  pp game.scoreline
+  pp game.label
 end

data/examples/basketball_team_game_logs.rb

@@ -11,26 +11,33 @@ require 'pp'
 query_params = Stattleship::Params::BasketballTeamGameLogsParams.new
 
 # use a slug, typically 'league-team_abbreviation'
+query_params.season_id = 'nba-2016-2017'
+query_params.interval_type = 'regularseason'
 query_params.team_id = 'nba-cle'
 
 # may need to adjust this depending on time of year/NBA season
-query_params.since = '1 week ago'
+# query_params.since = '1 month ago'
 
 # fetch will automatically traverse the paginated response links
 game_logs = Stattleship::BasketballTeamGameLogs.fetch(params: query_params)
 
 # the populated object
-pp game_logs.first
+# pp game_logs.first
 
 # can access friendly helpers
-pp game_logs.first.to_sentence
+# pp game_logs.first.to_sentence
 
 # "Cleveland 42 FGM, 50.6 FG%, 115 PTS, 33 DRB, 14 ORB, 47 REB (Clippers vs Cavaliers January 21, 2016 at  8:00pm)"
 
 # or, individual attributes
-game_logs.each do |game_log|
-  pp game_log.three_pointers_made
-end
+
+scores = game_logs.map(&:team_score)
+
+pp scores
+
+# game_logs.each do |game_log|
+#   pp game_log.to_sentence
+# end
 
 # 13
 # 11

data/examples/line_ups.rb

@@ -0,0 +1,21 @@
+# Set your STATTLESHIP_ACCESS_TOKEN from https://www.stattleship.com in the examples/.env file
+
+require 'dotenv'
+Dotenv.load
+
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'stattleship')
+require 'pp'
+
+# Construct params for the fetch
+query_params = Stattleship::Params::LineUpsParams.new
+
+query_params.season_id = 'mlb-2017'
+query_params.interval_type = 'preseason'
+query_params.since = '1 week ago'
+query_params.team_id = 'mlb-bos'
+
+# fetch will automatically traverse the paginated response links
+line_ups = Stattleship::LineUps.fetch(params: query_params)
+
+pp line_ups.map(&:to_sentence)

data/examples/pitches.rb

@@ -0,0 +1,26 @@
+# Set your STATTLESHIP_ACCESS_TOKEN from https://www.stattleship.com in the examples/.env file
+
+require 'dotenv'
+Dotenv.load
+
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'stattleship')
+require 'pp'
+
+# Construct params for the fetch
+query_params = Stattleship::Params::PitchesParams.new
+
+query_params.season_id = 'mlb-2017'
+query_params.interval_type = 'preseason'
+query_params.game_id = 'mlb-2017-cin-kc-2017-03-20-1605'
+
+
+# query_params.pitch_outcome_type = 'aHR'
+# query_params.inning = 9
+# query_params.speed_and_over = 103
+# query_params.pitcher_id = 'mlb-aroldis-chapman'
+
+# fetch will automatically traverse the paginated response links
+pitches = Stattleship::Pitches.fetch(params: query_params)
+
+pp pitches.map(&:to_sentence)

data/lib/stattleship.rb

@@ -114,4 +114,8 @@ require 'stattleship/football_top_stats'
 require 'stattleship/hockey_top_stats'
 require 'stattleship/baseball_top_stats'
 
+require 'stattleship/at_bats'
+require 'stattleship/line_ups'
+require 'stattleship/pitches'
+
 Dotenv.load

data/lib/stattleship/at_bats.rb

@@ -0,0 +1,81 @@
+module Stattleship
+  class AtBats < Stattleship::Endpoint
+    AT_BATS = 'baseball/mlb/at_bats'.freeze
+
+    def self.fetch(params:)
+      super(path: AT_BATS,
+            params: params)
+    end
+
+    def populate
+      at_bats.each do |model|
+        populate_games(model)
+
+        games.each do |game|
+          populate_game(game)
+        end
+
+        populate_hitters(model)
+        populate_hitter_teams(model)
+
+        (baseball_pitches || []).each do |pitch|
+          populate_pitchers(pitch)
+          populate_hitters(pitch)
+          populate_teams(pitch)
+          populate_hitter_teams(pitch)
+        end
+
+        populate_baseball_pitches(model)
+
+      end
+    end
+  end
+
+  module AtBatsRepresenter
+    include Roar::JSON
+    include Stattleship::Models
+
+    collection :away_teams, extend: TeamRepresenter,
+                            class: Team
+
+    collection :hitters, extend: PlayerRepresenter,
+                         class: Player
+
+    collection :hitter_teams, extend: TeamRepresenter,
+                              class: Team
+
+    collection :pitchers, extend: PlayerRepresenter,
+                          class: Player
+
+    collection :home_teams, extend: TeamRepresenter,
+                            class: Team
+
+    collection :winning_teams, extend: TeamRepresenter,
+                               class: Team
+
+    collection :games, extend: GameRepresenter,
+                       class: Game
+
+    collection :leagues, extend: LeagueRepresenter,
+                         class: League
+
+    collection :officials, extend: OfficialRepresenter,
+                           class: Official
+
+    collection :seasons, extend: SeasonRepresenter,
+                         class: Season
+
+    collection :venues, extend: VenueRepresenter,
+                        class: Venue
+
+
+    collection :teams, extend: TeamRepresenter,
+                       class: Team
+
+    collection :baseball_pitches, extend: PitchRepresenter,
+                                  class: Pitch
+
+    collection :at_bats, extend: AtBatRepresenter,
+                         class: AtBat
+  end
+end

data/lib/stattleship/endpoint.rb

@@ -16,6 +16,19 @@ module Stattleship
 
     private
 
+    def populate_baseball_pitches(model)
+      model.pitches = []
+
+      return if model.baseball_pitch_ids.nil?
+      return if baseball_pitches.nil?
+
+      model.baseball_pitch_ids.each do |baseball_pitch_id|
+        model.pitches << baseball_pitches.detect do |baseball_pitch|
+          baseball_pitch.id == baseball_pitch_id
+        end
+      end
+    end
+
     def populate_officials(model)
       model.officials = []
 
@@ -37,6 +50,22 @@ module Stattleship
       end
     end
 
+    def populate_pitchers(model)
+      return if pitchers.nil?
+
+      model.pitcher = pitchers.detect do |pitcher|
+        pitcher.id == model.pitcher_id
+      end
+    end
+
+    def populate_hitters(model)
+      return if hitters.nil?
+
+      model.hitter = hitters.detect do |hitter|
+        hitter.id == model.hitter_id
+      end
+    end
+
     def populate_players(model)
       return if players.nil?
 
@@ -179,6 +208,14 @@ module Stattleship
       end
     end
 
+    def populate_hitter_teams(model)
+      return if hitter_teams.nil?
+
+      model.hitter_team = hitter_teams.detect do |hitter_team|
+        hitter_team.id == model.hitter_team_id
+      end
+    end
+
     def populate_venue(model)
       return if venues.nil?
 

data/lib/stattleship/line_ups.rb

@@ -0,0 +1,61 @@
+module Stattleship
+  class LineUps < Stattleship::Endpoint
+    LINE_UPS = 'baseball/mlb/lineups'.freeze
+
+    def self.fetch(params:)
+      super(path: LINE_UPS,
+            params: params)
+    end
+
+    def populate
+      lineups.each do |model|
+        populate_games(model)
+
+        games.each do |game|
+          populate_game(game)
+        end
+
+        populate_players(model)
+        populate_teams(model)
+      end
+    end
+  end
+
+  module LineUpsRepresenter
+    include Roar::JSON
+    include Stattleship::Models
+
+    collection :away_teams, extend: TeamRepresenter,
+                            class: Team
+
+    collection :home_teams, extend: TeamRepresenter,
+                            class: Team
+
+    collection :winning_teams, extend: TeamRepresenter,
+                               class: Team
+
+    collection :games, extend: GameRepresenter,
+                       class: Game
+
+    collection :leagues, extend: LeagueRepresenter,
+                         class: League
+
+    collection :officials, extend: OfficialRepresenter,
+                           class: Official
+
+    collection :seasons, extend: SeasonRepresenter,
+                         class: Season
+
+    collection :venues, extend: VenueRepresenter,
+                        class: Venue
+
+    collection :teams, extend: TeamRepresenter,
+                       class: Team
+
+    collection :players, extend: PlayerRepresenter,
+                         class: Player
+
+    collection :lineups, extend: LineUpRepresenter,
+                          class: LineUp
+  end
+end

data/lib/stattleship/models.rb

@@ -13,6 +13,10 @@ require 'stattleship/models/team_outcome_streak'
 require 'stattleship/models/venue'
 require 'stattleship/models/ranking'
 
+require 'stattleship/models/at_bat'
+require 'stattleship/models/line_up'
+require 'stattleship/models/pitch'
+
 module Stattleship
   module Models
   end

data/lib/stattleship/models/at_bat.rb

@@ -0,0 +1,51 @@
+module Stattleship
+  module Models
+    class AtBat < OpenStruct
+      def to_sentence
+        description
+      end
+
+      def dump
+        {
+          id: id,
+          description: description,
+          inning: inning,
+          inning_label: inning_label,
+          half: half,
+          baseball_pitch_ids: baseball_pitch_ids,
+        }
+      end
+    end
+
+    module AtBatRepresenter
+      include Roar::JSON
+      include Roar::Coercion
+      include Virtus.model
+
+      [
+        :id,
+        :description,
+        :inning_label,
+        :half,
+      ].each do |attribute|
+        property attribute
+      end
+
+      [
+        :inning,
+      ].each do |attribute|
+        property attribute, type: Integer
+      end
+
+      [
+        :game_id,
+        :hitter_id,
+        :hitter_team_id,
+      ].each do |relationship|
+        property relationship
+      end
+
+      collection :baseball_pitch_ids
+    end
+  end
+end