Add comparison with Unicorn.

Author: ioquatix

examples/unicorn/config.ru

@@ -0,0 +1,41 @@
+#!/usr/bin/env falcon --verbose serve -c
+# frozen_string_literal: true
+
+def limited_semaphore_token(request)
+	if request.respond_to?(:connection)
+		io = request.connection.stream.io
+		
+		if io.respond_to?(:token)
+			return io.token
+		end
+	end
+	
+	return nil
+end
+
+run do |env|
+	# This is not part of the rack specification, but is available when running under Falcon.
+	request = env["protocol.http.request"]
+	
+	# Simulate a leaked IO object:
+	# leak_io = request.connection.stream.io.dup
+	
+	# There is no guarantee that there is a connection or that the connection has a token:
+	token = limited_semaphore_token(request)
+	
+	if env["PATH_INFO"] == "/fast"
+		if token
+			# Keeping the connection alive here is problematic because if the next request is slow, it will "block the server" since we have relinquished the token already.
+			token.release
+			request.connection.persistent = false
+		end
+		
+		# Simulated "fast / non-blocking" request:
+		sleep(0.01)
+	elsif env["PATH_INFO"] == "/slow"
+		# Simulated "slow / blocking" request:
+		sleep(0.1)
+	end
+	
+	[200, {}, ["Hello World"]]
+end

examples/unicorn/falcon.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env falcon-host
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2019-2024, by Samuel Williams.
+
+require "falcon/environment/rack"
+require_relative "../limited/limited"
+
+service "limited.localhost" do
+	include Falcon::Environment::Rack
+	
+	scheme "http"
+	protocol {Async::HTTP::Protocol::HTTP1.new(
+		persistent: false,
+	)}
+	
+	# Extend the endpoint options to include the (connection) limited wrapper.
+	endpoint_options do
+		super().merge(
+			protocol: protocol,
+			wrapper: Limited::Wrapper.new
+		)
+	end
+	
+	count 1
+	
+	url "http://localhost:8080"
+	
+	endpoint do
+		::Async::HTTP::Endpoint.parse(url).with(**endpoint_options)
+	end
+end

examples/unicorn/gems.locked

@@ -0,0 +1,98 @@
+PATH
+  remote: ../..
+  specs:
+    falcon (0.51.1)
+      async
+      async-container (~> 0.20)
+      async-container-supervisor (~> 0.5.0)
+      async-http (~> 0.75)
+      async-http-cache (~> 0.4)
+      async-service (~> 0.10)
+      bundler
+      localhost (~> 1.1)
+      openssl (~> 3.0)
+      protocol-http (~> 0.31)
+      protocol-rack (~> 0.7)
+      samovar (~> 2.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    async (2.23.1)
+      console (~> 1.29)
+      fiber-annotation
+      io-event (~> 1.9)
+      metrics (~> 0.12)
+      traces (~> 0.15)
+    async-container (0.24.0)
+      async (~> 2.22)
+    async-container-supervisor (0.5.1)
+      async-container (~> 0.22)
+      async-service
+      io-endpoint
+      memory-leak (~> 0.5)
+    async-http (0.88.0)
+      async (>= 2.10.2)
+      async-pool (~> 0.9)
+      io-endpoint (~> 0.14)
+      io-stream (~> 0.6)
+      metrics (~> 0.12)
+      protocol-http (~> 0.49)
+      protocol-http1 (~> 0.30)
+      protocol-http2 (~> 0.22)
+      traces (~> 0.10)
+    async-http-cache (0.4.5)
+      async-http (~> 0.56)
+    async-pool (0.10.3)
+      async (>= 1.25)
+    async-service (0.13.0)
+      async
+      async-container (~> 0.16)
+    console (1.30.2)
+      fiber-annotation
+      fiber-local (~> 1.1)
+      json
+    fiber-annotation (0.2.0)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.0)
+    io-endpoint (0.15.2)
+    io-event (1.10.0)
+    io-stream (0.6.1)
+    json (2.10.2)
+    kgio (2.11.4)
+    localhost (1.3.1)
+    mapping (1.1.1)
+    memory-leak (0.5.2)
+    metrics (0.12.2)
+    openssl (3.3.0)
+    protocol-hpack (1.5.1)
+    protocol-http (0.49.0)
+    protocol-http1 (0.31.0)
+      protocol-http (~> 0.22)
+    protocol-http2 (0.22.1)
+      protocol-hpack (~> 1.4)
+      protocol-http (~> 0.47)
+    protocol-rack (0.11.2)
+      protocol-http (~> 0.43)
+      rack (>= 1.0)
+    rack (3.1.12)
+    raindrops (0.20.1)
+    samovar (2.3.0)
+      console (~> 1.0)
+      mapping (~> 1.0)
+    traces (0.15.2)
+    unicorn (6.1.0)
+      kgio (~> 2.6)
+      raindrops (~> 0.7)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  falcon!
+  unicorn (~> 6.1)
+
+BUNDLED WITH
+   2.6.2

examples/unicorn/gems.rb

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gem "unicorn", "~> 6.1"
+gem "falcon", path: "../../"

examples/unicorn/readme.md

@@ -0,0 +1,40 @@
+# Unicorn (Mode)
+
+This is a comparison of Unicorn and Falcon running in single-request-per-process / `connection: close`.
+
+## Unicorn
+
+```sh
+> bundle exec unicorn -E production --port 9090
+```
+
+## Falcon
+
+```sh
+> bundle exec falcon host falcon.rb
+```
+
+## Results
+
+```
+samuel@sakura ~/D/i/wrk (main)> ./wrk --verbose -t1 -c1 -d1 http://localhost:8080
+Running 1s test @ http://localhost:8080
+  1 threads and 1 connections
+  6795 requests in 1.10s, 610.49KB read
+Requests/sec:   6170.43
+Transfer/sec:    554.37KB
+
+Thread Stats         Avg       Stdev         Min         Max    +/- Stdev 
+     Latency:     153.80us    227.98us     94.00us      5.12ms   97.91%
+     Req/sec:       6.22k       2.15k      49.00        7.25k    90.91%
+samuel@sakura ~/D/i/wrk (main)> ./wrk --verbose -t1 -c1 -d1 http://localhost:9090
+Running 1s test @ http://localhost:9090
+  1 threads and 1 connections
+  12070 requests in 1.10s, 0.99MB read
+Requests/sec:  10963.92
+Transfer/sec:      0.90MB
+
+Thread Stats         Avg       Stdev         Min         Max    +/- Stdev 
+     Latency:     190.98us      1.06ms     45.00us     15.56ms   98.39%
+     Req/sec:      11.03k       3.48k     712.00       12.68k    90.91%
+```