abt-cli 0.0.2 → 0.0.7

data/lib/abt/helpers.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Abt
+  module Helpers
+    def self.const_to_command(string)
+      string = string.to_s
+      string[0] = string[0].downcase
+      string.gsub(/([A-Z])/, '-\1').downcase
+    end
+
+    def self.command_to_const(string)
+      inflector = Dry::Inflector.new
+      inflector.camelize(inflector.underscore(string))
+    end
+  end
+end

data/lib/abt/providers/asana.rb

@@ -1,59 +1,18 @@
 # frozen_string_literal: true
 
-Dir.glob("#{File.expand_path(__dir__)}/asana/*.rb").sort.each do |file|
-  require file
-end
+Dir.glob("#{File.expand_path(__dir__)}/asana/*.rb").sort.each { |file| require file }
+Dir.glob("#{File.expand_path(__dir__)}/asana/commands/*.rb").sort.each { |file| require file }
 
 module Abt
   module Providers
-    class Asana
-      class << self
-        def workspace_gid
-          @workspace_gid ||= begin
-            current = Abt::GitConfig.global('abt.asana.workspaceGid')
-            if current.nil?
-              prompt_workspace['gid']
-            else
-              current
-            end
-          end
-        end
-
-        def clear
-          Abt::GitConfig.unset_local('abt.asana.projectGid')
-          Abt::GitConfig.unset_local('abt.asana.taskGid')
-        end
-
-        def clear_global
-          Abt::GitConfig.unset_global('abt.asana.workspaceGid')
-          Abt::GitConfig.unset_global('abt.asana.accessToken')
-        end
-
-        def client
-          Abt::AsanaClient.new(access_token: access_token)
-        end
-
-        private
-
-        def prompt_workspace
-          workspaces = client.get_paged('workspaces')
-          if workspaces.empty?
-            abort 'Your asana access token does not have access to any workspaces'
-          end
-
-          # TODO: Handle if there are multiple workspaces
-          workspace = workspaces.first
-          Abt::GitConfig.global('abt.asana.workspaceGid', workspace['gid'])
-          workspace
-        end
+    module Asana
+      def self.command_names
+        Commands.constants.sort.map { |constant_name| Helpers.const_to_command(constant_name) }
+      end
 
-        def access_token
-          Abt::GitConfig.prompt_global(
-            'abt.asana.accessToken',
-            'Please enter your personal asana access_token',
-            'Create a personal access token here: https://app.asana.com/0/developer-console'
-          )
-        end
+      def self.command_class(name)
+        const_name = Helpers.command_to_const(name)
+        Commands.const_get(const_name) if Commands.const_defined?(const_name)
       end
     end
   end

data/lib/abt/providers/asana/api.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Asana
+      class Api
+        API_ENDPOINT = 'https://app.asana.com/api/1.0'
+        VERBS = %i[get post put].freeze
+
+        attr_reader :access_token
+
+        def initialize(access_token:)
+          @access_token = access_token
+        end
+
+        VERBS.each do |verb|
+          define_method(verb) do |*args|
+            request(verb, *args)['data']
+          end
+        end
+
+        def get_paged(path, query = {})
+          records = []
+
+          loop do
+            result = request(:get, path, query.merge(limit: 100))
+            records += result['data']
+            break if result['next_page'].nil?
+
+            path = result['next_page']['path'][1..-1]
+          end
+
+          records
+        end
+
+        def request(*args)
+          response = connection.public_send(*args)
+
+          if response.success?
+            Oj.load(response.body)
+          else
+            error_class = Abt::HttpError.error_class_for_status(response.status)
+            encoded_response_body = response.body.force_encoding('utf-8')
+            raise error_class, "Code: #{response.status}, body: #{encoded_response_body}"
+          end
+        end
+
+        def connection
+          @connection ||= Faraday.new(API_ENDPOINT) do |connection|
+            connection.headers['Authorization'] = "Bearer #{access_token}"
+            connection.headers['Content-Type'] = 'application/json'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/asana/base_command.rb

@@ -2,12 +2,13 @@
 
 module Abt
   module Providers
-    class Asana
+    module Asana
       class BaseCommand
-        attr_reader :arg_str, :project_gid, :task_gid, :cli
+        attr_reader :arg_str, :project_gid, :task_gid, :cli, :config
 
         def initialize(arg_str:, cli:)
           @arg_str = arg_str
+          @config = Configuration.new(cli: cli)
 
           if arg_str.nil?
             use_current_args
@@ -19,19 +20,24 @@ module Abt
 
         private
 
+        def same_args_as_config?
+          project_gid == config.project_gid && task_gid == config.task_gid
+        end
+
         def print_project(project)
           cli.print_provider_command('asana', project['gid'], project['name'])
+          cli.warn project['permalink_url'] if project.key?('permalink_url') && cli.output.isatty
         end
 
         def print_task(project, task)
+          project = { 'gid' => project } if project.is_a?(String)
           cli.print_provider_command('asana', "#{project['gid']}/#{task['gid']}", task['name'])
+          cli.warn task['permalink_url'] if task.key?('permalink_url') && cli.output.isatty
         end
 
         def use_current_args
-          @project_gid = Abt::GitConfig.local('abt.asana.projectGid').to_s
-          @project_gid = nil if project_gid.empty?
-          @task_gid = Abt::GitConfig.local('abt.asana.taskGid').to_s
-          @task_gid = nil if task_gid.empty?
+          @project_gid = config.project_gid
+          @task_gid = config.task_gid
         end
 
         def use_arg_str(arg_str)
@@ -45,16 +51,8 @@ module Abt
           @task_gid = nil if @task_gid.empty?
         end
 
-        def remember_project_gid(project_gid)
-          Abt::GitConfig.local('abt.asana.projectGid', project_gid)
-        end
-
-        def remember_task_gid(task_gid)
-          if task_gid.nil?
-            Abt::GitConfig.unset_local('abt.asana.taskGid')
-          else
-            Abt::GitConfig.local('abt.asana.taskGid', task_gid)
-          end
+        def api
+          Abt::Providers::Asana::Api.new(access_token: config.access_token)
         end
       end
     end

data/lib/abt/providers/asana/commands/clear.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Asana
+      module Commands
+        class Clear < BaseCommand
+          def self.command
+            'clear asana'
+          end
+
+          def self.description
+            'Clear project/task for current git repository'
+          end
+
+          def call
+            cli.warn 'Clearing Asana project configuration'
+            config.clear_local
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/asana/commands/clear_global.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Asana
+      module Commands
+        class ClearGlobal < BaseCommand
+          def self.command
+            'clear-global asana'
+          end
+
+          def self.description
+            'Clear all global configuration'
+          end
+
+          def call
+            cli.warn 'Clearing Asana project configuration'
+            config.clear_global
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/asana/commands/current.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Asana
+      module Commands
+        class Current < BaseCommand
+          def self.command
+            'current asana[:<project-gid>[/<task-gid>]]'
+          end
+
+          def self.description
+            'Get or set project and or task for current git repository'
+          end
+
+          def call
+            if same_args_as_config? || !config.local_available?
+              show_current_configuration
+            else
+              cli.warn 'Updating configuration'
+              update_configuration
+            end
+          end
+
+          private
+
+          def show_current_configuration
+            if project_gid.nil?
+              cli.warn 'No project selected'
+            elsif task_gid.nil?
+              print_project(project)
+            else
+              print_task(project, task)
+            end
+          end
+
+          def update_configuration
+            ensure_project_is_valid!
+            config.project_gid = project_gid
+
+            if task_gid.nil?
+              print_project(project)
+              config.task_gid = nil
+            else
+              ensure_task_is_valid!
+              config.task_gid = task_gid
+
+              print_task(project, task)
+            end
+          end
+
+          def ensure_project_is_valid!
+            cli.abort "Invalid project: #{project_gid}" if project.nil?
+          end
+
+          def ensure_task_is_valid!
+            cli.abort "Invalid task: #{task_gid}" if task.nil?
+          end
+
+          def project
+            @project ||= begin
+              cli.warn 'Fetching project...'
+              api.get("projects/#{project_gid}", opt_fields: 'name,permalink_url')
+            end
+          end
+
+          def task
+            @task ||= begin
+              cli.warn 'Fetching task...'
+              api.get("tasks/#{task_gid}", opt_fields: 'name,permalink_url')
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/asana/commands/finalize.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Asana
+      module Commands
+        class Finalize < BaseCommand
+          def self.command
+            'finalize asana[:<project-gid>/<task-gid>]'
+          end
+
+          def self.description
+            'Move current/specified task to section (column) for finalized tasks'
+          end
+
+          def call
+            unless config.local_available?
+              cli.abort 'This is a no-op for tasks outside the current project'
+            end
+            cli.abort 'No current or specified task' if task.nil?
+            print_task(project_gid, task)
+
+            if task_already_in_finalized_section?
+              cli.warn "Task already in section: #{current_task_section['name']}"
+            else
+              cli.warn "Moving task to section: #{finalized_section['name']}"
+              move_task
+            end
+          end
+
+          private
+
+          def task_already_in_finalized_section?
+            !task_section_membership.nil?
+          end
+
+          def current_task_section
+            task_section_membership&.dig('section')
+          end
+
+          def task_section_membership
+            task['memberships'].find do |membership|
+              membership.dig('section', 'gid') == config.finalized_section_gid
+            end
+          end
+
+          def finalized_section
+            @finalized_section ||= api.get("sections/#{config.finalized_section_gid}",
+                                           opt_fields: 'name')
+          end
+
+          def move_task
+            body = { data: { task: task_gid } }
+            body_json = Oj.dump(body, mode: :json)
+            api.post("sections/#{config.finalized_section_gid}/addTask", body_json)
+          end
+
+          def task
+            @task ||= begin
+              if task_gid.nil?
+                nil
+              else
+                api.get("tasks/#{task_gid}", opt_fields: 'name,memberships.section.name,permalink_url')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/asana/commands/harvest_time_entry_data.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Asana
+      module Commands
+        class HarvestTimeEntryData < BaseCommand
+          def self.command
+            'harvest-time-entry-data asana[:<project-gid>/<task-gid>]'
+          end
+
+          def self.description
+            'Print Harvest time entry data for Asana task as json. Used by harvest start script.'
+          end
+
+          def call # rubocop:disable Metrics/MethodLength
+            ensure_current_is_valid!
+
+            body = {
+              notes: task['name'],
+              external_reference: {
+                id: task_gid.to_i,
+                group_id: project_gid.to_i,
+                permalink: task['permalink_url'],
+                service: 'app.asana.com',
+                service_icon_url: 'https://proxy.harvestfiles.com/production_harvestapp_public/uploads/platform_icons/app.asana.com.png'
+              }
+            }
+
+            cli.puts Oj.dump(body, mode: :json)
+          end
+
+          private
+
+          def ensure_current_is_valid!
+            cli.abort "Invalid task gid: #{task_gid}" if task.nil?
+
+            return if task['memberships'].any? { |m| m.dig('project', 'gid') == project_gid }
+
+            cli.abort "Invalid project gid: #{project_gid}"
+          end
+
+          def task
+            @task ||= api.get("tasks/#{task_gid}", opt_fields: 'name,permalink_url,memberships.project')
+          end
+        end
+      end
+    end
+  end
+end