gitlab_support_readiness 1.0.11 → 1.0.12

data/lib/support_readiness/repos/views.rb

@@ -0,0 +1,362 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Repos
+  module Repos
+    ##
+    # Defines the class Views within the module {Readiness::Repos}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Views < Readiness::Client
+      ##
+      # Compares the repo view files to the Zendesk instance Views
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param config [Object] An instance of {Readiness::Zendesk::Configuration}
+      # @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::Views.compare(config, client, 'views/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::Views.compare(config, client, 'views/data', true)
+      #   # => Detailed diff of Status::Close::Close solved tickets after 7 days
+      #   # => - @default Repo:
+      #   # => false
+      #   # =>   @default Zendesk:
+      #   # => true
+      #   # => Compare report:
+      #   # => - Creates: 0
+      #   # => - Updates: 1
+      #   pp diffs[:updates.count]
+      #   # => 1
+      def self.compare(config, zendesk_client, location = 'data', verbose = false)
+        diffs = {
+          updates: [],
+          creates: []
+        }
+        from_repo = gather(config, location)
+        from_zendesk = Zendesk::Views.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::Views}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::Views}
+      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::Views} to use for updates
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param repo [Object] An instance of {Readiness::Zendesk::Views}
+      # @param zendesk [Object] An instance of {Readiness::Zendesk::Views}
+      # @return [Object]
+      def self.update_object(repo, zendesk)
+        object = repo
+        object.id = zendesk.id
+        object
+      end
+
+      ##
+      # Parses repo view files
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param config [Object] An instance of {Readiness::Zendesk::Configuration}
+      # @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'
+      #   repo = Readiness::Repos::Views.gather(config, 'views/data')
+      #   pp repo.count
+      #   # => 35
+      def self.gather(config, location = 'data')
+        @errors = []
+        @location = location
+        array = []
+        Dir["#{@location}/{active,inactive}/*.yaml"].each do |f|
+          object = YAML.safe_load_file(f)
+          object = convert_managed_content(config, object)
+          validity_check(f, object)
+          object['id'] = nil
+          array.push(Zendesk::Views.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 view in active folder: #{file}") if folder == 'active' && !object['active']
+        @errors.push("Active view 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 config [Object] An instance of {Readiness::Zendesk::Configuration}
+      # @param object [Hash] The Hash derived from parsing a YAML file
+      def self.convert_managed_content(config, object)
+        path = "#{@location}/managed_content/#{object['active'] ? '' : 'in'}active/#{object['title'].gsub('/', '_')}.yaml"
+        handle_request_error(1, 'Repos', 404, { action: 'Get managed content', id: object['title'] }) unless File.exist?(path)
+        conversion = YAML.safe_load_file("#{@location}/managed_content/fields.yaml")
+        data = YAML.safe_load_file(path)
+        object['execution'] = {
+          "group_by" => (data['group_by'].nil? ? nil : conversion.detect { |c| c['name'] == data['group_by'] }['id'].to_s),
+          "group_order" => data['group_order'],
+          "sort_by" => (data['sort_by'].nil? ? nil : conversion.detect { |c| c['name'] == data['sort_by'] }['id'].to_s),
+          "sort_order" => data['sort_order'],
+          "group" => convert_group(config, data, conversion),
+          "sort" => convert_sort(config, data, conversion),
+          "columns" => convert_columns(config, data, conversion),
+          "fields" => convert_fields(data, conversion),
+          "custom_fields" => convert_custom_fields(config, data, conversion),
+        }
+        object
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.convert_columns(config, object, conversion)
+        array = []
+        object['fields'].each do |f|
+          c = conversion.detect { |c| c['name'] == f }
+          o = {
+            "id" => c['id'],
+            "title" => c['name'],
+            "type" => nil,
+            "url" => nil,
+            "filterable" => filterable?(c),
+            "sortable" => sortable?(c),
+          }
+          o['type'] = c['type'] if c['custom']
+          o['url'] = "#{config.url}/ticket_fields/#{c['id']}.json" if c['custom']
+          array.push(o.compact)
+        end
+        array
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.convert_fields(object, conversion)
+        array = []
+        object['fields'].each do |f|
+          c = conversion.detect { |c| c['name'] == f }
+          next if c['custom']
+          o = {
+            "id" => c['id'],
+            "title" => c['name'],
+            "filterable" => filterable?(c),
+            "sortable" => sortable?(c),
+          }
+          array.push(o)
+        end
+        array
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.convert_custom_fields(config, object, conversion)
+        array = []
+        object['fields'].each do |f|
+          c = conversion.detect { |c| c['name'] == f }
+          next unless c['custom']
+          o = {
+            "id" => c['id'],
+            "title" => c['name'],
+            "type" => c['type'],
+            "url" => "#{config.url}/ticket_fields/#{c['id']}.json",
+            "filterable" => filterable?(c),
+            "sortable" => sortable?(c)
+          }
+          array.push(o.compact)
+        end
+        array.sort_by { |a| a['id'] }
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.convert_sort(config, object, conversion)
+        return nil if object['sort_by'].nil?
+
+        c = conversion.detect { |c| c['name'] == object['sort_by'] }
+        sort = {
+          "id" => c['id'],
+          "title" => c['name'],
+          "type" => nil,
+          "url" => nil,
+          "filterable" => filterable?(c),
+          "sortable" => sortable?(c),
+          "order" => object['sort_order']
+        }
+        sort['type'] = c['type'] if c['custom']
+        sort['url'] = "#{config.url}/ticket_fields/#{c['id']}.json" if c['custom']
+        sort.compact
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.convert_group(config, object, conversion)
+        return nil if object['group_by'].nil?
+
+        c = conversion.detect { |c| c['name'] == object['group_by'] }
+        group = {
+          "id" => c['id'],
+          "title" => c['name'],
+          "type" => nil,
+          "url" => nil,
+          "filterable" => filterable?(c),
+          "sortable" => sortable?(c),
+          "order" => object['group_order']
+        }
+        group['type'] = c['type'] if c['custom']
+        group['url'] = "#{config.url}/ticket_fields/#{c['id']}.json" if c['custom']
+        group.compact
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.sortable?(data)
+        return false if data['name'] == 'Subject'
+
+        true
+      end
+
+      ##
+      # Performs conversions for a repo file using managed content
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      def self.filterable?(data)
+        return false if data['name'] == 'Subject'
+        return false if data['name'] == 'Requested'
+        return false if data['type'] == 'text'
+
+        true
+      end
+    end
+  end
+end

data/lib/support_readiness/repos.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  ##
+  # Defines the module Repos
+  # @author Jason Colyer
+  # @since 1.0.12
+  module Repos
+    require "#{__dir__}/repos/articles"
+    require "#{__dir__}/repos/automations"
+    require "#{__dir__}/repos/groups"
+    require "#{__dir__}/repos/macros"
+    require "#{__dir__}/repos/organization_fields"
+    require "#{__dir__}/repos/sla_policies"
+    require "#{__dir__}/repos/ticket_fields"
+    require "#{__dir__}/repos/ticket_forms"
+    require "#{__dir__}/repos/triggers"
+    require "#{__dir__}/repos/user_fields"
+    require "#{__dir__}/repos/views"
+  end
+end

data/lib/support_readiness/salesforce/accounts.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Salesforce
+  module Salesforce
+    ##
+    # Defines the class Accounts within the module {Readiness::Salesforce}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Accounts < Readiness::Client
+      ##
+      # Updates an Account in Salesforce. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Salesforce::Client}
+      # @param aid [String] The ID of the Account to update
+      # @param args [Various] This allows for multiple 'key: value' entries when calling the function
+      # @return [Boolean]
+      # @example
+      #   config = Readiness::Salesforce::Configuration.new
+      #   config.api_version = '58.0'
+      #   config.client_id = ENV.fetch('SFDC_CLIENTID')
+      #   config.client_secret = ENV.fetch('SFDC_CLIENTSECRET')
+      #   config.password = ENV.fetch('SFDC_PASSWORD')
+      #   config.security_token = ENV.fetch('SFDC_SECURITYTOKEN')
+      #   config.username = ENV.fetch('SFDC_USERNAME')
+      #   client = Readiness::Salesforce::Client.new(config)
+      #   result = Readiness::Salesforce::Client.update!(client, '0016100000AYvx9', Support_Hold__c: false, Support_Instance__c: 'federal-support')
+      #   pp result
+      #   # => true
+      #   result = Readiness::Salesforce::Client.update!(client, '0016100000AYvx9', Restricted_Account__c: nil)
+      #   pp result
+      #   # => true
+      def self.update!(client, aid, **args)
+        client.connection.update!('Account', Id: aid, **args)
+        true
+      end
+
+      ##
+      # Determines if a SFDC Account is US Government enabled.
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Salesforce::Client}
+      # @param aid [String] The ID of the Account to check
+      # @return [Boolean]
+      # @example
+      #   config = Readiness::Salesforce::Configuration.new
+      #   config.api_version = '58.0'
+      #   config.client_id = ENV.fetch('SFDC_CLIENTID')
+      #   config.client_secret = ENV.fetch('SFDC_CLIENTSECRET')
+      #   config.password = ENV.fetch('SFDC_PASSWORD')
+      #   config.security_token = ENV.fetch('SFDC_SECURITYTOKEN')
+      #   config.username = ENV.fetch('SFDC_USERNAME')
+      #   client = Readiness::Salesforce::Client.new(config)
+      #   pp Readiness::Salesforce::Client.us_gover_enabled?(client, '0016100000AYvx9')
+      #   # => false
+      def self.us_gov_enabled?(client, aid)
+        query = Queries.new(us_gov_check_query_string(aid))
+        results = Queries.run!(client, query)
+        return false if results.count.zero?
+        return false if results.first.Support_Hold__c
+        return false unless results.first.Restricted_Account__c.nil?
+        return true if results.first.Support_Instance__c == 'federal-support'
+
+        if results.first.Account_Demographics_Territory__c =~ /^PUBSEC/
+          if results.first.Account_Demographics_Territory__c != 'PUBSEC_'
+            return true unless results.first.Account_Demographics_Territory__c =~ /SLED/
+          end
+        end
+        false
+      end
+
+      ##
+      # Provides the String needed to make a specific type of SOQL query
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param aid [String] The ID of the Account to check
+      # @return [String]
+      def self.us_gov_check_query_string(aid)
+        <<~STRING
+          SELECT
+            Restricted_Account__c,
+            Support_Hold__c,
+            Support_Instance__c,
+            Account_Demographics_Territory__c,
+            (
+              SELECT
+                Id,
+                Name,
+                Zuora__ProductName__c,
+                Zuora__EffectiveEndDate__c,
+                Zuora__Quantity__c,
+                Zuora__TotalContractValue__c,
+                Subscription_Status__c
+              FROM Zuora__R00N40000001lGjTEAU__r
+            )
+          FROM Account
+          WHERE
+          Account_ID_18__c = '#{aid}'
+        STRING
+      end
+    end
+  end
+end

data/lib/support_readiness/salesforce/cases.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Salesforce
+  module Salesforce
+    ##
+    # Defines the class Cases within the module {Readiness::Salesforce}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Cases < Readiness::Client
+      attr_accessor :AccountId, :Description, :Id, :OwnerId, :Priority, :RecordTypeId, :Status, :Subject, :Zendesk_Support_Ticket_ID__c, :Zendesk_Support_Ticket_Requester_Email__c, :Zendesk_Support_Ticket_URL__c
+
+      ##
+      # Creates a new {Readiness::Salesforce::Cases} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param object [Object] An instance of {Readiness::Salesforce::Cases}
+      # @example
+      #   require 'support_readiness'
+      #   item = Readiness::Salesforce::Cases.new
+      def initialize(object = {})
+        @AccountId = object['AccountId']
+        @Description = object['Description']
+        @Id = object['Id']
+        @OwnerId = object['OwnerId']
+        @Priority = object['Priority']
+        @RecordTypeId = object['RecordTypeId']
+        @Status = object['Status']
+        @Subject = object['Subject']
+        @Zendesk_Support_Ticket_ID__c = object['Zendesk_Support_Ticket_ID__c']
+        @Zendesk_Support_Ticket_Requester_Email__c = object['Zendesk_Support_Ticket_Requester_Email__c']
+        @Zendesk_Support_Ticket_URL__c = object['Zendesk_Support_Ticket_URL__c']
+      end
+
+      ##
+      # Creates a Case in Salesforce. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Salesforce::Client}
+      # @param object [Object] An instance of {Readiness::Salesforce::Cases}
+      # @return [Boolean]
+      # @example
+      #   config = Readiness::Salesforce::Configuration.new
+      #   config.api_version = '58.0'
+      #   config.client_id = ENV.fetch('SFDC_CLIENTID')
+      #   config.client_secret = ENV.fetch('SFDC_CLIENTSECRET')
+      #   config.password = ENV.fetch('SFDC_PASSWORD')
+      #   config.security_token = ENV.fetch('SFDC_SECURITYTOKEN')
+      #   config.username = ENV.fetch('SFDC_USERNAME')
+      #   client = Readiness::Salesforce::Client.new(config)
+      #   item = Readiness::Salesforce::Cases.new
+      #   item.AccountId = '001ABC123'
+      #   item.Description = 'Test description'
+      #   item.Id = '500ABC123'
+      #   item.OwnerId = '0054ABC123'
+      #   item.Priority = 'Normal'
+      #   item.Status = 'Closed'
+      #   item.Subject = 'Test subject'
+      #   item.Zendesk_Support_Ticket_ID__c = '123456'
+      #   item.Zendesk_Support_Ticket_Requester_Email__c = 'alice@example.com'
+      #   item.Zendesk_Support_Ticket_URL__c = 'https://gitlab.zendesk.com/agent/tickets/123456'
+      #   pp Readiness::Salesforce::Cases.update!(client, item)
+      #   # => true
+      # returns case ID as String
+      def self.create!(client, object)
+        client.connection.create!('Case', to_clean_json(object))
+      end
+
+      ##
+      # Updates a Case in Salesforce. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Salesforce::Client}
+      # @param object [Object] An instance of {Readiness::Salesforce::Cases}
+      # @return [Boolean]
+      # @example
+      #   config = Readiness::Salesforce::Configuration.new
+      #   config.api_version = '58.0'
+      #   config.client_id = ENV.fetch('SFDC_CLIENTID')
+      #   config.client_secret = ENV.fetch('SFDC_CLIENTSECRET')
+      #   config.password = ENV.fetch('SFDC_PASSWORD')
+      #   config.security_token = ENV.fetch('SFDC_SECURITYTOKEN')
+      #   config.username = ENV.fetch('SFDC_USERNAME')
+      #   client = Readiness::Salesforce::Client.new(config)
+      #   item = Readiness::Salesforce::Cases.new
+      #   item.AccountId = '001ABC123'
+      #   item.Description = 'Test description'
+      #   item.Id = '500ABC123'
+      #   item.OwnerId = '0054ABC123'
+      #   item.Priority = 'Normal'
+      #   item.RecordTypeId: '012123ABC'
+      #   item.Status = 'Closed'
+      #   item.Subject = 'Test subject'
+      #   item.Zendesk_Support_Ticket_ID__c = '123456'
+      #   item.Zendesk_Support_Ticket_Requester_Email__c = 'alice@example.com'
+      #   item.Zendesk_Support_Ticket_URL__c = 'https://gitlab.zendesk.com/agent/tickets/123456'
+      #   pp Readiness::Salesforce::Cases.update!(client, item)
+      #   # => true
+      def self.update!(client, object)
+        client.connection.update!('Case', to_hash(object))
+      end
+    end
+  end
+end

data/lib/support_readiness/salesforce/client.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  ##
+  # Defines the module Salesforce
+  module Salesforce
+    ##
+    # Defines the class Client within the module {Readiness::Salesforce}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Client
+      attr_accessor :connection
+
+      ##
+      # Creates a new {Readiness::Salesforce::Client} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param config [Object] An instance of {Readiness::Salesforce::Configuration}
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Salesforce::Configuration.new
+      #   config.api_version = '58.0'
+      #   config.client_id = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789'
+      #   config.client_secret = 'XYZ789'
+      #   config.password = 'p@ssw0rd!'
+      #   config.security_token = 'ABC123'
+      #   config.username = 'alice@example.com'
+      #   client = Readiness::Salesforce::Client.new(config)
+      def initialize(config = Readiness::Salesforce::Configuration.new)
+        @connection = generate_connection(config)
+      end
+
+      ##
+      # Generates a connection to Salesforce
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param config [Object] An instance of {Readiness::Salesforce::Configuration}
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Salesforce::Configuration.new
+      #   config.api_version = '58.0'
+      #   config.client_id = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789'
+      #   config.client_secret = 'XYZ789'
+      #   config.password = 'p@ssw0rd!'
+      #   config.security_token = 'ABC123'
+      #   config.username = 'alice@example.com'
+      #   connection = Readiness::Salesforce::Client.generate_connection(config)
+      def generate_connection(config)
+        Restforce.new(
+          api_version: config.api_version,
+          client_id: config.client_id,
+          client_secret: config.client_secret,
+          password: config.password,
+          security_token: config.security_token,
+          username: config.username
+        )
+      end
+    end
+  end
+end