strava-ruby-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 795187f6ed3b261eda5e43a77d27c299772de0d877af93c523dfe5b302c7c476
+  data.tar.gz: 54880408a8294f2eee97ab2698452c79804b3da10cf6ad09f7b8b5905e3299ca
+SHA512:
+  metadata.gz: cdfcea1a6d0d98f0e9e4bbdc34964d33fab3beb9a5df5109180526b483a164e4beabca11d52e7f3305d6633d845460bf43320a7b870462e276ef745bb8c89df7
+  data.tar.gz: 7df4d3579bd3d1b8c7500bbd8b001077ea39de044bf027cb032ccfb4a339bd1852a6a1f13bfadff6e24e81a66fdd9bf88aab44a0d7b98cd0d3e5b2d679476a1c

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.1.0 (2019/1/11)
+
+* Initial public release - [@dblock](https://github.com/dblock).

data/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2019 Daniel Doubrovkine and Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,81 @@
+Strava Command-Line Client
+==========================
+
+[![Gem Version](https://badge.fury.io/rb/strava-ruby-cli.svg)](https://badge.fury.io/rb/strava-ruby-cli)
+[![Build Status](https://travis-ci.org/dblock/strava-ruby-cli.svg?branch=master)](https://travis-ci.org/dblock/strava-ruby-cli)
+
+A command-line client for Strava [Strava API v3](https://developers.strava.com).
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Authentication](#authentication)
+  - [Run Commands](#run-commands)
+  - [Strava Console](#strava-console)
+- [Contributing](#contributing)
+- [Copyright and License](#copyright-and-license)
+
+## Installation
+
+```
+gem install 'strava-ruby-cli'
+```
+
+## Usage
+
+### Authentication
+
+Strava commands require a Strava _Client ID_ and _Client Secret_ from [Your API Application](https://www.strava.com/settings/api). The command-line tool with prompt you for these or you can supply them with `--client_id` and `--client_secret` options. You can also adjust access scope with `--scope`.
+
+The client will fetch an access token. This will open a new browser window, navigate to Strava, request the appropriate permissions, then handle OAuth in a local redirect. The token type, refresh token, access token and token expiration will be displayed in the browser and subsequently used.
+
+You can note the access token and supply it via `--access_token` to avoid being prompted in the future.
+
+### Run Commands
+
+Use `strava run` to execute commands against the Strava API. Everything in [strava-ruby-client](https://github.com/dblock/strava-ruby-client) is supported.
+
+```bash
+$ strava run athlete.username
+
+dblockdotorg
+```
+
+Because this is Ruby, you can could fetch all currently logged-in athlete attributes in JSON.
+
+```bash
+$ strava run athlete.to_json
+
+{"id":26462176,"username":"dblockdotorg", ...}
+```
+
+To retrieve activities you need the `activity:read` scope.
+
+```bash
+$ strava --scope=activity:read run athlete_activities.first.name
+
+TCS NYC Marathon 2018
+```
+
+### Strava Console
+
+Use `strava console` to explore the Strava API interactively.
+
+```bash
+$ strava console
+
+Strava> athlete.name
+
+"Daniel Doubrovkine"
+```
+
+## Contributing
+
+See [CONTRIBUTING](CONTRIBUTING.md).
+
+## Copyright and License
+
+Copyright (c) 2019, [Daniel Doubrovkine](https://twitter.com/dblockdotorg) and [Contributors](CHANGELOG.md).
+
+This project is licensed under the [MIT License](LICENSE.md).

data/bin/strava

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+require 'gli'
+require 'ripl'
+
+require_relative '../lib/strava-ruby-cli'
+
+class App
+  extend GLI::App
+
+  program_desc "Command-line client for Strava #{Strava::VERSION}."
+  version Strava::Cli::VERSION
+
+  switch %i[v verbose], desc: 'Produce verbose output', default_value: false
+  flag %i[i client_id], desc: 'Strava client ID', default_value: ENV['STRAVA_CLIENT_ID']
+  flag %i[s client_secret], desc: 'Strava client secret', default_value: ENV['STRAVA_CLIENT_SECRET']
+  flag %i[t access_token], desc: 'Strava access token', default_value: ENV['STRAVA_ACCESS_TOKEN']
+  flag %i[p scope], desc: 'Strava access scope', default_value: ENV['STRAVA_ACCESS_SCOPE'] || 'read_all'
+
+  arguments :strict
+  subcommand_option_handling :normal
+
+  default_command :help
+
+  pre do |global_options, _command, options, _args|
+    options = global_options.dup
+    $auth = Strava::Cli::Auth.new(options)
+  end
+
+  desc 'Opens a Strava console'
+  command :console do |c|
+    c.action do |_global_options, _options, _args|
+      Strava::Cli::Console.new($auth.access_token).start!
+    end
+  end
+
+  desc 'Runs a command.'
+  arg_name 'command', :multiple
+  command :run do |c|
+    c.action do |_global_options, _options, args|
+      Strava::Cli::Console.new($auth.access_token).run(args)
+    end
+  end
+end
+
+exit App.run(ARGV)

data/lib/cli/auth.rb

@@ -0,0 +1,120 @@
+module Strava
+  module Cli
+    class Auth
+      def initialize(options = {})
+        @access_token = options[:access_token]
+        @client_id = options[:client_id]
+        @client_secret = options[:client_secret]
+        @scope = options[:scope]
+      end
+
+      def access_token
+        @access_token ||= get_access_token
+      end
+
+      def client_id
+        @client_id ||= get_client_id
+      end
+
+      def client_secret
+        @client_secret ||= get_client_secret
+      end
+
+      private
+
+      def get_access_token
+        require 'webrick'
+
+        server = WEBrick::HTTPServer.new(Port: 4242)
+
+        trap 'INT' do
+          server.shutdown
+        end
+
+        server.mount_proc '/' do |req, res|
+          begin
+            code = req.query['code']
+            response = strava_client.oauth_token(code: code)
+
+            res.body = %(
+          <html>
+            <body>
+              <h3>You may close this window and return to your shell.</h3>
+              <ul>
+                <li>token_type: #{response.token_type}</li>
+                <li>refresh_token: #{response.refresh_token}</li>
+                <li>access_token: #{response.access_token}</li>
+                <li>expires_at: #{response.expires_at}</li>
+              </ul>
+            <body>
+          </html>
+            )
+
+            @access_token = response.access_token if response
+          ensure
+            server.shutdown
+          end
+        end
+
+        redirect_url = strava_client.authorize_url(
+          redirect_uri: 'http://localhost:4242/',
+          response_type: 'code',
+          scope: @scope
+        )
+
+        system 'open', redirect_url
+
+        server.start
+
+        @access_token
+      end
+
+      def strava_client
+        @strava_client ||= Strava::OAuth::Client.new(
+          client_id: client_id,
+          client_secret: client_secret
+        )
+      end
+
+      def get_client_id
+        print 'Enter Strava client ID: '
+        get_insecure
+      end
+
+      def get_client_secret
+        print 'Enter Strava client secret: '
+        get_secure
+      end
+
+      private
+
+      def get_insecure
+        input = $stdin.gets
+        input.chomp! if input
+        input
+      rescue Interrupt => e
+        raise e, 'ctrl + c'
+      end
+
+      def get_secure
+        current_tty = `stty -g`
+        system 'stty raw -echo -icanon isig' if $CHILD_STATUS.success?
+        input = ''
+        while (char = $stdin.getbyte) && !((char == 13) || (char == 10))
+          if (char == 127) || (char == 8)
+            input[-1, 1] = '' unless input.empty?
+          else
+            $stdout.write '*'
+            input << char.chr
+          end
+        end
+        print "\r\n"
+        input
+      rescue Interrupt => e
+        raise e, 'ctrl + c'
+      ensure
+        system "stty #{current_tty}" unless current_tty.empty?
+      end
+    end
+  end
+end

data/lib/cli/console.rb

@@ -0,0 +1,24 @@
+module Strava
+  module Cli
+    class Console < SimpleDelegator
+      attr_reader :client
+
+      def initialize(access_token)
+        @client = Strava::Api::Client.new(access_token: access_token)
+        super @client
+      end
+
+      def run(args)
+        args.map do |arg|
+          rc = eval(arg)
+          puts rc
+          rc
+        end
+      end
+
+      def start!
+        Ripl.start(binding: binding, prompt: 'Strava> ')
+      end
+    end
+  end
+end

data/lib/cli/version.rb

@@ -0,0 +1,5 @@
+module Strava
+  module Cli
+    VERSION = '0.1.0'.freeze
+  end
+end

data/lib/strava-ruby-cli.rb

@@ -0,0 +1,8 @@
+require 'open3'
+require 'English'
+
+require 'strava-ruby-client'
+
+require_relative 'cli/version'
+require_relative 'cli/auth'
+require_relative 'cli/console'

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: strava-ruby-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Daniel Doubrovkine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-01-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ripl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: strava-ruby-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: dblock@dblock.org
+executables:
+- strava
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.md
+- README.md
+- bin/strava
+- lib/cli/auth.rb
+- lib/cli/console.rb
+- lib/cli/version.rb
+- lib/strava-ruby-cli.rb
+homepage: http://github.com/dblock/strava-ruby-cli
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Strava API CLI.
+test_files: []