abt-cli 0.0.10 → 0.0.15

data/lib/abt/providers/devops/commands/branch-name.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class BranchName < BaseCommand
+          def self.command
+            'branch-name devops[:<organization-name>/<project-name>/<board-id>/<work-item-id>]'
+          end
+
+          def self.description
+            'Suggest a git branch name for the current/specified work-item.'
+          end
+
+          def call
+            require_work_item!
+
+            cli.puts name
+          rescue HttpError::NotFoundError
+            args = [organization_name, project_name, board_id, work_item_id].compact
+            cli.warn 'Unable to find work item for configuration:'
+            cli.abort "devops:#{args.join('/')}"
+          end
+
+          private
+
+          def name
+            str = work_item['id']
+            str += '-'
+            str += work_item['name'].downcase.gsub(/[^\w]/, '-')
+            str.gsub(/-+/, '-')
+          end
+
+          def work_item
+            @work_item ||= begin
+              work_item = api.get_paged('wit/workitems', ids: work_item_id)[0]
+              sanitize_work_item(work_item)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

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

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

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

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

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class Current < BaseCommand
+          def self.command
+            'current devops[:<organization-name>/<project-name>/<board-id>[/<work-item-id>]]'
+          end
+
+          def self.description
+            'Get or set DevOps configuration for current git repository'
+          end
+
+          def call
+            require_board!
+
+            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 work_item_id.nil?
+              print_board(organization_name, project_name, board)
+            else
+              print_work_item(organization_name, project_name, board, work_item)
+            end
+          end
+
+          def update_configuration
+            ensure_board_is_valid!
+
+            if work_item_id.nil?
+              update_board_config
+              config.work_item_id = nil
+
+              print_board(organization_name, project_name, board)
+            else
+              ensure_work_item_is_valid!
+
+              update_board_config
+              config.work_item_id = work_item_id
+
+              print_work_item(organization_name, project_name, board, work_item)
+            end
+          end
+
+          def update_board_config
+            config.organization_name = organization_name
+            config.project_name = project_name
+            config.board_id = board_id
+          end
+
+          def ensure_board_is_valid!
+            if board.nil?
+              cli.abort 'Board could not be found, ensure that settings for organization, project, and board are correct'
+            end
+          end
+
+          def ensure_work_item_is_valid!
+            cli.abort "No such work item: ##{work_item_id}" if work_item.nil?
+          end
+
+          def board
+            @board ||= begin
+                         cli.warn 'Fetching board...'
+                         api.get("work/boards/#{board_id}")
+                       rescue HttpError::NotFoundError
+                         nil
+                       end
+          end
+
+          def work_item
+            @work_item ||= begin
+                             cli.warn 'Fetching work item...'
+                             work_item = api.get_paged('wit/workitems', ids: work_item_id)[0]
+                             sanitize_work_item(work_item)
+                           rescue HttpError::NotFoundError
+                             nil
+                           end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Abt
+  module Providers
+    module Devops
+      module Commands
+        class HarvestTimeEntryData < BaseCommand
+          def self.command
+            'harvest-time-entry-data devops[:<organization-name>/<project-name>/<board-id>/<work-item-id>]'
+          end
+
+          def self.description
+            'Print Harvest time entry data for DevOps work item as json. Used by harvest start script.'
+          end
+
+          def call
+            require_work_item!
+
+            body = {
+              notes: notes,
+              external_reference: {
+                id: work_item['id'],
+                group_id: 'AzureDevOpsWorkItem',
+                permalink: work_item['url']
+              }
+            }
+
+            cli.puts Oj.dump(body, mode: :json)
+          end
+
+          private
+
+          def notes
+            [
+              'Azure DevOps',
+              work_item['fields']['System.WorkItemType'],
+              "##{work_item['id']}",
+              '-',
+              work_item['name']
+            ].join(' ')
+          end
+
+          def work_item
+            @work_item ||= begin
+              work_item = api.get_paged('wit/workitems', ids: work_item_id)[0]
+              sanitize_work_item(work_item)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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.text([
+                  '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