falcon 0.55.1 → 0.55.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45c36302281a4c7947bc8c19869f93143254e821c0ab327b725aa8782dd710cb
-  data.tar.gz: c59ab82cc9babe0eea1a7ec74b2fdba4be6801dd7b1b05359fec6a2f8ec0db91
+  metadata.gz: 3e901867477864a82832904cbaa1662105e6dce12190e057d457a666fa3dfe42
+  data.tar.gz: 523e181a6685bfe398bc5630076ab8e76642bf47181d4e20c62192813f121712
 SHA512:
-  metadata.gz: 2242015bc8980ebef3ae53fb2bf8db8040ef943bada60bb801cd65e849cfc68f8586b6a33e050053270cd9bd10ea9e5c778de117adb82353ecc47d24439bfb7f
-  data.tar.gz: 522154fa107e97fa4a8b72e997f71ab7afcf4e8a5699cb741f6d16aa2720b722a664dae052c82130df930af3430aa1d531a705ac59081658074008b4e58ded6a
+  metadata.gz: 0eb64a874478507caeafefb4c83b108cfa7b00326cf69ce7581ab534e9466048dea1572b66044f06ee19b21998fafad32cf5de3ea050f6ae0f32b1743424ef2e
+  data.tar.gz: 3f041a4ebdf07b1063373a27e7151b4f8380f4f440b34a773f27b0b6761d64f721209c5a7d2366f1210e1be1d3042d1e8bed117a77a7ce81d9335274636fe656

data/context/deployment.md

@@ -56,18 +56,22 @@ service "supervisor" do
 end
 ~~~
 
-These configuration blocks are evaluated using the [async-service](https://github.com/socketry/async-service) gem. The supervisor is an independent service which monitors the health of the application and can restart it if necessary. Other services like background job processors can be added to the configuration.
+These configuration blocks are evaluated using the [async-service](https://github.com/socketry/async-service) gem. This configuration will bind Falcon to an [IPC socket](https://en.wikipedia.org/wiki/Unix_domain_socket) and is designed to be used with a reverse proxy such as [`falcon virtual`](#falcon-virtual).
+
+The supervisor is an independent service which monitors the health of the application and can restart it if necessary. Other services like background job processors can be added to the configuration.
 
 ### Environments
 
 The service blocks define configuration that is loaded by the service layer to control how the service is run. The `service ... do` block defines the service name and the environment in which it runs. Different modules can be included to provide different functionality, such as `Falcon::Environment::Rack` for Rack applications, or `Falcon::Environment::LetsEncryptTLS` for automatic TLS certificate management.
 
+**NOTE**: Falcon does not provision or renew certificates automatically. Use a tool like [certbot](https://certbot.eff.org) to provision your certificate and the `LetsEncryptTLS` environment will automatically read it in.
+
 ### Application Configuration
 
 The environment configuration is defined in the `Falcon::Environment` module. The {ruby Falcon::Environment::Application} environment supports the generic virtual host functionality, but you can customise any parts of the configuration, e.g. to bind a production host to `localhost:3000` using plaintext HTTP/2:
 
 ~~~ ruby
-#!/usr/bin/env falcon host
+#!/usr/bin/env falcon-host
 # frozen_string_literal: true
 
 require "falcon/environment/rack"
@@ -76,12 +80,54 @@ require "async/service/supervisor"
 hostname = File.basename(__dir__)
 service hostname do
 	include Falcon::Environment::Rack
-	include Falcon::Environment::LetsEncryptTLS
 
 	endpoint do
 		Async::HTTP::Endpoint
 			.parse('http://localhost:3000')
-			.with(protocol: Async::HTTP::Protocol::HTTP2)
+			.with(
+				protocol: Async::HTTP::Protocol::HTTP2
+			)
+	end
+end
+
+service "supervisor" do
+	include Async::Service::Supervisor::Environment
+end
+~~~
+
+You can verify this is working using the [`nghttp2` client](https://nghttp2.org): `nghttp -v http://localhost:3000`. This will not work in a browser as they mandate TLS for HTTP/2 connections.
+
+#### Self-signed certificate
+
+You can use a self-signed certificate to test your server configuration locally. First, provision a certificate using the [`localhost` gem](https://github.com/socketry/localhost):
+
+```
+$ bundle exec bake localhost:install
+```
+
+You may be prompted for a password to install the certificate. This is the password for your local keychain.
+
+Then, add the `SelfSignedTLS` environment to your configuration and set up the SSL context:
+
+~~~ ruby
+#!/usr/bin/env falcon-host
+# frozen_string_literal: true
+
+require "falcon/environment/rack"
+require "async/service/supervisor"
+
+hostname = File.basename(__dir__)
+service hostname do
+	include Falcon::Environment::Rack
+	include Falcon::Environment::SelfSignedTLS
+
+	endpoint do
+		Async::HTTP::Endpoint
+			.parse('https://localhost:3000')
+			.with(
+				protocol: Async::HTTP::Protocol::HTTP2,
+				ssl_context: ssl_context
+			)
 	end
 end
 
@@ -90,7 +136,7 @@ service "supervisor" do
 end
 ~~~
 
-You can verify this is working using `nghttp -v http://localhost:3000`.
+You should now be able to access your server at `https://localhost:3000` in your browser.
 
 #### Application Configuration Example for Heroku
 

data/lib/falcon/body/request_finished.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 require "protocol/http/body/wrapper"
 

data/lib/falcon/service/server.rb

@@ -5,7 +5,6 @@
 # Copyright, 2020, by Daniel Evans.
 
 require "async/service/managed/service"
-require "async/service/supervisor/supervised"
 require "async/http/endpoint"
 
 require_relative "../server"

data/lib/falcon/version.rb

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

data/license.md

@@ -28,6 +28,7 @@ Copyright, 2024, by Ismael Celis.
 Copyright, 2025, by Pierre Montelle.  
 Copyright, 2025, by Jared Smith.  
 Copyright, 2025, by Yoji Shidara.  
+Copyright, 2026, by Ayush Newatia.  
 
 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

@@ -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.2
+
+  - Remove unnecessary require for `async/service/supervisor/supervised`."
+
 ### v0.55.1
 
   - `requests_active` is decremented after the response body is closed, including `rack.response_finished` callbacks.
@@ -92,10 +96,6 @@ Please see the [project releases](https://socketry.github.io/falcon/releases/ind
   - [Falcon Server Container Health Checks](https://socketry.github.io/falcon/releases/index#falcon-server-container-health-checks)
   - [Falcon Server Process Title](https://socketry.github.io/falcon/releases/index#falcon-server-process-title)
 
-### v0.48.4
-
-  - Improve compatibility of rackup handler w.r.t. sinatra.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.55.2
+
+  - Remove unnecessary require for `async/service/supervisor/supervised`."
+
 ## v0.55.1
 
   - `requests_active` is decremented after the response body is closed, including `rack.response_finished` callbacks.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: falcon
 version: !ruby/object:Gem::Version
-  version: 0.55.1
+  version: 0.55.2
 platform: ruby
 authors:
 - Samuel Williams
@@ -15,6 +15,7 @@ authors:
 - Peter Schrammel
 - Sho Ito
 - Adam Daniels
+- Ayush Newatia
 - Colby Swandale
 - Daniel Evans
 - Ismael Celis