garmin_connectr 0.0.4 → 0.0.5

data/README.rdoc

@@ -1,6 +1,6 @@
 = garmin_connectr
 
-GarminConnectr is a simple Ruby library for accessing data from Garmin Connect. As of 12/2009, Garmin's own Connect API has yet to be released.
+GarminConnectr is a simple Ruby library for accessing data from Garmin Connect. As of 12/2009, Garmin's own Connect API has yet to be released. Until then, this screen scraping lib does the job.
 
 Install:
 
@@ -22,6 +22,11 @@ Usage:
     puts "#{ activity.name } / #{ activity.start_time }"
   end
 
+  # Review activity split/lap data
+  activity.splits.each do |split|
+    puts "#{ split['split'] }: Distance: #{ split['distance'] }"
+  end
+
 See examples/*
 
 == Copyright

data/VERSION

@@ -1 +1 @@
-0.0.4
+0.0.5

data/examples/activity.rb

@@ -1,6 +1,6 @@
 require '../lib/garmin_connectr.rb'
 
-activity_id = 20733252
+activity_id = 21450277
 
 gc = GarminConnectr.new
 activity = gc.load( activity_id )
@@ -9,4 +9,9 @@ puts activity.name
 puts "  Activity : #{ activity.activity }"
 puts "  Distance : #{ activity.distance }"
 puts "  Start    : #{ activity.start_time }"
-puts "  Avg HR   : #{ activity.avg_hr }"
+puts "  Avg HR   : #{ activity.avg_hr }"
+puts "  Splits   : #{ activity.splits.count }"
+
+activity.splits.each do |split|
+  puts "\t#{ split['split'] } : Distance = #{ split['distance'] }"
+end

data/garmin_connectr.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{garmin_connectr}
-  s.version = "0.0.4"
+  s.version = "0.0.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["aroth"]
-  s.date = %q{2009-12-24}
+  s.date = %q{2010-01-01}
   s.description = %q{GarminConnectr is a simple Ruby library for accessing data from Garmin Connect.}
   s.email = %q{adamjroth@gmail.com}
   s.extra_rdoc_files = [

data/lib/garmin_connectr.rb

@@ -2,6 +2,7 @@ require 'rubygems'
 require 'nokogiri'
 require 'open-uri'
 require 'mechanize'
+require 'fastercsv'
 
 class GarminConnectr
   
@@ -55,7 +56,7 @@ class GarminConnectActivity
 
   attr_reader :activity_id, :loaded, :name, :url, :device, :start_time, :activity, :event, :time, :distance, :calories
   attr_reader :avg_speed, :max_speed, :avg_power, :max_power, :elevation_gain, :elevation_loss, :min_elevation, :max_elevation, :avg_hr, :max_hr, :avg_bike_cadence, :max_bike_cadence, :avg_temperature, :min_temperature, :max_temperature, :avg_pace, :best_pace
-
+  
   FIELDS = ['Avg Speed', 'Max Speed', 'Avg Power', 'Max Power', 'Elevation Gain', 'Elevation Loss', 'Min Elevation', 'Max Elevation', 'Avg HR', 'Max HR', 'Avg Bike Cadence', 'Max Bike Cadence', 'Avg Temperature', 'Min Temperature', 'Max Temperature', 'Avg Pace', 'Best Pace']
   
   def initialize( activity_id, name=nil )
@@ -63,6 +64,8 @@ class GarminConnectActivity
     @name = name unless name.nil?
     @loaded = false
     @fields = ['name', 'url', 'device', 'start_time']
+    @splits = []
+    @split_summary = {}
   end
   
   ## Fetch activity details. This will happen automatically if using GarminConnect#load. You will have
@@ -88,10 +91,59 @@ class GarminConnectActivity
       self.instance_variable_set("@#{ name }", self.send( :tab_data, field ) )
     end
 
+    # Splits - parse CSV
+    @doc = open("http://connect.garmin.com/csvExporter/#{ @activity_id }.csv")
+    @splits = []
+    @split_summary  = {}
+    
+    @keys = []
+    @csv = FasterCSV.parse( @doc.read )
+    @csv[0].each do |key|
+      @keys.push key.downcase.gsub(' ','_') if key.is_a?(String)
+    end
+    ## Data Rows
+    @csv[1, @csv.length - 2].each_with_index do |row, index|
+      split = {}
+      @keys.each_with_index do |key, key_index|
+        split[ key ] = row[ key_index ]
+      end
+      @splits << split
+    end
+    ## Summary Row
+    @keys.each_with_index do |key, key_index|
+      @split_summary[ key ] = @csv.last[ key_index ]
+    end
+    
     self
   end
 
-  private 
+  ## Returns an array of hashes detailing activity splits (laps). Attributes may include:
+  ##
+  ##  split
+  ##  time
+  ##  distance
+  ##  elevation_gain
+  ##  elevation_loss
+  ##  avg_speed
+  ##  max_speed
+  ##  avg_hr
+  ##  max_hr
+  ##  avg_bike_cadence
+  ##  max_bike_cadence
+  ##  calories
+  ##  avg_temp
+  ##  max_power
+  ##  avg_power
+  def splits
+    @splits
+  end
+  
+  ## Returns a hash of activity splits/laps summary. See splits rdoc for possible attributes.
+  def split_summary
+    @split_summary
+  end
+
+  private
   
   def tab_data( label )
     label += ":" unless label.match(/:$/)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: garmin_connectr
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors: 
 - aroth
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-24 00:00:00 -05:00
+date: 2010-01-01 00:00:00 -05:00
 default_executable: 
 dependencies: []