strava-ruby-client 0.1.0

data/RELEASING.md

@@ -0,0 +1,61 @@
+# Releasing Strava-Ruby-Client
+
+There're no hard rules about when to release strava-ruby-client. Release bug fixes frequently, features not so frequently and breaking API changes rarely.
+
+### Release
+
+Run tests, check that all tests succeed locally.
+
+```
+bundle install
+rake
+```
+
+Check that the last build succeeded in [Travis CI](https://travis-ci.org/dblock/strava-ruby-client) for all supported platforms.
+
+Change "Next" in [CHANGELOG.md](CHANGELOG.md) to the current date.
+
+```
+### 0.2.2 (7/10/2015)
+```
+
+Remove the line with "Your contribution here.", since there will be no more contributions to this release.
+
+Commit your changes.
+
+```
+git add CHANGELOG.md
+git commit -m "Preparing for release, 0.2.2."
+git push origin master
+```
+
+Release.
+
+```
+$ rake release
+
+strava-ruby-client 0.2.2 built to pkg/strava-ruby-client-0.2.2.gem.
+Tagged v0.2.2.
+Pushed git commits and tags.
+Pushed strava-ruby-client 0.2.2 to rubygems.org.
+```
+
+### Prepare for the Next Version
+
+Add the next release to [CHANGELOG.md](CHANGELOG.md).
+
+```
+### 0.2.3 (Next)
+
+* Your contribution here.
+```
+
+Increment the third version number in [lib/strava/version.rb](lib/strava/version.rb).
+
+Commit your changes.
+
+```
+git add CHANGELOG.md lib/strava/version.rb
+git commit -m "Preparing for next development iteration, 0.2.3."
+git push origin master
+```

data/Rakefile

@@ -0,0 +1,17 @@
+require 'rubygems'
+require 'bundler'
+require 'bundler/gem_tasks'
+
+Bundler.setup :default, :development
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new
+
+task default: %i[rubocop spec]

data/bin/oauth-token.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+
+require 'dotenv/load'
+require 'strava-ruby-client'
+
+client = Strava::OAuth::Client.new(
+  client_id: ENV['STRAVA_CLIENT_ID'],
+  client_secret: ENV['STRAVA_CLIENT_SECRET']
+)
+
+redirect_url = client.authorize_url(
+  redirect_uri: 'http://localhost',
+  response_type: 'code',
+  scope: 'activity:read'
+)
+
+STDOUT.write "Opening browser at #{redirect_url}\n"
+system 'open', redirect_url
+
+STDOUT.write 'Copy paste the code from the redirect URL: '
+code = gets.strip
+
+response = client.oauth_token(code: code)
+
+puts "token_type: #{response.token_type}"
+puts "refresh_token: #{response.refresh_token}"
+puts "access_token: #{response.access_token}"
+puts "expires_at: #{response.expires_at}"

data/lib/strava-ruby-client.rb

@@ -0,0 +1,30 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'json'
+require 'logger'
+require 'hashie'
+require 'active_support/core_ext/object/to_query'
+require 'time'
+
+require_relative 'strava/version'
+require_relative 'strava/logger'
+
+require_relative 'strava/errors/fault'
+
+require_relative 'strava/models/model'
+require_relative 'strava/models/token'
+require_relative 'strava/models/athlete'
+require_relative 'strava/models/map'
+require_relative 'strava/models/activity'
+
+require_relative 'strava/web/raise_error'
+require_relative 'strava/web/connection'
+require_relative 'strava/web/request'
+require_relative 'strava/web/config'
+require_relative 'strava/web/client'
+
+require_relative 'strava/oauth/config'
+require_relative 'strava/oauth/client'
+
+require_relative 'strava/api/config'
+require_relative 'strava/api/client'

data/lib/strava/api/client.rb

@@ -0,0 +1,38 @@
+module Strava
+  module Api
+    class Client < Strava::Web::Client
+      attr_accessor(*Config::ATTRIBUTES)
+
+      def initialize(options = {})
+        Config::ATTRIBUTES.each do |key|
+          send("#{key}=", options[key] || Strava::Api.config.send(key))
+        end
+        super
+      end
+
+      def headers
+        { 'Authorization' => "Bearer #{access_token}" }
+      end
+
+      def athlete
+        Strava::Models::Athlete.new(get('athlete'))
+      end
+
+      def athlete_activities(options = {})
+        get('athlete/activities', options).map do |activity|
+          Strava::Models::Activity.new(activity)
+        end
+      end
+
+      class << self
+        def configure
+          block_given? ? yield(Config) : Config
+        end
+
+        def config
+          Config
+        end
+      end
+    end
+  end
+end

data/lib/strava/api/config.rb

@@ -0,0 +1,31 @@
+module Strava
+  module Api
+    module Config
+      extend self
+
+      ATTRIBUTES = %i[
+        endpoint
+        access_token
+      ].freeze
+
+      attr_accessor(*Config::ATTRIBUTES)
+
+      def reset
+        self.endpoint = 'https://www.strava.com/api/v3'
+        self.access_token = nil
+      end
+    end
+
+    class << self
+      def configure
+        block_given? ? yield(Config) : Config
+      end
+
+      def config
+        Config
+      end
+    end
+  end
+end
+
+Strava::Api::Config.reset

data/lib/strava/errors/fault.rb

@@ -0,0 +1,13 @@
+module Strava
+  module Errors
+    class Fault < ::Faraday::ClientError
+      def message
+        response[:body]['message'] || super
+      end
+
+      def errors
+        response[:body]['errors']
+      end
+    end
+  end
+end

data/lib/strava/logger.rb

@@ -0,0 +1,13 @@
+require 'logger'
+
+module Strava
+  class Logger < ::Logger
+    def self.default
+      @logger ||= begin
+        logger = new STDOUT
+        logger.level = Logger::WARN
+        logger
+      end
+    end
+  end
+end

data/lib/strava/models/activity.rb

@@ -0,0 +1,57 @@
+module Strava
+  module Models
+    class Activity < Model
+      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 'type'
+      property 'workout_type'
+      property 'id'
+      property 'external_id'
+      property 'upload_id'
+      property 'start_date', transform_with: ->(v) { Time.parse(v) }
+      property 'start_date_local', transform_with: ->(v) { Time.parse(v) }
+      property 'timezone'
+      property 'utc_offset'
+      property 'start_latlng'
+      property 'end_latlng'
+      property 'location_city'
+      property 'location_state'
+      property 'location_country'
+      property 'start_latitude'
+      property 'start_longitude'
+      property 'achievement_count'
+      property 'kudos_count'
+      property 'comment_count'
+      property 'athlete_count'
+      property 'photo_count'
+      property 'map', transform_with: ->(v) { Strava::Models::Map.new(v) }
+      property 'trainer'
+      property 'commute'
+      property 'manual'
+      property 'private'
+      property 'visibility'
+      property 'flagged'
+      property 'gear_id'
+      property 'from_accepted_tag'
+      property 'average_speed'
+      property 'max_speed'
+      property 'has_heartrate'
+      property 'average_heartrate'
+      property 'max_heartrate'
+      property 'heartrate_opt_out'
+      property 'display_hide_heartrate_option'
+      property 'elev_high'
+      property 'elev_low'
+      property 'pr_count'
+      property 'total_photo_count'
+      property 'has_kudoed'
+      property 'suffer_score'
+    end
+  end
+end

data/lib/strava/models/athlete.rb

@@ -0,0 +1,25 @@
+module Strava
+  module Models
+    class Athlete < Model
+      property 'id'
+      property 'username'
+      property 'resource_state'
+      property 'firstname'
+      property 'lastname'
+      property 'city'
+      property 'state'
+      property 'country'
+      property 'sex'
+      property 'premium'
+      property 'created_at', transform_with: ->(v) { Time.parse(v) }
+      property 'updated_at', transform_with: ->(v) { Time.parse(v) }
+      property 'badge_type_id'
+      property 'profile'
+      property 'profile_medium'
+      property 'email'
+      property 'follower'
+      property 'friend'
+      property 'summit'
+    end
+  end
+end

data/lib/strava/models/map.rb

@@ -0,0 +1,9 @@
+module Strava
+  module Models
+    class Map < Model
+      property 'id'
+      property 'summary_polyline'
+      property 'resource_state'
+    end
+  end
+end

data/lib/strava/models/model.rb

@@ -0,0 +1,5 @@
+module Strava
+  class Model < Hashie::Trash
+    include Hashie::Extensions::IgnoreUndeclared
+  end
+end

data/lib/strava/models/token.rb

@@ -0,0 +1,12 @@
+module Strava
+  module Models
+    class Token < Model
+      property 'token_type'
+      property 'access_token'
+      property 'refresh_token'
+      property 'expires_in'
+      property 'expires_at', transform_with: ->(v) { Time.at(v) }
+      property 'athlete', transform_with: ->(v) { Strava::Models::Athlete.new(v) }
+    end
+  end
+end

data/lib/strava/oauth/client.rb

@@ -0,0 +1,70 @@
+module Strava
+  module OAuth
+    class Client < Strava::Web::Client
+      attr_accessor(*Config::ATTRIBUTES)
+
+      def initialize(options = {})
+        Strava::OAuth::Config::ATTRIBUTES.each do |key|
+          send("#{key}=", options[key] || Strava::OAuth.config.send(key))
+        end
+        super
+      end
+
+      #
+      # Obtain the request access URL.
+      #
+      # @option options [Object] :redirect_uri
+      #   URL to which the user will be redirected after authentication.
+      # @option options [Object] :response_type
+      #   Must be code.
+      # @option options [Object] :approval_prompt
+      #   Prompt behavior, force or auto.
+      # @option options [Object] :scope
+      #   Requested scopes, as a comma delimited string.
+      # @option options [Object] :state
+      #   Returned in the redirect URI.
+      # @see https://developers.strava.com/docs/authentication/
+      # @return [String] URL to redirect the user to.
+      def authorize_url(options = {})
+        query = options.merge(
+          client_id: client_id || raise(ArgumentError, 'Missing Strava client id.'),
+          response_type: options[:response_type] || 'code',
+          redirect_uri: options[:redirect_uri] || 'http://localhost',
+          approval_prompt: options[:approval_prompt] || 'auto',
+          scope: options[:scope] || 'read'
+        )
+
+        [endpoint, "authorize?#{query.to_query}"].join('/')
+      end
+
+      #
+      # Complete the authentication process.
+      #
+      # @option options [Object] :code
+      #   The code parameter obtained in the redirect.
+      # @option options [Object] :grant_type
+      #   The grant type for the request.
+      # @see https://developers.strava.com/docs/authentication/
+      # @return [Hash] Token information.
+      def oauth_token(options = {})
+        query = options.merge(
+          client_id: client_id || raise(ArgumentError, 'Missing Strava client id.'),
+          client_secret: client_secret || raise(ArgumentError, 'Missing Strava client secret.'),
+          grant_type: options[:grant_type] || 'authorization_code'
+        )
+
+        Strava::Models::Token.new(post('token', query))
+      end
+
+      class << self
+        def configure
+          block_given? ? yield(Config) : Config
+        end
+
+        def config
+          Config
+        end
+      end
+    end
+  end
+end

data/lib/strava/oauth/config.rb

@@ -0,0 +1,33 @@
+module Strava
+  module OAuth
+    module Config
+      extend self
+
+      ATTRIBUTES = %i[
+        endpoint
+        client_id
+        client_secret
+      ].freeze
+
+      attr_accessor(*Config::ATTRIBUTES)
+
+      def reset
+        self.endpoint = 'https://www.strava.com/oauth'
+        self.client_id = nil
+        self.client_secret = nil
+      end
+    end
+
+    class << self
+      def configure
+        block_given? ? yield(Config) : Config
+      end
+
+      def config
+        Config
+      end
+    end
+  end
+end
+
+Strava::OAuth::Config.reset