abt-cli 0.0.2

data/lib/abt/help/cli.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Abt
+  module Help
+    module Cli
+      class << self
+        def content
+          <<~TXT
+            Usage: abt <command> [<provider:arguments>...]
+
+            #{example_commands}
+
+            Available commands:
+            #{providers_commands}
+          TXT
+        end
+
+        private
+
+        def example_commands
+          lines = []
+
+          Help.examples.each_with_index do |(title, examples), index|
+            lines << '' unless index.zero?
+            lines << title
+
+            max_length = examples.keys.map(&:length).max
+            examples.each do |(command, description)|
+              lines << "   #{command.ljust(max_length)}   #{description}"
+            end
+          end
+
+          lines.join("\n")
+        end
+
+        def providers_commands
+          lines = []
+
+          Help.providers.each_with_index do |(provider_name, commands_definition), index|
+            lines << '' unless index.zero?
+            lines << "#{inflector.humanize(provider_name)}:"
+
+            max_length = commands_definition.keys.map(&:length).max
+
+            commands_definition.each do |(command, description)|
+              lines << "   #{command.ljust(max_length)}   #{description}"
+            end
+          end
+
+          lines.join("\n")
+        end
+
+        def inflector
+          Dry::Inflector.new
+        end
+      end
+    end
+  end
+end

data/lib/abt/help/markdown.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Abt
+  module Help
+    module Markdown
+      class << self
+        def content
+          <<~MD
+            # Abt
+            This readme was generated with `abt help-md > README.md`
+
+            ## Usage
+            `abt <command> [<provider:arguments>...]`
+
+            #{example_commands}
+
+            ## Available commands:
+            #{provider_commands}
+          MD
+        end
+
+        private
+
+        def example_commands
+          lines = []
+
+          Help.examples.each_with_index do |(title, commands), index|
+            lines << '' unless index.zero?
+            lines << title
+
+            commands.each do |(command, description)|
+              formatted_description = description.nil? ? '' : ": #{description}"
+              lines << "- `#{command}`#{formatted_description}"
+            end
+          end
+
+          lines.join("\n")
+        end
+
+        def provider_commands # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          lines = []
+
+          Help.providers.each_with_index do |(provider_name, commands), index|
+            lines << '' unless index.zero?
+            lines << "### #{inflector.humanize(provider_name)}"
+            lines << '| Command | Description |'
+            lines << '| :------ | :---------- |'
+
+            max_length = commands.keys.map(&:length).max
+
+            commands.each do |(command, description)|
+              adjusted_command = "`#{command}`".ljust(max_length + 2)
+              lines << "| #{adjusted_command} | #{description} |"
+            end
+          end
+
+          lines.join("\n")
+        end
+
+        def inflector
+          Dry::Inflector.new
+        end
+      end
+    end
+  end
+end

data/lib/abt/http_error.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Abt
+  module HttpError
+    class HttpError < StandardError; end
+
+    class BadRequestError < HttpError; end
+
+    class UnauthorizedError < HttpError; end
+
+    class ForbiddenError < HttpError; end
+
+    class NotFoundError < HttpError; end
+
+    class MethodNotAllowedError < HttpError; end
+
+    class UnsupportedMediaTypeError < HttpError; end
+
+    class ProcessingError < HttpError; end
+
+    class TooManyRequestsError < HttpError; end
+
+    class InternalServerError < HttpError; end
+
+    class NotImplementedError < HttpError; end
+
+    class UnknownError < HttpError; end
+
+    def self.error_class_for_status(status) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength
+      case status
+      when 400 then BadRequestError
+      when 401 then UnauthorizedError
+      when 403 then ForbiddenError
+      when 404 then NotFoundError
+      when 405 then MethodNotAllowedError
+      when 415 then UnsupportedMediaTypeError
+      when 422 then ProcessingError
+      when 429 then TooManyRequestsError
+      when 500 then InternalServerError
+      when 501 then NotImplementedError
+      else UnknownError
+      end
+    end
+  end
+end

data/lib/abt/providers.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+Dir.glob("#{File.expand_path(__dir__)}/providers/*.rb").sort.each do |file|
+  require file
+end

data/lib/abt/providers/asana.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+Dir.glob("#{File.expand_path(__dir__)}/asana/*.rb").sort.each do |file|
+  require file
+end
+
+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
+
+        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
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    class Asana
+      class BaseCommand
+        attr_reader :arg_str, :project_gid, :task_gid, :cli
+
+        def initialize(arg_str:, cli:)
+          @arg_str = arg_str
+
+          if arg_str.nil?
+            use_current_args
+          else
+            use_arg_str(arg_str)
+          end
+          @cli = cli
+        end
+
+        private
+
+        def print_project(project)
+          cli.print_provider_command('asana', project['gid'], project['name'])
+        end
+
+        def print_task(project, task)
+          cli.print_provider_command('asana', "#{project['gid']}/#{task['gid']}", task['name'])
+        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?
+        end
+
+        def use_arg_str(arg_str)
+          args = arg_str.to_s.split('/')
+          @project_gid = args[0].to_s
+          @project_gid = nil if project_gid.empty?
+
+          return if project_gid.nil?
+
+          @task_gid = args[1].to_s
+          @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
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    class Asana
+      class Clear
+        def self.command
+          'clear asana'
+        end
+
+        def self.description
+          'Clear project/task for current git repository'
+        end
+
+        def initialize(**); end
+
+        def call
+          warn 'Clearing Asana project configuration'
+          Asana.clear
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    class Asana
+      class ClearGlobal
+        def self.command
+          'clear-global asana'
+        end
+
+        def self.description
+          'Clear all global configuration'
+        end
+
+        def initialize(**); end
+
+        def call
+          warn 'Clearing Asana project configuration'
+          Asana.clear_global
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    class Asana
+      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 arg_str.nil?
+            show_current_configuration
+          else
+            warn 'Updating configuration'
+            update_configuration
+          end
+        end
+
+        private
+
+        def show_current_configuration
+          if project_gid.nil?
+            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!
+          remember_project_gid(project_gid)
+
+          if task_gid.nil?
+            print_project(project)
+            remember_task_gid(nil)
+          else
+            ensure_task_is_valid!
+            remember_task_gid(task_gid)
+
+            print_task(project, task)
+          end
+        end
+
+        def ensure_project_is_valid!
+          abort "Invalid project: #{project_gid}" if project.nil?
+        end
+
+        def ensure_task_is_valid!
+          abort "Invalid task: #{task_gid}" if task.nil?
+        end
+
+        def project
+          @project ||= Asana.client.get("projects/#{project_gid}")
+        end
+
+        def task
+          @task ||= Asana.client.get("tasks/#{task_gid}")
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    class Asana
+      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'
+            }
+          }
+
+          puts Oj.dump(body, mode: :json)
+        end
+
+        private
+
+        def ensure_current_is_valid!
+          abort "Invalid task gid: #{task_gid}" if task.nil?
+
+          return if task['memberships'].any? { |m| m.dig('project', 'gid') == project_gid }
+
+          abort "Invalid project gid: #{project_gid}"
+        end
+
+        def task
+          @task ||= Asana.client.get("tasks/#{task_gid}")
+        end
+      end
+    end
+  end
+end