falcon 0.55.0 → 0.55.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8aa8fb7fb61e5c4112b6e7e3423a59e27a0f00555edd04ab381ca58f064b10cd
-  data.tar.gz: a8a3a69df547475b9fd306f0bedd3e0f4836f1d3f42be43f1f6b1d53746b82e5
+  metadata.gz: 45c36302281a4c7947bc8c19869f93143254e821c0ab327b725aa8782dd710cb
+  data.tar.gz: c59ab82cc9babe0eea1a7ec74b2fdba4be6801dd7b1b05359fec6a2f8ec0db91
 SHA512:
-  metadata.gz: 2dca19722a68b6bd56f1caf3639cc5b4f952a6d908a5e2e36f10cf1e6a3e733d1d423c1713dab0ac8dc5e1adc595d2d6acb345a24d868c85e1b6ca706164fd00
-  data.tar.gz: 6d1ffeb9711b90027841489a348322fe955004cab78a2aa5a26a6ec61be6613013dc33d87b675776338b91aa2715cf3423959e05947e8e3ff42e886e50727666
+  metadata.gz: 2242015bc8980ebef3ae53fb2bf8db8040ef943bada60bb801cd65e849cfc68f8586b6a33e050053270cd9bd10ea9e5c778de117adb82353ecc47d24439bfb7f
+  data.tar.gz: 522154fa107e97fa4a8b72e997f71ab7afcf4e8a5699cb741f6d16aa2720b722a664dae052c82130df930af3430aa1d531a705ac59081658074008b4e58ded6a

data/lib/falcon/body/request_finished.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+require "protocol/http/body/wrapper"
+
+module Falcon
+	# @namespace
+	module Body
+		# Wraps a response body and decrements a metric after the body is closed.
+		#
+		# Runs close on the underlying body first (which invokes rack.response_finished),
+		# then decrements the metric. Use this so requests_active stays elevated until
+		# the request is fully finished (including response_finished callbacks).
+		class RequestFinished < Protocol::HTTP::Body::Wrapper
+			# Wrap a response body with a metric. If the body is nil or empty, decrements immediately.
+			#
+			# @parameter message [Protocol::HTTP::Response] The response whose body to wrap.
+			# @parameter metric [Async::Utilization::Metric] The metric to decrement when the body is closed.
+			# @returns [Protocol::HTTP::Response] The message (modified in place).
+			def self.wrap(message, metric)
+				if body = message&.body and !body.empty?
+					message.body = new(body, metric)
+				else
+					metric.decrement
+				end
+				
+				message
+			end
+			
+			# @parameter body [Protocol::HTTP::Body::Readable] The body to wrap.
+			# @parameter metric [Async::Utilization::Metric] The metric to decrement on close.
+			def initialize(body, metric)
+				super(body)
+				
+				@metric = metric
+			end
+			
+			# @returns [Boolean] False, the wrapper does not support rewinding.
+			def rewindable?
+				false
+			end
+			
+			# @returns [Boolean] False, rewinding is not supported.
+			def rewind
+				false
+			end
+			
+			# Closes the underlying body (invoking rack.response_finished), then decrements the metric.
+			#
+			# @parameter error [Exception, nil] Optional error that caused the close.
+			def close(error = nil)
+				super
+				
+				@metric&.decrement
+				@metric = nil
+			end
+		end
+	end
+end

data/lib/falcon/server.rb

@@ -10,6 +10,7 @@ require "protocol/http/content_encoding"
 
 require "async/http/cache"
 require "async/utilization"
+require_relative "body/request_finished"
 require_relative "middleware/verbose"
 require "protocol/rack"
 
@@ -62,11 +63,16 @@ module Falcon
 		end
 		
 		# Handle a request and track request statistics.
+		#
+		# Uses manual increment/decrement so requests_active stays elevated until the
+		# response body is closed (including rack.response_finished). The
+		# Body::RequestFinished wrapper runs the decrement after the body closes,
+		# so response_finished callbacks are counted as active.
 		def call(...)
 			@requests_total_metric.increment
-			@requests_active_metric.track do
-				super
-			end
+			@requests_active_metric.increment
+			
+			return Body::RequestFinished.wrap(super, @requests_active_metric)
 		end
 		
 		# Generates a human-readable string representing the current statistics.

data/lib/falcon/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Falcon
-	VERSION = "0.55.0"
+	VERSION = "0.55.1"
 end

data/readme.md

@@ -47,6 +47,10 @@ Please see the [project documentation](https://socketry.github.io/falcon/) for m
 
 Please see the [project releases](https://socketry.github.io/falcon/releases/index) for all releases.
 
+### v0.55.1
+
+  - `requests_active` is decremented after the response body is closed, including `rack.response_finished` callbacks.
+
 ### v0.55.0
 
   - **Breaking**: Drop dependency on `async-container-supervisor`, you should migrate to `async-service-supervisor` instead.
@@ -92,10 +96,6 @@ Please see the [project releases](https://socketry.github.io/falcon/releases/ind
 
   - Improve compatibility of rackup handler w.r.t. sinatra.
 
-### v0.47.8
-
-  - Fix Falcon Supervisor implementation: due to invalid code, it was unable to start.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.55.1
+
+  - `requests_active` is decremented after the response body is closed, including `rack.response_finished` callbacks.
+
 ## v0.55.0
 
   - **Breaking**: Drop dependency on `async-container-supervisor`, you should migrate to `async-service-supervisor` instead.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: falcon
 version: !ruby/object:Gem::Version
-  version: 0.55.0
+  version: 0.55.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -252,6 +252,7 @@ files:
 - context/rails-integration.md
 - context/websockets.md
 - lib/falcon.rb
+- lib/falcon/body/request_finished.rb
 - lib/falcon/command.rb
 - lib/falcon/command/host.rb
 - lib/falcon/command/paths.rb