ask-graph 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59959ae9ec12f0d79aecfe21ae07748baa067bb47efb9c519d291dd352032873
-  data.tar.gz: ea54f68d9693259b6fbe2833693391e7844c26b9f442551af09fe3d1e4d6b84d
+  metadata.gz: c3062914e848e9fea15dd9b02bd001946b7a3fd0ab015a1805b4e21a371b68bf
+  data.tar.gz: 17866f6bfaf40d6e195c71655ac134430747e3690ce32c355036a8e30a62bbf1
 SHA512:
-  metadata.gz: 221a7565d2feb4ac3769793dbb510687b56f0058bc259ecf94a32acb59e4d8dcebe23a4d7cc14888a6001ffc53a3e06bbc940e45032138dcd734fb6476b76a28
-  data.tar.gz: 68e22b21cffae4f146781926d89dd7c767f31234212181ce60707f9dd8e35ec90841f868677517d772a0221ca80fe7a53b15f93a7a067f6c5a280c4ebd5e7ae4
+  metadata.gz: ac9dad679a58246c1bd04d67de6812e9126f8f341edad4a72e842b80b759bcf2e020a2ad0c5bedd625eff861f22f0cbb224d4d2dc058a136d4c13087c4420248
+  data.tar.gz: b0f7285fd1e447c3f48e06d061aa441f64bb37de1952022e22e44835c3b549c639bceec13d9a690d0d14becb5eb724e1d2f31c05ea47a514ba2be57d9680de3b

data/CHANGELOG.md

@@ -1,3 +1,44 @@
+## [0.4.0] — 2026-07-27
+
+### Changed
+
+- **`checkpoint_store:` renamed to `storage:`** — shorter, more general name
+  for the backend that persists checkpoint data for crash recovery.
+
+  ```ruby
+  # Before
+  MyGraph.call(input, checkpoint_store: RedisPool.new)
+  g.new(input, checkpoint_store: RedisPool.new)
+
+  # After
+  MyGraph.call(input, storage: RedisPool.new)
+  g.new(input, storage: RedisPool.new)
+  ```
+
+### Added
+
+- **Class-level `storage`** — set once at the class level instead of passing
+  per-call. Works the same as `timeout`: per-call → graph class → global.
+
+  ```ruby
+  # Global default for all graphs
+  Ask::Graph.storage RedisPool.new
+
+  # Per-graph override
+  class MyGraph < Ask::Graph
+    storage PostgresStore.new
+  end
+
+  # Per-call override (overrides everything)
+  MyGraph.call(input, storage: InMemory.new)
+  ```
+
+  Falls back to `Ask::State::Memory.new` when nothing is configured.
+
+### Tested
+
+- 70 tests, 92 assertions, 0 failures
+
 ## [0.3.0] — 2026-07-27
 
 ### Added

data/lib/ask/graph/runner.rb

@@ -21,16 +21,16 @@ module Ask
       attr_reader :declarations, :store
 
       # @param declarations [Array<Hash>] step declarations
-      # @param checkpoint_store [#set, #get, #delete] key-value store
+      # @param storage [#set, #get, #delete] key-value store for checkpoint data
       # @param hooks [Hash] lifecycle hook method names
       # @param graph_instance [Object] the graph instance (for hooks)
       # @param default_timeout [Integer, nil] fallback timeout for steps with no explicit timeout
-      def initialize(declarations, checkpoint_store: nil,
+      def initialize(declarations, storage: nil,
                      hooks: { before_step: [], after_step: [], on_failure: [] },
                      graph_instance: nil,
                      default_timeout: nil)
         @declarations = declarations
-        @store = checkpoint_store
+        @store = storage
         @hooks = hooks
         @graph = graph_instance
         @default_timeout = default_timeout

data/lib/ask/graph/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   class Graph
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

data/lib/ask/graph.rb

@@ -77,6 +77,39 @@ module Ask
         end
       end
 
+      # --- Storage ---
+
+      # Set or get the default storage backend for checkpoint data.
+      # The storage object must respond to +#set(key, value)+ and +#get(key)+.
+      #
+      # Setting on {Ask::Graph} itself applies to all graphs that don't set
+      # their own storage — a global default.
+      #
+      # @example Global default for all graphs
+      #   Ask::Graph.storage RedisPool.new
+      #
+      # @example Per-graph override
+      #   class MyGraph < Ask::Graph
+      #     storage PostgresStore.new
+      #   end
+      #
+      # @example Per-call override
+      #   MyGraph.call(input, storage: InMemory.new)
+      #
+      # @param store [Object, nil] a backend that responds to +#set+ and +#get+
+      # @return [Object, nil] the current storage for this graph
+      def storage(store = :not_set)
+        if store == :not_set
+          if instance_variable_defined?(:@storage)
+            @storage
+          elsif superclass.respond_to?(:storage)
+            superclass.storage
+          end
+        else
+          @storage = store
+        end
+      end
+
       # --- Lifecycle hooks ---
 
       def lifecycle_hooks
@@ -142,8 +175,8 @@ module Ask
       end
 
       # Convenience: create instance and call.
-      def call(input = nil, checkpoint_store: nil)
-        new(input, checkpoint_store: checkpoint_store).call
+      def call(input = nil, storage: nil)
+        new(input, storage: storage).call
       end
       alias run call
 
@@ -163,12 +196,12 @@ module Ask
       end
     end
 
-    def initialize(input = nil, checkpoint_store: nil)
+    def initialize(input = nil, storage: nil)
       @input = input
-      store = checkpoint_store || Ask::State::Memory.new
+      store = storage || self.class.storage || Ask::State::Memory.new
       hooks = self.class.lifecycle_hooks
       @runner = Runner.new(self.class.declarations,
-                           checkpoint_store: store,
+                           storage: store,
                            hooks: hooks,
                            graph_instance: self,
                            default_timeout: self.class.timeout)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-graph
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Kaka Ruto