async-limiter 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d153319af347142e9837f3a8e7523f47f2bbd28d56e497d03c0fd7279302af8f
-  data.tar.gz: 9d1da2a75240ba77a68d26141abf50b677d5248b9bf191a50e8821aac3bceee7
+  metadata.gz: 20ea7fcd7cb0c04777113d99878872f59f2275d7df572555eb23e5176173103a
+  data.tar.gz: 65bd9ebbc338f9cb786adb711f01085b8e3fdade9ed5d8a5614a3710023a5863
 SHA512:
-  metadata.gz: a35d89989f3d8faf3cd203a84b2e04125809ae07d6609ce0dc205214f97bc1bf11ab099bbc46542a3fa701674185e641461d548f67bb1d1325b8badce9b6c6cc
-  data.tar.gz: df563bd337ae1e9157df61f0b47ae35d1e536b15ad5c0e7cb6fe7ebf48f32bf18249185307aa07d287c3c54df90f8463ce014531763536bd8f92428c0d13e0f9
+  metadata.gz: dbd5950c897046843d3cd9da278843aab29a46d5a4e6f2915dc971596353e97edeec4da100553f243eb31661243a51a05fbc3232758521fdf8840ddcddd7fd58
+  data.tar.gz: 4e1a47617c6239470ba15351d22f310d082062358159e7c9595f42a160ea87a694f9cd52a25daaaa19a6d42983c0869dd5580e31f97a7dcd3603de4e056d84cf

data/lib/async/limiter/generic.rb

@@ -35,6 +35,9 @@ module Async
 				@mutex = Mutex.new
 			end
 			
+			# @attribute [Timing] Strategy for timing constraints.        
+			attr :timing
+			
 			# @attribute [Array(String)] Tags associated with this limiter for identification or categorization.
 			attr :tags
 			

data/lib/async/limiter/token.rb

@@ -14,7 +14,8 @@ module Async
 		# re-acquisition with modified parameters while maintaining the original context.
 		#
 		# The token automatically tracks release state using the resource itself as the
-		# state indicator (nil = released, non-nil = acquired).
+		# state indicator (nil = released, non-nil = acquired). A closed token also
+		# clears its limiter reference, which prevents future re-acquisition.
 		class Token
 			# Acquire a token from a limiter.
 			#
@@ -61,6 +62,12 @@ module Async
 				end
 			end
 			
+			# Close the token and prevent future re-acquisition.
+			def close
+				self.release
+				@limiter = nil
+			end
+			
 			# Re-acquire the resource with modified options.
 			#
 			# This allows changing acquisition parameters (timeout, cost, priority, etc.)
@@ -74,6 +81,7 @@ module Async
 			# @asynchronous
 			def acquire(**options, &block)
 				raise "Token already acquired!" if @resource
+				return nil unless @limiter
 				
 				@resource = @limiter.acquire(reacquire: true, **options)
 				
@@ -97,6 +105,12 @@ module Async
 			def released?
 				!@resource
 			end
+			
+			# Check if the token has been closed.
+			# @returns [Boolean] True if the token has been closed.
+			def closed?
+				!@limiter
+			end
 		end
 	end
 end

data/lib/async/limiter/version.rb

@@ -7,6 +7,6 @@
 
 module Async
 	module Limiter
-		VERSION = "2.2.0"
+		VERSION = "2.3.0"
 	end
 end

data/readme.md

@@ -24,6 +24,11 @@ Please see the [project documentation](https://socketry.github.io/async-limiter/
 
 Please see the [project releases](https://socketry.github.io/async-limiter/releases/index) for all releases.
 
+### v2.3.0
+
+  - Add `Async::Limiter::Token#close` to release and permanently invalidate a token.
+  - Expose `Async::Limiter::Generic#timing`.
+
 ### v2.2.0
 
   - Add `async-utilization` metrics for limiter telemetry counters.

data/releases.md

@@ -1,5 +1,10 @@
 # Releases
 
+## v2.3.0
+
+  - Add `Async::Limiter::Token#close` to release and permanently invalidate a token.
+  - Expose `Async::Limiter::Generic#timing`.
+
 ## v2.2.0
 
   - Add `async-utilization` metrics for limiter telemetry counters.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-limiter
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Bruno Sutic
@@ -100,7 +100,7 @@ files:
 - license.md
 - readme.md
 - releases.md
-homepage: https://github.com/bruno-/async-limiter
+homepage: https://github.com/socketry/async-limiter
 licenses:
 - MIT
 metadata:
@@ -120,7 +120,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Execution rate limiting for Async
 test_files: []