eco-helpers 3.2.7 → 3.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfe97cd5583e8650f73c0f7cb2557fde896d3b59b7e729703fdb01f9323d6fbb
-  data.tar.gz: e40c8fdeae21780ca957c043aa7a637d06d9e85088fdbca6eb7c488448c74ab5
+  metadata.gz: ffa9adf82dfa0cb6d91960757491fc7d39f163b9a98a2ec16e04a9247db32078
+  data.tar.gz: 122a747df40c99ae3fdb9b7bc2788f64b0fbc605acee56a26c5bf2c4d9e763e4
 SHA512:
-  metadata.gz: c1f28e77164e7f8c439b09dba5d952594c34721457842963cfb9e037c90658de8049545c1029e25e6aa2aadda2a729a4fc103fb04335adcfb6359b1fe946ad60
-  data.tar.gz: '090c4c12745401c0191aec263bb3970bd92e5244c6b57f4d5ef6dd157acab37ab868ed239972d133bd52a4eb11ddcac0e4857a8e760e10321b7236f50a7d3c76'
+  metadata.gz: e2ec933ca14583f749295a0efb312dbb1c883308493bd97c3d8d34a19cbd542d113b7f31b1941a9056aef62c566060c840a57dea381fc320d8e4441a40a04326
+  data.tar.gz: 777252e0b15115ae33b904bb425c204f6db77b4c3c5f47274ad9ce39a16bb76e24f06f57c8a6777243706a1af2d104289cca0987ceeb4753a0c2bfb51ce19a3e

data/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## [3.2.8] - 2025-09-xx
+## [3.2.10] - 2025-10-xx
 
 ### Added
 
@@ -10,6 +10,23 @@ All notable changes to this project will be documented in this file.
 
 ### Fixed
 
+## [3.2.9] - 2025-10-16
+
+### Added
+
+- `Organization::TagTree`: **aliased** from `tag` to `id` related methods.
+- `Session::Config#locations_mapper`, named **argument** `valid_internal_values`. To optionally validate the current mappings.
+
+### Changed
+
+- `Session::Config#locations_mapper` **changed** `insensitive` from **default** `false` to `true`.
+
+## [3.2.8] - 2025-10-14
+
+### Added
+
+- Compatibility with native RS CSV feature **headers**: support `classification_ids`.
+
 ## [3.2.7] - 2025-09-09
 
 ### Added

data/lib/eco/api/organization/tag_tree.rb

@@ -289,12 +289,14 @@ module Eco
             end.keys
           end
         end
+        alias_method :ids, :tags
 
         # Gets all but the upper level tags of the current node tree.
         # @return [Array<String>]
         def subtags
           tags - tags(depth: depth)
         end
+        alias_method :subids, :subtags
 
         # Verifies if a tag exists in the subtree(s).
         # @param key [String] tag to verify.
@@ -302,6 +304,7 @@ module Eco
         def subtag?(key)
           subtags.include?(key&.upcase)
         end
+        alias_method :subid?, :subtag?
 
         # Returns all the tags with no children
         # @return [Array<String>]
@@ -327,6 +330,7 @@ module Eco
         def tag?(key)
           @hash_tags.key?(key&.upcase)
         end
+        alias_method :id?, :tag?
 
         # Finds a subtree node.
         # @param key [String] parent node of subtree.
@@ -499,7 +503,7 @@ module Eco
           end.compact
         end
 
-        def as_boolean(value)
+        def as_boolean(value) # rubocop:disable Naming/PredicateMethod
           return false if value.nil? || value == false
           return true  if value == true
           return false if value.to_s.strip.empty?

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

@@ -54,6 +54,8 @@ module Eco
 
         # @!group Logger
 
+        # @note this is the configuration of the logger.
+        #   Not the logger itself.
         # @return [Eco::API::Session::Config::Logger]
         def logger
           self['logger'] ||= Eco::API::Session::Config::Logger.new(config: self)
@@ -82,6 +84,7 @@ module Eco
 
         # @!group Session and API
 
+        # @note this is where `session` is created.
         # @return [Eco::API::Session] the `session` linked to this `config`
         def session
           @session ||= Eco::API::Session.new(self)
@@ -252,17 +255,22 @@ module Eco
         alias_method :locations_map_file, :location_codes
 
         # @param internal [Symbol] either `:first` (default) or `:last`
-        # @param insensitive [Boolean] default `false`. Whether lookups are
-        #   case sensitive.
+        # @param insensitive [Boolean] default `true`. Whether lookups are
+        #   case insensitive (`true`) or case sensitive (`false`).
+        # @param valid_internal_values [Array<String>] when provided,
+        #   it will check and warn on internal values that aren't expected.
         # @param maps_file [String] the location maps file (default: `locations_map_file`).
         #   - Via `file_manager` it will try to spot the most recently changed.
         #   - The lookup to spot the **path** of the file, tries first as a **relative**
         #     path from `env/config/...`. If it fails, it tries it as an absolute path.
         # @return [Eco::Data::Mapper, NilClass]
-        def locations_mapper(**kargs)
+        def locations_mapper(
+          valid_internal_values: :no_validation,
+          **kargs
+        )
           kargs = {
             internal:    :first,
-            insensitive: false,
+            insensitive: true,
             maps_file:   nil
           }.merge(kargs)
 
@@ -279,7 +287,30 @@ module Eco
             file_manager.load_json(kargs[:maps_file]),
             internal:    kargs[:internal],
             insensitive: kargs[:insensitive]
-          )
+          ).tap do |mapper|
+            next unless valid_internal_values.is_a?(Array)
+
+            valid_internal_values = valid_internal_values.compact
+            valid_internal_values = valid_internal_values.map(&:upcase) if kargs[:insensitive]
+
+            unexpected = mapper.list(:internal).each_with_object([]) do |value, out|
+              out << value unless valid_internal_values.include?(value.upcase)
+            end
+
+            next unless unexpected.any?
+
+            unexpected = unexpected.uniq.sort.map do |internal|
+              "#{internal} (mapped from '#{mapper.to_external(internal)}')"
+            end
+
+            session.log(:warn) {
+              msg = "The location mappings file has mappings to "
+              msg << "non active or unknown location node IDs:"
+              msg << "\n * "
+              msg << unexpected.join("\n * ")
+              msg
+            }
+          end
         end
 
         def tagtree=(file)

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

@@ -22,6 +22,12 @@ module Eco::API::UseCases::GraphQL::Samples::Location::Service
           msg << "Given: #{csv.class}"
           raise ArgumentError, msg unless csv.is_a?(Eco::CSV::Table)
 
+          csv = csv.transform_headers do |name|
+            name = name.to_s.strip.downcase
+            name = 'classifications' if name == 'classification_ids'
+            name
+          end
+
           csv.each do |row|
             row_transform&.call(row)
             transform_classifications(row)

data/lib/eco/data/mapper.rb

@@ -2,7 +2,11 @@ module Eco
   module Data
     class Mapper
       # it expects [[v1a, v1b], [v2a, v2b] ...]
-      def initialize(array_of_arrays = [], internal: :last, insensitive: false)
+      def initialize(
+        array_of_arrays = [],
+        internal:         :last,
+        insensitive:      false
+      )
         @internal_order = internal
         @source         = array_of_arrays
         @insensitive    = insensitive

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = '3.2.7'.freeze
+  VERSION = '3.2.9'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 3.2.7
+  version: 3.2.9
 platform: ruby
 authors:
 - Oscar Segura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-09 00:00:00.000000000 Z
+date: 2025-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug