gitlab_support_readiness 1.0.11 → 1.0.13

data/lib/support_readiness/repos/triggers.rb

@@ -0,0 +1,255 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Repos
+  module Repos
+    ##
+    # Defines the class Triggers within the module {Readiness::Repos}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Triggers < Readiness::Client
+      ##
+      # Compares the repo trigger files to the Zendesk instance triggers
+      #
+      # @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::Triggers.compare(client, 'triggers/data', false)
+      #   pp diffs[:updates.count]
+      #   # => 5
+      # @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::Triggers.compare(client, 'triggers/data', true)
+      #   # => Detailed diff of Cleanup followup tickets
+      #   # => - @position Repo:
+      #   # => 13
+      #   # =>   @position Zendesk:
+      #   # => 12
+      #   # => Detailed diff of New Billing ticket created via Webform
+      #   # => - @position Repo:
+      #   # => 11
+      #   # =>   @position Zendesk:
+      #   # => 10
+      #   # => Compare report:
+      #   # => - Creates: 0
+      #   # => - Updates: 2
+      #   pp diffs[:updates.count]
+      #   # => 2
+      def self.compare(zendesk_client, location = 'data', verbose = false)
+        diffs = {
+          updates: [],
+          creates: []
+        }
+        from_repo = gather(location)
+        from_zendesk = Zendesk::Triggers.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.dup
+            comparable.id = nil
+            diffs[:updates].push(update_object(repo, zd)) if to_clean_json(repo) != to_clean_json(comparable)
+            detailed_diff(repo, comparable) if verbose && to_clean_json(repo) != to_clean_json(comparable)
+          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::Triggers}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::Triggers}
+      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::Triggers} to use for updates
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::Triggers}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::Triggers}
+      # @return [Object]
+      def self.update_object(repo, zendesk)
+        object = repo
+        object.id = zendesk.id
+        object
+      end
+
+      ##
+      # Parses repo trigger 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::Triggers.gather('triggers/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)
+          object = convert_managed_content(object, f) if object['contains_managed_content']
+          object['default'] = false
+          #object = convert_managed_webhook(object, f) if object['contains_managed_webhook']
+          validity_check(f, object)
+          object['id'] = nil
+          array.push(Zendesk::Triggers.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 position: #{file}") if object['position'].nil?
+        @errors.push("Missing title: #{file}") if object['title'].nil?
+        @errors.push("Inactive trigger in active folder: #{file}") if folder == 'active' && !object['active']
+        @errors.push("Active trigger 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
+
+      ##
+      # Performs conversions for a repo file if using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param object [Hash] The Hash derived from parsing a YAML file
+      def self.convert_managed_content(object, file)
+        category = file.split("#{@location}/#{object['active'] ? '' : 'in' }active/").last.split('/').first
+        path = "#{@location}/managed_content/#{category}/#{object['title']}.md"
+        handle_request_error(1, 'Repos', 404, { action: 'Get managed content', id: object['title'] }) unless File.exist?(path)
+        object['actions'].each_with_index do |action, index|
+          if action['value'].is_a?(String)
+            if action['value'] =~ /MANAGED_CONTENT/
+              if action['value'] == 'MANAGED_CONTENT'
+                object['actions'][index]['value'] = action['value'].gsub('MANAGED_CONTENT', File.read(path).chomp)
+              else
+                object['actions'][index]['value'] = action['value'].gsub('MANAGED_CONTENT', File.read(path).chomp.gsub("\n", '\\n'))
+              end
+            end
+          elsif action['value'].is_a?(Array)
+            action['value'].each_with_index do |value, sub_index|
+              if value =~ /MANAGED_CONTENT/
+                if value == 'MANAGED_CONTENT'
+                  object['actions'][index]['value'][sub_index] = value.gsub('MANAGED_CONTENT', File.read(path).chomp)
+                else
+                  object['actions'][index]['value'][sub_index] = value.gsub('MANAGED_CONTENT', File.read(path).chomp.gsub("\n", '\\n'))
+                end
+              end
+            end
+          end
+        end
+        object
+      end
+
+      ##
+      # Performs conversions for a repo file if using managed webhooks
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param object [Hash] The Hash derived from parsing a YAML file
+      def self.convert_managed_webhook(object, file)
+        category = file.split("#{@location}/#{object['active'] ? '' : 'in' }active/").last.split('/').first
+        path = "#{@location}/managed_content/#{category}/#{object['title']}.webhook"
+        handle_request_error(1, 'Repos', 404, { action: 'Get managed webhook', id: object['title'] }) unless File.exist?(path)
+        object['actions'].each_with_index do |action, index|
+          next unless action['value'].is_a?(Array)
+
+          action['value'].each_with_index do |value, sub_index|
+            next unless value == 'MANAGED_WEBHOOK'
+
+            object['actions'][index]['value'][sub_index] = JSON.parse(File.read(path))
+          end
+        end
+        object
+      end
+    end
+  end
+end

data/lib/support_readiness/repos/user_fields.rb

@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Repos
+  module Repos
+    ##
+    # Defines the class UserFields within the module {Readiness::Repos}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class UserFields < Readiness::Client
+      ##
+      # Compares the repo user fields files to the Zendesk instance user 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::UserFields.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?
+            pp @from_zendesk
+            pp repo
+            @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
+          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::UserFieldOptions.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::UserFields}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::UserFields}
+      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::UserFields} to use for updates
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::UserFields}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::UserFields}
+      # @return [Object]
+      def self.update_object(repo, zendesk)
+        object = repo
+        object.id = zendesk.id
+        object
+      end
+
+      ##
+      # Parses repo user 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::UserFields.gather(client, 'users/fields/data')
+      #   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::UserFields.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 user field in active folder: #{file}") if folder == 'active' && !object['active']
+        @errors.push("Active user 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