philiprehberger-timeout_kit 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a8adc873e824dbd74917d235e838e7471d7e8d5171dced00b3c551d6cd122c7
-  data.tar.gz: c32d783deeb26085d274dd7e802f0127848ad14292d25bb90edc72f8dbe1112b
+  metadata.gz: 80b321def31fd94ffb7e7800f957ed9dcc2037245dfbe90a1213a2bad9e0366d
+  data.tar.gz: cdff9dc81339f285c3209a505644d0ed772943d415c9e58dd731a270b8e0b0db
 SHA512:
-  metadata.gz: 41d90f277f055add991dede2a122ba767b109cc1d112526ef4aab0a217b935ad16df0e38ddf78ec78b9cc54de7e4d5c8b542b2b93d6f7c95908ed0deb3c7804a
-  data.tar.gz: 39b256c071b1b339f37b02bb13c07ed76fe486b78006961178c6d6e56d0046c1f04dab90d102b0fd14aa3cfb5b6a343f239c92e654de13fa9ce79658e1c56f64
+  metadata.gz: 34fa84c7798b419ba9ba807ecd824a5f20f143cd304e4b96874648c8dec0de012461543ab3af08411898f05011c2967a23e5ff8a488acb88f3a83d35d710bc58
+  data.tar.gz: 2234c624205be2928d8dc09d5257222116d7983af96f88e4d05c3610baf02e7fceb2a5d80ffc8412375562f522f7e99e93ec0704e7106bb6bf0bbf77193828df

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-17
+
+### Added
+- `Deadline#elapsed` returns seconds since the deadline was created (complement to `#remaining`)
+
 ## [0.2.1] - 2026-03-31
 
 ### Changed

data/README.md

@@ -49,6 +49,16 @@ Philiprehberger::TimeoutKit.deadline(10) do |d|
 end
 ```
 
+### Measuring elapsed time
+
+```ruby
+Philiprehberger::TimeoutKit.deadline(10) do |d|
+  do_work
+  puts "Work took #{d.elapsed}s so far"
+  # elapsed continues to grow past the budget even after expiration
+end
+```
+
 ### Nested Deadlines
 
 ```ruby
@@ -140,6 +150,7 @@ end
 | `.current_deadline` | Return the current active deadline or nil |
 | `Deadline#check!` | Raise `DeadlineExceeded` if the deadline has passed (respects grace period) |
 | `Deadline#remaining` | Seconds remaining until the primary deadline (negative during grace) |
+| `Deadline#elapsed` | Seconds elapsed since the deadline was created (continues past the budget after expiration) |
 | `Deadline#expired?` | Whether the primary deadline has passed |
 | `Deadline#name` | The human-readable name for this deadline (nil if not set) |
 | `Deadline#in_grace?` | Whether the deadline is in the grace period |

data/lib/philiprehberger/timeout_kit/deadline.rb

@@ -20,7 +20,8 @@ module Philiprehberger
       # @param grace [Numeric, nil] optional grace period in seconds after the primary deadline
       # @param on_expire [Proc, nil] optional callback that fires once when expiry is detected
       def initialize(seconds, name: nil, grace: nil, on_expire: nil)
-        @expires_at = now + seconds
+        @started_at = now
+        @expires_at = @started_at + seconds
         @name = name
         @grace_seconds = grace
         @grace_expires_at = @grace_seconds ? @expires_at + @grace_seconds : nil
@@ -65,6 +66,16 @@ module Philiprehberger
         end
       end
 
+      # Return the number of seconds elapsed since the deadline was created.
+      # This is a pure wall-clock reading from the monotonic clock and continues
+      # to increase past the original budget after expiration. Independent of
+      # {#expired?} and {#in_grace?}.
+      #
+      # @return [Float] seconds elapsed since creation
+      def elapsed
+        now - @started_at
+      end
+
       # Return the remaining time in the grace period.
       #
       # @return [Float] seconds remaining in grace period (0.0 if no grace period or grace expired)

data/lib/philiprehberger/timeout_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module TimeoutKit
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-timeout_kit
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-18 00:00:00.000000000 Z
 dependencies: []
 description: A cooperative timeout library providing deadline and timeout patterns
   that avoid Thread.raise, with nested deadline support, grace periods, callbacks,
@@ -25,11 +25,11 @@ files:
 - lib/philiprehberger/timeout_kit.rb
 - lib/philiprehberger/timeout_kit/deadline.rb
 - lib/philiprehberger/timeout_kit/version.rb
-homepage: https://github.com/philiprehberger/rb-timeout-kit
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-timeout_kit
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-timeout-kit
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-timeout_kit
   source_code_uri: https://github.com/philiprehberger/rb-timeout-kit
   changelog_uri: https://github.com/philiprehberger/rb-timeout-kit/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-timeout-kit/issues