abt-cli 0.0.15 → 0.0.20

data/lib/abt/docs/cli.rb

@@ -4,23 +4,54 @@ module Abt
   module Docs
     module Cli
       class << self
-        def content
+        def help
           <<~TXT
-            Usage: abt <command> [<provider[:<arguments>]>...]
+            Usage: #{usage_line}
 
-            #{example_commands}
+            <command>   Name of command to execute, e.g. start, finalize etc.
+            <ARI>       A URI-like resource identifier with a scheme and an optional path
+                        in the format: <scheme>[:<path>]. E.g., harvest:11111111/22222222
+            <options>   Optional flags for the command and ARI
 
-            Available commands:
-            #{providers_commands}
+            #{formatted_examples(Docs.basic_examples)}
+
+            For detailed examples/commands try:
+               abt examples
+               abt commands
+          TXT
+        end
+
+        def examples
+          <<~TXT
+            Printing examples
+
+            #{formatted_examples(Docs.basic_examples)}
+
+            #{formatted_examples(Docs.extended_examples)}
+          TXT
+        end
+
+        def commands
+          <<~TXT
+            Printing commands
+
+            Run commands with --help flag to see detailed usage and flags, e.g.:
+               abt track harvest -h
+
+            #{commands_per_provider}
           TXT
         end
 
         private
 
-        def example_commands
+        def usage_line
+          'abt <command> [<ARI>] [<options> --] [<ARI>] ...'
+        end
+
+        def formatted_examples(example_groups)
           lines = []
 
-          Docs.examples.each_with_index do |(title, examples), index|
+          example_groups.each_with_index do |(title, examples), index|
             lines << '' unless index.zero?
             lines << title
 
@@ -33,16 +64,16 @@ module Abt
           lines.join("\n")
         end
 
-        def providers_commands
+        def commands_per_provider
           lines = []
 
-          Docs.providers.each_with_index do |(provider_name, commands_definition), index|
+          Docs.providers.each_with_index do |(scheme, commands_definition), index|
             lines << '' unless index.zero?
-            lines << "#{inflector.humanize(provider_name)}:"
+            lines << "#{inflector.humanize(scheme)}:"
 
             max_length = commands_definition.keys.map(&:length).max
 
-            commands_definition.each do |(command, description)|
+            commands_definition.each do |(command, (_usage, description))|
               lines << "   #{command.ljust(max_length)}   #{description}"
             end
           end

data/lib/abt/docs/markdown.rb

@@ -4,18 +4,44 @@ module Abt
   module Docs
     module Markdown
       class << self
-        def content
+        def readme
           <<~MD
             # Abt
-            This readme was generated with `abt help-md > README.md`
+
+            Abt makes re-occuring tasks easily accessible from the terminal:
+            - Moving asana tasks around
+            - Tracking work/meetings in harvest
+            - Consistently naming branches
+
+            ## How does abt work?
+
+            Abt is a hybrid of having small scripts each doing one thing:
+            - `start-asana --project-gid xxxx --task-gid yyyy`
+            - `start-harvest --project-id aaaa --task-id bbbb`
+
+            And having a single highly advanced script that does everything with a single command:
+            - `start xxxx/yyyy aaaa/bbbb`
+
+            Abt looks like one command, but works like a bunch of light scripts:
+            - `abt start asana:xxxx/yyyy harvest:aaaa/bbbb`
 
             ## Usage
-            `abt <command> [<provider[:<arguments>]>...]`
+            `abt <command> [<ARI>] [<options> --] [<ARI>] ...`
+
+            Definitions:
+            - `<command>`: Name of command to execute, e.g. `start`, `finalize` etc.
+            - `<ARI>`: A URI-like resource identifier with a scheme and an optional path in the format: `<scheme>[:<path>]`. E.g., `harvest:11111111/22222222`
+            - `<options>`: Optional flags for the command and ARI
 
             #{example_commands}
 
-            ## Available commands:
+            ## Commands:
+
+            Some commands have `[options]`. Run such a command with `--help` flag to view supported flags, e.g: `abt track harvest -h`
+
             #{provider_commands}
+
+            #### This readme was generated with `abt readme > README.md`
           MD
         end
 
@@ -24,7 +50,8 @@ module Abt
         def example_commands
           lines = []
 
-          Docs.examples.each_with_index do |(title, commands), index|
+          examples = Docs.basic_examples.merge(Docs.extended_examples)
+          examples.each_with_index do |(title, commands), index|
             lines << '' unless index.zero?
             lines << title
 
@@ -40,17 +67,17 @@ module Abt
         def provider_commands # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
           lines = []
 
-          Docs.providers.each_with_index do |(provider_name, commands), index|
+          Docs.providers.each_with_index do |(scheme, commands), index|
             lines << '' unless index.zero?
-            lines << "### #{inflector.humanize(provider_name)}"
+            lines << "### #{inflector.humanize(scheme)}"
             lines << '| Command | Description |'
             lines << '| :------ | :---------- |'
 
-            max_length = commands.keys.map(&:length).max
+            max_length = commands.values.map(&:first).map(&:length).max
 
-            commands.each do |(command, description)|
-              adjusted_command = "`#{command}`".ljust(max_length + 2)
-              lines << "| #{adjusted_command} | #{description} |"
+            commands.each do |(_command, (usage, description))|
+              adjusted_usage = "`#{usage}`".ljust(max_length + 2)
+              lines << "| #{adjusted_usage} | #{description} |"
             end
           end
 

data/lib/abt/git_config.rb

@@ -4,21 +4,9 @@ module Abt
   class GitConfig
     attr_reader :namespace, :scope
 
-    LOCAL_CONFIG_AVAILABLE_CHECK_COMMAND = 'git config --local -l'
+    class UnsafeNamespaceError < StandardError; end
 
-    def self.local_available?
-      return @local_available if instance_variables.include?(:@local_available)
-
-      @local_available = begin
-        success = false
-        Open3.popen3(LOCAL_CONFIG_AVAILABLE_CHECK_COMMAND) do |_i, _o, _e, thread|
-          success = thread.value.success?
-        end
-        success
-      end
-    end
-
-    def initialize(namespace: '', scope: 'local')
+    def initialize(scope = 'local', namespace = '')
       @namespace = namespace
 
       unless %w[local global].include? scope
@@ -28,6 +16,20 @@ module Abt
       @scope = scope
     end
 
+    def available?
+      unless instance_variables.include?(:available)
+        @available = begin
+          success = false
+          Open3.popen3(availability_check_call) do |_i, _o, _e, thread|
+            success = thread.value.success?
+          end
+          success
+        end
+      end
+
+      @available
+    end
+
     def [](key)
       get(key)
     end
@@ -47,30 +49,23 @@ module Abt
       `git config --#{scope} --get-regexp --name-only ^#{namespace}`.lines.map(&:strip)
     end
 
-    def local
-      @local ||= begin
-        if scope == 'local'
-          self
-        else
-          self.class.new(namespace: namespace, scope: 'local')
-        end
-      end
-    end
+    def clear(output: nil)
+      raise UnsafeNamespaceError, 'Keys can only be cleared within a namespace' if namespace.empty?
 
-    def global
-      @global ||= begin
-        if scope == 'global'
-          self
-        else
-          self.class.new(namespace: namespace, scope: 'global')
-        end
+      keys.each do |key|
+        output&.puts "Clearing #{scope}: #{key_with_namespace(key)}"
+        self[key] = nil
       end
     end
 
     private
 
+    def availability_check_call
+      "git config --#{scope} -l"
+    end
+
     def ensure_scope_available!
-      return if scope != 'local' || self.class.local_available?
+      return if available?
 
       raise StandardError, 'Local configuration is not available outside a git repository'
     end

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

@@ -3,63 +3,43 @@
 module Abt
   module Providers
     module Asana
-      class BaseCommand
-        attr_reader :arg_str, :project_gid, :task_gid, :cli, :config
+      class BaseCommand < Abt::BaseCommand
+        extend Forwardable
+
+        attr_reader :path, :config
+
+        def_delegators(:@path, :project_gid, :task_gid)
+
+        def initialize(ari:, cli:)
+          super
 
-        def initialize(arg_str:, cli:)
-          @arg_str = arg_str
           @config = Configuration.new(cli: cli)
 
-          if arg_str.nil?
-            use_current_args
-          else
-            use_arg_str(arg_str)
-          end
-          @cli = cli
+          @path = ari.path ? Path.new(ari.path) : config.path
         end
 
         private
 
         def require_project!
-          cli.abort 'No current/specified project. Did you initialize Asana?' if project_gid.nil?
+          abort 'No current/specified project. Did you initialize Asana?' if project_gid.nil?
         end
 
         def require_task!
           if project_gid.nil?
-            cli.abort 'No current/specified project. Did you initialize Asana and pick a task?'
+            abort 'No current/specified project. Did you initialize Asana and pick a task?'
           end
-          cli.abort 'No current/specified task. Did you pick an Asana task?' if task_gid.nil?
-        end
-
-        def same_args_as_config?
-          project_gid == config.project_gid && task_gid == config.task_gid
+          abort 'No current/specified task. Did you pick an Asana task?' if task_gid.nil?
         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
+          cli.print_ari('asana', project['gid'], project['name'])
+          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 = config.project_gid
-          @task_gid = config.task_gid
-        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?
+          cli.print_ari('asana', "#{project['gid']}/#{task['gid']}", task['name'])
+          warn task['permalink_url'] if task.key?('permalink_url') && cli.output.isatty
         end
 
         def api

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

@@ -5,21 +5,26 @@ module Abt
     module Asana
       module Commands
         class Add < BaseCommand
-          def self.command
-            'add asana[:<project-gid>]'
+          def self.usage
+            'abt add asana[:<project-gid>]'
           end
 
           def self.description
             'Create a new task for the current/specified Asana project'
           end
 
-          def call
+          def perform
             require_project!
 
             task
-            print_task(project, task)
+            warn 'Task created'
+
+            if section
+              move_task
+              warn "Moved to section: #{section['name']}"
+            end
 
-            move_task if section
+            print_task(project, task)
           end
 
           private
@@ -33,7 +38,6 @@ module Abt
                   projects: [project_gid]
                 }
               }
-              cli.warn 'Creating task'
               api.post('tasks', Oj.dump(body, mode: :json))
             end
           end
@@ -53,7 +57,7 @@ module Abt
           end
 
           def project
-            @project ||= api.get("projects/#{project_gid}")
+            @project ||= api.get("projects/#{project_gid}", opt_fields: 'name')
           end
 
           def section
@@ -62,10 +66,8 @@ module Abt
 
           def sections
             @sections ||= begin
-              cli.warn 'Fetching sections...'
+              warn 'Fetching sections...'
               api.get_paged("projects/#{project_gid}/sections", opt_fields: 'name')
-                          rescue Abt::HttpError::HttpError
-                            []
             end
           end
         end

data/lib/abt/providers/asana/commands/{branch-name.rb → branch_name.rb}

@@ -5,19 +5,19 @@ module Abt
     module Asana
       module Commands
         class BranchName < BaseCommand
-          def self.command
-            'branch-name asana[:<project-gid>/<task-gid>]'
+          def self.usage
+            'abt branch-name asana[:<project-gid>/<task-gid>]'
           end
 
           def self.description
             'Suggest a git branch name for the current/specified task.'
           end
 
-          def call
+          def perform
             require_task!
             ensure_current_is_valid!
 
-            cli.puts name
+            puts name
           end
 
           private
@@ -27,15 +27,20 @@ module Abt
           end
 
           def ensure_current_is_valid!
-            cli.abort "Invalid task gid: #{task_gid}" if task.nil?
+            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}"
+            abort "Invalid or unmatching project gid: #{project_gid}"
           end
 
           def task
-            @task ||= api.get("tasks/#{task_gid}", opt_fields: 'name,memberships.project')
+            @task ||= begin
+              warn 'Fetching task...'
+              api.get("tasks/#{task_gid}", opt_fields: 'name,memberships.project')
+            rescue Abt::HttpError::NotFoundError
+              nil
+            end
           end
         end
       end

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

@@ -5,17 +5,30 @@ module Abt
     module Asana
       module Commands
         class Clear < BaseCommand
-          def self.command
-            'clear asana'
+          def self.usage
+            'abt clear asana'
           end
 
           def self.description
-            'Clear project/task for current git repository'
+            'Clear asana configuration'
           end
 
-          def call
-            cli.warn 'Clearing Asana project configuration'
-            config.clear_local
+          def self.flags
+            [
+              ['-g', '--global', 'Clear global instead of local asana configuration (credentials etc.)'],
+              ['-a', '--all', 'Clear all asana configuration']
+            ]
+          end
+
+          def perform
+            if flags[:global] && flags[:all]
+              abort('Flags --global and --all cannot be used at the same time')
+            end
+
+            config.clear_local unless flags[:global]
+            config.clear_global if flags[:global] || flags[:all]
+
+            warn 'Configuration cleared'
           end
         end
       end