cmdx 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aed549d510aee08ccdb114f75b51b7aefe1a9776905f53e75ec5c39477932350
-  data.tar.gz: b57596b1393185082d94616f8c08494d030a2d78bb85610674363a365efa15f5
+  metadata.gz: da7809a9d556cc2cb4cc5734fe52790f4e964ccc437728e1c78cef2a6e2121ec
+  data.tar.gz: 9577047cd8a98bc19fe81c02366aebf70c295e738e3083c478ab670c8af55048
 SHA512:
-  metadata.gz: 7d123c5a08fc89494b759eddea90e614858e55db733a3690e899de46b5e6e93e574a9bf2d9899f4f9c9c118686d5ff2f84cfd75b110ce242b79d7627ae3dfbd8
-  data.tar.gz: 17e336e03307f3dddaf7dba53d4a201f031f54348bc0e43059a17ace90cf7f4a762ad6e97ec731b32d1064616c978948867e8aa746ff96f52e93996376828a7c
+  metadata.gz: 3101e89eafcaf552fa64db81fdc0547628e23636564097ae91fb5dc726cbe25bcfbb6c44a04619cbbfcfe41f29f9a42a658bcd045a1a035f85b0c098d20a6038
+  data.tar.gz: 97450b9d1018dfc80d73fac8b0072356c4a1e05f39fc377cbf517468a412c77041bb1376ae0b3a72fb34575709fa169115ebf69ae7285a75fe41d453b21ee247

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-03-07
+## [0.3.0] - 2025-03-14
+### Added
+- Add `progname` to logger instances
+- Add `LoggerSerializer` to standardize log output
+### Changed
+- Revert default log formatter to `Line`
+- Removed `pid` from result serializer
+- Fix serialization of frozen run
+- Fix `call!` not marking state of failure as interrupted
+
+## [0.2.0] - 2025-03-12
+### Added
+- Add `PrettyJson` log formatter
+- Add `PrettyKeyValue` log formatter
+- Add `PrettyLine` log formatter
+### Changed
+- Make `PrettyLine` the default log formatter
+- Rename `MethodName` util to `NameAffix`
+- Rename `DatetimeFormatter` util to `LogTimestamp`
+- Rename `Runtime` util to `MonotonicRuntime`
+- Fix logging non hash values from raising an error
+- Fix bubbling of faults with nested halted calls
+- Wrap result logger in a `Logger#with_logger` block
 
+## [0.1.0] - 2025-03-07
+### Added
 - Initial release

data/README.md

@@ -2,8 +2,8 @@
 
 [![forthebadge](http://forthebadge.com/images/badges/made-with-ruby.svg)](http://forthebadge.com)
 
-[![Gem Version](https://badge.fury.io/rb/cmdx.svg)](https://badge.fury.io/rb/cmdx)
-[![CI](https://github.com/drexed/cmdx/actions/workflows/ruby.yml/badge.svg)](https://github.com/drexed/cmdx/actions/workflows/ruby.yml)
+[![Gem Version](https://badge.fury.io/rb/cmdx.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/cmdx)
+[![CI](https://github.com/drexed/cmdx/actions/workflows/ci.yml/badge.svg)](https://github.com/drexed/cmdx/actions/workflows/ci.yml)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=shields)](http://makeapullrequest.com)
 
 `CMDx` is a framework for expressive processing of business logic. Design

data/docs/logging.md

@@ -5,31 +5,33 @@ tasks executing concurrently so `CMDx` uses a custom logger to make debugging ea
 
 ## Output
 
-Built-in log formatters are: `Line` (default), `Json`, `KeyValue`, `Logstash`, `Raw`
+Built-in log formatters are:
+- Standard: `Line`, `Json`, `KeyValue`, `Logstash`, `Raw`
+- Stylized: `PrettyLine` (default), `PrettyJson`, `PrettyKeyValue`
 
 #### Success:
 ```txt
-I, [2022-07-17T18:43:15.000000 #3784] INFO -- CMDx: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task class=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 state=complete status=success outcome=success metadata={} runtime=0 tags=[] pid=3784
+I, [2022-07-17T18:43:15.000000 #3784] INFO -- SimulationTask: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task task=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 tags=[] state=complete status=success outcome=success metadata={} runtime=0 origin=CMDx
 ```
 
 #### Skipped:
 ```txt
-W, [2022-07-17T18:43:15.000000 #3784] WARN -- CMDx: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task class=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 state=interrupted status=skipped outcome=skipped metadata={} runtime=0 tags=[] pid=3784
+W, [2022-07-17T18:43:15.000000 #3784] WARN -- SimulationTask: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task task=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 tags=[] state=interrupted status=skipped outcome=skipped metadata={} runtime=0 origin=CMDx
 ```
 
 #### Failed:
 ```txt
-E, [2022-07-17T18:43:15.000000 #3784] ERROR -- CMDx: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task class=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 state=interrupted status=failed outcome=failed metadata={} runtime=0 tags=[] pid=3784
+E, [2022-07-17T18:43:15.000000 #3784] ERROR -- SimulationTask: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task task=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 tags=[] state=interrupted status=failed outcome=failed metadata={} runtime=0 origin=CMDx
 ```
 
 #### Level 1 subtask failure:
 ```txt
-E, [2022-07-17T18:43:15.000000 #3784] ERROR -- CMDx: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task class=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 state=interrupted status=failed outcome=interrupted metadata={} runtime=0 tags=[] pid=3784 caused_failure={:index=>1, :run_id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :type=>"Task", :class=>"SimulationTask", :id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :state=>"interrupted", :status=>"failed", :outcome=>"failed", :metadata=>{}, :runtime=>0, :tags=>[], :pid=>3784} threw_failure={:index=>1, :run_id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :type=>"Task", :class=>"SimulationTask", :id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :state=>"interrupted", :status=>"failed", :outcome=>"failed", :metadata=>{}, :runtime=>0, :tags=>[], :pid=>3784}
+E, [2022-07-17T18:43:15.000000 #3784] ERROR -- SimulationTask: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task task=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 tags=[] state=interrupted status=failed outcome=interrupted metadata={} runtime=0 caused_failure={index: 1, run_id: "018c2b95-b764-7615-a924-cc5b910ed1e5", type: "Task", task: "SimulationTask", id: "018c2b95-b764-7615-a924-cc5b910ed1e5", tags: [], state: "interrupted", status: "failed", outcome: "failed", metadata: {}, runtime: 0} threw_failure={index: 1, run_id: "018c2b95-b764-7615-a924-cc5b910ed1e5", type: "Task", task: "SimulationTask", id: "018c2b95-b764-7615-a924-cc5b910ed1e5", tags: [], state: "interrupted", status: "failed", outcome: "failed", metadata: {}, runtime: 0} origin=CMDx
 ```
 
 #### Level 2+ subtask failure:
 ```txt
-E, [2022-07-17T18:43:15.000000 #3784] ERROR -- CMDx: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task class=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 state=interrupted status=failed outcome=interrupted metadata={} runtime=0 tags=[] pid=3784 caused_failure={:index=>2, :run_id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :type=>"Task", :class=>"SimulationTask", :id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :state=>"interrupted", :status=>"failed", :outcome=>"failed", :metadata=>{}, :runtime=>0, :tags=>[], :pid=>3784} threw_failure={:index=>1, :run_id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :type=>"Task", :class=>"SimulationTask", :id=>"018c2b95-b764-7615-a924-cc5b910ed1e5", :state=>"interrupted", :status=>"failed", :outcome=>"interrupted", :metadata=>{}, :runtime=>0, :tags=>[], :pid=>3784}
+E, [2022-07-17T18:43:15.000000 #3784] ERROR -- SimulationTask: index=0 run_id=018c2b95-b764-7615-a924-cc5b910ed1e5 type=Task task=SimulationTask id=018c2b95-b764-7615-a924-cc5b910ed1e5 tags=[] state=interrupted status=failed outcome=interrupted metadata={} runtime=0 caused_failure={index: 2, run_id: "018c2b95-b764-7615-a924-cc5b910ed1e5", type: "Task", task: "SimulationTask", id: "018c2b95-b764-7615-a924-cc5b910ed1e5", tags: [], state: "interrupted", status: "failed", outcome: "failed", metadata: {}, runtime: 0} threw_failure={index: 1, run_id: "018c2b95-b764-7615-a924-cc5b910ed1e5", type: "Task", task: "SimulationTask", id: "018c2b95-b764-7615-a924-cc5b910ed1e5", tags: [], state: "interrupted", status: "failed", outcome: "interrupted", metadata: {}, runtime: 0} origin=CMDx
 ```
 
 ## Logger
@@ -90,7 +92,7 @@ Define a custom log formatter to match your expected output, for example one tha
 
 ```ruby
 class CustomCmdxLogFormat
-  def call(severity, time, progname, message)
+  def call(severity, time, task, message)
     # Return string, hash, array, etc to output...
   end
 end

data/lib/cmdx/configuration.rb

@@ -14,7 +14,7 @@ module CMDx
 
   def reset_configuration!
     @configuration = LazyStruct.new(
-      logger: ::Logger.new($stdout, formatter: CMDx::LogFormatters::Line.new),
+      logger: ::Logger.new($stdout, formatter: CMDx::LogFormatters::Json.new),
       task_halt: CMDx::Result::FAILED,
       task_timeout: nil,
       batch_halt: CMDx::Result::FAILED,

data/lib/cmdx/core_ext/module.rb

@@ -6,7 +6,7 @@ module CMDx
 
       def __cmdx_attr_delegator(*methods, **options)
         methods.each do |method|
-          method_name = Utils::MethodName.call(method, options.fetch(:to), options)
+          method_name = Utils::NameAffix.call(method, options.fetch(:to), options)
 
           define_method(method_name) do |*args, **kwargs, &block|
             object = (options[:to] == :class ? self.class : send(options[:to]))

data/lib/cmdx/log_formatters/json.rb

@@ -4,8 +4,14 @@ module CMDx
   module LogFormatters
     class Json
 
-      def call(_severity, _time, _progname, message)
-        JSON.dump(message)
+      def call(severity, time, task, message)
+        m = LoggerSerializer.call(severity, time, task, message).merge!(
+          severity:,
+          pid: Process.pid,
+          timestamp: Utils::LogTimestamp.call(time.utc)
+        )
+
+        JSON.dump(m) << "\n"
       end
 
     end

data/lib/cmdx/log_formatters/key_value.rb

@@ -4,8 +4,15 @@ module CMDx
   module LogFormatters
     class KeyValue
 
-      def call(_severity, _time, _progname, message)
-        message.map { |k, v| "#{k}=#{v}" }.join(" ")
+      def call(severity, time, task, message)
+        m = LoggerSerializer.call(severity, time, task, message).merge!(
+          severity:,
+          pid: Process.pid,
+          timestamp: Utils::LogTimestamp.call(time.utc)
+        )
+
+        m = m.map { |k, v| "#{k}=#{v}" }.join(" ") if m.is_a?(Hash)
+        m << "\n"
       end
 
     end

data/lib/cmdx/log_formatters/line.rb

@@ -4,9 +4,12 @@ module CMDx
   module LogFormatters
     class Line
 
-      def call(severity, time, progname, message)
-        message = message.map { |k, v| "#{k}=#{v}" }.join(" ")
-        "#{severity[0]}, [#{Utils::DatetimeFormatter.call(time.utc)} ##{Process.pid}] #{severity} -- #{progname || 'CMDx'}: #{message}"
+      def call(severity, time, task, message)
+        t = Utils::LogTimestamp.call(time.utc)
+        m = LoggerSerializer.call(severity, time, task, message)
+        m = m.map { |k, v| "#{k}=#{v}" }.join(" ") if m.is_a?(Hash)
+
+        "#{severity[0]}, [#{t} ##{Process.pid}] #{severity} -- #{task.class.name}: #{m}\n"
       end
 
     end

data/lib/cmdx/log_formatters/logstash.rb

@@ -4,13 +4,15 @@ module CMDx
   module LogFormatters
     class Logstash
 
-      def call(_severity, time, _progname, message)
-        if message.is_a?(Hash)
-          message["@version"]   ||= "1"
-          message["@timestamp"] ||= Utils::DatetimeFormatter.call(time.utc)
-        end
+      def call(severity, time, task, message)
+        m = LoggerSerializer.call(severity, time, task, message).merge!(
+          severity:,
+          pid: Process.pid,
+          "@version" => "1",
+          "@timestamp" => Utils::LogTimestamp.call(time.utc)
+        )
 
-        JSON.dump(message)
+        JSON.dump(m) << "\n"
       end
 
     end

data/lib/cmdx/log_formatters/pretty_json.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CMDx
+  module LogFormatters
+    class PrettyJson
+
+      def call(severity, time, task, message)
+        m = LoggerSerializer.call(severity, time, task, message).merge!(
+          severity:,
+          pid: Process.pid,
+          timestamp: Utils::LogTimestamp.call(time.utc)
+        )
+
+        JSON.pretty_generate(m) << "\n"
+      end
+
+    end
+  end
+end

data/lib/cmdx/log_formatters/pretty_key_value.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CMDx
+  module LogFormatters
+    class PrettyKeyValue
+
+      def call(severity, time, task, message)
+        m = LoggerSerializer.call(severity, time, task, message, ansi_colorize: true).merge!(
+          severity:,
+          pid: Process.pid,
+          timestamp: Utils::LogTimestamp.call(time.utc)
+        )
+
+        m = m.map { |k, v| "#{k}=#{v}" }.join(" ") if m.is_a?(Hash)
+        m << "\n"
+      end
+
+    end
+  end
+end

data/lib/cmdx/log_formatters/pretty_line.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CMDx
+  module LogFormatters
+    class PrettyLine
+
+      def call(severity, time, task, message)
+        i = LoggerAnsi.call(severity[0])
+        s = LoggerAnsi.call(severity)
+        t = Utils::LogTimestamp.call(time.utc)
+        m = LoggerSerializer.call(severity, time, task, message, ansi_colorize: true)
+        m = m.map { |k, v| "#{k}=#{v}" }.join(" ") if m.is_a?(Hash)
+
+        "#{i}, [#{t} ##{Process.pid}] #{s} -- #{task.class.name}: #{m}\n"
+      end
+
+    end
+  end
+end

data/lib/cmdx/log_formatters/raw.rb

@@ -4,8 +4,8 @@ module CMDx
   module LogFormatters
     class Raw
 
-      def call(_severity, _time, _progname, message)
-        message
+      def call(_severity, _time, _task, message)
+        message.inspect << "\n"
       end
 
     end

data/lib/cmdx/logger.rb

@@ -9,6 +9,7 @@ module CMDx
       logger           = task.task_setting(:logger)
       logger.formatter = task.task_setting(:log_formatter) if task.task_setting?(:log_formatter)
       logger.level     = task.task_setting(:log_level) if task.task_setting?(:log_level)
+      logger.progname  = task
       logger
     end
 

data/lib/cmdx/logger_ansi.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module CMDx
+  module LoggerAnsi
+
+    SEVERITY_COLOR_CODES = {
+      "D" => 34, # DEBUG - Blue
+      "I" => 32, # INFO  - Green
+      "W" => 33, # WARN  - Yellow
+      "E" => 31, # ERROR - Red
+      "F" => 35  # FATAL - Magenta
+    }.freeze
+
+    module_function
+
+    def call(s)
+      c = SEVERITY_COLOR_CODES[s[0]] || 39 # Default
+      "\e[1;#{c}m#{s}\e[0m"
+    end
+
+  end
+end

data/lib/cmdx/logger_serializer.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CMDx
+  module LoggerSerializer
+
+    COLORED_KEYS = %i[
+      state status outcome
+    ].freeze
+
+    module_function
+
+    def call(_severity, _time, task, message, **options)
+      m = message.respond_to?(:to_h) ? message.to_h : {}
+
+      if options.delete(:ansi_colorize) && message.is_a?(Result)
+        COLORED_KEYS.each { |k| m[k] = ResultAnsi.call(m[k]) if m.key?(k) }
+      elsif !message.is_a?(Result)
+        m.merge!(
+          TaskSerializer.call(task),
+          message: message
+        )
+      end
+
+      m[:origin] ||= "CMDx"
+      m
+    end
+
+  end
+end

data/lib/cmdx/parameter.rb

@@ -60,7 +60,7 @@ module CMDx
     end
 
     def method_name
-      @method_name ||= Utils::MethodName.call(name, method_source, options)
+      @method_name ||= Utils::NameAffix.call(name, method_source, options)
     end
 
     def method_source

data/lib/cmdx/result.rb

@@ -28,6 +28,10 @@ module CMDx
       define_method(:"#{s}?") { state == s }
     end
 
+    def executed!
+      success? ? complete! : interrupt!
+    end
+
     def executed?
       complete? || interrupted?
     end
@@ -103,11 +107,13 @@ module CMDx
       raise Fault.build(self)
     end
 
-    def throw!(result)
+    def throw!(result, local_metadata = {})
       raise ArgumentError, "must be a Result" unless result.is_a?(Result)
 
-      skip!(**result.metadata) if result.skipped?
-      fail!(**result.metadata) if result.failed?
+      md = result.metadata.merge(local_metadata)
+
+      skip!(**md) if result.skipped?
+      fail!(**md) if result.failed?
     end
 
     def caused_failure
@@ -154,7 +160,7 @@ module CMDx
       timeout_secs = task.task_setting(timeout_type)
 
       Timeout.timeout(timeout_secs, TimeoutError, "execution exceeded #{timeout_secs} seconds") do
-        @runtime = Utils::Runtime.call(&block)
+        @runtime = Utils::MonotonicRuntime.call(&block)
       end
     end
 

data/lib/cmdx/result_ansi.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module CMDx
+  module ResultAnsi
+
+    STATE_COLOR_CODES = {
+      Result::INITIALIZED => 34, # Blue
+      Result::EXECUTING => 33,   # Yellow
+      Result::COMPLETE => 32,    # Green
+      Result::INTERRUPTED => 31  # Red
+    }.freeze
+    STATUS_COLOR_CODES = {
+      Result::SUCCESS => 32, # Green
+      Result::SKIPPED => 33, # Yellow
+      Result::FAILED => 31   # Red
+    }.freeze
+
+    module_function
+
+    def call(s)
+      c = STATE_COLOR_CODES[s] || STATUS_COLOR_CODES[s] || 39 # Default
+      "\e[1;#{c}m#{s}\e[0m"
+    end
+
+  end
+end

data/lib/cmdx/result_inspector.rb

@@ -4,7 +4,7 @@ module CMDx
   module ResultInspector
 
     ORDERED_KEYS = %i[
-      class type index id state status outcome metadata
+      task type index id state status outcome metadata
       tags pid runtime caused_failure threw_failure
     ].freeze
 
@@ -17,10 +17,10 @@ module CMDx
         value = result[key]
 
         case key
-        when :class
+        when :task
           "#{value}:"
         when :caused_failure, :threw_failure
-          "#{key}=<[#{value[:index]}] #{value[:class]}: #{value[:id]}>"
+          "#{key}=<[#{value[:index]}] #{value[:task]}: #{value[:id]}>"
         else
           "#{key}=#{value}"
         end

data/lib/cmdx/result_logger.rb

@@ -3,7 +3,7 @@
 module CMDx
   module ResultLogger
 
-    STATUS_TO_LEVEL = {
+    STATUS_TO_SEVERITY = {
       Result::SUCCESS => :info,
       Result::SKIPPED => :warn,
       Result::FAILED => :error
@@ -12,10 +12,12 @@ module CMDx
     module_function
 
     def call(result)
-      logger = result.task.send(:logger)
-      status = STATUS_TO_LEVEL[result.status]
+      logger   = result.task.send(:logger)
+      severity = STATUS_TO_SEVERITY[result.status]
 
-      logger.send(status) { result.to_h }
+      logger.with_level(severity) do
+        logger.send(severity) { result }
+      end
     end
 
   end

data/lib/cmdx/result_serializer.rb

@@ -13,20 +13,15 @@ module CMDx
     module_function
 
     def call(result)
-      {
-        index: result.index,
-        run_id: result.run.id,
-        type: result.task.is_a?(Batch) ? "Batch" : "Task",
-        class: result.task.class.name,
-        id: result.task.id,
-        state: result.state,
-        status: result.status,
-        outcome: result.outcome,
-        metadata: result.metadata,
-        runtime: result.runtime,
-        tags: result.task.task_setting(:tags),
-        pid: Process.pid
-      }.tap do |hash|
+      TaskSerializer.call(result.task).tap do |hash|
+        hash.merge!(
+          state: result.state,
+          status: result.status,
+          outcome: result.outcome,
+          metadata: result.metadata,
+          runtime: result.runtime
+        )
+
         if result.failed?
           STRIP_FAILURE.call(hash, result, :caused_failure)
           STRIP_FAILURE.call(hash, result, :threw_failure)

data/lib/cmdx/run.rb

@@ -13,6 +13,11 @@ module CMDx
       @results = Array(attributes[:results])
     end
 
+    def freeze
+      first_result
+      super
+    end
+
     def to_h
       RunSerializer.call(self)
     end

data/lib/cmdx/task.rb

@@ -103,7 +103,6 @@ module CMDx
     end
 
     def after_call
-      result.send(result.success? ? :complete! : :interrupt!)
       TaskHook.call(self, :"on_#{result.status}")
       TaskHook.call(self, :"on_#{result.state}")
 
@@ -121,9 +120,12 @@ module CMDx
         call
       rescue UndefinedCallError => e
         raise(e)
+      rescue Fault => e
+        throw!(e.result, original_exception: e) if Array(task_setting(:task_halt)).include?(e.result.status)
       rescue StandardError => e
-        result.fail!(reason: "[#{e.class}] #{e.message}", original_exception: e) unless e.is_a?(Fault)
+        fail!(reason: "[#{e.class}] #{e.message}", original_exception: e)
       ensure
+        result.executed!
         after_call
       end
 
@@ -137,10 +139,12 @@ module CMDx
       rescue UndefinedCallError => e
         raise(e)
       rescue Fault => e
+        result.executed!
         raise(e) if Array(task_setting(:task_halt)).include?(e.result.status)
 
         after_call # HACK: treat as NO-OP
       else
+        result.executed!
         after_call # ELSE: treat as success
       end
 

data/lib/cmdx/task_serializer.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CMDx
+  module TaskSerializer
+
+    module_function
+
+    def call(task)
+      {
+        index: task.result.index,
+        run_id: task.run.id,
+        type: task.is_a?(Batch) ? "Batch" : "Task",
+        task: task.class.name,
+        id: task.id,
+        tags: task.task_setting(:tags)
+      }
+    end
+
+  end
+end

data/lib/cmdx/utils/{datetime_formatter.rb → log_timestamp.rb}

@@ -2,7 +2,7 @@
 
 module CMDx
   module Utils
-    module DatetimeFormatter
+    module LogTimestamp
 
       DATETIME_FORMAT = "%Y-%m-%dT%H:%M:%S.%6N"
 

data/lib/cmdx/utils/{runtime.rb → monotonic_runtime.rb}

@@ -2,7 +2,7 @@
 
 module CMDx
   module Utils
-    module Runtime
+    module MonotonicRuntime
 
       module_function
 

data/lib/cmdx/utils/{method_name.rb → name_affix.rb}

@@ -2,9 +2,9 @@
 
 module CMDx
   module Utils
-    module MethodName
+    module NameAffix
 
-      ROOTFIX = proc do |o, &block|
+      AFFIX = proc do |o, &block|
         o == true ? block.call : o
       end.freeze
 
@@ -12,8 +12,8 @@ module CMDx
 
       def call(method_name, source, options = {})
         options[:as] || begin
-          prefix = ROOTFIX.call(options[:prefix]) { "#{source}_" }
-          suffix = ROOTFIX.call(options[:suffix]) { "_#{source}" }
+          prefix = AFFIX.call(options[:prefix]) { "#{source}_" }
+          suffix = AFFIX.call(options[:suffix]) { "_#{source}" }
 
           "#{prefix}#{method_name}#{suffix}".strip.to_sym
         end

data/lib/cmdx/version.rb

@@ -2,6 +2,6 @@
 
 module CMDx
 
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 
 end

data/lib/cmdx.rb

@@ -18,6 +18,9 @@ require_relative "cmdx/log_formatters/key_value"
 require_relative "cmdx/log_formatters/line"
 require_relative "cmdx/log_formatters/logstash"
 require_relative "cmdx/log_formatters/raw"
+require_relative "cmdx/log_formatters/pretty_json"
+require_relative "cmdx/log_formatters/pretty_key_value"
+require_relative "cmdx/log_formatters/pretty_line"
 require_relative "cmdx/coercions/array"
 require_relative "cmdx/coercions/big_decimal"
 require_relative "cmdx/coercions/boolean"
@@ -38,13 +41,15 @@ require_relative "cmdx/validators/inclusion"
 require_relative "cmdx/validators/length"
 require_relative "cmdx/validators/numeric"
 require_relative "cmdx/validators/presence"
-require_relative "cmdx/utils/datetime_formatter"
-require_relative "cmdx/utils/method_name"
-require_relative "cmdx/utils/runtime"
+require_relative "cmdx/utils/log_timestamp"
+require_relative "cmdx/utils/name_affix"
+require_relative "cmdx/utils/monotonic_runtime"
 require_relative "cmdx/error"
 require_relative "cmdx/errors"
 require_relative "cmdx/fault"
 require_relative "cmdx/faults"
+require_relative "cmdx/logger_serializer"
+require_relative "cmdx/logger_ansi"
 require_relative "cmdx/logger"
 require_relative "cmdx/lazy_struct"
 require_relative "cmdx/configuration"
@@ -63,9 +68,11 @@ require_relative "cmdx/parameters_inspector"
 require_relative "cmdx/result"
 require_relative "cmdx/result_serializer"
 require_relative "cmdx/result_inspector"
+require_relative "cmdx/result_ansi"
 require_relative "cmdx/result_logger"
 require_relative "cmdx/task"
 require_relative "cmdx/task_hook"
+require_relative "cmdx/task_serializer"
 require_relative "cmdx/batch"
 require_relative "cmdx/immutator"
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Juan Gomez
 bindir: exe
 cert_chain: []
-date: 2025-03-08 00:00:00.000000000 Z
+date: 2025-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -219,8 +219,13 @@ files:
 - lib/cmdx/log_formatters/key_value.rb
 - lib/cmdx/log_formatters/line.rb
 - lib/cmdx/log_formatters/logstash.rb
+- lib/cmdx/log_formatters/pretty_json.rb
+- lib/cmdx/log_formatters/pretty_key_value.rb
+- lib/cmdx/log_formatters/pretty_line.rb
 - lib/cmdx/log_formatters/raw.rb
 - lib/cmdx/logger.rb
+- lib/cmdx/logger_ansi.rb
+- lib/cmdx/logger_serializer.rb
 - lib/cmdx/parameter.rb
 - lib/cmdx/parameter_inspector.rb
 - lib/cmdx/parameter_serializer.rb
@@ -231,6 +236,7 @@ files:
 - lib/cmdx/parameters_serializer.rb
 - lib/cmdx/railtie.rb
 - lib/cmdx/result.rb
+- lib/cmdx/result_ansi.rb
 - lib/cmdx/result_inspector.rb
 - lib/cmdx/result_logger.rb
 - lib/cmdx/result_serializer.rb
@@ -239,9 +245,10 @@ files:
 - lib/cmdx/run_serializer.rb
 - lib/cmdx/task.rb
 - lib/cmdx/task_hook.rb
-- lib/cmdx/utils/datetime_formatter.rb
-- lib/cmdx/utils/method_name.rb
-- lib/cmdx/utils/runtime.rb
+- lib/cmdx/task_serializer.rb
+- lib/cmdx/utils/log_timestamp.rb
+- lib/cmdx/utils/monotonic_runtime.rb
+- lib/cmdx/utils/name_affix.rb
 - lib/cmdx/validators/custom.rb
 - lib/cmdx/validators/exclusion.rb
 - lib/cmdx/validators/format.rb