eco-helpers 3.2.1 → 3.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea80ab87a718ddf4e177e212b1f4a5234c96554d67d4781579314d1e58ea821e
-  data.tar.gz: 835aec5ee8d25e186f3327e97b5ca382a3556c85a8f34bed4e4e3f09b2d201c0
+  metadata.gz: 415f7627b23706adc59420467cd7491f5990c267109a11f9128fa8dac908631c
+  data.tar.gz: 8f04152b0e476c656c83fe752b091e83e042a322d0cdbb69e26bb8650c812f07
 SHA512:
-  metadata.gz: 16cd391227194d4e929292ebe775f061f1ba58f592523ff28b32d2d7e92da638c94c0b36fdf2f55f2c38195517f6def5441e8ae15a6a3a516f02b5357540a69b
-  data.tar.gz: 4bad0d9fa30a1be333b69aa485808961a3ae39259fb42d616457b8cd2b501b808daf60526cf0d4f17540f42036b084b82f40aeae36dd25894df46735b5f1f91e
+  metadata.gz: 9cb01334ae6ae73d528f5841c568ee3f13305cabf5051d5ef2bee3775d9dac5d6618a16436f62fa28ff9c06ba628ca1c04897e528ba3a367db8a8805affc4f44
+  data.tar.gz: 6e9fe1d5c9cbda796692302ad551702c446ee73a44bdd83cb3e04a59de0ef3474e878d071d6977cd68fc7f0d19256a334a2c014c62ec79b63c918ad5d6463c48

data/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## [3.2.2] - 2025-05-xx
+## [3.3.1] - 2025-06-xx
 
 ### Added
 
@@ -10,6 +10,26 @@ All notable changes to this project will be documented in this file.
 
 ### Fixed
 
+## [3.2.2] - 2025-06-11
+
+### Added
+
+- `PersonEntry#[]` accessor (onto `final_entry`)
+- **Samples**:
+  - `require-id`
+  - `require-min-entries`
+
+### Changed
+
+- upgraded gem dependencies
+- `Session::Batch::Searcher` silence low level messages.
+  - And better feedback on search.
+- **Refactored** `Microcases` people get/cache/load helpers to reach a **unique access point** per functionality.
+
+### Fixed
+
+- The upgrade of the `ecoportal-api-graphql` **gem** fixes a bug introduced by a native release.
+
 ## [3.2.1] - 2025-05-17
 
 ### Changed

data/eco-helpers.gemspec

@@ -42,8 +42,8 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'docx',          '>= 0.8.0', '< 0.9'
   spec.add_dependency 'dotenv',        '~> 3'
   spec.add_dependency 'ecoportal-api',         '~> 0.10', '>= 0.10.11'
-  spec.add_dependency 'ecoportal-api-graphql', '~> 1.2',  '>= 1.2.1'
-  spec.add_dependency 'ecoportal-api-v2',      '~> 3.2',  '>= 3.2.1'
+  spec.add_dependency 'ecoportal-api-graphql', '~> 1.3',  '>= 1.3.1'
+  spec.add_dependency 'ecoportal-api-v2',      '~> 3.3',  '>= 3.3.1'
   spec.add_dependency 'ed25519',       '~> 1.2'
   spec.add_dependency 'fast_excel',    '>= 0.5.0',  '< 0.6'
   spec.add_dependency 'fuzzy_match',   '>= 2.1.0',  '< 2.2'

data/lib/eco/api/common/people/person_entry.rb

@@ -98,6 +98,11 @@ module Eco
             end
           end
 
+          # Value on the final entry
+          def [](key)
+            final_entry[key]
+          end
+
           # @note completely serialized entry.
           # @return [Hash] entry `Hash` with **external** attribute names, and values and types thereof.
           def external_entry # rubocop:disable Style/TrivialAccessors

data/lib/eco/api/microcases/people/manage/cache.rb

@@ -4,29 +4,34 @@ module Eco
       module People
         module Manage
           module Cache
-            # Helper to locally cache the people manager.
+            # Helper to locally cache the people manager (download via API).
             # @param filename [String] the name of the file where the data should be cached.
             # @return [Eco::API::Organization::People] the `People` object with the data.
-            def people_cache(filename = enviro.config.people.cache)
-              log(:info) { 'Going to get all the people via API' }
+            def people_cache(filename = enviro.config.people.cache, modifier: [:save])
+              modifier = [modifier].flatten
 
-              start   = Time.now
-              people  = session.batch.get_people
-              secs    = (Time.now - start).round(3)
-              cnt     = people.count
-              per_sec = (cnt.to_f / secs).round(2)
+              log(:info) { 'Going to get all the people via API' }
 
-              log(:info) {
-                "Loaded #{cnt} people in #{secs} seconds (#{per_sec} people/sec)"
-              }
+              start = Time.now
+              session.batch.get_people.tap do |people|
+                secs    = (Time.now - start).round(3)
+                cnt     = people.count
+                per_sec = (cnt.to_f / secs).round(2)
 
-              file = file_manager.save_json(people, filename, :timestamp)
+                log(:info) {
+                  "Loaded #{cnt} people in #{secs} seconds (#{per_sec} people/sec)"
+                }
 
-              log(:info) {
-                "#{people.length} people loaded and saved locally to #{file}."
-              }
+                if modifier.include?(:save)
+                  file = file_manager.save_json(people, filename, :timestamp)
 
-              Eco::API::Organization::People.new(people)
+                  log(:info) {
+                    "#{people.length} people loaded and saved locally to #{file}."
+                  }
+                end
+              end.then do |people|
+                Eco::API::Organization::People.new(people)
+              end
             end
           end
         end

data/lib/eco/api/microcases/people/manage/filename.rb

@@ -0,0 +1,29 @@
+module Eco
+  module API
+    class MicroCases
+      module People
+        module Manage
+          module Filename
+            private
+
+            # Spot the source data file.
+            def people_filename(filename = enviro.config.people.cache, newest: false)
+              if newest
+                # search input file based on pattern (in case the name has a timestamp)
+                file_manager.dir.newest_file(file: filename).tap do |file|
+                  next unless file
+
+                  log(:info) {
+                    "previous file found: #{file}"
+                  }
+                end
+              else
+                file_manager.dir.file(filename, should_exist: true)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/eco/api/microcases/people/manage/load.rb

@@ -22,19 +22,10 @@ module Eco
               modifier  = [modifier].flatten
               load_file = %i[file newest].any? {|flag| modifier.include?(flag)}
 
-              case
-              when filename && load_file
-                file = people_load_filename(filename, newest: modifier.include?(:newest))
+              if filename && load_file
+                load_cache(filename, newest: modifier.include?(:newest)).tap do |people|
+                  next if people.is_a?(Eco::API::Organization::People)
 
-                if file
-                  file_manager.load_json(file).tap do |people|
-                    next unless people.is_a?(Array)
-
-                    log(:info) {
-                      "#{people&.length} people loaded from file #{file}"
-                    }
-                  end
-                else
                   log(:error) {
                     "could not find the file #{file_manager.dir.file(filename)}"
                   }
@@ -43,43 +34,10 @@ module Eco
 
                   people_load(modifier: modifier - %i[newest file])
                 end
-              when modifier.include?(:api)
-                log(:info) { 'Going to get all the people via API (load)' }
-
-                start = Time.now
-                session.batch.get_people.tap do |people|
-                  secs    = (Time.now - start).round(3)
-                  cnt     = people.count
-                  per_sec = (cnt.to_f / secs).round(2)
-
-                  log(:info) {
-                    "Loaded #{cnt} people in #{secs} seconds (#{per_sec} people/sec)"
-                  }
-
-                  if modifier.include?(:save) && people && people.length.positive?
-                    file = file_manager.save_json(people, filename, :timestamp)
-                    log(:info) { "#{people.length} people saved to file #{file}." }
-                  end
-                end
+              elsif modifier.include?(:api)
+                people_cache(filename, modifier: modifier)
               end.then do |people|
-                Eco::API::Organization::People.new(people)
-              end
-            end
-
-            private
-
-            def people_load_filename(filename, newest: false)
-              if newest
-                # search input file based on pattern (in case the name has a timestamp)
-                file_manager.dir.newest_file(file: filename).tap do |file|
-                  next unless file
-
-                  log(:info) {
-                    "previous file found: #{file}"
-                  }
-                end
-              else
-                file_manager.dir.file(filename, should_exist: true)
+                Eco::API::Organization::People.new(people.to_a)
               end
             end
           end

data/lib/eco/api/microcases/people/manage/load_cache.rb

@@ -0,0 +1,29 @@
+module Eco
+  module API
+    class MicroCases
+      module People
+        module Manage
+          module LoadCache
+            private
+
+            # Finds the source data file and loads it.
+            # @return [Eco::API::Organization::People] the `People` object with the data.
+            def load_cache(filename = enviro.config.people.cache, newest: false)
+              return unless (file = people_filename(filename, newest: newest))
+
+              file_manager.load_json(file).then do |people|
+                next unless people.is_a?(Array)
+
+                log(:info) {
+                  "#{people&.length} people loaded from file #{file}"
+                }
+
+                Eco::API::Organization::People.new(people)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/eco/api/microcases/people/manage/refresh.rb

@@ -5,16 +5,18 @@ module Eco
         module Manage
           module Refresh
             # Helper to obtain all the elements of `people` anew from the _People Manager_.
+            # @note it does NOT save to a local file.
             # @note
-            #   1. This helper is normally used to run consecutive usecases, where data needs refresh.
+            #   1. This helper is normally used to run consecutive usecases,
+            #     where data needs refresh.
             #   2. It only includes new people if they are not dirty (they do not have pending updates)
             #     - This contingency wouldn't be necessary if the server worked perfectly.
             # @param people [Eco::API::Organization::People] the people that needs refresh.
             # @param include_created [Boolean] include people created during this session? (will check `:create` batch jobs).
             # @return [Eco::API::Organization::People] the `People` object with the data.
             def people_refresh(people:, include_created: true) # rubocop:disable Metrics/AbcSize
-              people = people.newFrom people.select do |person|
-                !person.new? || !person.dirty?
+              people = people.newFrom people.reject do |person|
+                person.new? && person.dirty?
               end
 
               ini = people.length

data/lib/eco/api/microcases/people/manage.rb

@@ -1,3 +1,5 @@
+require_relative 'manage/filename'
+require_relative 'manage/load_cache'
 require_relative 'manage/cache'
 require_relative 'manage/load'
 require_relative 'manage/search'
@@ -8,6 +10,8 @@ module Eco
     class MicroCases
       module People
         module Manage
+          include Filename
+          include LoadCache
           include Cache
           include Load
           include Search

data/lib/eco/api/session/batch/searcher.rb

@@ -56,7 +56,7 @@ module Eco
               entries.each_with_index do |entry, i|
                 if (i % 10).zero?
                   percent = i * 100 / entries.length
-                  print "Searching: #{percent.round}% (#{i}/#{entries.length} entries)\r"
+                  print "Searching in results: #{percent.round}% (#{i}/#{entries.length} entries)\r"
                   $stdout.flush
                 end
 
@@ -75,7 +75,7 @@ module Eco
                 unless email.empty?
                   people_matching = get(
                     params:  params.merge(q: email),
-                    silent:  silent,
+                    silent:  true,
                     options: options
                   ).select do |person|
                     person.email == email
@@ -94,7 +94,7 @@ module Eco
 
           private
 
-          def get(params: {}, silent: false, options: self.options)
+          def get(params: {}, silent: true, options: self.options)
             msg  = 'cannot batch get without api connnection, '
             msg << 'please provide a valid api connection!'
             fatal msg unless (people_api = api&.people)

data/lib/eco/api/session/config/people.rb

@@ -3,69 +3,72 @@ module Eco
     class Session
       class Config
         class People < BaseConfig
-
           def cache=(file)
-            self["cache"] = file
+            self['cache'] = file
           end
 
           def cache
-            self["cache"] ||= "cache/people.json"
+            self['cache'] ||= 'cache/people.json'
           end
 
           def partial_cache
-            if file = self.cache
-              File.join(File.dirname(file),
-                File.basename(file, File.extname(file)) + "_partial" + File.extname(file)
-              )
-            end
+            return unless (file = self.cache)
+
+            extension = File.extname(file)
+            basename  = File.basename(file, extension)
+
+            File.join(
+              File.dirname(file),
+              "#{basename}_partial#{extension}"
+            )
           end
 
           # specifies if people search should be strict or not
           def strict_search=(value)
-            self["strict_search"] = !!value
+            self['strict_search'] = !!value
           end
 
           def strict_search?
-            self["strict_search"]
+            self['strict_search']
           end
 
           # api queried logs
           def requests_folder=(folder)
-            self["requests_folder"] = folder
+            self['requests_folder'] = folder
           end
 
           def requests_folder
-            self["requests_folder"] ||= "requests"
+            self['requests_folder'] ||= 'requests'
           end
 
           # people to exclude from update feeds
           def discarded_file=(file)
-            self["discarded_file"] = file
+            self['discarded_file'] = file
           end
 
           def discarded_file
-            self["discarded_file"]
+            self['discarded_file']
           end
 
           # with given a person what is the criteria of exclusion
           def api_excluded(&block)
-            return self["api_excluded"] unless block_given?
-            self["api_excluded"] = block
+            return self['api_excluded'] unless block_given?
+
+            self['api_excluded'] = block
           end
 
           # internal-external fields map
           def fields_mapper=(file)
-            self["fields_mapper"] = file
+            self['fields_mapper'] = file
           end
 
           def fields_mapper
-            self["fields_mapper"]
+            self['fields_mapper']
           end
 
           # person model
           attr_key :default_usergroup, :default_schema, :default_login_method
 
-
           def default_usergroup?
             !!default_usergroup
           end
@@ -80,7 +83,7 @@ module Eco
 
           # @return [Hash] with defined pairs format `key` and Person parsers.
           def parsers
-            self["parsers"] ||= {}
+            self['parsers'] ||= {}
           end
 
           # The person parser/serializer for a given format (default `csv`).

data/lib/eco/api/usecases/samples/drivers/cli/sftp_cli.rb

@@ -1,4 +1,4 @@
-class  Eco::API::UseCases::Samples::Drivers::Sftp
+class Eco::API::UseCases::Samples::Drivers::Sftp
   class Cli < Eco::API::UseCases::Cli
     desc 'SFTP case: manages remote files that match a file pattern'
 

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

@@ -28,7 +28,10 @@ class Eco::API::UseCases::Samples::Drivers::Sftp < Eco::API::Common::Loaders::Us
 
   def list_folder
     puts "Listing remote folder: '#{remote_folder}' (host: #{sftp.host}):"
-    with_remote_files(pattern: file_pattern) {|file| puts file.longname}
+
+    with_remote_files(pattern: file_pattern) do |file|
+      puts file.longname
+    end
   end
 
   def get_files

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

@@ -38,6 +38,7 @@ class Eco::API::UseCases::Samples::Drivers::UrlPull < Eco::API::Common::Loaders:
     base_request(uri, **kargs) do |request|
       http_start(uri) do |http|
         puts "Pulling from url: #{uri}"
+
         return http.request(request)
       end
     end
@@ -73,6 +74,7 @@ class Eco::API::UseCases::Samples::Drivers::UrlPull < Eco::API::Common::Loaders:
   def base_request(uri, user: nil, pass: '')
     Net::HTTP::Get.new(uri).tap do |request|
       request.basic_auth(user, pass) unless user.nil?
+
       yield(request)
     end
   end
@@ -91,6 +93,7 @@ class Eco::API::UseCases::Samples::Drivers::UrlPull < Eco::API::Common::Loaders:
 
   def target_url(required: true)
     fpc = target_url_const
+
     return fpc if fpc
     return     unless required
 
@@ -99,15 +102,15 @@ class Eco::API::UseCases::Samples::Drivers::UrlPull < Eco::API::Common::Loaders:
   end
 
   def target_url_const
-    if (fpc = options.dig(:url_pull, :target_url_const))
-      msg = "(#{self.class}) Invalid file pattern const referral: #{fpc}"
-      raise WrongConst, msg unless fpc.match(CONST_REFERRAL)
-
-      begin
-        self.eval(fpc)
-      rescue NameError
-        self.class.const_get(fpc)
-      end
+    return unless (fpc = options.dig(:url_pull, :target_url_const))
+
+    msg = "(#{self.class}) Invalid file pattern const referral: #{fpc}"
+    raise WrongConst, msg unless fpc.match(CONST_REFERRAL)
+
+    begin
+      self.eval(fpc)
+    rescue NameError
+      self.class.const_get(fpc)
     end
   rescue NameError
     raise WrongConst, "(#{self.class}) Unknown constant: #{fpc}"

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

@@ -0,0 +1,5 @@
+class Eco::API::UseCases::Samples::People::Filters::RequireId
+  class Cli < Eco::API::UseCases::Cli
+    desc 'Import case to discard entries that do NOT have a unique identifier (external_id)'
+  end
+end

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

@@ -0,0 +1,5 @@
+class Eco::API::UseCases::Samples::People::Filters::RequireMinEntries
+  class Cli < Eco::API::UseCases::Cli
+    desc 'Import case to halt if MIN_COUNT is NOT met'
+  end
+end

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/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/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = '3.2.1'.freeze
+  VERSION = '3.2.2'.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.2
 platform: ruby
 authors:
 - Oscar Segura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-16 00:00:00.000000000 Z
+date: 2025-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -260,40 +260,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: 1.3.1
   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.1
 - !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
@@ -919,6 +921,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