cmdx 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 198e34bfa10cf9b640e3a768e335e3901063e2cde3817be7c63fb710b322acc6
-  data.tar.gz: 59f99b87b1c2cc5fff64e2092f3f5ef5230a43d11de6f27c6609802627509164
+  metadata.gz: 00e2b2067ace8ed3afdb75bc07e3f3c5ec3ed40233a63cc3a9abc495c3a3199c
+  data.tar.gz: 053c7a3a6e3c70808b4dba6d916a35419ee0c858145dbace0d83d89e0583d05a
 SHA512:
-  metadata.gz: e60556e4f9af0a9af56d748a1084d95e5fecbe5316268d1d2f1414e5d4c323be81a7c56066bf19edf121eab3fb48080d6b5b3470086ee96241008eb28df9a152
-  data.tar.gz: cc37a5a0029f708f624e449b0526060e203b649d282f33f69551c641ae06f34a3d53886b346b8e48b68f6dbaff23654171d34e58e7d854429c58f0c3d90c62af
+  metadata.gz: 2de61e9b7e43d9e1187b4c6c925c930ae55163a5075ac624f4a9c29595588b10aacd007d64654397dc458a9c704d9175dd884eadafbef614bb8f01182f022cf0
+  data.tar.gz: 52dcb48c2e9538d33fea460946fde8f25814127aa490895fc4a676f865423d0b915ad1e7c5daae88ebe46e4bff01a36f850fa704bff312fa938ed5e3a7ea879a

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 ## [Unreleased]
 
+## [0.4.0] - 2025-03-17
+
+### Added
+- Add ansi util
+- Add string to json parsing in hash coercion
+- Add string to json parsing in array coercion
+### Changed
+- Skip assigning log settings if logger is nil
+- Improve ANSI escape sequence
+- Improve run inspector output
+
+## [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

data/docs/logging.md

@@ -11,27 +11,27 @@ Built-in log formatters are:
 
 #### 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 class=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 class=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 class=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 class=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", class: "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", class: "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 class=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", class: "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", class: "SimulationTask", id: "018c2b95-b764-7615-a924-cc5b910ed1e5", tags: [], state: "interrupted", status: "failed", outcome: "interrupted", metadata: {}, runtime: 0} origin=CMDx
 ```
 
 ## Logger
@@ -92,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/coercions/array.rb

@@ -7,7 +7,11 @@ module CMDx
       module_function
 
       def call(value, _options = {})
-        Array(value)
+        if value.is_a?(::String) && value.start_with?("[")
+          JSON.parse(value)
+        else
+          Array(value)
+        end
       end
 
     end

data/lib/cmdx/coercions/hash.rb

@@ -8,11 +8,16 @@ module CMDx
 
       def call(value, _options = {})
         case value.class.name
-        when "Hash", "ActionController::Parameters" then value
-        when "Array" then ::Hash[*value]
-        else raise_coercion_error!
+        when "Hash", "ActionController::Parameters"
+          value
+        when "Array"
+          ::Hash[*value]
+        when "String"
+          value.start_with?("{") ? JSON.parse(value) : raise_coercion_error!
+        else
+          raise_coercion_error!
         end
-      rescue ArgumentError, TypeError
+      rescue ArgumentError, TypeError, JSON::ParserError
         raise_coercion_error!
       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::PrettyLine.new),
+      logger: ::Logger.new($stdout, formatter: CMDx::LogFormatters::Line.new),
       task_halt: CMDx::Result::FAILED,
       task_timeout: nil,
       batch_halt: CMDx::Result::FAILED,

data/lib/cmdx/log_formatters/json.rb

@@ -4,9 +4,14 @@ module CMDx
   module LogFormatters
     class Json
 
-      def call(_severity, _time, _progname, message)
-        message = message.to_h if message.is_a?(Result)
-        JSON.dump(message) << "\n"
+      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,14 +4,15 @@ module CMDx
   module LogFormatters
     class KeyValue
 
-      def call(_severity, _time, _progname, message)
-        if message.is_a?(Result)
-          message = message.to_h.map do |k, v|
-            "#{k}=#{v}"
-          end.join(" ")
-        end
+      def call(severity, time, task, message)
+        m = LoggerSerializer.call(severity, time, task, message).merge!(
+          severity:,
+          pid: Process.pid,
+          timestamp: Utils::LogTimestamp.call(time.utc)
+        )
 
-        message << "\n"
+        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,11 +4,12 @@ module CMDx
   module LogFormatters
     class Line
 
-      def call(severity, time, progname, message)
-        timestamp = Utils::LogTimestamp.call(time.utc)
-        message   = KeyValue.new.call(severity, time, progname, message).chomp
+      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]}, [#{timestamp} ##{Process.pid}] #{severity} -- #{progname || 'CMDx'}: #{message}\n"
+        "#{severity[0]}, [#{t} ##{Process.pid}] #{severity} -- #{task.class.name}: #{m}\n"
       end
 
     end

data/lib/cmdx/log_formatters/logstash.rb

@@ -4,15 +4,15 @@ module CMDx
   module LogFormatters
     class Logstash
 
-      def call(_severity, time, _progname, message)
-        message = message.to_h if message.is_a?(Result)
+      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)
+        )
 
-        if message.is_a?(Hash)
-          message["@version"]   ||= "1"
-          message["@timestamp"] ||= Utils::LogTimestamp.call(time.utc)
-        end
-
-        JSON.dump(message) << "\n"
+        JSON.dump(m) << "\n"
       end
 
     end

data/lib/cmdx/log_formatters/pretty_json.rb

@@ -4,9 +4,14 @@ module CMDx
   module LogFormatters
     class PrettyJson
 
-      def call(_severity, _time, _progname, message)
-        message = message.to_h if message.is_a?(Result)
-        JSON.pretty_generate(message) << "\n"
+      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

data/lib/cmdx/log_formatters/pretty_key_value.rb

@@ -4,19 +4,15 @@ module CMDx
   module LogFormatters
     class PrettyKeyValue
 
-      COLORED_KEYS = %i[
-        state status outcome
-      ].freeze
+      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)
+        )
 
-      def call(_severity, _time, _progname, message)
-        if message.is_a?(Result)
-          message = message.to_h.map do |k, v|
-            v = ResultAnsi.call(v) if COLORED_KEYS.include?(k)
-            "#{k}=#{v}"
-          end.join(" ")
-        end
-
-        message << "\n"
+        m = m.map { |k, v| "#{k}=#{v}" }.join(" ") if m.is_a?(Hash)
+        m << "\n"
       end
 
     end

data/lib/cmdx/log_formatters/pretty_line.rb

@@ -4,13 +4,14 @@ module CMDx
   module LogFormatters
     class PrettyLine
 
-      def call(severity, time, progname, message)
-        indicator = LoggerAnsi.call(severity[0])
-        severity  = LoggerAnsi.call(severity)
-        timestamp = Utils::LogTimestamp.call(time.utc)
-        message   = PrettyKeyValue.new.call(severity, time, progname, message).chomp
+      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)
 
-        "#{indicator}, [#{timestamp} ##{Process.pid}] #{severity} -- #{progname || 'CMDx'}: #{message}\n"
+        "#{i}, [#{t} ##{Process.pid}] #{s} -- #{task.class.name}: #{m}\n"
       end
 
     end

data/lib/cmdx/log_formatters/raw.rb

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

data/lib/cmdx/logger.rb

@@ -6,9 +6,14 @@ module CMDx
     module_function
 
     def call(task)
-      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 = task.task_setting(:logger)
+
+      unless logger.nil?
+        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
+      end
+
       logger
     end
 

data/lib/cmdx/logger_ansi.rb

@@ -3,19 +3,20 @@
 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
+    SEVERITY_COLORS = {
+      "D" => :blue,
+      "I" => :green,
+      "W" => :yellow,
+      "E" => :red,
+      "F" => :magenta
     }.freeze
 
     module_function
 
     def call(s)
-      c = SEVERITY_COLOR_CODES[s[0]] || 39 # Default
-      "\e[1;#{c}m#{s}\e[0m"
+      color = SEVERITY_COLORS[s[0]] || :default
+
+      Utils::AnsiColor.call(s, color:, mode: :bold)
     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/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

data/lib/cmdx/result_ansi.rb

@@ -3,23 +3,24 @@
 module CMDx
   module ResultAnsi
 
-    STATE_COLOR_CODES = {
-      Result::INITIALIZED => 34, # Blue
-      Result::EXECUTING => 33,   # Yellow
-      Result::COMPLETE => 32,    # Green
-      Result::INTERRUPTED => 31  # Red
+    STATE_COLORS = {
+      Result::INITIALIZED => :blue,
+      Result::EXECUTING => :yellow,
+      Result::COMPLETE => :green,
+      Result::INTERRUPTED => :red
     }.freeze
-    STATUS_COLOR_CODES = {
-      Result::SUCCESS => 32, # Green
-      Result::SKIPPED => 33, # Yellow
-      Result::FAILED => 31   # Red
+    STATUS_COLORS = {
+      Result::SUCCESS => :green,
+      Result::SKIPPED => :yellow,
+      Result::FAILED => :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"
+      color = STATE_COLORS[s] || STATUS_COLORS[s] || :default
+
+      Utils::AnsiColor.call(s, color:)
     end
 
   end

data/lib/cmdx/result_logger.rb

@@ -12,7 +12,9 @@ module CMDx
     module_function
 
     def call(result)
-      logger   = result.task.send(:logger)
+      logger = result.task.send(:logger)
+      return if logger.nil?
+
       severity = STATUS_TO_SEVERITY[result.status]
 
       logger.with_level(severity) do

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/run_inspector.rb

@@ -3,18 +3,23 @@
 module CMDx
   module RunInspector
 
-    ORDERED_KEYS = %i[
+    FOOTER_KEYS = %i[
       state status outcome runtime
     ].freeze
 
     module_function
 
     def call(run)
-      header = "Run: #{run.id}"
-      footer = ORDERED_KEYS.map { |key| "#{key}=#{run.send(key)}" }.join(" ")
+      header = "\nrun: #{run.id}"
+      footer = FOOTER_KEYS.map { |key| "#{key}: #{run.send(key)}" }.join(" | ")
       spacer = "=" * [header.size, footer.size].max
 
-      run.results.map(&:to_s).unshift(header, spacer).push(spacer, footer).join("\n")
+      run
+        .results
+        .map { |r| r.to_h.except(:run_id).pretty_inspect }
+        .unshift(header, "#{spacer}\n")
+        .push(spacer, "#{footer}\n\n")
+        .join("\n")
     end
 
   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}")
 
@@ -126,6 +125,7 @@ module CMDx
       rescue StandardError => e
         fail!(reason: "[#{e.class}] #{e.message}", original_exception: e)
       ensure
+        result.executed!
         after_call
       end
 
@@ -139,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",
+        class: task.class.name,
+        id: task.id,
+        tags: task.task_setting(:tags)
+      }
+    end
+
+  end
+end

data/lib/cmdx/utils/ansi_color.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module CMDx
+  module Utils
+    module AnsiColor
+
+      COLOR_CODES = {
+        black: 30,
+        red: 31,
+        green: 32,
+        yellow: 33,
+        blue: 34,
+        magenta: 35,
+        cyan: 36,
+        white: 37,
+        default: 39,
+        light_black: 90,
+        light_red: 91,
+        light_green: 92,
+        light_yellow: 93,
+        light_blue: 94,
+        light_magenta: 95,
+        light_cyan: 96,
+        light_white: 97
+      }.freeze
+      MODE_CODES = {
+        default: 0,
+        bold: 1,
+        dim: 2,
+        italic: 3,
+        underline: 4,
+        blink: 5,
+        blink_slow: 5,
+        blink_fast: 6,
+        invert: 7,
+        hide: 8,
+        strike: 9,
+        double_underline: 20,
+        reveal: 28,
+        overlined: 53
+      }.freeze
+
+      module_function
+
+      def call(value, color:, mode: :default)
+        color_code = COLOR_CODES.fetch(color)
+        mode_code  = MODE_CODES.fetch(mode)
+
+        "\e[#{mode_code};#{color_code};49m#{value}\e[0m"
+      end
+
+    end
+  end
+end

data/lib/cmdx/version.rb

@@ -2,6 +2,6 @@
 
 module CMDx
 
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 
 end

data/lib/cmdx.rb

@@ -5,6 +5,7 @@ require "date"
 require "i18n"
 require "json"
 require "logger"
+require "pp"
 require "securerandom"
 require "time"
 require "timeout"
@@ -41,6 +42,7 @@ require_relative "cmdx/validators/inclusion"
 require_relative "cmdx/validators/length"
 require_relative "cmdx/validators/numeric"
 require_relative "cmdx/validators/presence"
+require_relative "cmdx/utils/ansi_color"
 require_relative "cmdx/utils/log_timestamp"
 require_relative "cmdx/utils/name_affix"
 require_relative "cmdx/utils/monotonic_runtime"
@@ -48,6 +50,7 @@ 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"
@@ -71,6 +74,7 @@ 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.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Juan Gomez
 bindir: exe
 cert_chain: []
-date: 2025-03-13 00:00:00.000000000 Z
+date: 2025-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -225,6 +225,7 @@ files:
 - 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
@@ -244,6 +245,8 @@ files:
 - lib/cmdx/run_serializer.rb
 - lib/cmdx/task.rb
 - lib/cmdx/task_hook.rb
+- lib/cmdx/task_serializer.rb
+- lib/cmdx/utils/ansi_color.rb
 - lib/cmdx/utils/log_timestamp.rb
 - lib/cmdx/utils/monotonic_runtime.rb
 - lib/cmdx/utils/name_affix.rb