cmdx 1.7.3 → 1.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01fd49f8d31e90b2818d78cbf452c68888f76e8f4983647b1c163b235963b6a8
-  data.tar.gz: ab15559fbfedd9f359f23fbce24b7259ed428ef37caeb5522777de0724f395a8
+  metadata.gz: '0238294eeb6dd614280c7c386832d6780ea4005879c1162e7cacc4f97c54d5fd'
+  data.tar.gz: 50c49904dbc84ffa7451a585e443c061b71576498ad00504ee87ae2efff07945
 SHA512:
-  metadata.gz: f5a8da6a5f773f69d2e25fb856f8440ec630c7d049493b0bf1478719ef4ac17f2d1bfc82f2718030de3883cf91db43986d0826b4bcfbfed7ceaaf1f7b5ba1c6f
-  data.tar.gz: c36629bdbe94b2ce563e67f0d1bcaf9c292d180f30a22871a10480d11676714819f2636f463f538916f72c56200170f4ab39e8d9a84c28479a41a5310f7fdd12
+  metadata.gz: 7bac1596b901e86412d241f81c2c5fa331d2bf05b63c0ef3ee3691dd832c30fa8a187e6d8d4788fe9f3d1760bb8f7b1da62c2701a9a86bac6d9a4b5116f3e490
+  data.tar.gz: 8794c3049d206178d68a4e9446d001668ee8b3a7902569dd1f66d05fe10b67f9cbc59e5264286ebfb075681415f430a3d69c40f181fdbe6f541caf4ec7fb4e56

data/CHANGELOG.md

@@ -4,7 +4,21 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [TODO]
+## [UNRELEASED]
+
+## [1.7.5] - 2025-09-10
+
+### Added
+- Added `fetch_or_store` method to context
+- Added `ctx` alias for context in result
+- Added `ok?` alias for `good?` in result
+- Added deconstruction values in result
+
+## [1.7.4] - 2025-09-03
+
+### Added
+- Added errors delegation from result object
+- Added `full_messages` and `to_hash` methods to errors
 
 ## [1.7.3] - 2025-09-03
 

data/lib/cmdx/context.rb

@@ -108,6 +108,26 @@ module CMDx
       table.fetch(key.to_sym, ...)
     end
 
+    # Fetches a value from the context by key, or stores and returns a default value if not found.
+    #
+    # @param key [String, Symbol] the key to fetch or store
+    # @param value [Object] the default value to store if key is not found
+    #
+    # @yield [key] a block to compute the default value to store
+    #
+    # @return [Object] the existing value if key is found, otherwise the stored default value
+    #
+    # @example
+    #   context = Context.new(name: "John")
+    #   context.fetch_or_store(:name, "Default") # => "John" (existing value)
+    #   context.fetch_or_store(:age, 25) # => 25 (stored and returned)
+    #   context.fetch_or_store(:city) { |key| "Unknown #{key}" } # => "Unknown city" (stored and returned)
+    def fetch_or_store(key, value = nil)
+      table.fetch(key.to_sym) do
+        table[key.to_sym] = block_given? ? yield : value
+      end
+    end
+
     # Merges the given arguments into the current context, modifying it in place.
     #
     # @param args [Hash, Object] arguments to merge into the context

data/lib/cmdx/errors.rb

@@ -48,6 +48,18 @@ module CMDx
       !messages[attribute].empty?
     end
 
+    # Convert errors to a hash format with arrays of fullmessages.
+    #
+    # @return [Hash{Symbol => Array<String>}] Hash with attribute keys and message arrays
+    #
+    # @example
+    #   errors.full_messages # => { email: ["email must be valid format", "email cannot be blank"] }
+    def full_messages
+      messages.each_with_object({}) do |(attribute, messages), hash|
+        hash[attribute] = messages.map { |message| "#{attribute} #{message}" }
+      end
+    end
+
     # Convert errors to a hash format with arrays of messages.
     #
     # @return [Hash{Symbol => Array<String>}] Hash with attribute keys and message arrays
@@ -58,6 +70,18 @@ module CMDx
       messages.transform_values(&:to_a)
     end
 
+    # Convert errors to a hash format with optional full messages.
+    #
+    # @param full [Boolean] Whether to include full messages with attribute names
+    # @return [Hash{Symbol => Array<String>}] Hash with attribute keys and message arrays
+    #
+    # @example
+    #   errors.to_hash # => { email: ["must be valid format", "cannot be blank"] }
+    #   errors.to_hash(true) # => { email: ["email must be valid format", "email cannot be blank"] }
+    def to_hash(full = false)
+      full ? full_messages : to_h
+    end
+
     # Convert errors to a human-readable string format.
     #
     # @return [String] Formatted error messages joined with periods
@@ -65,9 +89,7 @@ module CMDx
     # @example
     #   errors.to_s # => "email must be valid format. email cannot be blank"
     def to_s
-      messages.each_with_object([]) do |(attribute, messages), memo|
-        messages.each { |message| memo << "#{attribute} #{message}" }
-      end.join(". ")
+      full_messages.values.flatten.join(". ")
     end
 
   end

data/lib/cmdx/result.rb

@@ -33,7 +33,8 @@ module CMDx
 
     attr_reader :task, :state, :status, :metadata, :reason, :cause
 
-    def_delegators :task, :context, :chain
+    def_delegators :task, :context, :chain, :errors
+    alias ctx context
 
     # @param task [CMDx::Task] The task instance this result represents
     #
@@ -185,6 +186,7 @@ module CMDx
     def good?
       !failed?
     end
+    alias ok? good?
 
     # @param block [Proc] Block to execute conditionally
     #
@@ -430,13 +432,13 @@ module CMDx
 
     # @param keys [Array] Array of keys to deconstruct
     #
-    # @return [Array] Array containing state and status
+    # @return [Array] Array containing state, status, reason, cause, and metadata
     #
     # @example
     #   state, status = result.deconstruct
     #   puts "State: #{state}, Status: #{status}"
     def deconstruct(*)
-      [state, status]
+      [state, status, reason, cause, metadata]
     end
 
     # @param keys [Array] Array of keys to deconstruct
@@ -454,7 +456,10 @@ module CMDx
       {
         state: state,
         status: status,
+        reason: reason,
+        cause: cause,
         metadata: metadata,
+        outcome: outcome,
         executed: executed?,
         good: good?,
         bad: bad?

data/lib/cmdx/version.rb

@@ -2,6 +2,6 @@
 
 module CMDx
 
-  VERSION = "1.7.3"
+  VERSION = "1.7.5"
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 1.7.3
+  version: 1.7.5
 platform: ruby
 authors:
 - Juan Gomez