eco-helpers 3.0.4 → 3.0.6

data/lib/eco/api/usecases/graphql/helpers/location/base/classifications_parser.rb

@@ -10,7 +10,9 @@ module Eco::API::UseCases::GraphQL::Helpers::Location
       #   2. If the value is wrong, it warns and returns `nil`
       def to_classification(value)
         return nil unless node_classifications?
+
         raise ArgumentError, "Expecting a single element. Given: #{value.class}" if value.is_a?(Enumerator)
+
         return nil unless value.is_a?(String)
 
         node_classifications.to_id(value).tap do |type|
@@ -28,7 +30,9 @@ module Eco::API::UseCases::GraphQL::Helpers::Location
       #   2. If the value is wrong, it warns and returns `nil`
       def to_classification_name(value)
         return nil unless node_classifications?
+
         raise ArgumentError, "Expecting a single element. Given: #{value.class}" if value.is_a?(Enumerator)
+
         return nil unless value.is_a?(String)
 
         node_classifications.to_name(value) do |name|
@@ -46,6 +50,7 @@ module Eco::API::UseCases::GraphQL::Helpers::Location
 
       def unknown_clasification!(value)
         return if unknown_classifications.include?(value)
+
         unknown_classifications << value
         log(:warn) {
           "Unknown location node classification '#{value}'"

data/lib/eco/api/usecases/graphql/helpers/location/command/diffs/stages/commandable.rb

@@ -12,6 +12,7 @@ class Eco::API::UseCases::GraphQL::Helpers::Location::Command::Diffs
       module ClassMethods
         def stage_command(stage)
           return :update if stage == :id_name
+
           stage
         end
       end
@@ -37,6 +38,7 @@ class Eco::API::UseCases::GraphQL::Helpers::Location::Command::Diffs
 
       def stage_diffs(stage)
         raise "There is NO support for stage '#{stage}'. Please review" unless respond_to?(stage)
+
         sort_diffs(stage) do
           send(stage)
         end

data/lib/eco/api/usecases/graphql/helpers/location/command/diffs/stages/diff_sortable.rb

@@ -20,6 +20,7 @@ class Eco::API::UseCases::GraphQL::Helpers::Location::Command::Diffs
       # @yieldreturn [Array<Diff>] the raw diffs of `stage`
       def sort_diffs(stage)
         raise ArgumentError, "Expecting block but not given" unless block_given?
+
         raw_diffs = yield
 
         case stage
@@ -41,6 +42,7 @@ class Eco::API::UseCases::GraphQL::Helpers::Location::Command::Diffs
       def uniq_archive_token(raw_diffs, stage)
         raw_diffs.group_by(&:archived_token_prev).each_with_object([]) do |(token, token_diffs), out|
           next out.concat(token_diffs) unless token
+
           out << sort_top_to_bottom(token_diffs, stage).first
         end
       end

data/lib/eco/api/usecases/graphql/helpers/location/command/result.rb

@@ -58,7 +58,8 @@ module Eco::API::UseCases::GraphQL::Helpers::Location::Command
     end
 
     def command_id
-      return nil unless result
+      return unless result
+
       command_result["id"]
     end
 

data/lib/eco/api/usecases/graphql/helpers/location/command/results.rb

@@ -124,14 +124,17 @@ module Eco::API::UseCases::GraphQL::Helpers::Location::Command
     # First error is relevant only if request was NOT forced to continue.
     def first_err_str
       return '' if force?
+
       pre_str = 'stopped on node'
       pre_str = 'first error' unless force?
+
       "(#{pre_str}: '#{first_errored&.node_id}' - idx: #{first_errored_idx})"
     end
 
     # Last successfully applied is relevant only if request was NOT forced to continue.
     def last_okay_str
       return '' if force?
+
       "(last node done: '#{last_applied&.node_id}' - idx: #{last_applied_idx})"
     end
   end

data/lib/eco/api/usecases/graphql/helpers/location/command.rb

@@ -36,6 +36,7 @@ module Eco::API::UseCases::GraphQL::Helpers::Location
         msg  = "#{dry_run_msg}No commands for '#{desc}'."
         msg << " Skipping batch..." unless simulate?
         log(:info) { msg }
+
         return
       end
 

data/lib/eco/api/usecases/graphql/helpers/location/tags_remap.rb

@@ -21,6 +21,7 @@ module Eco::API::UseCases::GraphQL::Helpers::Location
     def to_csv(filename)
       CSV.open(filename, "w") do |fd|
         fd << %w[src_tags dst_tags]
+
         each do |tags_map|
           fd << tags_map.to_csv_row
         end
@@ -64,12 +65,14 @@ module Eco::API::UseCases::GraphQL::Helpers::Location
 
     def <<(pair)
       raise ArgumentError, "Expecting pair of Array in Array. Given: #{pair}" unless self.class.correct_pair?(pair)
+
       add(*pair)
     end
 
     def add(from, to)
       raise ArgumentError, "Expecting Array. Given: #{from.class}" unless from.is_a?(Array)
       raise ArgumentError, "Expecting Array. Given: #{to.class}"   unless to.is_a?(Array)
+
       new_src TagsMap.new(from, to)
     end
 

data/lib/eco/api/usecases/graphql/samples/location/command/service/tree_update.rb

@@ -28,6 +28,7 @@ class Eco::API::UseCases::GraphQL::Samples::Location
         # @note this is an additional necessary step
         def re_archive
           return if simulate?
+
           stage = :rearchive
 
           nodes_diff_class.new(
@@ -75,6 +76,7 @@ class Eco::API::UseCases::GraphQL::Samples::Location
         #   2. `REMOTE_FOLDER` const
         def close_handling_tags_remap_csv
           return false unless super
+
           upload(tags_remap_csv_file) unless remote_subfolder.nil?
           true
         end

data/lib/eco/api/usecases/graphql/samples/location/command/track_changed_ids.rb

@@ -71,6 +71,7 @@ class Eco::API::UseCases::GraphQL::Samples::Location
     # Generates the final tags remap file
     def generate_tags_remap_csv(filename = tags_remap_csv_full_filename)
       return nil if tags_remap_table.empty?
+
       timestamp_file(filename).tap do |file|
         CSV.open(file, 'w') do |csv|
           csv << %w[prev_node_ids new_node_ids]

data/lib/eco/api/usecases/graphql/samples/location/service/tree_diff/convertible/parsing/classifications.rb

@@ -13,6 +13,7 @@ module Eco::API::UseCases::GraphQL::Samples::Location::Service
 
           def transform_classifications(row)
             return row if node_classifications_maping.empty?
+
             row['classifications'] = into_a(row['classifications']).map do |type|
               node_classifications_map(type)
             end.join('|')
@@ -21,6 +22,7 @@ module Eco::API::UseCases::GraphQL::Samples::Location::Service
           # Helper to map classifications
           def node_classifications_map(value)
             return value unless node_classifications_maping.key?(value)
+
             node_classifications_maping[value]
           end
 

data/lib/eco/api/usecases/graphql/samples/location/service/tree_diff.rb

@@ -92,7 +92,9 @@ module Eco::API::UseCases::GraphQL::Samples
 
       def live_nodes_list
         @live_nodes_list ||= as_nodes_json(input_tagtree).tap do |list|
-          log(:info) { "Converted live tree to list of #{list.count} hash-nodes" }
+          log(:info) {
+            "Converted live tree to list of #{list.count} hash-nodes"
+          }
         end
       end
 
@@ -103,7 +105,9 @@ module Eco::API::UseCases::GraphQL::Samples
       #   2. `org_tree` is native from `Eco::Data::Locations::NodeBase::CsvConvert`
       def file_nodes_list
         @file_nodes_list ||= as_nodes_json(file_tree).tap do |list|
-          log(:info) { "Converted input csv file to list of #{list.count} hash-nodes" }
+          log(:info) {
+            "Converted input csv file to list of #{list.count} hash-nodes"
+          }
         end
       end
 

data/lib/eco/api/usecases/graphql/samples/location/service/tree_to_list/converter/parser.rb

@@ -12,8 +12,10 @@ module Eco::API::UseCases::GraphQL::Samples::Location::Service
 
         def node_parser_block
           return @node_parser_block if instance_variable_defined?(:@node_parser_block)
+
           custom_before = custom_node_parser_before_block
           custom_after  = custom_node_parser_block
+
           @node_parser_block = proc do |node_hash, node|
             node_hash.tap do
               custom_before&.call(node_hash, node)
@@ -25,12 +27,14 @@ module Eco::API::UseCases::GraphQL::Samples::Location::Service
 
         # Grabs the custom node parser that runs after the generic one
         def custom_node_parser_block
-          return nil unless respond_to?(:custom_node_parser, true)
+          return unless respond_to?(:custom_node_parser, true)
+
           method(:custom_node_parser)
         end
 
         def custom_node_parser_before_block
-          return nil unless respond_to?(:custom_node_parser_before, true)
+          return unless respond_to?(:custom_node_parser_before, true)
+
           method(:custom_node_parser_before)
         end
 

data/lib/eco/api/usecases/graphql/samples/location/service/tree_to_list/converter.rb

@@ -22,9 +22,11 @@ module Eco::API::UseCases::GraphQL::Samples::Location::Service
         end.each_with_object([]) do |node, list|
           list << node.as_json(include_children: false).transform_keys do |key|
             next key unless node_attr_maps.key?(key)
+
             node_attr_maps[key]
           end.tap do |node_hash|
             node_parser_block&.call(node_hash, node)
+
             yield(node_hash, node) if block_given?
           end
         end.compact.reject(&:empty?)

data/lib/eco/api/usecases/ooze_cases/export_register_case.rb

@@ -41,6 +41,7 @@ class Eco::API::UseCases::OozeCases::ExportRegisterCase < Eco::API::UseCases::Oo
   def build_tags_filter(mode = :any)
     tags = option_tags(mode)
     return nil if !tags || tags.empty?
+
     tags_filter(tags, any: mode == :any)
   end
 

data/lib/eco/api/usecases/ooze_samples/helpers_migration/copying.rb

@@ -1,16 +1,21 @@
+# rubocop:disable Lint/DuplicateBranch
 class Eco::API::UseCases::OozeSamples
   module HelpersMigration
     module Copying
+      include Eco::Language::AuxiliarLogger
+
       def session
         defined?(super)? super : @session
       end
 
-      def logger
-        session.logger
-      end
-
       def copy_generic_paired_fields(src, dst, src_excluded: [], dst_excluded: [], exclude_ximport: false)
-        HelpersMigration::TypedFieldsPairing.new(src, dst, src_excluded: src_excluded, dst_excluded: dst_excluded, exclude_ximport: false).tap do |pairing|
+        HelpersMigration::TypedFieldsPairing.new(
+          src,
+          dst,
+          src_excluded:    src_excluded,
+          dst_excluded:    dst_excluded,
+          exclude_ximport: exclude_ximport
+        ).tap do |pairing|
           pairing.each_pair do |src_fld, dst_fld|
             copy_field_content(src_fld, dst_fld)
             yield(src_fld, dst_fld, pairing) if block_given?
@@ -21,18 +26,35 @@ class Eco::API::UseCases::OozeSamples
       def copy_hooked_fields(src, dst, hook:, type:, fields_tracker: nil, src_excluded: [], dst_excluded: [])
         case hook
         when String
-          with_src_dst_field_pair(src, dst, label: to_regex(hook), type: type, src_excluded: src_excluded, dst_excluded: dst_excluded) do |src_fld, dst_fld|
-            copy_field_content(src_fld, dst_fld).tap do |result|
-              fields_tracker.resolve(src_fld, dst_fld) if fields_tracker
+          with_src_dst_field_pair(
+            src,
+            dst,
+            label:        to_regex(hook),
+            type:         type,
+            src_excluded: src_excluded,
+            dst_excluded: dst_excluded
+          ) do |src_fld, dst_fld|
+            copy_field_content(src_fld, dst_fld).tap do
+              fields_tracker&.resolve(src_fld, dst_fld)
               yield(src_fld, dst_fld, fields_tracker) if block_given?
             end
           end
         when Hash
           hook.each do |hook_src, hook_dst|
-            src_lab, dst_lab = to_regex(hook_src), to_regex(hook_dst)
-            with_src_dst_field_pair(src, dst, label: src_lab, label_dst: dst_lab, type: type, src_excluded: src_excluded, dst_excluded: dst_excluded) do |src_fld, dst_fld|
-              copy_field_content(src_fld, dst_fld).tap do |result|
-                fields_tracker.resolve(src_fld, dst_fld) if fields_tracker
+            src_lab = to_regex(hook_src)
+            dst_lab = to_regex(hook_dst)
+
+            with_src_dst_field_pair(
+              src,
+              dst,
+              label:        src_lab,
+              label_dst:    dst_lab,
+              type:         type,
+              src_excluded: src_excluded,
+              dst_excluded: dst_excluded
+            ) do |src_fld, dst_fld|
+              copy_field_content(src_fld, dst_fld).tap do
+                fields_tracker&.resolve(src_fld, dst_fld)
                 yield(src_fld, dst_fld, fields_tracker) if block_given?
               end
             end
@@ -46,60 +68,72 @@ class Eco::API::UseCases::OozeSamples
 
       # @note
       #   - When used with `type: nil` it may pair fields of different type. There isn't refinement for this yet.
-      def with_src_dst_field_pair(src, dst, label: nil, label_dst: label, type: nil, src_excluded: [], dst_excluded: [])
-        unless respond_to?(:with_fields, true)
-          raise "These helpers are to be included in class cases inheriting from Eco::API::UseCases::OozeSamples::RegisterUpdateCase"
-        end
+      def with_src_dst_field_pair(src, dst, label: nil, label_dst: label, type: nil, src_excluded: [], dst_excluded: []) # rubocop:disable Metrics/AbcSize
+        msg = "These helpers are to be included in class cases inheriting from Eco::API::UseCases::OozeSamples::RegisterUpdateCase"
+        raise msg unless respond_to?(:with_fields, true)
+
         src_flds = with_fields(src, label: label, type: type)
         dst_flds = with_fields(dst, label: label_dst, type: type)
-        src_fld, dst_fld = src_flds.first, dst_flds.first
+        src_fld  = src_flds.first
+        dst_fld  = dst_flds.first
 
         # Not found
         if dst_flds.empty? || src_flds.empty?
-          msg = "There isn't a '#{type}'"
+          msg     = "There isn't a '#{type}'"
           dst_msg = dst_flds.empty?? "destination field named '#{label_dst}'" : nil
           src_msg = src_flds.empty?? "source field named '#{label}'" : nil
-          msg << " #{[dst_msg, src_msg].join(" or ")} (source: '#{src.id}')"
-          logger.warn(msg)
+          msg    << " #{[dst_msg, src_msg].join(" or ")} (source: '#{src.id}')"
+
+          log(:warn) { msg }
           return nil, nil
         end
 
         # Fields exclusion
         dst_flds -= dst_excluded unless dst_excluded.empty?
         src_flds -= src_excluded unless src_excluded.empty?
-        src_fld, dst_fld = src_flds.first, dst_flds.first
+
+        src_fld = src_flds.first
+        dst_fld = dst_flds.first
+
         return src_fld, dst_fld if dst_flds.empty? || src_flds.empty?
 
         if dst_flds.count > 1
-          logger.warn("There are #{dst_flds.count} destination '#{type}' fields named '#{label_dst}' (source: '#{dst.id}'). Using first...")
+          log(:warn) {
+            msg  = "There are #{dst_flds.count} destination '#{type}' fields "
+            msg << "named '#{label_dst}' (source: '#{dst.id}'). Using first..."
+            msg
+          }
         end
 
         if src_flds.count > 1
-          msg = "There are #{src_flds.count} source '#{type}' fields named '#{label}' (source: '#{src.id}'). "
+          msg         = "There are #{src_flds.count} source '#{type}' fields named '#{label}' (source: '#{src.id}'). "
           src_content = src_flds.reject(&:empty?)
+
           if src_content.empty?
             msg << "None with content. Using first..."
           else
             src_fld = src_content.first
+
             if src_content.count == 1
               msg << "Using the only one with content (idx: #{src_flds.index(src_fld)})..."
             else
               msg << "#{src_content.count} have content. Using first..."
             end
           end
-          logger.warn(msg)
+
+          log(:warn) { msg }
         end
 
-        [src_fld, dst_fld].tap do |(src_fld, dst_fld)|
+        [src_fld, dst_fld].tap do
           yield(src_fld, dst_fld) if block_given?
         end
       end
 
-      def copy_field_content(src, dst)
+      def copy_field_content(src, dst) # rubocop:disable Metrics/AbcSize
         type = src.type
         case type
         when "select"
-          src.values.each {|val| dst.select(val)}
+          src.values.each {|val| dst.select(val)} # rubocop:disable Style/HashEachMethods
           dst.other_desc = src.other_desc if src.other && src.other_desc && dst.other
         when "plain_text", "date", "number", "gauge"
           dst.value = src.value
@@ -110,8 +144,9 @@ class Eco::API::UseCases::OozeSamples
         when "people"
           dst.people_ids << src.people_ids.to_a
         when "geo"
-          src_coo, dst_coo = src.coordinates, dst.coordinates
-          dst_coo.lat, dst_coo.lon = src_coo.lat, src_coo.lon
+          src_coo = src.coordinates
+          dst_coo = dst.coordinates
+          dst_coo.lat, dst_coo.lon = src_coo.lat, src_coo.lon # rubocop:disable Style/ParallelAssignment
         when "file"
           src.items.each do |src_item|
             dst.add_file(src_item.file_container_id) do |dst_item|
@@ -149,3 +184,5 @@ class Eco::API::UseCases::OozeSamples
     end
   end
 end
+
+# rubocop:enable Lint/DuplicateBranch

data/lib/eco/api/usecases/ooze_samples/ooze_base_case.rb

@@ -14,6 +14,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
   def main(_session, options, _usecase)
     options[:end_get] = false
     raise "You need to inherit from this class ('#{self.class}') and call super with a block" unless block_given?
+
     @target = nil
     yield
   end
@@ -22,6 +23,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
   def process_ooze(ooz = target)
     ooz ||= ooze
     raise "You need to inherit from this class ('#{self.class}') and call super with a block" unless block_given?
+
     yield(ooz)
     update_ooze(ooz)
   end
@@ -33,15 +35,18 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
   end
 
   def create_page(page = nil, template_id: nil, retrieve: false)
-    template_id = template_id.id if template_id.is_a?(Ecoportal::API::V2::Page)
-    template_id ||= page.template_id if page.respond_to?(:template_id)
+    template_id = template_id.id        if template_id.is_a?(Ecoportal::API::V2::Page)
+    template_id ||= page.template_id    if page.respond_to?(:template_id)
     template_id ||= page["template_id"] if page.is_a?(Hash)
-    page = new_page(template_id) unless page || !template_id
+    page = new_page(template_id)        unless page || !template_id
+
     yield(page) if block_given?
+
     reference = apiv2.pages.create(page, from: template_id)
     ooze_id   = reference.page_id
     stage_id  = reference.active_stage_id
     return [ooze_id, stage_id] unless retrieve
+
     ooze(ooze_id, stage_id: stage_id)
   end
 
@@ -49,6 +54,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
     unless section.is_a?(Ecoportal::API::V2::Page::Section)
       raise "You need to specify a section for a new field. Given: #{section.class}"
     end
+
     entry.components.add(doc: doc) do |field|
       section.add_component(field, after: after, before: before, side: side)
     end.tap do |field|
@@ -60,6 +66,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
     unless section.is_a?(Ecoportal::API::V2::Page::Section)
       raise "You need to specify a section for a new field. Given: #{section.class}"
     end
+
     entry.components.add(label: name, type: type) do |field|
       section.add_component(field, after: after, before: before, side: side)
     end.tap do |field|
@@ -69,6 +76,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
 
   def with_fields(entry = target, type: nil, label: nil)
     flds = entry.components
+
     if type
       if flds.respond_to?(:get_by_type)
         flds = flds.get_by_type(type)
@@ -76,6 +84,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
         flds = flds.select {|fld| fld.type == type}
       end
     end
+
     flds.select do |fld|
       value = label == :unnamed ? nil : label
       !label || same_string?(fld.label, value)
@@ -87,6 +96,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
   def with_sections(entry = target, type: nil, heading: nil)
     secs = entry.sections
     secs = secs.get_by_type(type) if type
+
     secs.select do |sec|
       value = heading == :unnamed ? nil : heading
       !heading || same_string?(sec.heading, value)
@@ -97,6 +107,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
 
   def with_stage(name:)
     return unless (stage = target.stages.get_by_name(name))
+
     yield(stage) if block_given?
     stage
   end
@@ -110,7 +121,9 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
 
   def ooze(ooze_id = nil, stage_id: nil)
     return target unless ooze_id
+
     before_loading_new_target(ooze_id)
+
     apiv2.pages.get(ooze_id, stage_id: stage_id).tap do |ooze|
       if ooze
         new_target(ooze)
@@ -130,7 +143,9 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
 
     if (stg = ooze.stages[id_name] || ooze.stages.get_by_name(id_name))
       return ooze if ooze.respond_to?(:current_stage_id) && (ooze.current_stage_id == stg.id)
+
       before_loading_new_target(ooze_id)
+
       return apiv2.pages.get(ooze_id, stage_id: stg.id).tap do |stage|
         if stage
           new_target(stage)
@@ -142,6 +157,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
         end
       end
     end
+
     exit_error "Stage '#{id_name}' doesn't exist in ooze '#{ooze_id}'"
   end
 
@@ -178,8 +194,10 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
         msg += " after doing unsaved changes to #{object_reference(target)}"
         log(:warn) { msg }
       end
+
       yield(target) if block_given?
     end
+
     @target = object
   end
 
@@ -206,6 +224,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
   def display_patch(entry = target)
     return if options.dig(:feedback, :only_stats)
     return unless (patch = (patch_doc(entry) || {})["page"])
+
     pp patch
   end
 
@@ -222,12 +241,15 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
     entry.validate.tap do |validation|
       log(:error) { validation } if validation.is_a?(String)
     end
+
     display_patch(entry)
     backup_patch!(entry)
+
     if dirty?(entry) && dry_count > self.class::DRY_COUNT
       log(:info) { "Reached #{self.class::DRY_COUNT} dry-run samples." }
       exit(0)
     end
+
     false
   end
 

data/lib/eco/api/usecases/ooze_samples/register_update_case.rb

@@ -49,6 +49,7 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
 
   def before_loading_new_target(ooze_id)
     return unless (pending = queue_shift(ooze_id))
+
     update_ooze(pending).tap do |result|
       if result.is_a?(Ecoportal::API::Common::Response)
         if result.success?
@@ -83,6 +84,7 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
           log(:warn) { msg }
           update_ooze(pending)
         end
+
         if (ooz = ooze(page_result.id))
           @retrieved_oozes += 1
           yield(ooz)
@@ -97,9 +99,11 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
 
   def enqueue(object)
     return unless object.respond_to?(:id)
+
     unless object.is_a?(Ecoportal::API::V2::Page) or object.is_a?(Ecoportal::API::V2::Pages::PageStage)
       raise "Queuing is just for entries. Expecting Page or PageStage. Given: #{object.class}"
     end
+
     if (elem = queue_get(object.id))
       msg = "Something is wrong. Native case 'RegisterUpdateCase' is "
       if (elem != object) && dirty?(elem)
@@ -131,7 +135,9 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
 
   def batched_search_results
     raise "Missing block. It yields in slices of #{self.class.batch_size} results" unless block_given?
+
     results_preview
+
     results = []
     apiv2.registers.search(register_id, search_options) do |page_result|
       results << page_result
@@ -140,6 +146,7 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
         results = []
       end
     end
+
     yield(results) unless results.empty?
   end
 
@@ -180,6 +187,7 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
 
   def backup_patch!(ooze = target)
     return if (patch_doc(ooze) || {})["page"]
+
     log(:info) {
       "No changes to update for #{object_reference(ooze)}."
     }
@@ -188,8 +196,10 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
   def results_preview
     apiv2.registers.search(register_id, search_options.merge(only_first: true)).tap do |search_results|
       @total_search_oozes = search_results.total
+
       str_results = "Total target entries: #{search_results.total} (out of #{search_results.total_before_filtering})"
       default_answer = session.config.run_mode_remote?? "Y" : "N"
+
       session.prompt_user(
         "Do you want to proceed (y/N):",
         explanation: str_results,

data/lib/eco/api/usecases/use_case.rb

@@ -58,7 +58,9 @@ module Eco
 
           UseCaseIO.new(**kargs).tap do |uio|
             @options = uio.options
-            uio.session.logger.debug("#{self.class}: going to process '#{name}'")
+            uio.session.log(:debug) {
+              "#{self.class}: going to process '#{name}'"
+            }
 
             set_session_n_options(uio) if callback_from_loader?
 

data/lib/eco/cli/config/use_cases.rb

@@ -28,13 +28,16 @@ module Eco
         # @return [String] summary of the use cases.
         def help(refine: nil)
           refinement = refine.is_a?(String)? " (containing: '#{refine}')" : ""
+
           ["The following are the available use cases#{refinement}:"].then do |lines|
             max_len = keys_max_len(@linked_cases.keys)
+
             @linked_cases.keys.sort.select do |key|
               !refine.is_a?(String) || key.include?(refine)
             end.each do |option_case|
               lines << help_line(option_case, @linked_cases[option_case].description, max_len)
             end
+
             lines
           end.join("\n")
         end
@@ -150,6 +153,7 @@ module Eco
 
         def validate_io!(io)
           return if io.is_a?(Eco::API::UseCases::BaseIO)
+
           raise ArgumentError, "You need to provide Eco::API::UseCases::BaseIO object. Given: #{io.class}"
         end
       end