openc-asana 0.1.2

data/Rakefile

@@ -0,0 +1,65 @@
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'yard'
+
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new
+
+YARD::Rake::YardocTask.new do |t|
+  t.stats_options = ['--list-undoc']
+end
+
+desc 'Generates a test resource from a YAML using the resource template.'
+task :codegen do
+  `node spec/support/codegen.js`
+end
+
+namespace :bump do
+  def read_version
+    File.readlines('./lib/asana/version.rb')
+      .detect { |l| l =~ /VERSION/ }
+      .scan(/VERSION = '([^']+)/).flatten.first.split('.')
+      .map { |n| Integer(n) }
+  end
+
+  # rubocop:disable Metrics/MethodLength
+  def write_version(major, minor, patch)
+    str = <<-EOS
+#:nodoc:
+module Asana
+  # Public: Version of the gem.
+  VERSION = '#{major}.#{minor}.#{patch}'
+end
+EOS
+    File.open('./lib/asana/version.rb', 'w') do |f|
+      f.write str
+    end
+
+    new_version = "#{major}.#{minor}.#{patch}"
+    system('git add lib/asana/version.rb')
+    system(%(git commit -m "Bumped to #{new_version}" && ) +
+           %(git tag -a v#{new_version} -m "Version #{new_version}"))
+    puts "\nRun git push --tags to release."
+  end
+
+  desc 'Bumps a patch version'
+  task :patch do
+    major, minor, patch = read_version
+    write_version major, minor, patch + 1
+  end
+
+  desc 'Bumps a minor version'
+  task :minor do
+    major, minor, = read_version
+    write_version major, minor + 1, 0
+  end
+
+  desc 'Bumps a major version'
+  task :major do
+    major, = read_version
+    write_version major + 1, 0, 0
+  end
+end
+
+task default: [:codegen, :spec, :rubocop, :yard]

data/examples/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'omniauth'
+gem 'omniauth-asana'
+gem 'sinatra'
+gem 'asana', path: '../'

data/examples/Gemfile.lock

@@ -0,0 +1,59 @@
+PATH
+  remote: ../
+  specs:
+    asana (0.1.1)
+      faraday (~> 0.9)
+      faraday_middleware (~> 0.9)
+      faraday_middleware-multi_json (~> 0.0)
+      oauth2 (~> 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    faraday (0.9.1)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.9.1)
+      faraday (>= 0.7.4, < 0.10)
+    faraday_middleware-multi_json (0.0.6)
+      faraday_middleware
+      multi_json
+    hashie (3.4.1)
+    jwt (1.5.0)
+    multi_json (1.11.0)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    oauth2 (1.0.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    omniauth (1.2.2)
+      hashie (>= 1.2, < 4)
+      rack (~> 1.0)
+    omniauth-asana (0.0.1)
+      omniauth (~> 1.0)
+      omniauth-oauth2 (~> 1.1)
+    omniauth-oauth2 (1.3.0)
+      oauth2 (~> 1.0)
+      omniauth (~> 1.2)
+    rack (1.6.1)
+    rack-protection (1.5.3)
+      rack
+    sinatra (1.4.6)
+      rack (~> 1.4)
+      rack-protection (~> 1.4)
+      tilt (>= 1.3, < 3)
+    tilt (2.0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  asana!
+  omniauth
+  omniauth-asana
+  sinatra
+
+BUNDLED WITH
+   1.10.3

data/examples/api_token.rb

@@ -0,0 +1,21 @@
+require 'bundler'
+Bundler.require
+require 'asana'
+
+api_token = ENV['ASANA_API_TOKEN']
+unless api_token
+  abort "Run this program with the env var ASANA_API_TOKEN.\n"  \
+    "Go to http://app.asana.com/-/account_api to see your API token."
+end
+
+client = Asana::Client.new do |c|
+  c.authentication :api_token, api_token
+end
+
+puts "My Workspaces:"
+client.workspaces.find_all.each do |workspace|
+  puts "\t* #{workspace.name} - tags:"
+  client.tags.find_by_workspace(workspace: workspace.id).each do |tag|
+    puts "\t\t- #{tag.name}"
+  end
+end

data/examples/cli_app.rb

@@ -0,0 +1,25 @@
+require 'bundler'
+Bundler.require
+require 'asana'
+
+id, secret = ENV['ASANA_CLIENT_ID'], ENV['ASANA_CLIENT_SECRET']
+unless id && secret
+  abort "Run this program with the env vars ASANA_CLIENT_ID and ASANA_CLIENT_SECRET.\n"  \
+    "Refer to https://asana.com/developers/documentation/getting-started/authentication "\
+    "to get your credentials." \
+    "The redirect URI for your application should be \"urn:ietf:wg:oauth:2.0:oob\"."
+end
+
+access_token = Asana::Authentication::OAuth2.offline_flow(client_id: id,
+                                                          client_secret: secret)
+client = Asana::Client.new do |c|
+  c.authentication :oauth2, access_token
+end
+
+puts "My Workspaces:"
+client.workspaces.find_all.each do |workspace|
+  puts "\t* #{workspace.name} - tags:"
+  client.tags.find_by_workspace(workspace: workspace.id).each do |tag|
+    puts "\t\t- #{tag.name}"
+  end
+end

data/examples/events.rb

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+require 'bundler'
+Bundler.require
+require 'asana'
+
+api_token = ENV['ASANA_API_TOKEN']
+unless api_token
+  abort "Run this program with the env var ASANA_API_TOKEN.\n"  \
+    "Go to http://app.asana.com/-/account_api to see your API token."
+end
+
+client = Asana::Client.new do |c|
+  c.authentication :api_token, api_token
+end
+
+workspace = client.workspaces.find_all.first
+task = client.tasks.find_all(assignee: "me", workspace: workspace.id).first
+unless task
+  task = client.tasks.create(workspace: workspace.id, name: "Hello world!", assignee: "me")
+end
+
+Thread.abort_on_exception = true
+
+Thread.new do
+  puts "Listening for 'changed' events on #{task} in one thread..."
+  task.events(wait: 2).lazy.select { |event| event.action == 'changed' }.each do |event|
+    puts "#{event.user.name} changed #{event.resource}"
+  end
+end
+
+Thread.new do
+  puts "Listening for non-'changed' events on #{task} in another thread..."
+  task.events(wait: 1).lazy.reject { |event| event.action == 'changed' }.each do |event|
+    puts "'#{event.action}' event: #{event}"
+  end
+end
+
+sleep

data/examples/omniauth_integration.rb

@@ -0,0 +1,54 @@
+require 'bundler'
+Bundler.require
+require 'asana'
+
+class SinatraApp < Sinatra::Base
+  id, secret = ENV['ASANA_CLIENT_ID'], ENV['ASANA_CLIENT_SECRET']
+  unless id && secret
+    abort "Run this program with the env vars ASANA_CLIENT_ID and ASANA_CLIENT_SECRET.\n"  \
+      "Refer to https://asana.com/developers/documentation/getting-started/authentication "\
+      "to get your credentials."
+  end
+
+  use OmniAuth::Strategies::Asana, id, secret
+
+  enable :sessions
+
+  get '/' do
+    if $client
+      '<a href="/workspaces">My Workspaces</a>'
+    else
+      '<a href="/sign_in">sign in to asana</a>'
+    end
+  end
+
+  get '/workspaces' do
+    if $client
+      "<h1>My Workspaces</h1>" \
+        "<ul>" + $client.workspaces.find_all.map { |w| "<li>#{w.name}</li>" }.join + "</ul>"
+    else
+      redirect '/sign_in'
+    end
+  end
+
+  get '/auth/:name/callback' do
+    creds = request.env["omniauth.auth"]["credentials"].tap { |h| h.delete('expires') }
+    strategy = request.env["omniauth.strategy"]
+    access_token = OAuth2::AccessToken.from_hash(strategy.client, creds).refresh!
+    $client = Asana::Client.new do |c|
+      c.authentication :oauth2, access_token
+    end
+    redirect '/workspaces'
+  end
+
+  get '/sign_in' do
+    redirect '/auth/asana'
+  end
+
+  get '/sign_out' do
+    $client = nil
+    redirect '/'
+  end
+end
+
+SinatraApp.run! if __FILE__ == $0

data/lib/asana.rb

@@ -0,0 +1,12 @@
+require 'asana/ruby2_0_0_compatibility'
+require 'asana/authentication'
+require 'asana/resources'
+require 'asana/client'
+require 'asana/errors'
+require 'asana/http_client'
+require 'asana/version'
+
+# Public: Top-level namespace of the Asana API Ruby client.
+module Asana
+  include Asana::Resources
+end

data/lib/asana/authentication.rb

@@ -0,0 +1,8 @@
+require_relative 'authentication/oauth2'
+require_relative 'authentication/token_authentication'
+
+module Asana
+  # Public: Authentication strategies for the Asana API.
+  module Authentication
+  end
+end

data/lib/asana/authentication/oauth2.rb

@@ -0,0 +1,42 @@
+require_relative 'oauth2/bearer_token_authentication'
+require_relative 'oauth2/access_token_authentication'
+require_relative 'oauth2/client'
+
+module Asana
+  module Authentication
+    # Public: Deals with OAuth2 authentication. Contains a function to get an
+    # access token throught a browserless authentication flow, needed for some
+    # applications such as CLI applications.
+    module OAuth2
+      module_function
+
+      # Public: Retrieves an access token through an offline authentication
+      # flow. If your application can receive HTTP requests, you might want to
+      # opt for a browser-based flow and use the omniauth-asana gem instead.
+      #
+      # Your registered application's redirect_uri should be exactly
+      # "urn:ietf:wg:oauth:2.0:oob".
+      #
+      # client_id     - [String] the client id of the registered Asana API
+      #                 application.
+      # client_secret - [String] the client secret of the registered Asana API
+      #                 application.
+      #
+      # Returns an ::OAuth2::AccessToken object.
+      #
+      # Note: This function reads from STDIN and writes to STDOUT. It is meant
+      # to be used only within the context of a CLI application.
+      def offline_flow(client_id: required('client_id'),
+                       client_secret: required('client_secret'))
+        client = Client.new(client_id: client_id,
+                            client_secret: client_secret,
+                            redirect_uri: 'urn:ietf:wg:oauth:2.0:oob')
+        STDOUT.puts '1. Go to the following URL to authorize the ' \
+          " application: #{client.authorize_url}"
+        STDOUT.puts '2. Paste the authorization code here: '
+        auth_code = STDIN.gets.chomp
+        client.token_from_auth_code(auth_code)
+      end
+    end
+  end
+end

data/lib/asana/authentication/oauth2/access_token_authentication.rb

@@ -0,0 +1,51 @@
+module Asana
+  module Authentication
+    module OAuth2
+      # Public: A mechanism to authenticate with an OAuth2 access token (a
+      # bearer token and a refresh token) or just a refresh token.
+      class AccessTokenAuthentication
+        # Public: Builds an AccessTokenAuthentication from a refresh token and
+        # client credentials, by refreshing into a new one.
+        #
+        # refresh_token - [String] a refresh token
+        # client_id     - [String] the client id of the registered Asana API
+        #                 Application.
+        # client_secret - [String] the client secret of the registered Asana API
+        #                 Application.
+        # redirect_uri  - [String] the redirect uri of the registered Asana API
+        #                 Application.
+        #
+        # Returns an [AccessTokenAuthentication] instance with a refreshed
+        # access token.
+        def self.from_refresh_token(refresh_token,
+                                    client_id: required('client_id'),
+                                    client_secret: required('client_secret'),
+                                    redirect_uri: required('redirect_uri'))
+          client = Client.new(client_id: client_id,
+                              client_secret: client_secret,
+                              redirect_uri: redirect_uri)
+          new(client.token_from_refresh_token(refresh_token))
+        end
+
+        # Public: Initializes a new AccessTokenAuthentication.
+        #
+        # access_token - [::OAuth2::AccessToken] An ::OAuth2::AccessToken
+        #                object.
+        def initialize(access_token)
+          @token = access_token
+        end
+
+        # Public: Configures a Faraday connection injecting a bearer token,
+        # auto-refreshing it when needed.
+        #
+        # connection - [Faraday::Connection] the Faraday connection instance.
+        #
+        # Returns nothing.
+        def configure(connection)
+          @token = @token.refresh! if @token.expired?
+          connection.request :oauth2, @token.token
+        end
+      end
+    end
+  end
+end

data/lib/asana/authentication/oauth2/bearer_token_authentication.rb

@@ -0,0 +1,32 @@
+module Asana
+  module Authentication
+    module OAuth2
+      # Public: A mechanism to authenticate with an OAuth2 bearer token obtained
+      # somewhere, for instance through omniauth-asana.
+      #
+      # Note: This authentication mechanism doesn't support token refreshing. If
+      # you'd like refreshing and you have a refresh token as well as a bearer
+      # token, you can generate a proper access token with
+      # {AccessTokenAuthentication.from_refresh_token}.
+      class BearerTokenAuthentication
+        # Public: Initializes a new BearerTokenAuthentication with a plain
+        # bearer token.
+        #
+        # bearer_token - [String] a plain bearer token.
+        def initialize(bearer_token)
+          @token = bearer_token
+        end
+
+        # Public: Configures a Faraday connection injecting its token as an
+        # OAuth2 bearer token.
+        #
+        # connection - [Faraday::Connection] the Faraday connection instance.
+        #
+        # Returns nothing.
+        def configure(connection)
+          connection.request :oauth2, @token
+        end
+      end
+    end
+  end
+end

data/lib/asana/authentication/oauth2/client.rb

@@ -0,0 +1,50 @@
+require 'oauth2'
+
+module Asana
+  module Authentication
+    module OAuth2
+      # Public: Deals with the details of obtaining an OAuth2 authorization URL
+      # and obtaining access tokens from either authorization codes or refresh
+      # tokens.
+      class Client
+        # Public: Initializes a new client with client credentials associated
+        # with a registered Asana API application.
+        #
+        # client_id     - [String] a client id from the registered application
+        # client_secret - [String] a client secret from the registered
+        #                 application
+        # redirect_uri  - [String] a redirect uri from the registered
+        #                 application
+        def initialize(client_id: required('client_id'),
+                       client_secret: required('client_secret'),
+                       redirect_uri: required('redirect_uri'))
+          @client = ::OAuth2::Client.new(client_id, client_secret,
+                                         site: 'https://app.asana.com',
+                                         authorize_url: '/-/oauth_authorize',
+                                         token_url: '/-/oauth_token')
+          @redirect_uri = redirect_uri
+        end
+
+        # Public:
+        # Returns the [String] OAuth2 authorize URL.
+        def authorize_url
+          @client.auth_code.authorize_url(redirect_uri: @redirect_uri)
+        end
+
+        # Public: Retrieves a token from an authorization code.
+        #
+        # Returns the [::OAuth2::AccessToken] token.
+        def token_from_auth_code(auth_code)
+          @client.auth_code.get_token(auth_code, redirect_uri: @redirect_uri)
+        end
+
+        # Public: Retrieves a token from a refresh token.
+        #
+        # Returns the refreshed [::OAuth2::AccessToken] token.
+        def token_from_refresh_token(token)
+          ::OAuth2::AccessToken.new(@client, '', refresh_token: token).refresh!
+        end
+      end
+    end
+  end
+end