gitlab_support_readiness 1.0.10 → 1.0.12

data/lib/support_readiness/repos/organization_fields.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Repos
+  module Repos
+    ##
+    # Defines the class OrganizationFields within the module {Readiness::Repos}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class OrganizationFields < Readiness::Client
+      ##
+      # Compares the repo automation files to the Zendesk instance organization fields
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param zendesk_client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param location [String] The location (relative or absolute) of the repo's data folder
+      # @param verbose [Boolean] Whether you want a detailed report or not
+      # @return [Hash]
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   diffs = Readiness::Repos::OrganizationFields.compare(client, 'organizations/fields/data', false)
+      #   pp diffs[:updates.count]
+      #   # => 1
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   diffs = Readiness::Repos::OrganizationFields.compare(client, 'organizations/fields/data', true)
+      #   # => Detailed diff of Support Ops
+      #   # => - @description Repo:
+      #   # => "For GitLab Support Operations"
+      #   # =>   @description Zendesk:
+      #   # => "For GitLab Support Ops"
+      #   # => Compare report:
+      #   # => - Creates: 0
+      #   # => - Updates: 1
+      #   pp diffs[:updates.count]
+      #   # => 1
+      def self.compare(zendesk_client, location = 'data', verbose = false)
+        diffs = {
+          updates: [],
+          creates: []
+        }
+        from_repo = gather(location)
+        from_zendesk = Zendesk::OrganizationFields.list(zendesk_client)
+        from_repo.each do |repo|
+          zd = from_zendesk.detect { |z| z.title == repo.title }
+          if zd.nil?
+            diffs[:creates].push(repo)
+          else
+            comparable_zd = zd.dup
+            comparable_repo = repo.dup
+            comparable_zd.id = nil
+            comparable_zd.custom_field_options.map { |a| a.delete('raw_name') } unless comparable_zd.custom_field_options.nil?
+            diffs[:updates].push(update_object(repo, zd)) if to_clean_json(comparable_repo) != to_clean_json(comparable_zd)
+            detailed_diff(comparable_repo, comparable_zd) if verbose && to_clean_json(comparable_repo) != to_clean_json(comparable_zd)
+          end
+        end
+        report_diffs(diffs) if verbose
+        diffs
+      end
+
+      ##
+      # Outputs a comparison report
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param diffs [Hash] The returned value of {compare}
+      def self.report_diffs(diffs)
+        puts 'Compare report:'
+        puts "- Creates: #{diffs[:creates].count}"
+        puts "- Updates: #{diffs[:updates].count}"
+      end
+
+      ##
+      # Outputs a comparison report
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::OrganizationFields}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::OrganizationFields}
+      def self.detailed_diff(repo, zendesk)
+        puts "Detailed diff of #{repo.title}"
+        repo.instance_variables.each do |v|
+          next if v == :@id
+
+          if repo.instance_variable_get(v) != zendesk.instance_variable_get(v)
+            puts "- #{v} Repo:"
+            pp repo.instance_variable_get(v)
+            puts "  #{v} Zendesk:"
+            pp zendesk.instance_variable_get(v)
+          end
+        end
+      end
+
+      ##
+      # Creates an instance of {Readiness::Zendesk::OrganizationFields} to use for updates
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::OrganizationFields}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::OrganizationFields}
+      # @return [Object]
+      def self.update_object(repo, zendesk)
+        object = repo
+        object.id = zendesk.id
+        object
+      end
+
+      ##
+      # Parses repo group files
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param location [String] The location (relative or absolute) of the repo's data folder
+      # @return [Array]
+      # @example
+      #   require 'support_readiness'
+      #   repo = Readiness::Repos::OrganizationFields.gather('organizations/fields/data')
+      #   pp repo.count
+      #   # => 35
+      def self.gather(location = 'data')
+        @errors = []
+        @location = location
+        array = []
+        Dir["#{@location}/**/*.yaml"].each do |f|
+          object = YAML.safe_load_file(f)
+          validity_check(f, object)
+          object['id'] = nil
+          array.push(Zendesk::OrganizationFields.new(object))
+        end
+        repo_check(array)
+        report_errors unless @errors.count.zero?
+        array
+      end
+
+      ##
+      # Outputs an error report and exits with a status code of 1
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.report_errors
+        puts 'The following errors were found in the repo files:'
+        @errors.each do |e|
+          puts "- #{e}"
+        end
+        puts 'Rectify the errors and retry. We cannot proceed with those errors occurring.'
+        exit 1
+      end
+
+      ##
+      # Performs basic checks on a repo file
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param file [String] The path to the repo file
+      # @param object [Hash] The Hash derived from parsing a YAML file
+      def self.validity_check(file, object)
+        folder = file.split("#{@location}/").last.split('/').first
+        @errors.push("Missing title: #{file}") if object['title'].nil?
+        @errors.push("Missing position: #{file}") if object['position'].nil?
+        @errors.push("Inactive organization field in active folder: #{file}") if folder == 'active' && !object['active']
+        @errors.push("Active organization field in inactive folder: #{file}") if folder == 'inactive' && object['active']
+      end
+
+      ##
+      # Performs basic checks on the repo
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param objects [Array] The Array of Hashes derived from parsing the repo files
+      def self.repo_check(objects)
+        duplicate_names = objects.group_by { |o| o.title }.select { |k, v| v.size > 1 }.map(&:first)
+        unless duplicate_names.count.zero?
+          duplicate_names.each do |d|
+            @errors.push("The name '#{d}' is used in multiple files")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/support_readiness/repos/sla_policies.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Repos
+  module Repos
+    ##
+    # Defines the class SLAs within the module {Readiness::Repos}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class SLAs < Readiness::Client
+      ##
+      # Compares the repo automation files to the Zendesk instance SLA policies
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param zendesk_client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param location [String] The location (relative or absolute) of the repo's data folder
+      # @param verbose [Boolean] Whether you want a detailed report or not
+      # @return [Hash]
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   diffs = Readiness::Repos::SLAs.compare(client, 'sla-polcies/data', false)
+      #   pp diffs[:updates.count]
+      #   # => 1
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   diffs = Readiness::Repos::SLAs.compare(client, 'sla-polcies/data', true)
+      #   # => Detailed diff of Support Ops
+      #   # => - @description Repo:
+      #   # => "For GitLab Support Operations"
+      #   # =>   @description Zendesk:
+      #   # => "For GitLab Support Ops"
+      #   # => Compare report:
+      #   # => - Creates: 0
+      #   # => - Updates: 1
+      #   pp diffs[:updates.count]
+      #   # => 1
+      def self.compare(zendesk_client, location = 'data', verbose = false)
+        diffs = {
+          updates: [],
+          creates: []
+        }
+        from_repo = gather(location)
+        from_zendesk = Zendesk::SLAs.list(zendesk_client)
+        from_repo.each do |repo|
+          zd = from_zendesk.detect { |z| z.title == repo.title }
+          if zd.nil?
+            diffs[:creates].push(repo)
+          else
+            comparable_zd = zd.dup
+            comparable_repo = repo.dup
+            comparable_zd.id = nil
+            comparable_zd.policy_metrics.map { |a| a.delete('target_in_seconds') }
+            comparable_zd.policy_metrics.sort_by! { |a| [a['priority'], a['metric']] }
+            comparable_repo.policy_metrics.sort_by! { |a| [a['priority'], a['metric']] }
+            diffs[:updates].push(update_object(repo, zd)) if to_clean_json(comparable_repo) != to_clean_json(comparable_zd)
+            detailed_diff(repo, comparable) if verbose && to_clean_json(comparable_repo) != to_clean_json(comparable_zd)
+          end
+        end
+        report_diffs(diffs) if verbose
+        diffs
+      end
+
+      ##
+      # Outputs a comparison report
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param diffs [Hash] The returned value of {compare}
+      def self.report_diffs(diffs)
+        puts 'Compare report:'
+        puts "- Creates: #{diffs[:creates].count}"
+        puts "- Updates: #{diffs[:updates].count}"
+      end
+
+      ##
+      # Outputs a comparison report
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::SLAs}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::SLAs}
+      def self.detailed_diff(repo, zendesk)
+        puts "Detailed diff of #{repo.title}"
+        repo.instance_variables.each do |v|
+          next if v == :@id
+
+          if repo.instance_variable_get(v) != zendesk.instance_variable_get(v)
+            puts "- #{v} Repo:"
+            pp repo.instance_variable_get(v)
+            puts "  #{v} Zendesk:"
+            pp zendesk.instance_variable_get(v)
+          end
+        end
+      end
+
+      ##
+      # Creates an instance of {Readiness::Zendesk::Groups} to use for updates
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::Groups}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::Groups}
+      # @return [Object]
+      def self.update_object(repo, zendesk)
+        object = repo
+        object.id = zendesk.id
+        object
+      end
+
+      ##
+      # Parses repo group files
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param location [String] The location (relative or absolute) of the repo's data folder
+      # @return [Array]
+      # @example
+      #   require 'support_readiness'
+      #   repo = Readiness::Repos::Groups.gather('groups/data')
+      #   pp repo.count
+      #   # => 35
+      def self.gather(location = 'data')
+        @errors = []
+        @location = location
+        array = []
+        Dir["#{@location}/*.yaml"].each do |f|
+          object = YAML.safe_load_file(f)
+          validity_check(f, object)
+          object['id'] = nil
+          array.push(Zendesk::SLAs.new(object))
+        end
+        repo_check(array)
+        report_errors unless @errors.count.zero?
+        array
+      end
+
+      ##
+      # Outputs an error report and exits with a status code of 1
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.report_errors
+        puts 'The following errors were found in the repo files:'
+        @errors.each do |e|
+          puts "- #{e}"
+        end
+        puts 'Rectify the errors and retry. We cannot proceed with those errors occurring.'
+        exit 1
+      end
+
+      ##
+      # Performs basic checks on a repo file
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param file [String] The path to the repo file
+      # @param object [Hash] The Hash derived from parsing a YAML file
+      def self.validity_check(file, object)
+        @errors.push("Missing title: #{file}") if object['title'].nil?
+        @errors.push("Missing position: #{file}") if object['position'].nil?
+      end
+
+      ##
+      # Performs basic checks on the repo
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param objects [Array] The Array of Hashes derived from parsing the repo files
+      def self.repo_check(objects)
+        duplicate_names = objects.group_by { |o| o.title }.select { |k, v| v.size > 1 }.map(&:first)
+        unless duplicate_names.count.zero?
+          duplicate_names.each do |d|
+            @errors.push("The name '#{d}' is used in multiple files")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/support_readiness/repos/ticket_fields.rb

@@ -0,0 +1,200 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Repos
+  module Repos
+    ##
+    # Defines the class TicketFields within the module {Readiness::Repos}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class TicketFields < Readiness::Client
+      ##
+      # Compares the repo ticket fields files to the Zendesk instance ticket fields
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param zendesk_client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param location [String] The location (relative or absolute) of the repo's data folder
+      # @param verbose [Boolean] Whether you want a detailed report or not
+      # @return [Hash]
+      def self.compare(zendesk_client, location = 'data', verbose = false)
+        @from_repo = gather(zendesk_client, location)
+        @from_zendesk = Zendesk::TicketFields.list(zendesk_client)
+        @diffs = {
+          field_updates: [],
+          field_creates: [],
+          option_updates: [],
+          option_deletes: []
+        }
+        @from_repo.each do |repo|
+          zd = @from_zendesk.detect { |z| z.title == repo.title }
+          if zd.nil?
+            @diffs[:field_creates].push(repo)
+            unless repo.custom_field_options.nil?
+              repo.custom_field_options.each do |o|
+                @diffs[:option_updates].push({ "#{repo.title}" => o })
+              end
+            end
+            break
+          else
+            comparable_zd = zd.dup
+            comparable_repo = repo.dup
+            comparable_zd.id = nil
+            comparable_zd.custom_field_options = nil
+            comparable_repo.custom_field_options = nil
+            @diffs[:field_updates].push(update_object(repo, zd)) if to_clean_json(comparable_zd) != to_clean_json(comparable_repo)
+            detailed_diff(comparable_repo, comparable_zd) if verbose && to_clean_json(comparable_repo) != to_clean_json(comparable_zd)
+            next if repo.custom_field_options.nil?
+
+            zd_options = @from_zendesk.detect { |z| z.title == repo.title }.custom_field_options
+            repo.custom_field_options.map! { |o| Zendesk::TicketFieldOptions.new(o) } unless repo.custom_field_options.first.is_a? Object
+            repo.custom_field_options.each do |repo_option|
+              repo_option.position = repo.custom_field_options.index(repo_option) if repo_option.position.nil?
+              zd_option = zd_options.detect { |zd_o| zd_o.name == repo_option.name }
+              if zd_option.nil? || to_clean_json(zd_option) != to_clean_json(repo_option)
+                @diffs[:option_updates].push({ "#{repo.title}" => repo_option })
+              end
+            end
+            zd_options.each do |zd_option|
+              repo_option = repo.custom_field_options.detect { |rp_o| rp_o.name == zd_option.name }
+              if repo_option.nil?
+                @diffs[:option_deletes].push({ "#{repo.title}" => zd_option })
+              end
+            end
+          end
+        end
+        report_diffs if verbose
+        @diffs
+      end
+
+      ##
+      # Outputs a comparison report
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.report_diffs
+        puts 'Compare report:'
+        puts "- Field Creates:  #{@diffs[:field_creates].count}"
+        puts "- Field Updates:  #{@diffs[:field_updates].count}"
+        puts "- Option Updates: #{@diffs[:option_updates].count}"
+        puts "- Option Deletes: #{@diffs[:option_deletes].count}"
+      end
+
+      ##
+      # Outputs a comparison report
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::TicketFields}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::TicketFields}
+      def self.detailed_diff(repo, zendesk)
+        puts "Detailed diff of #{repo.title}"
+        repo.instance_variables.each do |v|
+          next if v == :@id
+
+          if repo.instance_variable_get(v) != zendesk.instance_variable_get(v)
+            puts "- #{v} Repo:"
+            pp repo.instance_variable_get(v)
+            puts "  #{v} Zendesk:"
+            pp zendesk.instance_variable_get(v)
+          end
+        end
+      end
+
+      ##
+      # Creates an instance of {Readiness::Zendesk::TicketFields} to use for updates
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::TicketFields}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::TicketFields}
+      # @return [Object]
+      def self.update_object(repo, zendesk)
+        object = repo
+        object.id = zendesk.id
+        object
+      end
+
+      ##
+      # Parses repo ticket field files
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param location [String] The location (relative or absolute) of the repo's data folder
+      # @return [Array]
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   repo = Readiness::Repos::TicketFields.gather(client, 'tickets/forms-and-fields/data/fields')
+      #   pp repo.count
+      #   # => 170
+      def self.gather(client, location = 'data')
+        @errors = []
+        @location = location
+        array = []
+        Dir["#{@location}/**/*.yaml"].each do |f|
+          object = YAML.safe_load_file(f)
+          validity_check(f, object)
+          object['id'] = nil
+          object['title_in_portal'] = (object['visible_in_portal'] ? object['title_in_portal'] : object['title'])
+          array.push(Zendesk::TicketFields.new(client, object))
+        end
+        repo_check(array)
+        report_errors unless @errors.count.zero?
+        array
+      end
+
+      ##
+      # Outputs an error report and exits with a status code of 1
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.report_errors
+        puts 'The following errors were found in the repo files:'
+        @errors.each do |e|
+          puts "- #{e}"
+        end
+        puts 'Rectify the errors and retry. We cannot proceed with those errors occurring.'
+        exit 1
+      end
+
+      ##
+      # Performs basic checks on a repo file
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param file [String] The path to the repo file
+      # @param object [Hash] The Hash derived from parsing a YAML file
+      def self.validity_check(file, object)
+        folder = file.split("#{@location}/").last.split('/').first
+        @errors.push("Missing type: #{file}") if object['type'].nil?
+        @errors.push("Missing title: #{file}") if object['title'].nil?
+        @errors.push("Missing position: #{file}") if object['position'].nil?
+        @errors.push("Inactive ticket field in active folder: #{file}") if folder == 'active' && !object['active']
+        @errors.push("Active ticket field in inactive folder: #{file}") if folder == 'inactive' && object['active']
+      end
+
+      ##
+      # Performs basic checks on the repo
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param objects [Array] The Array of Hashes derived from parsing the repo files
+      def self.repo_check(objects)
+        duplicate_names = objects.group_by { |o| o.title }.select { |k, v| v.size > 1 }.map(&:first)
+        unless duplicate_names.count.zero?
+          duplicate_names.each do |d|
+            @errors.push("The title '#{d}' is used in multiple files")
+          end
+        end
+      end
+    end
+  end
+end