cmdx 1.21.0 → 2.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 1.21.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Juan Gomez
@@ -37,20 +37,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: zeitwerk
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -65,20 +51,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: cmdx-rspec
-  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: i18n
   requirement: !ruby/object:Gem::Requirement
@@ -234,15 +206,13 @@ files:
 - Rakefile
 - lib/cmdx.rb
 - lib/cmdx/.DS_Store
-- lib/cmdx/attribute.rb
-- lib/cmdx/attribute_registry.rb
-- lib/cmdx/attribute_value.rb
-- lib/cmdx/callback_registry.rb
+- lib/cmdx/callbacks.rb
 - lib/cmdx/chain.rb
-- lib/cmdx/coercion_registry.rb
+- lib/cmdx/coercions.rb
 - lib/cmdx/coercions/array.rb
 - lib/cmdx/coercions/big_decimal.rb
 - lib/cmdx/coercions/boolean.rb
+- lib/cmdx/coercions/coerce.rb
 - lib/cmdx/coercions/complex.rb
 - lib/cmdx/coercions/date.rb
 - lib/cmdx/coercions/date_time.rb
@@ -255,35 +225,51 @@ files:
 - lib/cmdx/coercions/time.rb
 - lib/cmdx/configuration.rb
 - lib/cmdx/context.rb
-- lib/cmdx/deprecator.rb
+- lib/cmdx/deprecation.rb
+- lib/cmdx/deprecators.rb
+- lib/cmdx/deprecators/error.rb
+- lib/cmdx/deprecators/log.rb
+- lib/cmdx/deprecators/warn.rb
 - lib/cmdx/errors.rb
-- lib/cmdx/exception.rb
-- lib/cmdx/executor.rb
+- lib/cmdx/executors.rb
+- lib/cmdx/executors/fiber.rb
+- lib/cmdx/executors/thread.rb
 - lib/cmdx/fault.rb
-- lib/cmdx/identifier.rb
-- lib/cmdx/locale.rb
+- lib/cmdx/i18n_proxy.rb
+- lib/cmdx/input.rb
+- lib/cmdx/inputs.rb
 - lib/cmdx/log_formatters/json.rb
 - lib/cmdx/log_formatters/key_value.rb
 - lib/cmdx/log_formatters/line.rb
 - lib/cmdx/log_formatters/logstash.rb
 - lib/cmdx/log_formatters/raw.rb
-- lib/cmdx/middleware_registry.rb
-- lib/cmdx/middlewares/correlate.rb
-- lib/cmdx/middlewares/runtime.rb
-- lib/cmdx/middlewares/timeout.rb
-- lib/cmdx/parallelizer.rb
+- lib/cmdx/logger_proxy.rb
+- lib/cmdx/mergers.rb
+- lib/cmdx/mergers/deep_merge.rb
+- lib/cmdx/mergers/last_write_wins.rb
+- lib/cmdx/mergers/no_merge.rb
+- lib/cmdx/middlewares.rb
+- lib/cmdx/output.rb
+- lib/cmdx/outputs.rb
 - lib/cmdx/pipeline.rb
 - lib/cmdx/railtie.rb
 - lib/cmdx/result.rb
+- lib/cmdx/retriers.rb
+- lib/cmdx/retriers/bounded_random.rb
+- lib/cmdx/retriers/decorrelated_jitter.rb
+- lib/cmdx/retriers/exponential.rb
+- lib/cmdx/retriers/fibonacci.rb
+- lib/cmdx/retriers/full_random.rb
+- lib/cmdx/retriers/half_random.rb
+- lib/cmdx/retriers/linear.rb
 - lib/cmdx/retry.rb
+- lib/cmdx/runtime.rb
 - lib/cmdx/settings.rb
+- lib/cmdx/signal.rb
 - lib/cmdx/task.rb
-- lib/cmdx/utils/call.rb
-- lib/cmdx/utils/condition.rb
-- lib/cmdx/utils/format.rb
-- lib/cmdx/utils/normalize.rb
-- lib/cmdx/utils/wrap.rb
-- lib/cmdx/validator_registry.rb
+- lib/cmdx/telemetry.rb
+- lib/cmdx/util.rb
+- lib/cmdx/validators.rb
 - lib/cmdx/validators/absence.rb
 - lib/cmdx/validators/exclusion.rb
 - lib/cmdx/validators/format.rb
@@ -291,101 +277,16 @@ files:
 - lib/cmdx/validators/length.rb
 - lib/cmdx/validators/numeric.rb
 - lib/cmdx/validators/presence.rb
+- lib/cmdx/validators/validate.rb
 - lib/cmdx/version.rb
 - lib/cmdx/workflow.rb
 - lib/generators/cmdx/install_generator.rb
-- lib/generators/cmdx/locale_generator.rb
 - lib/generators/cmdx/task_generator.rb
 - lib/generators/cmdx/templates/install.rb
 - lib/generators/cmdx/templates/task.rb.tt
 - lib/generators/cmdx/templates/workflow.rb.tt
 - lib/generators/cmdx/workflow_generator.rb
-- lib/locales/af.yml
-- lib/locales/ar.yml
-- lib/locales/az.yml
-- lib/locales/be.yml
-- lib/locales/bg.yml
-- lib/locales/bn.yml
-- lib/locales/bs.yml
-- lib/locales/ca.yml
-- lib/locales/cnr.yml
-- lib/locales/cs.yml
-- lib/locales/cy.yml
-- lib/locales/da.yml
-- lib/locales/de.yml
-- lib/locales/dz.yml
-- lib/locales/el.yml
 - lib/locales/en.yml
-- lib/locales/eo.yml
-- lib/locales/es.yml
-- lib/locales/et.yml
-- lib/locales/eu.yml
-- lib/locales/fa.yml
-- lib/locales/fi.yml
-- lib/locales/fr.yml
-- lib/locales/fy.yml
-- lib/locales/gd.yml
-- lib/locales/gl.yml
-- lib/locales/he.yml
-- lib/locales/hi.yml
-- lib/locales/hr.yml
-- lib/locales/hu.yml
-- lib/locales/hy.yml
-- lib/locales/id.yml
-- lib/locales/is.yml
-- lib/locales/it.yml
-- lib/locales/ja.yml
-- lib/locales/ka.yml
-- lib/locales/kk.yml
-- lib/locales/km.yml
-- lib/locales/kn.yml
-- lib/locales/ko.yml
-- lib/locales/lb.yml
-- lib/locales/lo.yml
-- lib/locales/lt.yml
-- lib/locales/lv.yml
-- lib/locales/mg.yml
-- lib/locales/mk.yml
-- lib/locales/ml.yml
-- lib/locales/mn.yml
-- lib/locales/mr-IN.yml
-- lib/locales/ms.yml
-- lib/locales/nb.yml
-- lib/locales/ne.yml
-- lib/locales/nl.yml
-- lib/locales/nn.yml
-- lib/locales/oc.yml
-- lib/locales/or.yml
-- lib/locales/pa.yml
-- lib/locales/pl.yml
-- lib/locales/pt.yml
-- lib/locales/rm.yml
-- lib/locales/ro.yml
-- lib/locales/ru.yml
-- lib/locales/sc.yml
-- lib/locales/sk.yml
-- lib/locales/sl.yml
-- lib/locales/sq.yml
-- lib/locales/sr.yml
-- lib/locales/st.yml
-- lib/locales/sv.yml
-- lib/locales/sw.yml
-- lib/locales/ta.yml
-- lib/locales/te.yml
-- lib/locales/th.yml
-- lib/locales/tl.yml
-- lib/locales/tr.yml
-- lib/locales/tt.yml
-- lib/locales/ug.yml
-- lib/locales/uk.yml
-- lib/locales/ur.yml
-- lib/locales/uz.yml
-- lib/locales/vi.yml
-- lib/locales/wo.yml
-- lib/locales/zh-CN.yml
-- lib/locales/zh-HK.yml
-- lib/locales/zh-TW.yml
-- lib/locales/zh-YUE.yml
 - mkdocs.yml
 homepage: https://github.com/drexed/cmdx
 licenses:
@@ -404,14 +305,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.11
 specification_version: 4
 summary: CMDx is a framework for building maintainable business processes.
 test_files: []

data/lib/cmdx/attribute.rb

@@ -1,440 +0,0 @@
-# frozen_string_literal: true
-
-module CMDx
-  # Represents a configurable attribute within a CMDx task.
-  # Attributes define the data structure and validation rules for task parameters.
-  # They can be nested to create complex hierarchical data structures.
-  class Attribute
-
-    # @rbs AFFIX: Proc
-    AFFIX = proc do |value, &block|
-      value == true ? block.call : value
-    end.freeze
-    private_constant :AFFIX
-
-    # Returns the task instance associated with this attribute.
-    #
-    # @return [CMDx::Task] The task instance
-    #
-    # @example
-    #   attribute.task.context[:user_id] # => 42
-    #
-    # @rbs @task: Task
-    attr_accessor :task
-
-    # Returns the name of this attribute.
-    #
-    # @return [Symbol] The attribute name
-    #
-    # @example
-    #   attribute.name # => :user_id
-    #
-    # @rbs @name: Symbol
-    attr_reader :name
-
-    # Returns the configuration options for this attribute.
-    #
-    # @return [Hash{Symbol => Object}] Configuration options hash
-    #
-    # @example
-    #   attribute.options # => { required: true, default: 0 }
-    #
-    # @rbs @options: Hash[Symbol, untyped]
-    attr_reader :options
-
-    # Returns the child attributes for nested structures.
-    #
-    # @return [Array<Attribute>] Array of child attributes
-    #
-    # @example
-    #   attribute.children # => [#<Attribute @name=:street>, #<Attribute @name=:city>]
-    #
-    # @rbs @children: Array[Attribute]
-    attr_reader :children
-
-    # Returns the parent attribute if this is a nested attribute.
-    #
-    # @return [Attribute, nil] The parent attribute, or nil if root-level
-    #
-    # @example
-    #   attribute.parent # => #<Attribute @name=:address>
-    #
-    # @rbs @parent: (Attribute | nil)
-    attr_reader :parent
-
-    # Returns the expected type(s) for this attribute's value.
-    #
-    # @return [Array<Class>] Array of expected type classes
-    #
-    # @example
-    #   attribute.types # => [Integer, String]
-    #
-    # @rbs @types: Array[Class]
-    attr_reader :types
-
-    # Returns the description of the attribute.
-    #
-    # @return [String] The description of the attribute
-    #
-    # @example
-    #   attribute.description # => "The user's name"
-    #
-    # @rbs @description: String
-    attr_reader :description
-
-    # Creates a new attribute with the specified name and configuration.
-    #
-    # @param name [Symbol, String] The name of the attribute
-    # @param options [Hash] Configuration options for the attribute
-    # @option options [Attribute] :parent The parent attribute for nested structures
-    # @option options [Boolean] :required Whether the attribute is required (default: false)
-    # @option options [Array<Class>, Class] :types The expected type(s) for the attribute value
-    # @option options [String] :description The description of the attribute
-    # @option options [Symbol, String, Proc] :source The source of the attribute value
-    # @option options [Symbol, String] :as The method name to use for this attribute
-    # @option options [Symbol, String, Boolean] :prefix The prefix to add to the method name
-    # @option options [Symbol, String, Boolean] :suffix The suffix to add to the method name
-    # @option options [Object] :default The default value for the attribute
-    #
-    # @yield [self] Block to configure nested attributes
-    #
-    # @example
-    #   Attribute.new(:user_id, required: true, types: [Integer, String]) do
-    #     required :name, types: String
-    #     optional :email, types: String
-    #   end
-    #
-    # @rbs ((Symbol | String) name, ?Hash[Symbol, untyped] options) ?{ () -> void } -> void
-    def initialize(name, options = {}, &)
-      @parent = options.delete(:parent)
-      @required = options.delete(:required) || false
-      @types = Utils::Wrap.array(options.delete(:types) || options.delete(:type))
-      @description = options.delete(:description) || options.delete(:desc)
-
-      @name = name.to_sym
-      @options = options
-      @children = []
-
-      instance_eval(&) if block_given?
-    end
-
-    # Deep-copies children and clears task-dependent memoization so that
-    # duped attributes can be safely bound to a task without mutating the
-    # class-level originals. This makes concurrent execution thread-safe.
-    #
-    # @param source [Attribute] The attribute being duplicated
-    #
-    # @rbs (Attribute source) -> void
-    def initialize_dup(source)
-      super
-      @children = source.children.map(&:dup)
-      remove_instance_variable(:@source) if defined?(@source)
-      remove_instance_variable(:@method_name) if defined?(@method_name)
-      @task = nil
-    end
-
-    class << self
-
-      # Builds multiple attributes with the same configuration.
-      #
-      # @param names [Array<Symbol, String>] The names of the attributes to create
-      # @param options [Hash] Configuration options for the attributes
-      # @option options [Object] :* Any attribute configuration option
-      #
-      # @yield [self] Block to configure nested attributes
-      #
-      # @return [Array<Attribute>] Array of created attributes
-      #
-      # @raise [ArgumentError] When no names are provided or :as is used with multiple attributes
-      #
-      # @example
-      #   Attribute.build(:first_name, :last_name, required: true, types: String)
-      #
-      # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
-      def build(*names, **options, &)
-        if names.none?
-          raise ArgumentError, "no attributes given"
-        elsif (names.size > 1) && options.key?(:as)
-          raise ArgumentError, "the :as option only supports one attribute per definition"
-        end
-
-        names.filter_map { |name| new(name, **options, &) }
-      end
-
-      # Creates optional attributes (not required).
-      #
-      # @param names [Array<Symbol, String>] The names of the attributes to create
-      # @param options [Hash] Configuration options for the attributes
-      # @option options [Object] :* Any attribute configuration option
-      #
-      # @yield [self] Block to configure nested attributes
-      #
-      # @return [Array<Attribute>] Array of created optional attributes
-      #
-      # @example
-      #   Attribute.optional(:description, :tags, types: String)
-      #
-      # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
-      def optional(*names, **options, &)
-        build(*names, **options.merge(required: false), &)
-      end
-
-      # Creates required attributes.
-      #
-      # @param names [Array<Symbol, String>] The names of the attributes to create
-      # @param options [Hash] Configuration options for the attributes
-      # @option options [Object] :* Any attribute configuration option
-      #
-      # @yield [self] Block to configure nested attributes
-      #
-      # @return [Array<Attribute>] Array of created required attributes
-      #
-      # @example
-      #   Attribute.required(:id, :name, types: [Integer, String])
-      #
-      # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
-      def required(*names, **options, &)
-        build(*names, **options.merge(required: true), &)
-      end
-
-    end
-
-    # Checks if the attribute is optional.
-    #
-    # @return [Boolean] true if the attribute is optional, false otherwise
-    #
-    # @example
-    #   attribute.optional? # => true
-    #
-    # @rbs () -> bool
-    def optional?
-      !required? || !!options[:optional]
-    end
-
-    # Checks if the attribute is required.
-    #
-    # @return [Boolean] true if the attribute is required, false otherwise
-    #
-    # @example
-    #   attribute.required? # => true
-    #
-    # @rbs () -> bool
-    def required?
-      !!@required
-    end
-
-    # Determines the source of the attribute value. Returns :context
-    # as a safe fallback when task is not yet set (e.g., schema introspection).
-    #
-    # @return [Symbol] The source identifier for the attribute value
-    #
-    # @example
-    #   attribute.source # => :context
-    #
-    # @rbs () -> untyped
-    def source
-      return @source if defined?(@source)
-
-      parent&.method_name || begin
-        value = options[:source]
-
-        if value.is_a?(Proc)
-          task ? @source = task.instance_eval(&value) : :context
-        elsif value.respond_to?(:call)
-          task ? @source = value.call(task) : :context
-        else
-          @source = value || :context
-        end
-      end
-    end
-
-    # Returns the method name for this attribute when it can be resolved
-    # statically (without a task instance). Returns nil for Proc/callable
-    # sources whose method name depends on runtime evaluation.
-    #
-    # @return [Symbol, nil] The static method name, or nil if dynamic
-    #
-    # @example
-    #   attribute.allocation_name # => :user_name
-    #
-    # @rbs () -> Symbol?
-    def allocation_name
-      return @allocation_name if defined?(@allocation_name)
-
-      @allocation_name = options[:as] || begin
-        src = options[:source]
-        source_name =
-          if parent
-            parent.allocation_name
-          elsif !src.is_a?(Proc) && !src.respond_to?(:call)
-            src || :context
-          end
-
-        if source_name.is_a?(Symbol)
-          prefix = AFFIX.call(options[:prefix]) { "#{source_name}_" }
-          suffix = AFFIX.call(options[:suffix]) { "_#{source_name}" }
-          :"#{prefix}#{name}#{suffix}"
-        end
-      end
-    end
-
-    # Generates the method name for accessing this attribute.
-    #
-    # @return [Symbol] The method name for the attribute
-    #
-    # @example
-    #   attribute.method_name # => :user_name
-    #
-    # @rbs () -> Symbol
-    def method_name
-      return @method_name if defined?(@method_name)
-
-      result = options[:as] || begin
-        prefix = AFFIX.call(options[:prefix]) { "#{source}_" }
-        suffix = AFFIX.call(options[:suffix]) { "_#{source}" }
-        :"#{prefix}#{name}#{suffix}"
-      end
-
-      # Only memoize if @source is defined to avoid memoizing method
-      # name when no task is present.
-      return result unless defined?(@source)
-
-      @method_name = result
-    end
-
-    # Defines and verifies the entire attribute tree including nested children.
-    #
-    # @rbs () -> void
-    def define_and_verify_tree
-      define_and_verify
-
-      children.each do |child|
-        child.task = task
-        child.define_and_verify_tree
-      end
-    end
-
-    # Recursively clears the task reference from this attribute and all children.
-    # Prevents the class-level attribute from retaining the last-executed task instance.
-    #
-    # @rbs () -> void
-    def clear_task_tree!
-      @task = nil
-      children.each(&:clear_task_tree!)
-    end
-
-    # @return [Hash] A hash representation of the attribute
-    #
-    # @example
-    #   attribute.to_h # => {
-    #   name: :user_id,
-    #   method_name: :current_user_id,
-    #   description: "The user's name",
-    #   required: true,
-    #   types: [:integer],
-    #   options: {},
-    #   children: []
-    # }
-    #
-    # @rbs () -> Hash[Symbol, untyped]
-    def to_h
-      {
-        name: name,
-        method_name: method_name,
-        description: description,
-        required: required?,
-        types: types,
-        options: options.except(:if, :unless),
-        children: children.map(&:to_h)
-      }
-    end
-
-    private
-
-    # Creates nested attributes as children of this attribute.
-    #
-    # @param names [Array<Symbol, String>] The names of the child attributes
-    # @param options [Hash] Configuration options for the child attributes
-    # @option options [Object] :* Any attribute configuration option
-    #
-    # @yield [self] Block to configure the child attributes
-    #
-    # @return [Array<Attribute>] Array of created child attributes
-    #
-    # @example
-    #   attributes :street, :city, :zip, types: String
-    #
-    # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
-    def attributes(*names, **options, &)
-      attrs = self.class.build(*names, **options.merge(parent: self), &)
-      children.concat(attrs)
-    end
-    alias attribute attributes
-
-    # Creates optional nested attributes.
-    #
-    # @param names [Array<Symbol, String>] The names of the optional child attributes
-    # @param options [Hash] Configuration options for the child attributes
-    # @option options [Object] :* Any attribute configuration option
-    #
-    # @yield [self] Block to configure the child attributes
-    #
-    # @return [Array<Attribute>] Array of created optional child attributes
-    #
-    # @example
-    #   optional :middle_name, :nickname, types: String
-    #
-    # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
-    def optional(*names, **options, &)
-      attributes(*names, **options.merge(required: false), &)
-    end
-
-    # Creates required nested attributes.
-    #
-    # @param names [Array<Symbol, String>] The names of the required child attributes
-    # @param options [Hash] Configuration options for the child attributes
-    # @option options [Object] :* Any attribute configuration option
-    #
-    # @yield [self] Block to configure the child attributes
-    #
-    # @return [Array<Attribute>] Array of created required child attributes
-    #
-    # @example
-    #   required :first_name, :last_name, types: String
-    #
-    # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
-    def required(*names, **options, &)
-      attributes(*names, **options.merge(required: true), &)
-    end
-
-    # Defines the attribute reader on the task class (once) and
-    # generates/validates the per-instance value (every execution).
-    #
-    # @raise [RuntimeError] When the method name is already defined on the task
-    #
-    # @rbs () -> void
-    def define_and_verify
-      name_of_method = method_name
-
-      unless task.class.method_defined?(name_of_method)
-        if task.respond_to?(name_of_method, true)
-          raise <<~MESSAGE
-            The method #{name_of_method.inspect} is already defined on the #{task.class.name} task.
-            This may be due conflicts with one of the task's user defined or internal methods/attributes.
-
-            Use :as, :prefix, and/or :suffix attribute options to avoid conflicts with existing methods.
-          MESSAGE
-        end
-
-        task.class.define_method(name_of_method) do
-          attributes[name_of_method]
-        end
-      end
-
-      attribute_value = AttributeValue.new(self)
-      attribute_value.generate
-      attribute_value.validate
-    end
-
-  end
-end