eco-helpers 3.0.27 → 3.0.29

data/lib/eco/language/klass/inheritable_class_vars.rb

@@ -0,0 +1,45 @@
+module Eco::Language::Klass
+  module InheritableClassVars
+    include Naming
+
+    # Keeps track on class instance variables that should be inherited by child classes.
+    # @note
+    #   - subclasses will inherit the value as is at that moment
+    #   - any change afterwards will be only on the specific class (in line with class instance variables)
+    #   - adapted from https://stackoverflow.com/a/10729812/4352306
+    # TODO: this separates the logic of the method to the instance var.
+    #   Think if would be possible to join them somehow.
+    def inheritable_class_vars(*vars)
+      @inheritable_class_vars ||= [:inheritable_class_vars]
+      @inheritable_class_vars += vars
+    end
+
+    # Builds the attr_reader and attr_writer of `attrs` and registers
+    # the associated instance variable as inheritable.
+    def inheritable_attrs(*attrs)
+      attrs.each do |attr|
+        class_eval %(
+          class << self; attr_accessor :#{attr} end
+        ), __FILE__, __LINE__ - 2
+      end
+
+      inheritable_class_vars(*attrs)
+    end
+
+    # This callback method is called whenever a subclass of the current class is created.
+    # @note
+    #   - values of the instance variables are copied as they are (no dups or clones)
+    #   - the above means: avoid methods that change the state of the mutable object on it
+    #   - mutating methods would reflect the changes on other classes as well
+    #   - therefore, `freeze` will be called on the values that are inherited.
+    def inherited(subclass)
+      super
+
+      inheritable_class_vars.each do |var|
+        instance_var = instance_variable_name(var)
+        value        = instance_variable_get(instance_var)
+        subclass.instance_variable_set(instance_var, value.freeze)
+      end
+    end
+  end
+end

data/lib/eco/language/klass/naming.rb

@@ -0,0 +1,21 @@
+module Eco::Language::Klass
+  module Naming
+    # Helper to normalize `key` into a correct `ruby` **constant name**
+    # @param key [String, Symbol] to be normalized
+    # @return [String] a correct constant name
+    def to_constant(key)
+      key.to_s.strip.split(/[\-\_ ]/i).compact.map do |str|
+        str.slice(0).upcase + str.slice(1..-1).downcase
+      end.join
+    end
+
+    # Helper to create an instance variable `name`
+    # @param [String, Symbol] the name of the variable
+    # @reutrn [String] the name of the created instance variable
+    def instance_variable_name(name)
+      str = name.to_s
+      str = "@#{str}" unless str.start_with?("@")
+      str
+    end
+  end
+end

data/lib/eco/language/klass/resolver.rb

@@ -0,0 +1,30 @@
+module Eco::Language::Klass
+  module Resolver
+    # Creates a class and instance object methods with name `name` to resolve `klass` name
+    def class_resolver(name, klass)
+      define_singleton_method(name) { resolve_class(klass) }
+      define_method(name) { self.class.resolve_class(klass) }
+    end
+
+    # With given a `klass` name it resolves to an actual `Class`
+    # @return [Class] the class that was being searched by name `klass`.
+    def resolve_class(klass, exception: true)
+      @resolved ||= {}
+      @resolved[klass] ||=
+        case klass
+        when Class
+          klass
+        when String
+          begin
+            Kernel.const_get(klass)
+          rescue NameError
+            raise if exception
+          end
+        when Symbol
+          resolve_class(send(klass))
+        else
+          raise "Unknown class: #{klass}" if exception
+        end
+    end
+  end
+end

data/lib/eco/language/klass/when_inherited.rb

@@ -1,18 +1,15 @@
-module Eco
-  module Language
-    module Klass
-      module WhenInherited
-        def inherited(subclass)
-          super
-          subclass.instance_exec(&when_inherited)
-        end
+module Eco::Language::Klass
+  module WhenInherited
+    def inherited(subclass)
+      super
 
-        def when_inherited(&block)
-          return @when_inherited unless block_given?
+      subclass.instance_exec(&when_inherited)
+    end
+
+    def when_inherited(&block)
+      return @when_inherited unless block_given?
 
-          @when_inherited = block
-        end
-      end
+      @when_inherited = block
     end
   end
 end

data/lib/eco/language/klass.rb

@@ -5,4 +5,10 @@ module Eco
   end
 end
 
+require_relative 'klass/resolver'
+require_relative 'klass/naming'
+require_relative 'klass/builder'
+require_relative 'klass/hierarchy'
 require_relative 'klass/when_inherited'
+require_relative 'klass/inheritable_class_vars'
+require_relative 'klass/helpers_built'

data/lib/eco/language/methods.rb

@@ -6,5 +6,4 @@ module Eco
 end
 
 require_relative 'methods/call_detector'
-require_relative 'methods/delegate_missing'
 require_relative 'methods/dsl_able'

data/lib/eco/language/strings/underscore.rb

@@ -0,0 +1,17 @@
+module Eco::Language::Strings
+  module Underscore
+    private
+
+    # @see https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-underscore
+    def underscore(sym)
+      return super if defined?(super)
+      return sym.to_s.dup unless /[A-Z-]|::/.match?(sym)
+
+      word = sym.to_s.gsub('::', '/')
+      word.gsub!(/(?<=[A-Z])(?=[A-Z][a-z])|(?<=[a-z\d])(?=[A-Z])/, '_')
+      word.tr!('-', '_')
+      word.downcase!
+      word
+    end
+  end
+end

data/lib/eco/language/strings.rb

@@ -0,0 +1,8 @@
+module Eco
+  module Language
+    module Strings
+    end
+  end
+end
+
+require_relative 'strings/underscore'

data/lib/eco/language.rb

@@ -3,6 +3,7 @@ module Eco
   end
 end
 
+require_relative 'language/strings'
 require_relative 'language/klass'
 require_relative 'language/methods'
 require_relative 'language/models'

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = '3.0.27'.freeze
+  VERSION = '3.0.29'.freeze
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 3.0.27
+  version: 3.0.29
 platform: ruby
 authors:
 - Oscar Segura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-28 00:00:00.000000000 Z
+date: 2025-03-31 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -898,6 +912,8 @@ 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/service.rb
+- lib/eco/api/usecases/service/sftp.rb
 - lib/eco/api/usecases/use_case.rb
 - lib/eco/api/usecases/use_case/chainer.rb
 - lib/eco/api/usecases/use_case_chain.rb
@@ -987,18 +1003,29 @@ files:
 - lib/eco/language/basic_logger.rb
 - lib/eco/language/curry.rb
 - lib/eco/language/delegation.rb
-- lib/eco/language/delegation/const_delegator.rb
-- lib/eco/language/delegation/const_lookup_hooks.rb
-- lib/eco/language/delegation/delegated_class.rb
+- lib/eco/language/delegation/chainable_delegator.rb
+- lib/eco/language/delegation/delegating_blank.rb
+- lib/eco/language/delegation/delegating_missing.rb
+- lib/eco/language/delegation/delegating_missing_const.rb
+- lib/eco/language/delegation/delegating_missing_on_class.rb
+- lib/eco/language/delegation/for_delegator.rb
+- lib/eco/language/delegation/for_delegator/const_delegator.rb
+- lib/eco/language/delegation/for_delegator/const_lookup_hooks.rb
+- lib/eco/language/delegation/for_delegator/delegated_class.rb
 - lib/eco/language/hash_transform.rb
 - lib/eco/language/hash_transform_modifier.rb
 - lib/eco/language/klass.rb
+- lib/eco/language/klass/builder.rb
+- lib/eco/language/klass/helpers_built.rb
+- lib/eco/language/klass/hierarchy.rb
+- lib/eco/language/klass/inheritable_class_vars.rb
+- lib/eco/language/klass/naming.rb
+- lib/eco/language/klass/resolver.rb
 - lib/eco/language/klass/when_inherited.rb
 - lib/eco/language/match.rb
 - lib/eco/language/match_modifier.rb
 - lib/eco/language/methods.rb
 - lib/eco/language/methods/call_detector.rb
-- lib/eco/language/methods/delegate_missing.rb
 - lib/eco/language/methods/dsl_able.rb
 - lib/eco/language/models.rb
 - lib/eco/language/models/class_helpers.rb
@@ -1006,6 +1033,8 @@ files:
 - lib/eco/language/models/modifier.rb
 - lib/eco/language/models/parser_serializer.rb
 - lib/eco/language/models/wrap.rb
+- lib/eco/language/strings.rb
+- lib/eco/language/strings/underscore.rb
 - lib/eco/language/values_at.rb
 - lib/eco/version.rb
 homepage: https://www.ecoportal.com

data/lib/eco/language/methods/delegate_missing.rb

@@ -1,30 +0,0 @@
-module Eco
-  module Language
-    module Methods
-      module DelegateMissing
-        def delegate_missing_to(meth)
-          @delegate_missing_to = meth
-        end
-
-        def method_missing(method_name, *args, **kargs, &block)
-          super unless (receiver = object_missing_delegated_to)
-
-          receiver.send(method_name, *args, **kargs, &block)
-        end
-
-        def respond_to_missing?(method_name, include_private = false)
-          super
-        end
-
-        private
-
-        # retrieve the delegate_missing_to object
-        def object_missing_delegated_to
-          return unless @delegate_missing_to
-
-          method(@delegate_missing_to).call
-        end
-      end
-    end
-  end
-end