falcon-limiter 0.1.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19aed9c67b7fe7b68716eb8b4db0ffaa0424733a2e3e18abda65e367293fda17
-  data.tar.gz: 1eabdea4a1110e92a86a5d30bc1dba115cc10f7d33fb8ef545d3f5f6806eaac0
+  metadata.gz: efce26d7d356f61fc199b952971ffb0aa4b30b12951b7cdb1f6679dc3efce8d4
+  data.tar.gz: fe3034b672f0d63c7474022af9f9c757ad9e4046f90254e61b034ec15cb79682
 SHA512:
-  metadata.gz: be434c0ba702339891fbf77bf78ce76610e5b833abf304ac7c65913aceac28a04a0ac4560d75e29c5866d8fa13598482b62aa949d9bef6d326eb62b2ccfcd1f7
-  data.tar.gz: 51344952a67ae841d4f3284fe084178ba6af764e482c7f16d730c5d22a3ffc64560af6010602c416427c8f42706e822b3228073ee84714f7508c07b787f2da18
+  metadata.gz: 8be62c56f78e18866b8278e57ff3591d45ecb27ef7046e6efb29ea33876c078b87bc670be31bcbcf1194cdcab14ad4acd364b091a9a96ff26a06b0d12f26cf96
+  data.tar.gz: 9fd43adf07deb0227c5f86492abdd5aac9ef39a1d48eec6cf9fb4781d31a65c61b53011c2f3794b076734580bfe39da09e9dc1e5f90dcd4e592b4a11e4c39785

data/lib/falcon/limiter/environment.rb

@@ -7,6 +7,7 @@
 require_relative "middleware"
 require_relative "semaphore"
 require_relative "wrapper"
+require "async/utilization"
 
 module Falcon
 	module Limiter
@@ -32,13 +33,18 @@ module Falcon
 				0.1
 			end
 			
+			# @returns [Async::Utilization::Registry] The utilization registry for limiter metrics.
+			def limiter_utilization
+				@limiter_utilization ||= Async::Utilization::Registry.new
+			end
+			
 			# @returns [Async::Limiter::Queued] The limiter for coordinating long tasks and connection accepts.
 			def connection_limiter
 				# Create priority queue and pre-populate with tokens:
 				queue = Async::PriorityQueue.new
 				limiter_maximum_connections.times{queue.push(true)}
 				
-				Async::Limiter::Queued.new(queue)
+				Async::Limiter::Queued.new(queue, utilization: limiter_utilization.namespace(:socket_accept))
 			end
 			
 			# @returns [Class] The middleware class to use for long task support.
@@ -54,7 +60,8 @@ module Falcon
 						middleware, 
 						connection_limiter: connection_limiter,
 						maximum_long_tasks: limiter_maximum_long_tasks,
-						start_delay: limiter_start_delay
+						start_delay: limiter_start_delay,
+						utilization: limiter_utilization
 					)
 				else
 					middleware

data/lib/falcon/limiter/middleware.rb

@@ -5,6 +5,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require "protocol/http/middleware"
+require "async/utilization"
 require_relative "long_task"
 require_relative "semaphore"
 
@@ -18,16 +19,18 @@ module Falcon
 			# @parameter connection_limiter [Async::Limiter] Connection limiter instance for managing accepts.
 			# @parameter maximum_long_tasks [Integer] Maximum number of concurrent long tasks (default: 10).
 			# @parameter start_delay [Float] Delay in seconds before starting long tasks (default: 0.1).
-			def initialize(delegate, connection_limiter:, maximum_long_tasks: 10, start_delay: 0.1)
+			# @parameter utilization [Async::Utilization::Registry] Utilization registry for limiter metrics.
+			def initialize(delegate, connection_limiter:, maximum_long_tasks: 10, start_delay: 0.1, utilization: Async::Utilization::Registry.new)
 				super(delegate)
 				
 				@maximum_long_tasks = maximum_long_tasks
 				@start_delay = start_delay
 				@connection_limiter = connection_limiter
-				@long_task_limiter = Semaphore.new(maximum_long_tasks)
+				@utilization = utilization
+				@long_task_limiter = Semaphore.new(maximum_long_tasks, utilization: utilization.namespace(:long_task))
 			end
 			
-			attr_reader :maximum_long_tasks, :start_delay, :long_task_limiter, :connection_limiter
+			attr_reader :maximum_long_tasks, :start_delay, :long_task_limiter, :connection_limiter, :utilization
 			
 			# Process an HTTP request with long task management support.
 			# Creates a long task context that applications can use to manage I/O operations.

data/lib/falcon/limiter/semaphore.rb

@@ -15,13 +15,14 @@ module Falcon
 		module Semaphore
 			# Create a new limiter with the specified capacity.
 			# @parameter limit [Integer] The maximum number of concurrent operations allowed (default: 1).
+			# @parameter options [Hash] Options passed to {Async::Limiter::Queued#initialize}.
 			# @returns [Async::Limiter::Queued] A new limiter instance with pre-allocated tokens.
-			def self.new(limit = 1)
+			def self.new(limit = 1, **options)
 				# Create priority queue and pre-populate with tokens
 				queue = Async::PriorityQueue.new
 				limit.times{queue.push(true)}
 				
-				return Async::Limiter::Queued.new(queue)
+				return Async::Limiter::Queued.new(queue, **options)
 			end
 		end
 	end

data/lib/falcon/limiter/socket.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 module Falcon
 	module Limiter
@@ -25,7 +25,7 @@ module Falcon
 			ensure
 				if token = @token
 					@token = nil
-					token.release
+					token.close
 				end
 			end
 			

data/lib/falcon/limiter/version.rb

@@ -5,6 +5,6 @@
 
 module Falcon
 	module Limiter
-		VERSION = "0.1.2"
+		VERSION = "0.3.0"
 	end
 end

data/readme.md

@@ -26,6 +26,14 @@ Please see the [project documentation](https://socketry.github.io/falcon-limiter
 
 Please see the [project releases](https://socketry.github.io/falcon-limiter/releases/index) for all releases.
 
+### v0.3.0
+
+  - Use `Async::Limiter::Token#close` when closing sockets so cached tokens cannot re-acquire after socket close.
+
+### v0.2.0
+
+  - Use `async-limiter` v2.2 utilization metrics for connection and long task limiter telemetry.
+
 ### v0.1.0
 
   - Initial implementation.
@@ -46,6 +54,22 @@ We welcome contributions to this project.
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
 
+### Running Tests
+
+To run the test suite:
+
+``` shell
+bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` shell
+bundle exec bake gem:release:patch # or minor or major
+```
+
 ### Developer Certificate of Origin
 
 In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.3.0
+
+  - Use `Async::Limiter::Token#close` when closing sockets so cached tokens cannot re-acquire after socket close.
+
+## v0.2.0
+
+  - Use `async-limiter` v2.2 utilization metrics for connection and long task limiter telemetry.
+
 ## v0.1.0
 
   - Initial implementation.

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: falcon-limiter
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.3.0
 platform: ruby
 authors:
-- Josh Teeter
 - Samuel Williams
+- Josh Teeter
 - Francisco Mejia
 - Marc-André Cournoyer
 bindir: bin
@@ -47,14 +47,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: async-utilization
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.4'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -86,14 +100,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Advanced concurrency control and resource limiting for Falcon web server.
 test_files: []