falcon 0.48.3 → 0.48.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7402cf048a80de8e1c357956b59f0f2838ac727a8982e08a6f55724b74bf77da
-  data.tar.gz: 1e068e76060caf2dc6812e99a49e2559f6c2d0c36b9da6629fc43c25b434b6fd
+  metadata.gz: 1b4caa19c4227d2fdeeb8a700a20be255a12f3bee3d2aa69ea31d9a8c7a2508b
+  data.tar.gz: 6ae1117406cc230dad0447a43fd35ef94b1361dbe196a3e1e2ebd29700a7e228
 SHA512:
-  metadata.gz: 3e36ef9ebb0e04a9cd5fb7acf4f6a0e3c4347cafe24a87a5c4768f6a4ad5a18623419fbc87130fd60f3aa318a2c00a40e8b87ca4199087a7780274b08178d4a6
-  data.tar.gz: d12353d67f5f3f5ffcb931496996cc6beab8f00fa1e5363a712829963426b52e7379a5084e1133cca498ee720824c59e698a8366cee4e21f2ceaed95a668d796
+  metadata.gz: 75086f0c0c1c552b9201d26b2ef3c3cc394ecb64c596642ff62ad73c361fac5493b867aa19becfd1aa4b6e0b7dfe1abba334c276df2ba5ca0dc194df759f007c
+  data.tar.gz: d19a36195d9521d3ac0d7ae4db56b6521cfd0e2bfbaf5ade95408c8cd557d6bf3c8733cda818a84980c61fed3a05fce936af85fb53807d15216ab4d8a88733e1

data/bake/falcon/supervisor.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2023, by Samuel Williams.
+# Copyright, 2020-2025, by Samuel Williams.
 
 def restart
-	require_relative '../../lib/falcon/command/supervisor'
+	require_relative "../../lib/falcon/command/supervisor"
 	
 	Falcon::Command::Supervisor["restart"].call
 end

data/bin/falcon

@@ -21,7 +21,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require_relative '../lib/falcon/command'
+require_relative "../lib/falcon/command"
 
 begin
 	Falcon::Command.call

data/bin/falcon-host

@@ -21,7 +21,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require_relative '../lib/falcon/command/host'
+require_relative "../lib/falcon/command/host"
 
 begin
 	Falcon::Command::Host.call

data/lib/falcon/command/host.rb

@@ -3,11 +3,11 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'paths'
-require_relative '../version'
+require_relative "paths"
+require_relative "../version"
 
-require 'samovar'
-require 'async/service/controller'
+require "samovar"
+require "async/service/controller"
 
 module Falcon
 	module Command

data/lib/falcon/command/paths.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative '../configuration'
+require_relative "../configuration"
 
 module Falcon
 	module Command

data/lib/falcon/command/proxy.rb

@@ -3,10 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative '../environment/proxy'
-require_relative 'paths'
+require_relative "../environment/proxy"
+require_relative "paths"
 
-require 'samovar'
+require "samovar"
 
 module Falcon
 	module Command
@@ -19,9 +19,9 @@ module Falcon
 			# The command line options.
 			# @attribute [Samovar::Options]
 			options do
-				option '--bind <address>', "Bind to the given hostname/address", default: "https://[::]:443"
+				option "--bind <address>", "Bind to the given hostname/address", default: "https://[::]:443"
 				
-				option '-t/--timeout <duration>', "Specify the maximum time to wait for non-blocking operations.", type: Float, default: nil
+				option "-t/--timeout <duration>", "Specify the maximum time to wait for non-blocking operations.", type: Float, default: nil
 			end
 			
 			# One or more paths to the configuration files.

data/lib/falcon/command/redirect.rb

@@ -3,10 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative '../environment/redirect'
-require_relative 'paths'
+require_relative "../environment/redirect"
+require_relative "paths"
 
-require 'samovar'
+require "samovar"
 
 module Falcon
 	module Command
@@ -16,10 +16,10 @@ module Falcon
 			# The command line options.
 			# @attribute [Samovar::Options]
 			options do
-				option '--bind <address>', "Bind to the given hostname/address", default: "http://[::]:80"
-				option '--redirect <address>', "Redirect using this address as a template.", default: "https://[::]:443"
+				option "--bind <address>", "Bind to the given hostname/address", default: "http://[::]:80"
+				option "--redirect <address>", "Redirect using this address as a template.", default: "https://[::]:443"
 				
-				option '-t/--timeout <duration>', "Specify the maximum time to wait for non-blocking operations.", type: Float, default: nil
+				option "-t/--timeout <duration>", "Specify the maximum time to wait for non-blocking operations.", type: Float, default: nil
 			end
 			
 			# One or more paths to the configuration files.

data/lib/falcon/command/serve.rb

@@ -4,15 +4,15 @@
 # Copyright, 2018-2024, by Samuel Williams.
 # Copyright, 2018, by Mitsutaka Mimura.
 
-require_relative '../server'
-require_relative '../endpoint'
-require_relative '../configuration'
-require_relative '../service/server'
-require_relative '../environment/rackup'
+require_relative "../server"
+require_relative "../endpoint"
+require_relative "../configuration"
+require_relative "../service/server"
+require_relative "../environment/rackup"
 
-require 'async/container'
-require 'async/http/client'
-require 'samovar'
+require "async/container"
+require "async/http/client"
+require "samovar"
 
 module Falcon
 	module Command
@@ -25,26 +25,26 @@ module Falcon
 			# The command line options.
 			# @attribute [Samovar::Options]
 			options do
-				option '-b/--bind <address>', "Bind to the given hostname/address.", default: "https://localhost:9292"
+				option "-b/--bind <address>", "Bind to the given hostname/address.", default: "https://localhost:9292"
 				
-				option '-p/--port <number>', "Override the specified port.", type: Integer
-				option '-h/--hostname <hostname>', "Specify the hostname which would be used for certificates, etc."
-				option '-t/--timeout <duration>', "Specify the maximum time to wait for non-blocking operations.", type: Float, default: nil
+				option "-p/--port <number>", "Override the specified port.", type: Integer
+				option "-h/--hostname <hostname>", "Specify the hostname which would be used for certificates, etc."
+				option "-t/--timeout <duration>", "Specify the maximum time to wait for non-blocking operations.", type: Float, default: nil
 				
-				option '-c/--config <path>', "Rackup configuration file to load.", default: 'config.ru'
-				option '--preload <path>', "Preload the specified path before creating containers."
+				option "-c/--config <path>", "Rackup configuration file to load.", default: "config.ru"
+				option "--preload <path>", "Preload the specified path before creating containers."
 				
-				option '--cache', "Enable the response cache."
+				option "--cache", "Enable the response cache."
 				
-				option '--forked | --threaded | --hybrid', "Select a specific parallelism model.", key: :container, default: :forked
+				option "--forked | --threaded | --hybrid", "Select a specific parallelism model.", key: :container, default: :forked
 				
-				option '-n/--count <count>', "Number of instances to start.", default: Async::Container.processor_count, type: Integer
+				option "-n/--count <count>", "Number of instances to start.", default: Async::Container.processor_count, type: Integer
 				
-				option '--forks <count>', "Number of forks (hybrid only).", type: Integer
-				option '--threads <count>', "Number of threads (hybrid only).", type: Integer
+				option "--forks <count>", "Number of forks (hybrid only).", type: Integer
+				option "--threads <count>", "Number of threads (hybrid only).", type: Integer
 				
-				option '--[no]-restart', "Enable/disable automatic restart.", default: true
-				option '--graceful-stop <timeout>', "Duration to wait for graceful stop.", type: Float, default: 1.0
+				option "--[no]-restart", "Enable/disable automatic restart.", default: true
+				option "--graceful-stop <timeout>", "Duration to wait for graceful stop.", type: Float, default: 1.0
 			end
 			
 			def container_options

data/lib/falcon/command/supervisor.rb

@@ -3,12 +3,12 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'samovar'
-require 'async'
-require 'json'
+require "samovar"
+require "async"
+require "json"
 
-require 'io/endpoint/unix_endpoint'
-require 'io/stream'
+require "io/endpoint/unix_endpoint"
+require "io/stream"
 
 module Falcon
 	module Command
@@ -30,7 +30,7 @@ module Falcon
 				
 				# Send the restart message to the supervisor.
 				def call(stream)
-					stream.puts({please: 'restart'}.to_json, separator: "\0")
+					stream.puts({please: "restart"}.to_json, separator: "\0")
 				end
 			end
 			
@@ -40,7 +40,7 @@ module Falcon
 				
 				# Send the metrics message to the supervisor and print the results.
 				def call(stream)
-					stream.puts({please: 'metrics'}.to_json, separator: "\0", chomp: true)
+					stream.puts({please: "metrics"}.to_json, separator: "\0", chomp: true)
 					response = JSON.parse(stream.read_until("\0"), symbolize_names: true)
 					
 					$stdout.puts response
@@ -51,9 +51,9 @@ module Falcon
 			# @name nested
 			# @attribute [Command]
 			nested :command, {
-				'restart' => Restart,
-				'metrics' => Metrics,
-			}, default: 'metrics'
+				"restart" => Restart,
+				"metrics" => Metrics,
+			}, default: "metrics"
 			
 			# The endpoint the supervisor is bound to.
 			def endpoint

data/lib/falcon/command/top.rb

@@ -3,16 +3,16 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative 'serve'
-require_relative 'host'
-require_relative 'virtual'
-require_relative 'proxy'
-require_relative 'redirect'
-require_relative 'supervisor'
+require_relative "serve"
+require_relative "host"
+require_relative "virtual"
+require_relative "proxy"
+require_relative "redirect"
+require_relative "supervisor"
 
-require_relative '../version'
+require_relative "../version"
 
-require 'samovar'
+require "samovar"
 
 module Falcon
 	module Command
@@ -23,23 +23,23 @@ module Falcon
 			# The command line options.
 			# @attribute [Samovar::Options]
 			options do
-				option '--verbose | --quiet', "Verbosity of output for debugging.", key: :logging
-				option '-h/--help', "Print out help information."
-				option '-v/--version', "Print out the application version."
-				option '-e/--encoding', "Specify the default external encoding of the server.", default: "UTF-8"
+				option "--verbose | --quiet", "Verbosity of output for debugging.", key: :logging
+				option "-h/--help", "Print out help information."
+				option "-v/--version", "Print out the application version."
+				option "-e/--encoding", "Specify the default external encoding of the server.", default: "UTF-8"
 			end
 			
 			# The nested command to execute.
 			# @name nested
 			# @attribute [Command]
 			nested :command, {
-				'serve' => Serve,
-				'host' => Host,
-				'virtual' => Virtual,
-				'proxy' => Proxy,
-				'redirect' => Redirect,
-				'supervisor' => Supervisor,
-			}, default: 'serve'
+				"serve" => Serve,
+				"host" => Host,
+				"virtual" => Virtual,
+				"proxy" => Proxy,
+				"redirect" => Redirect,
+				"supervisor" => Supervisor,
+			}, default: "serve"
 			
 			# Whether verbose logging is enabled.
 			# @returns [Boolean]

data/lib/falcon/command/virtual.rb

@@ -3,11 +3,11 @@
 # Released under the MIT License.
 # Copyright, 2018-2024, by Samuel Williams.
 
-require 'async/service'
+require "async/service"
 
-require_relative '../environment/virtual'
+require_relative "../environment/virtual"
 
-require 'samovar'
+require "samovar"
 
 module Falcon
 	module Command
@@ -20,10 +20,10 @@ module Falcon
 			# The command line options.
 			# @attribute [Samovar::Options]
 			options do
-				option '--bind-insecure <address>', "Bind redirection to the given hostname/address", default: "http://[::]:80"
-				option '--bind-secure <address>', "Bind proxy to the given hostname/address", default: "https://[::]:443"
+				option "--bind-insecure <address>", "Bind redirection to the given hostname/address", default: "http://[::]:80"
+				option "--bind-secure <address>", "Bind proxy to the given hostname/address", default: "https://[::]:443"
 				
-				option '-t/--timeout <duration>', "Specify the maximum time to wait for non-blocking operations.", type: Float, default: 30
+				option "-t/--timeout <duration>", "Specify the maximum time to wait for non-blocking operations.", type: Float, default: 30
 			end
 			
 			# One or more paths to the configuration files.

data/lib/falcon/command.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2023, by Samuel Williams.
+# Copyright, 2017-2025, by Samuel Williams.
 # Copyright, 2018, by Mitsutaka Mimura.
 
-require_relative 'command/top'
+require_relative "command/top"
 
 module Falcon
 	module Command

data/lib/falcon/configuration.rb

@@ -4,7 +4,7 @@
 # Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2019, by Sho Ito.
 
-require 'async/service'
+require "async/service"
 
 module Falcon
 	# Manages environments which describes how to host a specific application.

data/lib/falcon/endpoint.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require 'async/http/endpoint'
-require 'localhost/authority'
+require "async/http/endpoint"
+require "localhost/authority"
 
 module Falcon
 	# An HTTP-specific endpoint which adds localhost TLS.

data/lib/falcon/environment/application.rb

@@ -4,8 +4,8 @@
 # Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2020, by Daniel Evans.
 
-require_relative 'server'
-require_relative '../proxy_endpoint'
+require_relative "server"
+require_relative "../proxy_endpoint"
 
 module Falcon
 	module Environment
@@ -22,7 +22,7 @@ module Falcon
 			# The scheme to use to communicate with the application.
 			# @returns [String]
 			def scheme
-				'https'
+				"https"
 			end
 			
 			# The protocol to use to communicate with the application.

data/lib/falcon/environment/lets_encrypt_tls.rb

@@ -3,8 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative 'tls'
-require_relative '../environment'
+require_relative "tls"
+require_relative "../environment"
 
 module Falcon
 	module Environment
@@ -13,7 +13,7 @@ module Falcon
 			# The Lets Encrypt certificate store path.
 			# @parameter [String]
 			def lets_encrypt_root
-				'/etc/letsencrypt/live'
+				"/etc/letsencrypt/live"
 			end
 			
 			# The public certificate path.

data/lib/falcon/environment/proxy.rb

@@ -3,10 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative 'server'
-require_relative '../tls'
-require_relative '../middleware/proxy'
-require_relative '../environment'
+require_relative "server"
+require_relative "../tls"
+require_relative "../middleware/proxy"
+require_relative "../environment"
 
 module Falcon
 	module Environment
@@ -43,7 +43,7 @@ module Falcon
 						Console.info(self) {"Proxying #{self.url} to #{evaluator.authority} using #{evaluator.endpoint}"}
 						hosts[evaluator.authority] = evaluator
 						
-						if RUBY_VERSION < '3.1'
+						if RUBY_VERSION < "3.1"
 							# Ensure the SSL context is set up before forking - it's buggy on Ruby < 3.1:
 							evaluator.ssl_context
 						end

data/lib/falcon/environment/rack.rb

@@ -3,9 +3,9 @@
 # Released under the MIT License.
 # Copyright, 2024, by Samuel Williams.
 
-require_relative 'application'
-require_relative 'rackup'
-require_relative '../environment'
+require_relative "application"
+require_relative "rackup"
+require_relative "../environment"
 
 module Falcon
 	module Environment

data/lib/falcon/environment/rackup.rb

@@ -3,15 +3,15 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require 'rack/builder'
-require_relative '../server'
+require "rack/builder"
+require_relative "../server"
 
 module Falcon
 	module Environment
 		# Provides an environment for hosting loading a Rackup `config.ru` file.
 		module Rackup
 			def rackup_path
-				File.expand_path('config.ru', root)
+				File.expand_path("config.ru", root)
 			end
 			
 			def rack_app

data/lib/falcon/environment/redirect.rb

@@ -3,8 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require_relative 'server'
-require_relative '../middleware/redirect'
+require_relative "server"
+require_relative "../middleware/redirect"
 
 module Falcon
 	module Environment

data/lib/falcon/environment/self_signed_tls.rb

@@ -3,9 +3,9 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'localhost/authority'
-require_relative 'tls'
-require_relative '../environment'
+require "localhost/authority"
+require_relative "tls"
+require_relative "../environment"
 
 module Falcon
 	module Environment

data/lib/falcon/environment/server.rb

@@ -3,11 +3,11 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require 'async/service/generic'
-require 'async/http/endpoint'
+require "async/service/generic"
+require "async/http/endpoint"
 
-require_relative '../service/server'
-require_relative '../server'
+require_relative "../service/server"
+require_relative "../server"
 
 module Falcon
 	module Environment

data/lib/falcon/environment/supervisor.rb

@@ -3,10 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative '../service/supervisor'
-require_relative '../environment'
+require_relative "../service/supervisor"
+require_relative "../environment"
 
-require 'io/endpoint/unix_endpoint'
+require "io/endpoint/unix_endpoint"
 
 module Falcon
 	module Environment

data/lib/falcon/environment/tls.rb

@@ -3,8 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative '../tls'
-require_relative '../environment'
+require_relative "../tls"
+require_relative "../environment"
 
 module Falcon
 	module Environment

data/lib/falcon/environment/virtual.rb

@@ -3,9 +3,9 @@
 # Released under the MIT License.
 # Copyright, 2024, by Samuel Williams.
 
-require_relative 'configured'
+require_relative "configured"
 
-require_relative '../service/virtual'
+require_relative "../service/virtual"
 
 module Falcon
 	module Environment

data/lib/falcon/middleware/proxy.rb

@@ -3,12 +3,12 @@
 # Released under the MIT License.
 # Copyright, 2018-2024, by Samuel Williams.
 
-require 'async/http/client'
-require 'protocol/http/headers'
-require 'protocol/http/middleware'
+require "async/http/client"
+require "protocol/http/headers"
+require "protocol/http/middleware"
 
-require 'console/event/failure'
-require 'traces/provider'
+require "console/event/failure"
+require "traces/provider"
 
 module Falcon
 	module Middleware
@@ -25,21 +25,21 @@ module Falcon
 		# A HTTP middleware for proxying requests to a given set of hosts.
 		# Typically used for implementing virtual servers.
 		class Proxy < Protocol::HTTP::Middleware
-			FORWARDED = 'forwarded'
-			X_FORWARDED_FOR = 'x-forwarded-for'
-			X_FORWARDED_PROTO = 'x-forwarded-proto'
+			FORWARDED = "forwarded"
+			X_FORWARDED_FOR = "x-forwarded-for"
+			X_FORWARDED_PROTO = "x-forwarded-proto"
 			
-			VIA = 'via'
-			CONNECTION = 'connection'
+			VIA = "via"
+			CONNECTION = "connection"
 			
 			# HTTP hop headers which *should* not be passed through the proxy.
 			HOP_HEADERS = [
-				'connection',
-				'keep-alive',
-				'public',
-				'proxy-authenticate',
-				'transfer-encoding',
-				'upgrade',
+				"connection",
+				"keep-alive",
+				"public",
+				"proxy-authenticate",
+				"transfer-encoding",
+				"upgrade",
 			]
 			
 			# Initialize the proxy middleware.
@@ -78,7 +78,7 @@ module Falcon
 			# @returns [Service::Proxy]
 			def lookup(request)
 				# Trailing dot and port is ignored/normalized.
-				if authority = request.authority&.sub(/(\.)?(:\d+)?$/, '')
+				if authority = request.authority&.sub(/(\.)?(:\d+)?$/, "")
 					return @hosts[authority]
 				end
 			end
@@ -119,7 +119,7 @@ module Falcon
 				end
 				
 				unless forwarded.empty?
-					request.headers.add(FORWARDED, forwarded.join(';'))
+					request.headers.add(FORWARDED, forwarded.join(";"))
 				end
 				
 				request.headers.add(VIA, "#{request.version} #{self.class}")
@@ -145,7 +145,7 @@ module Falcon
 				end
 			rescue => error
 				Console::Event::Failure.for(error).emit(self)
-				return Protocol::HTTP::Response[502, {'content-type' => 'text/plain'}, [error.class.name]]
+				return Protocol::HTTP::Response[502, {"content-type" => "text/plain"}, [error.class.name]]
 			end
 			
 			Traces::Provider(self) do
@@ -154,7 +154,7 @@ module Falcon
 						"authority" => request.authority,
 					}
 					
-					Traces.trace('falcon.middleware.proxy.call', attributes: attributes) do
+					Traces.trace("falcon.middleware.proxy.call", attributes: attributes) do
 						super
 					end
 				end

data/lib/falcon/middleware/redirect.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2024, by Samuel Williams.
 
-require 'async/http/client'
+require "async/http/client"
 
 module Falcon
 	module Middleware
@@ -35,7 +35,7 @@ module Falcon
 			# @parameter request [Protocol::HTTP::Request]
 			def lookup(request)
 				# Trailing dot and port is ignored/normalized.
-				if authority = request.authority&.sub(/(\.)?(:\d+)?$/, '')
+				if authority = request.authority&.sub(/(\.)?(:\d+)?$/, "")
 					return @hosts[authority]
 				end
 			end
@@ -50,7 +50,7 @@ module Falcon
 						location = "#{@endpoint.scheme}://#{host.authority}:#{@endpoint.port}#{request.path}"
 					end
 					
-					return Protocol::HTTP::Response[301, [['location', location]], []]
+					return Protocol::HTTP::Response[301, [["location", location]], []]
 				else
 					super
 				end
@@ -58,7 +58,7 @@ module Falcon
 			
 			Traces::Provider(self) do
 				def call(request)
-					Traces.trace('falcon.middleware.redirect.call', attributes: {authority: request.authority}) do
+					Traces.trace("falcon.middleware.redirect.call", attributes: {authority: request.authority}) do
 						super
 					end
 				end

data/lib/falcon/middleware/verbose.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require 'console'
-require 'async/http/statistics'
+require "console"
+require "async/http/statistics"
 
 module Falcon
 	module Middleware

data/lib/falcon/proxy_endpoint.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'io/endpoint/unix_endpoint'
+require "io/endpoint/unix_endpoint"
 
 module Falcon
 	# An endpoint suitable for proxing requests, typically via a unix pipe.

data/lib/falcon/rackup/handler.rb

@@ -1,14 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
-require 'rackup/handler'
+require_relative "../../falcon"
 
-require_relative '../../falcon'
-
-require 'kernel/sync'
-require 'io/endpoint/host_endpoint'
+require "kernel/sync"
+require "io/endpoint/host_endpoint"
 
 module Falcon
 	module Rackup
@@ -25,7 +23,7 @@ module Falcon
 			# Generate an endpoint for the given `rackup` options.
 			# @returns [::IO::Endpoint::HostEndpoint]
 			def self.endpoint_for(**options)
-				host = options[:Host] || 'localhost'
+				host = options[:Host] || "localhost"
 				port = Integer(options[:Port] || 9292)
 				
 				return ::IO::Endpoint.tcp(host, port)

data/lib/falcon/server.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2023, by Samuel Williams.
+# Copyright, 2017-2025, by Samuel Williams.
 
-require 'async/http/server'
+require "async/http/server"
 
-require 'protocol/http/middleware/builder'
-require 'protocol/http/content_encoding'
+require "protocol/http/middleware/builder"
+require "protocol/http/content_encoding"
 
-require 'async/http/cache'
+require "async/http/cache"
 
-require_relative 'middleware/verbose'
-require 'protocol/rack'
+require_relative "middleware/verbose"
+require "protocol/rack"
 
 module Falcon
 	# A server listening on a specific endpoint, hosting a specific middleware.

data/lib/falcon/service/server.rb

@@ -4,10 +4,10 @@
 # Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2020, by Daniel Evans.
 
-require 'async/service/generic'
-require 'async/http/endpoint'
+require "async/service/generic"
+require "async/http/endpoint"
 
-require_relative '../server'
+require_relative "../server"
 
 module Falcon
 	module Service

data/lib/falcon/service/supervisor.rb

@@ -3,13 +3,13 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'process/metrics'
-require 'json'
+require "process/metrics"
+require "json"
 
-require 'async/service/generic'
+require "async/service/generic"
 
-require 'io/endpoint/bound_endpoint'
-require 'io/stream'
+require "io/endpoint/bound_endpoint"
+require "io/stream"
 
 module Falcon
 	module Service
@@ -50,9 +50,9 @@ module Falcon
 			# @parameter message [Hash] The decoded message.
 			def handle(message)
 				case message[:please]
-				when 'restart'
+				when "restart"
 					self.do_restart(message)
-				when 'metrics'
+				when "metrics"
 					self.do_metrics(message)
 				end
 			end

data/lib/falcon/service/virtual.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2020-2024, by Samuel Williams.
 
-require 'async/service/generic'
+require "async/service/generic"
 
 module Falcon
 	module Service
@@ -18,14 +18,14 @@ module Falcon
 			def assume_privileges(path)
 				# Process.exec / Process.spawn don't replace the environment but instead update it, so we need to clear out any existing BUNDLE_ variables using `nil` values, which will cause them to be removed from the child environment:
 				env = ENV.to_h do |key, value|
-					if key.start_with?('BUNDLE_')
+					if key.start_with?("BUNDLE_")
 						[key, nil]
 					else
 						[key, value]
 					end
 				end
 				
-				env['PWD'] = File.dirname(path)
+				env["PWD"] = File.dirname(path)
 				
 				stat = File.stat(path)
 				
@@ -33,7 +33,7 @@ module Falcon
 				Process::UID.change_privilege(stat.uid)
 				
 				home = Etc.getpwuid(stat.uid).dir
-				env['HOME'] = home
+				env["HOME"] = home
 				
 				return env
 			end

data/lib/falcon/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2017-2024, by Samuel Williams.
 
 module Falcon
-	VERSION = "0.48.3"
+	VERSION = "0.48.4"
 end

data/lib/rack/handler/falcon.rb

@@ -1,16 +1,22 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2024, by Samuel Williams.
+# Copyright, 2017-2025, by Samuel Williams.
 # Copyright, 2019, by Bryan Powell.
 
-require 'rack/handler'
+require "rack/handler"
 
-require_relative '../../falcon/rackup/handler'
+require_relative "../../falcon/rackup/handler"
+
+# Generally speaking, you should not require this file directly, or assume the existance of the `Rack::Handler::Falcon` constant. Instead, use `Rack::Handler.get(:falcon)` to load and access the handler.
 
 module Rack
 	module Handler
-		Falcon = ::Falcon::Rackup::Handler
-		register :falcon, Falcon
+		# Rack (v2) expects the constant to be in the `Rack::Handler` namespace, so we define a new handler class in the `Rack::Handler` namespace that inherits from `Falcon::Rackup::Handler`.
+		class Falcon < ::Falcon::Rackup::Handler
+		end
+		
+		# Rack (v2) expects a string for the handler constant name. `Falcon.to_s` returns a more human friendly name, so we explicitly pass `Falcon.name` to `register` to ensure Rack can find the handler using the registered name.
+		register :falcon, Falcon.name
 	end
 end

data/lib/rackup/handler/falcon.rb

@@ -1,15 +1,21 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023-2024, by Samuel Williams.
+# Copyright, 2023-2025, by Samuel Williams.
 
-require 'rackup/handler'
+require "rackup/handler"
 
-require_relative '../../falcon/rackup/handler'
+require_relative "../../falcon/rackup/handler"
+
+# Generally speaking, you should not require this file directly, or assume the existance of the `Rackup::Handler::Falcon` constant. Instead, use `Rackup::Handler.get(:falcon)` to load and access the handler.
 
 module Rackup
 	module Handler
-		Falcon = ::Falcon::Rackup::Handler
+		# Sinatra (and possibly others) try to extract the name using the final part of the class path, so we define a new class in the `Rack::Handler` namespace that inherits from `Falcon::Rackup::Handler`, that follows that convention.
+		class Falcon < ::Falcon::Rackup::Handler
+		end
+		
+		# Rack (v3) expects a class for the handler constant, so we explicitly pass `Falcon` to `register` to ensure Rack can find the handler using the registered name.
 		register :falcon, Falcon
 	end
 end

data/license.md

@@ -1,16 +1,18 @@
 # MIT License
 
-Copyright, 2017-2024, by Samuel Williams.  
+Copyright, 2017-2025, by Samuel Williams.  
 Copyright, 2018, by Kent Gruber.  
 Copyright, 2018, by Janko Marohnić.  
 Copyright, 2018, by Tad Thorley.  
 Copyright, 2018, by Mitsutaka Mimura.  
 Copyright, 2018, by Kyle Tam.  
 Copyright, 2018, by Claudiu Garba.  
+Copyright, 2018, by Martin Hrdlicka.  
 Copyright, 2019, by Bryan Powell.  
 Copyright, 2019, by Sh Lin.  
 Copyright, 2019, by Sho Ito.  
 Copyright, 2019, by Colby Swandale.  
+Copyright, 2019-2024, by dependabot[bot].  
 Copyright, 2020, by Daniel Evans.  
 Copyright, 2020, by Mikel Kew.  
 Copyright, 2020, by Michael Adams.  
@@ -20,9 +22,9 @@ Copyright, 2023, by Nick Janetakis.
 Copyright, 2024, by Peter Schrammel.  
 Copyright, 2024, by Santiago Bartesaghi.  
 Copyright, 2024, by Trevor Turk.  
-Copyright, 2024, by dependabot[bot].  
 Copyright, 2024, by Adam Daniels.  
 Copyright, 2024, by Stefan Buhrmester.  
+Copyright, 2024, by Ismael Celis.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -45,6 +45,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.48.4
+
+  - 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.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.48.4
+
+  - 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.

data.tar.gz.sig

@@ -1 +1 @@
-��%j����4t�΂\��2�O���<�_���j�����6�����5M#(���3��MP��֫���k��9��7
+�ڨ�a��Z��>E����|�����E��7$Ȭ���%bp^O�J��|ȵ~���o�p�@�Á!O/4�L�RW���a���'�/����V�aۉH�u�s��^i���N ĶE��kE�(��0hy�ّ��d*:g%]�*�•x?�K��f����V��Cb����EV,l���U��/�j��Z`B�2X�S����,�Wc�T��ւ �v�f�28I���#@
��������<����qF�mx�{cBd�,ú�e��W�m8$:�~Qv���:F�8�����M4��������:�R�������[�LB��F�h�[5ٖ�ׂ�ٌ."=Y�2ne��Ӌ��j爌�F�D���]�)	���@�`�'��

metadata

@@ -1,10 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: falcon
 version: !ruby/object:Gem::Version
-  version: 0.48.3
+  version: 0.48.4
 platform: ruby
 authors:
 - Samuel Williams
+- dependabot[bot]
 - Janko Marohnić
 - Bryan Powell
 - Trevor Turk
@@ -16,7 +17,9 @@ authors:
 - Adam Daniels
 - Colby Swandale
 - Daniel Evans
+- Ismael Celis
 - Kent Gruber
+- Martin Hrdlicka
 - Michael Adams
 - Mikel Kew
 - Nick Janetakis
@@ -26,7 +29,6 @@ authors:
 - Stefan Buhrmester
 - Tad Thorley
 - Tasos Latsas
-- dependabot[bot]
 autorequire:
 bindir: bin
 cert_chain:
@@ -59,7 +61,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-10-15 00:00:00.000000000 Z
+date: 2025-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -174,33 +176,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: protocol-http
+  name: process-metrics
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
-  name: process-metrics
+  name: protocol-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.31'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.31'
 - !ruby/object:Gem::Dependency
   name: protocol-rack
   requirement: !ruby/object:Gem::Requirement
@@ -304,7 +306,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A fast, asynchronous, rack-compatible web server.