cmdx 1.5.0 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de49105a37f479ac8172f6329536b45a976adbb4e09c43b9351e329dbf662760
-  data.tar.gz: 7b100f2619d36ae0ac287c108bbab114168d87528beb1751951ac1282dbc37d3
+  metadata.gz: 14a2616a171c3c514fbc553369936eac48fe2fd3d8e406cc4780ee39a483637f
+  data.tar.gz: 28d973a4973c4f2dc5e3acf1c1a09d4a0e0fbe158bc2f3553a5722acb9490051
 SHA512:
-  metadata.gz: becbfc6dcc4657b16697559c91bac79a2416610655f2831cef74745d30720ac6e0f64991b442229384c8c98259f3b9dc0df706b60c988c01462a8a02eb8ee097
-  data.tar.gz: e0dc0122625d710048768d0a31b39a1081ef800206e331f7e842b483c4639108177dbe83a6e1b47cbd08328ddfc5899e5d5b682ce65ec90287035b8e17a7d8f3
+  metadata.gz: 363225923cd389ddca29f5580321ef3fb3efe863b08480a31b505f67ca08db260695e752631f0b58912421679bc43b52bd679c6e3a0441a8d54628f7b09d855c
+  data.tar.gz: 7d479a75b0e048e9eb7385ce31b7f3bc10512856ba9fe95b34bde5b4a833822787a087d0420a6020830fc322846d72e80604ff3706d25795cc486707d1c31726

data/.cursor/rules/cursor-instructions.mdc

@@ -58,4 +58,3 @@ business logic within service/command objects.
   - Keep comments up-to-date with code changes
   - Keep documentation consistent
 - Update CHANGELOG.md with any changes
-

data/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [TODO]
 
+## [1.5.2] - 2025-08-22
+
+### Changes
+- Rename the workflow `execution_groups` attribute to `pipeline`
+
+## [1.5.1] - 2025-08-21
+
+### Changes
+- Prefix I18n with `::` to play nice with `CMDx::I18n`
+- Safe navigate length and numeric validators
+- Update railtie file path points to correct directory
+
 ## [1.5.0] - 2025-08-21
 
 ### Changes

data/LLM.md

@@ -44,11 +44,20 @@ Globally these settings are initialized with sensible defaults.
 
 ### Breakpoints
 
-Breakpoints control when `execute!` raises faults.
+Raise `CMDx::Fault` when a task called with `execute!` returns a matching status.
 
 ```ruby
 CMDx.configure do |config|
-  config.task_breakpoints = "skipped"
+  # String or Array[String]
+  config.task_breakpoints = "failed"
+end
+```
+
+Workflow breakpoints stops execution and of workflow pipeline on the first task that returns a matching status and throws its `CMDx::Fault`.
+
+```ruby
+CMDx.configure do |config|
+  # String or Array[String]
   config.workflow_breakpoints = ["skipped", "failed"]
 end
 ```
@@ -2964,7 +2973,7 @@ Workflow orchestrates sequential execution of multiple tasks in a linear pipelin
 
 ## Declarations
 
-Tasks execute in declaration order (FIFO). The workflow context propagates to each task, allowing access to data from previous executions.
+Tasks execute sequentially in declaration order (FIFO). The workflow context propagates to each task, allowing access to data from previous executions.
 
 > [!IMPORTANT]
 > Do **NOT** define a `work` method in workflow tasks. The included module automatically provides the execution logic.

data/README.md

@@ -122,13 +122,12 @@ end
 
 ## Ecosystem
 
+- [cmdx-i18n](https://github.com/drexed/cmdx-i18n) - 85+ translations
+
 The following gems are currently under development:
 
-- `cmdx-i18n` I18n locales
-- `cmdx-rspec` RSpec matchers
-- `cmdx-minitest` Minitest matchers
-- `cmdx-jobs` Background job integrations
-- `cmdx-parallel` Parallel workflow task execution
+- `cmdx-testing` - RSpec and Minitest matchers
+- `cmdx-parallel` - Parallel workflow task execution
 
 ## Development
 

data/docs/getting_started.md

@@ -54,11 +54,20 @@ Globally these settings are initialized with sensible defaults.
 
 ### Breakpoints
 
-Breakpoints control when `execute!` raises faults.
+Raise `CMDx::Fault` when a task called with `execute!` returns a matching status.
 
 ```ruby
 CMDx.configure do |config|
-  config.task_breakpoints = "skipped"
+  # String or Array[String]
+  config.task_breakpoints = "failed"
+end
+```
+
+Workflow breakpoints stops execution and of workflow pipeline on the first task that returns a matching status and throws its `CMDx::Fault`.
+
+```ruby
+CMDx.configure do |config|
+  # String or Array[String]
   config.workflow_breakpoints = ["skipped", "failed"]
 end
 ```

data/docs/workflows.md

@@ -15,7 +15,7 @@ Workflow orchestrates sequential execution of multiple tasks in a linear pipelin
 
 ## Declarations
 
-Tasks execute in declaration order (FIFO). The workflow context propagates to each task, allowing access to data from previous executions.
+Tasks execute sequentially in declaration order (FIFO). The workflow context propagates to each task, allowing access to data from previous executions.
 
 > [!IMPORTANT]
 > Do **NOT** define a `work` method in workflow tasks. The included module automatically provides the execution logic.

data/lib/cmdx/locale.rb

@@ -36,7 +36,7 @@ module CMDx
     #   # => "Custom fallback message"
     def translate(key, **options)
       options[:default] ||= EN.dig("en", *key.to_s.split("."))
-      return I18n.t(key, **options) if defined?(I18n)
+      return ::I18n.t(key, **options) if defined?(::I18n)
 
       case message = options.delete(:default)
       when NilClass then "Translation missing: #{key}"

data/lib/cmdx/railtie.rb

@@ -23,7 +23,7 @@ module CMDx
     #   # in the CMDx gem's locales directory
     initializer("cmdx.configure_locales") do |app|
       Array(app.config.i18n.available_locales).each do |locale|
-        path = CMDx.gem_path.join("locales/#{locale}.yml")
+        path = CMDx.gem_path.join("lib/locales/#{locale}.yml")
         next unless File.file?(path)
 
         I18n.load_path << path

data/lib/cmdx/validators/length.rb

@@ -52,25 +52,27 @@ module CMDx
       #   Length.call("short", not_in: 1..3)
       #   # => nil (validation passes - length 5 is not in excluded range)
       def call(value, options = {})
+        length = value&.length
+
         case options
         in within:
-          raise_within_validation_error!(within.begin, within.end, options) unless within.cover?(value.length)
+          raise_within_validation_error!(within.begin, within.end, options) unless within&.cover?(length)
         in not_within:
-          raise_not_within_validation_error!(not_within.begin, not_within.end, options) if not_within.cover?(value.length)
+          raise_not_within_validation_error!(not_within.begin, not_within.end, options) if not_within&.cover?(length)
         in in: xin
-          raise_within_validation_error!(xin.begin, xin.end, options) unless xin.cover?(value.length)
+          raise_within_validation_error!(xin.begin, xin.end, options) unless xin&.cover?(length)
         in not_in:
-          raise_not_within_validation_error!(not_in.begin, not_in.end, options) if not_in.cover?(value.length)
+          raise_not_within_validation_error!(not_in.begin, not_in.end, options) if not_in&.cover?(length)
         in min:, max:
-          raise_within_validation_error!(min, max, options) unless value.length.between?(min, max)
+          raise_within_validation_error!(min, max, options) unless length&.between?(min, max)
         in min:
-          raise_min_validation_error!(min, options) unless min <= value.length
+          raise_min_validation_error!(min, options) unless !length.nil? && (min <= length)
         in max:
-          raise_max_validation_error!(max, options) unless value.length <= max
+          raise_max_validation_error!(max, options) unless !length.nil? && (length <= max)
         in is:
-          raise_is_validation_error!(is, options) unless value.length == is
+          raise_is_validation_error!(is, options) unless !length.nil? && (length == is)
         in is_not:
-          raise_is_not_validation_error!(is_not, options) if value.length == is_not
+          raise_is_not_validation_error!(is_not, options) if !length.nil? && (length == is_not)
         else
           raise ArgumentError, "unknown length validator options given"
         end

data/lib/cmdx/validators/numeric.rb

@@ -51,23 +51,23 @@ module CMDx
       def call(value, options = {})
         case options
         in within:
-          raise_within_validation_error!(within.begin, within.end, options) unless within.cover?(value)
+          raise_within_validation_error!(within.begin, within.end, options) unless within&.cover?(value)
         in not_within:
-          raise_not_within_validation_error!(not_within.begin, not_within.end, options) if not_within.cover?(value)
+          raise_not_within_validation_error!(not_within.begin, not_within.end, options) if not_within&.cover?(value)
         in in: xin
-          raise_within_validation_error!(xin.begin, xin.end, options) unless xin.cover?(value)
+          raise_within_validation_error!(xin.begin, xin.end, options) unless xin&.cover?(value)
         in not_in:
-          raise_not_within_validation_error!(not_in.begin, not_in.end, options) if not_in.cover?(value)
+          raise_not_within_validation_error!(not_in.begin, not_in.end, options) if not_in&.cover?(value)
         in min:, max:
-          raise_within_validation_error!(min, max, options) unless value.between?(min, max)
+          raise_within_validation_error!(min, max, options) unless value&.between?(min, max)
         in min:
-          raise_min_validation_error!(min, options) unless min <= value
+          raise_min_validation_error!(min, options) unless !value.nil? && (min <= value)
         in max:
-          raise_max_validation_error!(max, options) unless value <= max
+          raise_max_validation_error!(max, options) unless !value.nil? && (value <= max)
         in is:
-          raise_is_validation_error!(is, options) unless value == is
+          raise_is_validation_error!(is, options) unless !value.nil? && (value == is)
         in is_not:
-          raise_is_not_validation_error!(is_not, options) if value == is_not
+          raise_is_not_validation_error!(is_not, options) if !value.nil? && (value == is_not)
         else
           raise ArgumentError, "unknown numeric validator options given"
         end

data/lib/cmdx/version.rb

@@ -2,6 +2,6 @@
 
 module CMDx
 
-  VERSION = "1.5.0"
+  VERSION = "1.5.2"
 
 end

data/lib/cmdx/workflow.rb

@@ -35,10 +35,10 @@ module CMDx
       #     include CMDx::Workflow
       #     task Task1
       #     task Task2
-      #     puts execution_groups.size # => 2
+      #     puts pipeline.size # => 2
       #   end
-      def execution_groups
-        @execution_groups ||= []
+      def pipeline
+        @pipeline ||= []
       end
 
       # Adds multiple tasks to the workflow with optional configuration.
@@ -56,7 +56,7 @@ module CMDx
       #     tasks ValidateTask, ProcessTask, NotifyTask, breakpoints: [:failure, :halt]
       #   end
       def tasks(*tasks, **options)
-        execution_groups << ExecutionGroup.new(
+        pipeline << ExecutionGroup.new(
           tasks.map do |task|
             next task if task.is_a?(Class) && (task <= Task)
 
@@ -107,7 +107,7 @@ module CMDx
     #   workflow = DataProcessingWorkflow.new
     #   workflow.work # Stops on first breakpoint encountered
     def work
-      self.class.execution_groups.each do |group|
+      self.class.pipeline.each do |group|
         next unless Utils::Condition.evaluate(self, group.options, self)
 
         breakpoints = group.options[:breakpoints] || self.class.settings[:workflow_breakpoints]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.5.2
 platform: ruby
 authors:
 - Juan Gomez
@@ -163,9 +163,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: A framework that provides structured command execution, attribute management,
-  validation, coercion, callbacks, and workflow orchestration for building maintainable
-  business processes.
+description: CMDx is a framework for building maintainable business processes.
 email:
 - drexed@users.noreply.github.com
 executables: []