mlb_terminal 0.0.2 → 0.0.3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mlb_terminal (0.0.1)
+    mlb_terminal (0.0.2)
       activesupport (~> 3.2.8)
       commander (~> 4.1.2)
       nokogiri (~> 1.5.5)

data/README.md

@@ -9,22 +9,23 @@ Don't you just wish you could have a little terminal app to stream out real-time
 ### Syntax
 
 #### Commands
-        
-* help: Display global or [command] help documentation.                
-* list: Print out a list of scheduled games for the specified date   
+
+* help: Display global or [command] help documentation.
+* games: Print out a list of scheduled games for the specified date
+* game: Print out play-by-play events for a specific game. Use `--pitches` to output realtime pitch trajectory data.
 
 #### Global options
-        
+
 * -h, --help: Display help documentation
-        
+
 * -v, --version: Display version information
-        
+
 * -t, --trace: Display backtrace when an error occurs
 
 ### Examples
 
     > # List todays games
-    > mlb list
+    > mlb games
     0   Red Sox (69-88) @ Orioles (90-67)      7:05 ET (F)   1-9
     1   Reds (95-62) @ Pirates (76-81)         7:05 ET (F)   1-0
     2   Royals (70-87) @ Indians (66-91)       7:05 ET (F)   5-8
@@ -41,6 +42,33 @@ Don't you just wish you could have a little terminal app to stream out real-time
     13  Giants (92-65) @ Padres (74-83)        10:05 ET (F)  3-1
     14  Rockies (62-95) @ Dodgers (82-75)      10:10 ET (F)  0-8
 
-    # How did the Nationals do on May 30th of this year?
-    > mlb list --date 2012-05-30 | grep -i nationals | cut -f 2,4
-    Nationals (29-21) @ Marlins (29-22)     3-5
+    # How did the Nationals do on 5/30/2012?
+    > mlb games --date 2012-05-30 | grep -i nationals | cut -f 2,4
+    Nationals (29-21) @ Marlins (29-22) 3-5
+
+    > # How did Bryce Harper do tonight?
+    > mlb games | grep Nationals | cut -f 1 | xargs mlb game | grep Harper
+    2012-09-29 19:18:00  1  2   1/2/1  Bryce Harper singles on a soft line drive to center fielder Jon Jay.
+    2012-09-29 19:20:11  1  3   1/2/1  Ryan Zimmerman doubles (36) on a fly ball to left fielder Matt Holliday.   Bryce Harper to 3rd.
+    2012-09-29 19:26:56  1  5   0/0/1  Play reviewed and overturned: Michael Morse hits a grand slam (17) to right field.   Bryce Harper scores.    Ryan Zimmerman scores.    Adam LaRoche scores.
+    2012-09-29 19:48:35  2  14  3/2/3  Bryce Harper grounds out, second baseman Skip Schumaker to first baseman Allen Craig.
+    2012-09-29 19:56:08  2  17  3/2/2  Carlos Beltran lines out to center fielder Bryce Harper.
+    2012-09-29 20:09:19  3  23  3/2/1  Pete Kozma flies out to center fielder Bryce Harper.
+    2012-09-29 20:38:38  5  36  3/3/1  Bryce Harper called out on strikes.
+    2012-09-29 21:15:16  7  51  2/2/1  Bryce Harper singles on a line drive to left fielder Matt Holliday.
+    2012-09-29 21:19:08  7  53  1/1/2  Adam LaRoche singles on a sharp line drive to first baseman Allen Craig.   Bryce Harper to 3rd.
+    2012-09-29 21:24:34  7  55  0/1/1  Yadier Molina flies out to center fielder Bryce Harper.
+    2012-09-29 21:37:46  7  61  1/2/2  Matt Carpenter flies out to center fielder Bryce Harper.
+    2012-09-29 22:10:49  9  71  1/0/2  Bryce Harper doubles (25) on a line drive to left fielder Matt Holliday.
+    2012-09-29 22:21:20  9  76  0/0/2  Jon Jay out on a sacrifice fly to center fielder Bryce Harper.   Pete Kozma scores.
+
+    > # Visualize pitch speed for Gio Gonzalez on his full game on August 8, 2012.
+    > mlb games --date 2012-08-08                              \
+        | grep Nationals                                       \
+        | cut -f 1                                             \
+        | xargs mlb game --pitches --date 2012-08-08           \
+        | awk 'BEGIN{FS="\t"}{ if ($4=="Gio Gonzalez") print}' \
+        | cut -f 1,9,6                                         \
+        | Rscript -e 'library(ggplot2); library(scales); d <- read.csv("stdin", header=F, sep="\\t", col.names=c("time", "type", "pitch_speed")); png("gio-pitch-speed.png"); ggplot(d, aes(x=as.POSIXct(time), y=pitch_speed, colour=type, shape=type)) + geom_point() + opts(title="Pitch Speed Over Time for Gio Gonzalez") + scale_x_datetime(breaks=date_breaks("1 hour"), minor_breaks=date_breaks("15 min"), labels=date_format("%H:%M")) + scale_colour_discrete(name = "Pitch Type") + scale_shape_discrete(name = "Pitch Type") + xlab("Time") + ylab("Pitch Speed"); dev.off()'
+    > open gio-pitch-speed.png
+![gio-pitch-speed.png](http://i.imgur.com/WFw3J.png)

data/bin/mlb

@@ -17,7 +17,7 @@ command :games do |c|
   c.option '--date STRING', String, 'List games for specified dates (Default: today)'
   c.action do |args, options|
     options.default :date => Time.now.to_date.to_s
-    MLBTerminal::Client.list_games(Date.parse options.date).each_with_index do |game, index|
+    MLBTerminal::Game.list(Date.parse options.date).each_with_index do |game, index|
       puts [
         index,
         "#{game[:away_team][:name]} " \
@@ -36,6 +36,7 @@ command :game do |c|
   c.description = 'Print play-by-play action for the corresponding game. Columns: time, inning, balls/strikes/outs/description.'
   c.example 'description', 'command example'
   c.option '--date STRING', String, 'Specify the date for the corresponding game number.'
+  c.option '--pitches', 'Print pitch-by-pitch action'
   c.action do |args, options|
     options.default :date => Time.now.to_date.to_s
 
@@ -47,23 +48,68 @@ command :game do |c|
     end
     
     game_number = args.first.to_i
-    game_info = MLBTerminal::Client.list_games(date)[game_number]
+    game_info = MLBTerminal::Game.list(date)[game_number]
 
     if game_info.nil?
       puts "Error: Game does not exist"
       break
     end
     
-    game = MLBTerminal::Client.new(game_info[:game_id])
+    game = MLBTerminal::Game.new(game_info[:game_id])
 
-    game.events.each do |event|
-      puts [
-        event[:time].getlocal.strftime("%Y-%m-%d %H:%M:%S"),
-        event[:inning],
-        event[:num],
-        "#{event[:balls]}/#{event[:strikes]}/#{event[:outs]}",
-        event[:desc]].join("\t")
+    begin
+      if options.pitches
+        game.pitches.each do |pitch|
+          puts [
+            pitch[:time].getlocal.strftime("%Y-%m-%d %H:%M:%S"),
+            pitch[:inning],
+            pitch[:inning_loc],
+            pitch[:pitcher],
+            pitch[:batter],
+            pitch[:type],
+            pitch[:x],
+            pitch[:y],
+            pitch[:start_speed],
+            pitch[:end_speed],
+            pitch[:sz_top],
+            pitch[:sz_bot],
+            pitch[:pfx_x],
+            pitch[:pfx_z],
+            pitch[:px],
+            pitch[:pz],
+            pitch[:x0],
+            pitch[:y0],
+            pitch[:z0],
+            pitch[:vx0],
+            pitch[:vy0],
+            pitch[:vz0],
+            pitch[:ax],
+            pitch[:ay],
+            pitch[:az],
+            pitch[:break_y],
+            pitch[:break_angle],
+            pitch[:break_length],
+            pitch[:pitch_type],
+            pitch[:type_confidence],
+            pitch[:zone],
+            pitch[:nasty],
+            pitch[:spin_dir],
+            pitch[:spin_rate],
+            pitch[:cc],
+            pitch[:mt]].join("\t")
+        end
+      else
+        game.events.each do |event|
+          puts [
+            event[:time].getlocal.strftime("%Y-%m-%d %H:%M:%S"),
+            event[:inning],
+            event[:num],
+            "#{event[:balls]}/#{event[:strikes]}/#{event[:outs]}",
+            event[:desc]].join("\t")
+        end
+      end
+    rescue SystemExit, Interrupt
+      # Do nothing if a user issues ctrl-c.
     end
   end
 end
-

data/lib/mlb_terminal.rb

@@ -1,2 +1,2 @@
 require 'mlb_terminal/version'
-require 'mlb_terminal/client'
+require 'mlb_terminal/game'

data/lib/mlb_terminal/game.rb

@@ -0,0 +1,153 @@
+require 'date'
+require 'nokogiri'
+require 'open-uri'
+require 'active_support/core_ext/integer/inflections'
+
+module MLBTerminal
+  MLB_BASE_URL = 'http://gd2.mlb.com/components/game/mlb'
+
+  class Game
+    def self.list(date = Time.now.to_date)
+      doc = Nokogiri::HTML(open "#{base_url_for_date date}/epg.xml")
+
+      doc.xpath("//epg/game").map{|game|
+        {:home_team => {
+           :name   => game["home_team_name"],
+           :wins   => game["home_win"],
+           :losses => game["home_loss"]},
+         :away_team => {
+           :name   => game["away_team_name"],
+           :wins   => game["away_win"],
+           :losses => game["away_loss"]},
+         :score => {
+           :home => game["home_team_runs"],
+           :away => game["away_team_runs"]},
+         :starts => "#{game["time"]} #{game["time_zone"]}",
+         :status => "#{game["status"]}" \
+           "#{game["status"] == "In Progress" ? 
+             ", #{game["top_inning"]=="Y" ? "Top" : "Bot"} of #{game["inning"].to_i.ordinalize}" :
+             ""}",
+         :game_id => game["gameday"]}}
+    end
+
+    def initialize(gameday)
+      @gameday = gameday
+      year, month, day, game_name = /([0-9]{4})_([0-9]{2})_([0-9]{2})_(.*)/.match(@gameday).to_a.slice(1,4)
+      @base_url = "#{Game.base_url_for_date(Date.new(year.to_i, month.to_i, day.to_i))}/gid_#{@gameday}"
+    end
+
+    def events(delay = 5, &block)
+      last_atbat = 0
+
+      Enumerator.new do |y|
+        begin
+          doc = Nokogiri::HTML(open "#{@base_url}/game_events.xml")
+          
+          doc.xpath("//game/inning[*/atbat/@num > #{last_atbat}]").each do |inning|
+            inning.xpath("*/atbat").each do |at_bat|
+              y.yield({
+                :inning => inning["num"],
+                :inning_loc => at_bat.xpath("..").first.name.camelcase,
+                :num => at_bat["num"],
+                :balls => at_bat["b"],
+                :strikes => at_bat["s"],
+                :outs => at_bat["o"],
+                :time => Time.parse(at_bat["start_tfs_zulu"], "%Y-%m-%dT%H:%M:%SZ"),
+                :desc => at_bat["des"].strip})
+            end
+          end
+
+          last_atbat = doc.xpath("//game/inning/*/atbat/@num").map(&:value).map(&:to_i).max
+
+          sleep delay
+
+          if doc.xpath("//game").first["ind"] != "F"
+            doc = Nokogiri::HTML(open "#{@base_url}/inning/inning_all.xml")
+          end
+        end while game_status != "F"
+      end.each(&block)
+    end
+
+    def pitches(delay = 5, &block)
+      last_pitch = 0
+      players = player_lookup
+      doc = Nokogiri::HTML(open "#{@base_url}/inning/inning_all.xml")
+
+      Enumerator.new do |y|
+        begin
+          doc.xpath("//game/inning[*/*/pitch/@id > #{last_pitch}]").each do |inning|
+
+            inning.xpath("*/atbat").each do |at_bat|
+              pitcher = players[at_bat["pitcher"]]
+              batter = players[at_bat["batter"]]
+
+              at_bat.xpath("pitch").each do |pitch|
+                y.yield({
+                 :time => Time.parse(pitch["tfs_zulu"], "%Y-%m-%dT%H:%M:%SZ"),
+                 :inning => inning["num"],
+                 :inning_loc => at_bat.xpath("..").first.name.camelcase,
+                 :pitcher => pitcher,
+                 :batter => batter,
+                 :type => pitch["type"],
+                 :x => pitch["x"],
+                 :y => pitch["y"],
+                 :start_speed => pitch["start_speed"],
+                 :end_speed => pitch["end_speed"],
+                 :sz_top => pitch["sz_top"],
+                 :sz_bot => pitch["sz_bot"],
+                 :pfx_x => pitch["pfx_x"],
+                 :pfx_z => pitch["pfx_z"],
+                 :px => pitch["px"],
+                 :pz => pitch["pz"],
+                 :x0 => pitch["x0"],
+                 :y0 => pitch["y0"],
+                 :z0 => pitch["z0"],
+                 :vx0 => pitch["vx0"],
+                 :vy0 => pitch["vy0"],
+                 :vz0 => pitch["vz0"],
+                 :ax => pitch["ax"],
+                 :ay => pitch["ay"],
+                 :az => pitch["az"],
+                 :break_y => pitch["break_y"],
+                 :break_angle => pitch["break_angle"],
+                 :break_length => pitch["break_length"],
+                 :pitch_type => pitch["pitch_type"],
+                 :type_confidence => pitch["type_confidence"],
+                 :zone => pitch["zone"],
+                 :nasty => pitch["nasty"],
+                 :spin_dir => pitch["spin_dir"],
+                 :spin_rate => pitch["spin_rate"],
+                 :cc => pitch["cc"],
+                 :mt => pitch["mt"]})
+              end
+            end
+          end
+
+          last_pitch = doc.xpath("//game/inning/*/*/pitch/@id").map(&:value).map(&:to_i).max
+
+          sleep delay
+
+          if doc.xpath("//game").first["ind"] != "F"
+            doc = Nokogiri::HTML(open "#{@base_url}/inning/inning_all.xml")
+          end
+        end while game_status != "F"
+      end.each(&block)
+    end
+
+    def self.base_url_for_date(date = Time.now.to_date)
+      "#{MLB_BASE_URL}/year_#{date.year}/month_#{"%02d" % date.month}/day_#{"%02d" % date.day}"
+    end
+
+    private
+
+    def player_lookup
+      doc = Nokogiri::HTML(open( "#{@base_url}/players.xml"))
+      Hash[doc.xpath("//game/team/player").map{|x| [x["id"], "#{x["first"]} #{x["last"]}"]}]
+    end
+
+    def game_status
+      doc = Nokogiri::HTML(open( "#{@base_url}/linescore.xml"))
+      doc.xpath("//game").first["ind"]
+    end
+  end
+end

data/lib/mlb_terminal/version.rb

@@ -1,3 +1,3 @@
 module MLBTerminal
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/mlb_terminal.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |s|
   s.authors     = ["Stefan Novak"]
   s.email       = ["stefan.louis.novak@gmail.com"]
   s.homepage    = "https://github.com/slnovak/mlb_terminal"
-  s.description = %q{A small terminal app to translate MLB baseball feeds into the terminal for easy manipulation.} 
-  s.summary     = %q{Command line interface to keeping track of MLB ballgames}
+  s.description = %q{A small terminal app to pipe formatted MLB baseball feeds into the terminal for easy manipulation. Includes access to both historic and real-time baseball feeds including play-by-play and pitch-by-pitch data. Visit the homepage for examples!} 
+  s.summary     = %q{A small terminal app for accessing historic and realtime MLB game data}
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mlb_terminal
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -59,8 +59,9 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 3.2.8
-description: A small terminal app to translate MLB baseball feeds into the terminal
-  for easy manipulation.
+description: A small terminal app to pipe formatted MLB baseball feeds into the terminal
+  for easy manipulation. Includes access to both historic and real-time baseball feeds
+  including play-by-play and pitch-by-pitch data. Visit the homepage for examples!
 email:
 - stefan.louis.novak@gmail.com
 executables:
@@ -75,7 +76,7 @@ files:
 - Rakefile
 - bin/mlb
 - lib/mlb_terminal.rb
-- lib/mlb_terminal/client.rb
+- lib/mlb_terminal/game.rb
 - lib/mlb_terminal/version.rb
 - mlb_terminal.gemspec
 homepage: https://github.com/slnovak/mlb_terminal
@@ -101,5 +102,5 @@ rubyforge_project:
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Command line interface to keeping track of MLB ballgames
+summary: A small terminal app for accessing historic and realtime MLB game data
 test_files: []

data/lib/mlb_terminal/client.rb

@@ -1,85 +0,0 @@
-require 'date'
-require 'nokogiri'
-require 'open-uri'
-require 'active_support/core_ext/integer/inflections'
-
-module MLBTerminal
-  MLB_BASE_URL = 'http://gd2.mlb.com/components/game/mlb'
-
-  class Client
-    def self.list_games(date = Time.now.to_date)
-      doc = Nokogiri::HTML(open "#{base_url_for_date date}/epg.xml")
-      doc.xpath("//epg/game").map{|game|
-        {:home_team => {
-            :name   => game["home_team_name"],
-            :wins   => game["home_win"],
-            :losses => game["home_loss"]},
-         :away_team => {
-            :name   => game["away_team_name"],
-            :wins   => game["away_win"],
-            :losses => game["away_loss"]},
-         :score => {
-          :home => game["home_team_runs"],
-          :away => game["away_team_runs"]},
-         :starts => "#{game["time"]} #{game["time_zone"]}",
-         :status => "#{game["status"]}" \
-           "#{game["status"] == "In Progress" ? 
-             ", #{game["top_inning"]=="Y" ? "Top" : "Bot"} of #{game["inning"].to_i.ordinalize}" :
-             ""}",
-         :game_id => game["gameday"]}}
-    end
-
-    def initialize(gameday)
-      @gameday = gameday
-      year, month, day, game_name = /([0-9]{4})_([0-9]{2})_([0-9]{2})_(.*)/.match(@gameday).to_a.slice(1,4)
-      @base_url = "#{Client.base_url_for_date(Date.new(year.to_i, month.to_i, day.to_i))}/gid_#{@gameday}"
-    end
-
-    def events(start_inning = 1, end_inning = 9, delay = 5, &block)
-      current_inning = start_inning
-      current_inning_loc= "top"
-
-      innings = ["top", "bottom"]
-
-      Enumerator.new do |y|
-        while current_inning <= end_inning and not current_inning_loc.nil?
-          doc = Nokogiri::HTML(open "#{@base_url}/game_events.xml")
-          
-          doc.xpath("//game/inning[@num >= #{current_inning}]").each do |inning|
-
-            current_inning_loc ||= "top"
-
-            innings.slice(innings.index(current_inning_loc), 2).each do |inning_loc|
-              if inning.xpath(inning_loc).nil?
-                break
-              else
-                inning.xpath("#{inning_loc}/atbat").each do |atbat|
-                  y.yield({:inning => current_inning,
-                   :num => atbat["num"],
-                   :balls => atbat["b"],
-                   :strikes => atbat["s"],
-                   :outs => atbat["o"],
-                   :time => Time.parse(atbat["start_tfs_zulu"], "%Y-%m-%dT%H:%M:%SZ"),
-                   :desc => atbat["des"]})
-                end
-                         
-                current_inning_loc = innings[innings.index(current_inning_loc) + 1]
-              end
-            end
-            current_inning += 1
-          end
-
-          # If we had to break early, wait before trying again.
-          if current_inning != end_inning and not current_inning_loc.nil?
-            sleep delay
-          end
-
-        end
-      end.each(&block)
-    end
-
-    def self.base_url_for_date(date = Time.now.to_date)
-      "#{MLB_BASE_URL}/year_#{date.year}/month_#{"%02d" % date.month}/day_#{"%02d" % date.day}"
-    end
-  end
-end