abt-cli 0.0.8 → 0.0.13

data/lib/abt/providers/devops/commands/init.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class Init < BaseCommand
+          AZURE_DEV_URL_REGEX = %r{^https://dev\.azure\.com/(?<organization>[^/]+)/(?<project>[^/]+)}.freeze
+          VS_URL_REGEX = %r{^https://(?<organization>[^.]+)\.visualstudio\.com/(?<project>[^/]+)}.freeze
+
+          def self.command
+            'init devops'
+          end
+
+          def self.description
+            'Pick DevOps board for current git repository'
+          end
+
+          def call
+            cli.abort 'Must be run inside a git repository' unless config.local_available?
+
+            @organization_name = config.organization_name = organization_name_from_url
+            @project_name = config.project_name = project_name_from_url
+
+            board = cli.prompt_choice 'Select a project work board', boards
+
+            config.board_id = board['id']
+
+            print_board(organization_name, project_name, board)
+          end
+
+          private
+
+          def boards
+            @boards ||= api.get_paged('work/boards')
+          end
+
+          def project_name_from_url
+            if (match = AZURE_DEV_URL_REGEX.match(project_url)) ||
+               (match = VS_URL_REGEX.match(project_url))
+              match[:project]
+            end
+          end
+
+          def organization_name_from_url
+            if (match = AZURE_DEV_URL_REGEX.match(project_url)) ||
+               (match = VS_URL_REGEX.match(project_url))
+              match[:organization]
+            end
+          end
+
+          def project_url
+            @project_url ||= begin
+              loop do
+                url = cli.prompt([
+                  'Please provide the URL for the devops project',
+                  'For instance https://{organization}.visualstudio.com/{project} or https://dev.azure.com/{organization}/{project}',
+                  '',
+                  'Enter URL'
+                ].join("\n"))
+
+                break url if AZURE_DEV_URL_REGEX =~ url || VS_URL_REGEX =~ url
+
+                cli.warn 'Invalid URL'
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/devops/commands/pick.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class Pick < BaseCommand
+          def self.command
+            'pick devops[:<organization-name>/<project-name>/<board-id>]'
+          end
+
+          def self.description
+            'Pick work item for current git repository'
+          end
+
+          def call
+            cli.abort 'Must be run inside a git repository' unless config.local_available?
+            require_board!
+
+            cli.warn "#{project_name} - #{board['name']}"
+
+            work_item = select_work_item
+
+            update_config!(work_item)
+
+            print_work_item(organization_name, project_name, board, work_item)
+          end
+
+          private
+
+          def update_config!(work_item)
+            config.organization_name = organization_name
+            config.project_name = project_name
+            config.board_id = board_id
+            config.work_item_id = work_item['id']
+          end
+
+          def select_work_item
+            loop do
+              column = cli.prompt_choice 'Which column?', columns
+              cli.warn 'Fetching work items...'
+              work_items = work_items_in_column(column)
+
+              if work_items.length.zero?
+                cli.warn 'Section is empty'
+                next
+              end
+
+              work_item = cli.prompt_choice 'Select a work item', work_items, true
+              return work_item if work_item
+            end
+          end
+
+          def work_items_in_column(column)
+            work_items = api.work_item_query(
+              <<~WIQL
+                SELECT [System.Id]
+                FROM WorkItems
+                WHERE [System.BoardColumn] = '#{column['name']}'
+                ORDER BY [Microsoft.VSTS.Common.BacklogPriority] ASC
+              WIQL
+            )
+
+            work_items.map { |work_item| sanitize_work_item(work_item) }
+          end
+
+          def columns
+            board['columns']
+          end
+
+          def board
+            @board ||= api.get("work/boards/#{board_id}")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/devops/commands/share.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class Share < BaseCommand
+          def self.command
+            'share devops[:<organization-name>/<project-name>/<board-id>[/<work-item-id>]]'
+          end
+
+          def self.description
+            'Print DevOps config string'
+          end
+
+          def call
+            require_work_item!
+
+            args = [organization_name, project_name, board_id, work_item_id].compact
+            cli.print_provider_command('devops', args.join('/'))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/devops/commands/work-items.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class WorkItems < BaseCommand
+          def self.command
+            'work-items devops'
+          end
+
+          def self.description
+            'List all work items on board - useful for piping into grep etc.'
+          end
+
+          def call
+            require_board!
+
+            work_items.each do |work_item|
+              print_work_item(organization_name, project_name, board, work_item)
+            end
+          end
+
+          private
+
+          def work_items
+            @work_items ||= begin
+              cli.warn 'Fetching work items...'
+              api.work_item_query(
+                <<~WIQL
+                  SELECT [System.Id]
+                  FROM WorkItems
+                  ORDER BY [System.Title] ASC
+                WIQL
+              ).map { |work_item| sanitize_work_item(work_item) }
+            end
+          end
+
+          def board
+            @board ||= api.get("work/boards/#{board_id}")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/abt/providers/devops/configuration.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      class Configuration
+        attr_accessor :cli
+
+        def initialize(cli:)
+          @cli = cli
+          @git = GitConfig.new(namespace: 'abt.devops')
+        end
+
+        def local_available?
+          GitConfig.local_available?
+        end
+
+        def organization_name
+          local_available? ? git['organizationName'] : nil
+        end
+
+        def project_name
+          local_available? ? git['projectName'] : nil
+        end
+
+        def board_id
+          local_available? ? git['boardId'] : nil
+        end
+
+        def work_item_id
+          local_available? ? git['workItemId'] : nil
+        end
+
+        def organization_name=(value)
+          return if organization_name == value
+
+          clear_local
+          git['organizationName'] = value unless value.nil?
+        end
+
+        def project_name=(value)
+          return if project_name == value
+
+          git['projectName'] = value unless value.nil?
+          git['boardId'] = nil
+          git['workItemId'] = nil
+        end
+
+        def board_id=(value)
+          return if board_id == value
+
+          git['boardId'] = value unless value.nil?
+          git['workItemId'] = nil
+        end
+
+        def work_item_id=(value)
+          git['workItemId'] = value
+        end
+
+        def clear_local
+          cli.abort 'No local configuration was found' unless local_available?
+
+          git['organizationName'] = nil
+          git['projectName'] = nil
+          git['boardId'] = nil
+          git['workItemId'] = nil
+        end
+
+        def clear_global
+          git.global.keys.each do |key|
+            cli.puts 'Deleting configuration: ' + key
+            git.global[key] = nil
+          end
+        end
+
+        def username_for_organization(organization_name)
+          username_key = "organizations.#{organization_name}.username"
+
+          return git.global[username_key] unless git.global[username_key].nil?
+
+          git.global[username_key] = cli.prompt([
+            "Please provide your username for the DevOps organization (#{organization_name}).",
+            '',
+            'Enter username'
+          ].join("\n"))
+        end
+
+        def access_token_for_organization(organization_name)
+          access_token_key = "organizations.#{organization_name}.accessToken"
+
+          return git.global[access_token_key] unless git.global[access_token_key].nil?
+
+          git.global[access_token_key] = cli.prompt([
+            "Please provide your personal access token for the DevOps organization (#{organization_name}).",
+            'If you don\'t have one, follow the guide here: https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate',
+            '',
+            'The token MUST have "Read" permission for Work Items',
+            'Future features will likely require "Write" or "Manage"',
+            '',
+            'Enter access token'
+          ].join("\n"))
+        end
+
+        private
+
+        attr_reader :git
+      end
+    end
+  end
+end

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

@@ -20,6 +20,17 @@ module Abt
 
         private
 
+        def require_project!
+          cli.abort 'No current/specified project. Did you initialize Harvest?' if project_id.nil?
+        end
+
+        def require_task!
+          if project_id.nil?
+            cli.abort 'No current/specified project. Did you initialize Harvest and pick a task?'
+          end
+          cli.abort 'No current/specified task. Did you pick a Harvest task?' if task_id.nil?
+        end
+
         def same_args_as_config?
           project_id == config.project_id && task_id == config.task_id
         end

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

@@ -14,6 +14,8 @@ module Abt
           end
 
           def call
+            require_project!
+
             if same_args_as_config? || !config.local_available?
               show_current_configuration
             else
@@ -25,9 +27,7 @@ module Abt
           private
 
           def show_current_configuration
-            if project_id.nil?
-              cli.warn 'No project selected'
-            elsif task_id.nil?
+            if task_id.nil?
               print_project(project)
             else
               print_task(project, task)

data/lib/abt/providers/harvest/commands/pick.rb

@@ -15,6 +15,7 @@ module Abt
 
           def call
             cli.abort 'Must be run inside a git repository' unless config.local_available?
+            require_project!
 
             cli.warn project['name']
             task = cli.prompt_choice 'Select a task', tasks

data/lib/abt/providers/harvest/commands/start.rb

@@ -14,10 +14,10 @@ module Abt
           end
 
           def call
-            start_output = call_start
-            puts start_output
+            track_output = call_track
+            puts track_output
 
-            use_arg_str(arg_str_from_start_output(start_output))
+            use_arg_str(arg_str_from_track_output(track_output))
 
             maybe_override_current_task
           rescue Abt::HttpError::HttpError => e
@@ -27,18 +27,17 @@ module Abt
 
           private
 
-          def arg_str_from_start_output(output)
+          def arg_str_from_track_output(output)
             output = output.split(' # ').first
             output.split(':')[1]
           end
 
-          def call_start
+          def call_track
+            input = StringIO.new(cli.args.join(' '))
             output = StringIO.new
-            Abt::Cli.new(argv: ['track', *cli.args], output: output).perform
+            Abt::Cli.new(argv: ['track'], output: output, input: input).perform
 
-            output_str = output.string.strip
-            cli.abort 'No task provided' if output_str.empty?
-            output_str
+            output.string.strip
           end
 
           def maybe_override_current_task
@@ -47,9 +46,9 @@ module Abt
             return unless config.local_available?
             return unless cli.prompt_boolean 'Set selected task as current?'
 
+            input = StringIO.new("harvest:#{project_id}/#{task_id}")
             output = StringIO.new
-            Abt::Cli.new(argv: ['current', "harvest:#{project_id}/#{task_id}"],
-                         output: output).perform
+            Abt::Cli.new(argv: ['current'], output: output, input: input).perform
           end
         end
       end

data/lib/abt/providers/harvest/commands/tasks.rb

@@ -14,6 +14,8 @@ module Abt
           end
 
           def call
+            require_project!
+
             tasks.each do |task|
               print_task(project, task)
             end