strava-ruby-client 0.1.0 → 0.2.0

data/lib/strava/api/cursor.rb

@@ -0,0 +1,29 @@
+module Strava
+  module Api
+    class Cursor
+      include Enumerable
+
+      attr_reader :client
+      attr_reader :path
+      attr_reader :params
+
+      def initialize(client, path, params = {})
+        @client = client
+        @path = path
+        @params = params
+      end
+
+      def each
+        next_page = 1
+        loop do
+          query = params.merge(page: next_page)
+          response = client.get(path, query)
+          break unless response.any?
+
+          yield response
+          next_page += 1
+        end
+      end
+    end
+  end
+end

data/lib/strava/models/activity.rb

@@ -1,14 +1,15 @@
 module Strava
   module Models
     class Activity < Model
+      include Mixins::Distance
+      include Mixins::Time
+      include Mixins::Elevation
+
       property 'id'
       property 'resource_state'
       property 'athlete', transform_with: ->(v) { Strava::Models::Athlete.new(v) }
       property 'name'
-      property 'distance'
-      property 'moving_time'
-      property 'elapsed_time'
-      property 'total_elevation_gain'
+      property 'description'
       property 'type'
       property 'workout_type'
       property 'id'
@@ -52,6 +53,91 @@ module Strava
       property 'total_photo_count'
       property 'has_kudoed'
       property 'suffer_score'
+      property 'calories'
+      property 'segment_efforts', transform_with: ->(v) { v.map { |r| Strava::Models::SegmentEffort.new(r) } }
+      property 'best_efforts', transform_with: ->(v) { v.map { |r| Strava::Models::SegmentEffort.new(r) } }
+      property 'photos', transform_with: ->(v) { Strava::Models::Photos.new(v) }
+      property 'similar_activities', transform_with: ->(v) { Strava::Models::SimilarActivities.new(v) }
+      property 'embed_token'
+      property 'available_zones'
+      property 'splits_metric', transform_with: ->(v) { v.map { |r| Strava::Models::Split::Metric.new(r) } }
+      property 'splits_standard', transform_with: ->(v) { v.map { |r| Strava::Models::Split::Standard.new(r) } }
+      property 'laps', transform_with: ->(v) { v.map { |r| Strava::Models::Lap.new(r) } }
+      property 'gear', transform_with: ->(v) { Strava::Models::Gear.new(v) }
+      property 'device_name'
+
+      def units
+        :metric
+      end
+
+      def distance_s
+        if type == 'Swim'
+          case units
+          when :metric then distance_in_meters_s
+          when :imperial then distance_in_yards_s
+          end
+        else
+          case units
+          when :metric then distance_in_kilometers_s
+          when :imperial then distance_in_miles_s
+          end
+        end
+      end
+
+      def pace_s
+        case type
+        when 'Swim'
+          case units
+          when :metric then pace_per_100_meters_s
+          when :imperial then pace_per_100_yards_s
+          end
+        else
+          case units
+          when :metric then pace_per_kilometer_s
+          when :imperial then pace_per_mile_s
+          end
+        end
+      end
+
+      def strava_url
+        "https://www.strava.com/activities/#{id}"
+      end
+
+      def type_emoji
+        case type
+        when 'Run' then '🏃'
+        when 'Ride' then '🚴'
+        when 'Swim' then '🏊'
+        when 'Walk' then '🚶'
+        when 'AlpineSki' then '⛷️'
+        when 'BackcountrySki' then '🎿️'
+        # when 'Canoeing' then ''
+        # when 'Crossfit' then ''
+        when 'EBikeRide' then '🚴'
+        # when 'Elliptical' then ''
+        # when 'Hike' then ''
+        when 'IceSkate' then '⛸️'
+        # when 'InlineSkate' then ''
+        # when 'Kayaking' then ''
+        # when 'Kitesurf' then ''
+        # when 'NordicSki' then ''
+        when 'RockClimbing' then '🧗'
+        when 'RollerSki' then ''
+        when 'Rowing' then '🚣'
+        when 'Snowboard' then '🏂'
+        # when 'Snowshoe' then ''
+        # when 'StairStepper' then ''
+        # when 'StandUpPaddling' then ''
+        when 'Surfing' then '🏄'
+        when 'VirtualRide' then '🚴'
+        when 'VirtualRun' then '🏃'
+        when 'WeightTraining' then '🏋️'
+        # when 'Windsurf' then ''
+        when 'Wheelchair' then '♿'
+          # when 'Workout' then ''
+          # when 'Yoga'' then ''
+        end
+      end
     end
   end
 end

data/lib/strava/models/activity_zone.rb

@@ -0,0 +1,13 @@
+module Strava
+  module Models
+    class ActivityZone < Model
+      property 'score'
+      property 'distribution_buckets', transform_with: ->(v) { v.map { |r| Strava::Models::TimedZoneRange.new(r) } }
+      property 'type'
+      property 'resource_state'
+      property 'sensor_based'
+      property 'points'
+      property 'custom_zones'
+    end
+  end
+end

data/lib/strava/models/athlete.rb

@@ -20,6 +20,14 @@ module Strava
       property 'follower'
       property 'friend'
       property 'summit'
+
+      def name
+        [firstname, lastname].compact.join(' ') if firstname || lastname
+      end
+
+      def strava_url
+        "https://www.strava.com/athletes/#{username || id}"
+      end
     end
   end
 end

data/lib/strava/models/club.rb

@@ -0,0 +1,26 @@
+module Strava
+  module Models
+    class Club < Model
+      property 'id'
+      property 'resource_state'
+      property 'name'
+      property 'profile_medium'
+      property 'profile'
+      property 'cover_photo'
+      property 'cover_photo_small'
+      property 'sport_type'
+      property 'city'
+      property 'state'
+      property 'country'
+      property 'private'
+      property 'member_count'
+      property 'featured'
+      property 'verified'
+      property 'url'
+
+      def strava_url
+        "https://www.strava.com/clubs/#{url || id}"
+      end
+    end
+  end
+end

data/lib/strava/models/comment.rb

@@ -0,0 +1,12 @@
+module Strava
+  module Models
+    class Comment < Model
+      property 'id'
+      property 'activity_id'
+      property 'resource_state'
+      property 'text'
+      property 'created_at', transform_with: ->(v) { Time.parse(v) }
+      property 'athlete', transform_with: ->(v) { Strava::Models::Athlete.new(v) }
+    end
+  end
+end

data/lib/strava/models/gear.rb

@@ -0,0 +1,11 @@
+module Strava
+  module Models
+    class Gear < Model
+      property 'id'
+      property 'resource_state'
+      property 'distance'
+      property 'name'
+      property 'primary'
+    end
+  end
+end

data/lib/strava/models/lap.rb

@@ -0,0 +1,26 @@
+module Strava
+  module Models
+    class Lap < Model
+      include Mixins::Time
+      include Mixins::Distance
+      include Mixins::Elevation
+
+      property 'id'
+      property 'resource_state'
+      property 'name'
+      property 'activity', transform_with: ->(v) { Strava::Models::Activity.new(v) }
+      property 'athlete', transform_with: ->(v) { Strava::Models::Athlete.new(v) }
+      property 'start_date', transform_with: ->(v) { Time.parse(v) }
+      property 'start_date_local', transform_with: ->(v) { Time.parse(v) }
+      property 'start_index'
+      property 'end_index'
+      property 'average_speed'
+      property 'max_speed'
+      property 'average_heartrate'
+      property 'max_heartrate'
+      property 'lap_index'
+      property 'split'
+      property 'pace_zone'
+    end
+  end
+end

data/lib/strava/models/map.rb

@@ -4,6 +4,7 @@ module Strava
       property 'id'
       property 'summary_polyline'
       property 'resource_state'
+      property 'polyline'
     end
   end
 end

data/lib/strava/models/mixins/distance.rb

@@ -0,0 +1,73 @@
+module Strava
+  module Models
+    module Mixins
+      module Distance
+        extend ActiveSupport::Concern
+
+        included do
+          property 'distance'
+        end
+
+        def distance_in_meters
+          case units
+          when :metric then distance
+          when :imperial then distance / 3.28084
+          end
+        end
+
+        def distance_in_feet
+          case units
+          when :metric then distance * 3.28084
+          when :imperial then distance
+          end
+        end
+
+        def distance_in_miles
+          case units
+          when :metric then distance_in_meters * 0.00062137
+          when :imperial then distance_in_feet / 5280
+          end
+        end
+
+        def distance_in_miles_s
+          return unless distance && distance.positive?
+
+          format('%gmi', format('%.2f', distance_in_miles))
+        end
+
+        def distance_in_yards
+          distance_in_meters * 1.09361
+        end
+
+        def distance_in_yards_s
+          return unless distance && distance.positive?
+
+          format('%gyd', format('%.1f', distance_in_yards))
+        end
+
+        def distance_in_meters_s
+          return unless distance && distance.positive?
+
+          format('%gm', format('%d', distance_in_meters))
+        end
+
+        def distance_in_kilometers
+          distance_in_meters / 1000
+        end
+
+        def distance_in_kilometers_s
+          return unless distance && distance.positive?
+
+          format('%gkm', format('%.2f', distance_in_kilometers))
+        end
+
+        def distance_s
+          case units
+          when :metric then distance_in_kilometers_s
+          when :imperial then distance_in_miles_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/strava/models/mixins/elevation.rb

@@ -0,0 +1,46 @@
+module Strava
+  module Models
+    module Mixins
+      module Elevation
+        extend ActiveSupport::Concern
+
+        included do
+          property 'total_elevation_gain'
+        end
+
+        def total_elevation_gain_in_feet
+          case units
+          when :metric then total_elevation_gain * 3.28084
+          when :imperial then total_elevation_gain
+          end
+        end
+
+        def total_elevation_gain_in_meters
+          case units
+          when :metric then total_elevation_gain
+          when :imperial then total_elevation_gain / 3.28084
+          end
+        end
+
+        def total_elevation_gain_in_meters_s
+          return unless total_elevation_gain && total_elevation_gain.positive?
+
+          format('%gm', format('%.1f', total_elevation_gain_in_meters))
+        end
+
+        def total_elevation_gain_in_feet_s
+          return unless total_elevation_gain && total_elevation_gain.positive?
+
+          format('%gft', format('%.1f', total_elevation_gain_in_feet))
+        end
+
+        def total_elevation_gain_s
+          case units
+          when :metric then total_elevation_gain_in_meters_s
+          when :imperial then total_elevation_gain_in_feet_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/strava/models/mixins/time.rb

@@ -0,0 +1,99 @@
+module Strava
+  module Models
+    module Mixins
+      module Time
+        extend ActiveSupport::Concern
+
+        included do
+          property 'moving_time'
+          property 'elapsed_time'
+          property 'average_speed'
+        end
+
+        # always in meters per second, even in imperial splits
+        def average_speed_meters_per_second
+          elapsed_time
+        end
+
+        def moving_time_in_hours_s
+          time_in_hours_s moving_time
+        end
+
+        def elapsed_time_in_hours_s
+          time_in_hours_s elapsed_time
+        end
+
+        def pace_per_mile_s
+          convert_meters_per_second_to_pace average_speed, :mi
+        end
+
+        def pace_per_100_yards_s
+          convert_meters_per_second_to_pace average_speed, :"100yd"
+        end
+
+        def pace_per_100_meters_s
+          convert_meters_per_second_to_pace average_speed, :"100m"
+        end
+
+        def pace_per_kilometer_s
+          convert_meters_per_second_to_pace average_speed, :km
+        end
+
+        def kilometer_per_hour_s
+          return unless average_speed && average_speed.positive?
+
+          format('%.1fkm/h', average_speed * 3.6)
+        end
+
+        def miles_per_hour_s
+          return unless average_speed && average_speed.positive?
+
+          format('%.1fmph', average_speed * 2.23694)
+        end
+
+        def speed_s
+          case units
+          when :metric then kilometer_per_hour_s
+          when :imperial then miles_per_hour_s
+          end
+        end
+
+        private
+
+        def time_in_hours_s(time)
+          return unless time
+
+          hours = time / 3600 % 24
+          minutes = time / 60 % 60
+          seconds = time % 60
+          [
+            hours.to_i.positive? ? format('%dh', hours) : nil,
+            minutes.to_i.positive? ? format('%dm', minutes) : nil,
+            seconds.to_i.positive? ? format('%ds', seconds) : nil
+          ].compact.join
+        end
+
+        # Convert speed (m/s) to pace (min/mile or min/km) in the format of 'x:xx'
+        # http://yizeng.me/2017/02/25/convert-speed-to-pace-programmatically-using-ruby
+        def convert_meters_per_second_to_pace(speed, unit = :mi)
+          return unless speed && speed.positive?
+
+          total_seconds = case unit
+                          when :mi then 1609.344 / speed
+                          when :km then 1000 / speed
+                          when :"100yd" then 91.44 / speed
+                          when :"100m" then 100 / speed
+                          end
+          minutes, seconds = total_seconds.divmod(60)
+          seconds = seconds.round
+          if seconds == 60
+            minutes += 1
+            seconds = 0
+          end
+          seconds = seconds < 10 ? "0#{seconds}" : seconds.to_s
+          "#{minutes}m#{seconds}s/#{unit}"
+        end
+      end
+    end
+  end
+end