ask-graph 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 965f606d4e8a059634acd10ed0e2fbf96c159ba487d30f5f2edcec9bb1b75b89
-  data.tar.gz: b419551a611da8cd81eb7ab0d31bdf0c8213d8ed829e6a30981fe0d561938e84
+  metadata.gz: 59959ae9ec12f0d79aecfe21ae07748baa067bb47efb9c519d291dd352032873
+  data.tar.gz: ea54f68d9693259b6fbe2833693391e7844c26b9f442551af09fe3d1e4d6b84d
 SHA512:
-  metadata.gz: fee1727d038a4a74c11571ad040b86cb1d1b18bbeda4e9e3e59c46ae1a9d2eeab34d9660fbc9674e94601a14704d014e71bf782f61848c4e681bf3efd5e8f896
-  data.tar.gz: 9f943406f882e4e4344870b05b3cc945bf03555095f0f581456b22a9f1b8596acc5091c72d6191c4e41ed0651e6c5a09a895c49b4ae3fc4a8550dc6f0fdd3c84
+  metadata.gz: 221a7565d2feb4ac3769793dbb510687b56f0058bc259ecf94a32acb59e4d8dcebe23a4d7cc14888a6001ffc53a3e06bbc940e45032138dcd734fb6476b76a28
+  data.tar.gz: 68e22b21cffae4f146781926d89dd7c767f31234212181ce60707f9dd8e35ec90841f868677517d772a0221ca80fe7a53b15f93a7a067f6c5a280c4ebd5e7ae4

data/CHANGELOG.md

@@ -1,3 +1,33 @@
+## [0.3.0] — 2026-07-27
+
+### Added
+
+- **Class-level `timeout`** — set a default timeout for all steps in a graph.
+  Steps without an explicit `timeout:` option inherit the class default.
+
+  ```ruby
+  class MyGraph < Ask::Graph
+    timeout 30
+    step FastOp   # uses 30s
+    step SlowOp, timeout: 120  # overrides
+  end
+  ```
+
+- **Global default timeout** — `Ask::Graph.timeout 30` applies to all graphs
+  that don't set their own `timeout`. Resolution order: step option → graph
+  class → `Ask::Graph`.
+
+  ```ruby
+  Ask::Graph.timeout 30
+  ```
+
+- **Child override and clearing** — child graphs can override or clear
+  (`timeout nil`) the parent's default.
+
+### Tested
+
+- 62 tests, 83 assertions, 0 failures
+
 ## [0.2.0] — 2026-07-29
 
 ### Added

data/lib/ask/graph/runner.rb

@@ -24,13 +24,16 @@ module Ask
       # @param checkpoint_store [#set, #get, #delete] key-value store
       # @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,
                      hooks: { before_step: [], after_step: [], on_failure: [] },
-                     graph_instance: nil)
+                     graph_instance: nil,
+                     default_timeout: nil)
         @declarations = declarations
         @store = checkpoint_store
         @hooks = hooks
         @graph = graph_instance
+        @default_timeout = default_timeout
         @completed_steps = []
       end
 
@@ -90,6 +93,7 @@ module Ask
       end
 
       def run_with_timeout(decl, context, timeout_value)
+        timeout_value ||= @default_timeout
         if timeout_value
           ::Timeout.timeout(timeout_value) { execute_step(decl, context) }
         else

data/lib/ask/graph/version.rb

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

data/lib/ask/graph.rb

@@ -46,6 +46,37 @@ module Ask
         subclass.instance_variable_set(:@lifecycle_hooks, lifecycle_hooks.dup)
       end
 
+      # --- Timeout ---
+
+      # Set or get the default timeout (in seconds) for steps in this graph.
+      # Steps without an explicit +timeout:+ option will inherit this value.
+      # Setting on {Ask::Graph} itself applies to all graphs that don't set
+      # their own default — a global default.
+      #
+      # @example Global default for all graphs
+      #   Ask::Graph.timeout 30
+      #
+      # @example Per-graph override
+      #   class MyGraph < Ask::Graph
+      #     timeout 15
+      #     step FastOp          # uses 15s
+      #     step SlowOp, timeout: 60  # overrides
+      #   end
+      #
+      # @param seconds [Integer, nil] timeout in seconds, or nil to clear
+      # @return [Integer, nil] the current default timeout for this graph
+      def timeout(seconds = :not_set)
+        if seconds == :not_set
+          if instance_variable_defined?(:@timeout)
+            @timeout
+          elsif superclass.respond_to?(:timeout)
+            superclass.timeout
+          end
+        else
+          @timeout = seconds
+        end
+      end
+
       # --- Lifecycle hooks ---
 
       def lifecycle_hooks
@@ -139,7 +170,8 @@ module Ask
       @runner = Runner.new(self.class.declarations,
                            checkpoint_store: store,
                            hooks: hooks,
-                           graph_instance: self)
+                           graph_instance: self,
+                           default_timeout: self.class.timeout)
       @context = nil
     end
 

metadata

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