eco-helpers 3.2.1 → 3.2.3

data/lib/eco/api/usecases/samples/people/filters/require_id_sample.rb

@@ -0,0 +1,61 @@
+class Eco::API::UseCases::Samples::People::Filters::RequireId < Eco::API::Custom::UseCase
+  require_relative 'cli/require_id_cli'
+
+  name 'require-id'
+  type :import
+
+  GENERATE_FILE   = true
+  OUT_FOLDER      = 'sftp'.freeze
+  OUT_TIME_FORMAT = '%Y%m%dT%H%M%S'.freeze
+  OUT_FILENAME    = 'no_id'.freeze
+
+  def main(*_args)
+    output = input
+
+    # Filter out the ones that we could not build ids for
+    no_id = input.newFrom(input.reject {|e| id?(e)})
+
+    unless no_id.empty?
+      log(:warn) {
+        "Excluding #{no_id.length} entries with no external_id."
+      }
+
+      no_id.export(output_filename) if generate_file?
+
+      output = input.newFrom(input.select {|e| id?(e)})
+    end
+
+    output.tap do
+      next unless output.empty?
+
+      msg  = 'Empty entries after excluding entries with no external_id. '
+      msg << 'Aborting...'
+      abort msg
+    end
+  end
+
+  private
+
+  def id?(entry)
+    return true unless entry.id.to_s.strip.empty?
+    return true unless entry.external_id.to_s.strip.empty?
+
+    false
+  end
+
+  def generate_file?
+    self.class::GENERATE_FILE
+  end
+
+  def output_filename(name = self.class::OUT_FILENAME)
+    File.join(output_folder, "#{timestamp}_#{config.active_enviro}_#{name}.csv")
+  end
+
+  def output_folder
+    File.join(config.active_enviro, self.class::OUT_FOLDER)
+  end
+
+  def timestamp(date = Time.now)
+    date.strftime(self.class::OUT_TIME_FORMAT)
+  end
+end

data/lib/eco/api/usecases/samples/people/filters/require_min_entries_sample.rb

@@ -0,0 +1,20 @@
+class Eco::API::UseCases::Samples::People::Filters::RequireMinEntries < Eco::API::Custom::UseCase
+  require_relative 'cli/require_min_entries_cli'
+
+  name 'require-min-entries'
+  type :import
+
+  MIN_COUNT = 200
+
+  def main(*_args)
+    return input if options.dig(:workflow, :ad_hoc)
+
+    input.tap do |entries|
+      next if entries.count >= self.class::MIN_COUNT
+
+      msg  = "There are only #{entries.count} valid entries in the file "
+      msg << "(min required: #{self.class::MIN_COUNT}). Aborting..."
+      abort(msg)
+    end
+  end
+end

data/lib/eco/api/usecases/samples/people/filters.rb

@@ -0,0 +1,7 @@
+module Eco::API::UseCases::Samples::People
+  module Filters
+  end
+end
+
+require_relative 'filters/require_id_sample'
+require_relative 'filters/require_min_entries_sample'

data/lib/eco/api/usecases/samples/people.rb

@@ -0,0 +1,12 @@
+module Eco
+  module API
+    class UseCases
+      class Samples
+        module People
+        end
+      end
+    end
+  end
+end
+
+require_relative 'people/filters'

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

@@ -8,3 +8,4 @@ module Eco
 end
 
 require_relative 'samples/drivers'
+require_relative 'samples/people'

data/lib/eco/cli_default/options.rb

@@ -145,6 +145,11 @@ ASSETS.cli.config do |cnf| # rubocop:disable Metrics/BlockLength
       end
     end
 
+    desc = 'It allows to skip the filtering of entries during the workflow.'
+    options_set.add('-skip-pre-filter', desc) do |options, session|
+      options.deep_merge!(workflow: {ad_hoc: true})
+    end
+
     # PEOPLE FETCH
 
     desc = 'Do not load any people for this run.'

data/lib/eco/data/hashes/array_diff.rb

@@ -95,14 +95,24 @@ module Eco
           when String
             to_array_of_hashes(Eco::CSV.parse(content))
           when Enumerable
-            sample = content.to_a.first
+            content_ary = content.to_a
+            content_cnt = content_ary.count
+            sample      = content_ary.first
+
             case sample
             when Hash, Array, ::CSV::Row
               Eco::CSV::Table.new(content).to_array_of_hashes
             else
-              log(:error) {
-                "(ArrayDiff) Input content 'Array' of '#{sample.class}' is not supported."
-              }
+              if content_cnt.zero?
+                log(:error) {
+                  "Inpout should not be empty"
+                }
+              else
+                log(:error) {
+                  "(ArrayDiff) Input content 'Array' of '#{sample.class}' is not supported."
+                }
+              end
+
               exit(1)
             end
           else

data/lib/eco/data/locations/node_base/csv_convert.rb

@@ -15,6 +15,7 @@ module Eco::Data::Locations::NodeBase
     def hash_list(value, &block)
       return hash_list(org_tree(value), &block) if value.is_a?(::CSV::Table)
       return value.as_nodes_json(&block)        if value.is_a?(tree_class)
+
       raise ArgumentError, "Expecting Eco::API::Organization::TagTree or CSV::Table. Given: #{value.class}"
     end
 
@@ -28,6 +29,7 @@ module Eco::Data::Locations::NodeBase
     def hash_tree(value, &block)
       return hash_tree_from_csv(value, &block) if value.is_a?(::CSV::Table)
       return value.as_json(&block)             if value.is_a?(tree_class)
+
       raise ArgumentError, "Expecting Eco::API::Organization::TagTree or CSV::Table. Given: #{value.class}"
     end
 
@@ -40,6 +42,7 @@ module Eco::Data::Locations::NodeBase
     def org_tree(value, &block)
       return tree_class.new(hash_tree(value), &block) if value.is_a?(::CSV::Table)
       return tree_class.new(value.as_json)            if value.is_a?(tree_class)
+
       raise ArgumentError, "Expecting Eco::API::Organization::TagTree or CSV::Table. Given: #{value.class}"
     end
 
@@ -49,7 +52,12 @@ module Eco::Data::Locations::NodeBase
     # @yieldreturn [Hash] the serialized Node
     # @return [CSV::Table] a table with L1 to Ln columns ready for dump to csv
     def csv_tree(value, encoding: 'utf-8', attrs: [:id], &block) # rubocop:disable Lint/UnusedMethodArgument
-      Eco::CSV::Table.new(hash_tree_to_tree_csv(hash_tree(value, &block), attrs: attrs))
+      Eco::CSV::Table.new(
+        hash_tree_to_tree_csv(
+          hash_tree(value, &block),
+          attrs: attrs
+        )
+      )
     end
 
     # @note it just converts to an organizational tagtree and uses a helper method.

data/lib/eco/data/locations/node_base/tag_validations.rb

@@ -2,14 +2,14 @@ module Eco::Data::Locations::NodeBase
   module TagValidations
     include Eco::Language::AuxiliarLogger
 
-    ALLOWED_CHARACTERS = "A-Za-z0-9 &_'\/.-"
+    ALLOWED_CHARACTERS = "A-Za-z0-9 &_'\/.-".freeze
     VALID_TAG_REGEX    = /^[#{ALLOWED_CHARACTERS}]+$/
     INVALID_TAG_REGEX  = /[^#{ALLOWED_CHARACTERS}]+/
     VALID_TAG_CHARS    = /[#{ALLOWED_CHARACTERS}]+/
     DOUBLE_BLANKS      = /\s\s+/
 
     def clean_id(str, notify: true, ref: '')
-      blanks_x2 = has_double_blanks?(str)
+      blanks_x2 = has_double_blanks?(str) # dubocop:disable Naming/VariableNumber
       partial   = replace_not_allowed(str)
       remove_double_blanks(partial).tap do |result|
         next unless notify

data/lib/eco/data/locations/node_diff/nodes_diff/diffs_tree.rb

@@ -3,6 +3,7 @@ class Eco::Data::Locations::NodeDiff::NodesDiff
   class DiffsTree
     class CyclicHierarchy < StandardError
     end
+
     class CyclicAncestorsChain < CyclicHierarchy
     end
 
@@ -37,12 +38,15 @@ class Eco::Data::Locations::NodeDiff::NodesDiff
     #   supports building partial trees (clusters), where some parents
     #   may not have presence.
     def parent_id
-      return nil unless parent
+      return unless parent
+
       parent.id
     end
 
     def add_child(child_tree)
-      raise ArgumentError, "Expecting #{self.class}. Given: #{child_tree.class}" unless child_tree.is_a?(self.class)
+      msg = "Expecting #{self.class}. Given: #{child_tree.class}"
+      raise ArgumentError, msg unless child_tree.is_a?(self.class)
+
       prevent_cyclic_chain(child_tree)
       children.push(child_tree)
       child_tree.link_parent(self)
@@ -69,8 +73,11 @@ class Eco::Data::Locations::NodeDiff::NodesDiff
     protected
 
     def link_parent(parent_node)
-      raise ArgumentError, "Expecting #{self.class}. Given: #{parent_node.class}" unless parent_node.is_a?(self.class)
+      msg = "Expecting #{self.class}. Given: #{parent_node.class}"
+      raise ArgumentError, msg unless parent_node.is_a?(self.class)
+
       return (@parent = parent_node) unless parent
+
       msg = "Node '#{id}' already has a parent (#{parent.id}). "
       msg << "Can't make it child of '#{parent_node.id}' as well."
       raise CyclicHierarchy, msg

data/lib/eco/data/locations/node_diff/nodes_diff.rb

@@ -20,10 +20,16 @@ class Eco::Data::Locations::NodeDiff
 
     def initialize(*args, original_tree:, **kargs, &block)
       super(*args, **kargs, &block)
+
       @original_tree = original_tree
       mark_implicit_unarchive!
     end
 
+    def any?
+      diffs.any?
+    end
+    alias_method :any_diff?, :any?
+
     def diffs
       @diffs ||= super.select do |dff|
         # discard entries that are to be inserted and archived at the same time

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = '3.2.1'.freeze
+  VERSION = '3.2.3'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 3.2.1
+  version: 3.2.3
 platform: ruby
 authors:
 - Oscar Segura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-16 00:00:00.000000000 Z
+date: 2025-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -243,7 +243,7 @@ dependencies:
         version: '0.10'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.10.11
+        version: 0.10.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -253,47 +253,47 @@ dependencies:
         version: '0.10'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.10.11
+        version: 0.10.14
 - !ruby/object:Gem::Dependency
   name: ecoportal-api-graphql
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: 1.3.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: 1.3.2
 - !ruby/object:Gem::Dependency
   name: ecoportal-api-v2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '3.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.1
+        version: 3.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '3.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.1
+        version: 3.3.1
 - !ruby/object:Gem::Dependency
   name: ed25519
   requirement: !ruby/object:Gem::Requirement
@@ -667,7 +667,9 @@ files:
 - lib/eco/api/microcases/people/macro/take_email.rb
 - lib/eco/api/microcases/people/manage.rb
 - lib/eco/api/microcases/people/manage/cache.rb
+- lib/eco/api/microcases/people/manage/filename.rb
 - lib/eco/api/microcases/people/manage/load.rb
+- lib/eco/api/microcases/people/manage/load_cache.rb
 - lib/eco/api/microcases/people/manage/refresh.rb
 - lib/eco/api/microcases/people/manage/search.rb
 - lib/eco/api/microcases/people/preserve.rb
@@ -843,7 +845,9 @@ files:
 - lib/eco/api/usecases/graphql/helpers/location/command/diffs/stages/diff_sortable/for_unarchive.rb
 - lib/eco/api/usecases/graphql/helpers/location/command/diffs/stages/sortable.rb
 - lib/eco/api/usecases/graphql/helpers/location/command/diffs/stages/sortable/relation_safe_sort.rb
-- lib/eco/api/usecases/graphql/helpers/location/command/optimizations.rb
+- lib/eco/api/usecases/graphql/helpers/location/command/end_points.rb
+- lib/eco/api/usecases/graphql/helpers/location/command/end_points/optimizations.rb
+- lib/eco/api/usecases/graphql/helpers/location/command/input_unit_response.rb
 - lib/eco/api/usecases/graphql/helpers/location/command/result.rb
 - lib/eco/api/usecases/graphql/helpers/location/command/results.rb
 - lib/eco/api/usecases/graphql/helpers/location/tags_remap.rb
@@ -919,6 +923,12 @@ files:
 - lib/eco/api/usecases/samples/drivers/cli/url_pull_cli.rb
 - lib/eco/api/usecases/samples/drivers/sftp_sample.rb
 - lib/eco/api/usecases/samples/drivers/url_pull_sample.rb
+- lib/eco/api/usecases/samples/people.rb
+- lib/eco/api/usecases/samples/people/filters.rb
+- lib/eco/api/usecases/samples/people/filters/cli/require_id_cli.rb
+- lib/eco/api/usecases/samples/people/filters/cli/require_min_entries_cli.rb
+- lib/eco/api/usecases/samples/people/filters/require_id_sample.rb
+- lib/eco/api/usecases/samples/people/filters/require_min_entries_sample.rb
 - lib/eco/api/usecases/service.rb
 - lib/eco/api/usecases/service/sftp.rb
 - lib/eco/api/usecases/service/sftp/with_target_config.rb

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

@@ -1,84 +0,0 @@
-module Eco::API::UseCases::GraphQL::Helpers::Location
-  module Command::Optimizations
-    DEFAULT_COMMANDS_PER_PAGE = 45
-    DEFAULT_FORCE_CONTINUE    = false
-
-    # Available options are:
-    #   - :per_request -> on each request
-    #   - :per_batch   -> at the end of each batch / stage (on last page)
-    #   - :once        -> only when the script starts to run
-    def default_tree_tracking_mode
-      :per_request
-    end
-
-    # Helper to identify the commands payload block
-    # @note
-    #   1. Gives flexibility on at what time the structure should be retrieved
-    #   2. This increases performacne, as we don't retrieve the full tree on
-    #     each request unless necessary/specified
-    #   3. `nil` falls the block back to the `ecoportal-api-graphql` gem, which
-    #     has a default block that retrieves the structure
-    # @return [Proc, NilClass] the payload block
-    def scope_commands_block(idx, total, track_tree_mode: default_tree_tracking_mode)
-      case track_tree_mode
-      when :per_request
-        nil
-      when :once
-        commands_payload_without_structure_block
-      when :per_batch
-        return nil if idx == total
-        commands_payload_without_structure_block
-      end
-    end
-
-    # Prevents each request from timing out
-    def commands_per_page
-      if self.class.const_defined?(:COMMANDS_PER_PAGE)
-        self.class::COMMANDS_PER_PAGE
-      else
-        DEFAULT_COMMANDS_PER_PAGE
-      end
-    end
-
-    # Whether to stop or continue on command fail
-    def force_continue?
-      if self.class.const_defined?(:FORCE_CONTINUE)
-        self.class::FORCE_CONTINUE
-      else
-        DEFAULT_FORCE_CONTINUE
-      end
-    end
-
-    # Commands payload without querying Structure
-    # @note this servces the purpose of optimizing/speeding up the requests.
-    def commands_payload_without_structure_block
-      proc {
-        clientMutationId
-        error { # rubocop:disable Style/BlockDelimiters
-          message
-          conflictingIds
-          validationErrors { # rubocop:disable Style/BlockDelimiters
-            error
-            message
-          }
-        }
-        results { # rubocop:disable Style/BlockDelimiters
-          command { # rubocop:disable Style/BlockDelimiters
-            id
-            state
-            __typename
-          }
-          ok
-          error { # rubocop:disable Style/BlockDelimiters
-            conflictingIds
-            message
-            validationErrors { # rubocop:disable Style/BlockDelimiters
-              error
-              message
-            }
-          }
-        }
-      }
-    end
-  end
-end