100% test coverage. (#353)

Author: samuel-williams-shopify

bin/falcon

@@ -23,11 +23,4 @@
 
 require_relative "../lib/falcon/command"
 
-begin
-	Falcon::Command.call
-rescue Interrupt
-	# Ignore.
-rescue => error
-	Console.error(Falcon::Command, error)
-	exit! 1
-end
+Falcon::Command.call

bin/falcon-host

@@ -23,7 +23,4 @@
 
 require_relative "../lib/falcon/command/host"
 
-begin
-	Falcon::Command::Host.call
-rescue Interrupt
-end
+Falcon::Command::Host.call

config/covered.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+def ignore_paths
+	super + ["examples/"]
+end

gems.rb

@@ -53,6 +53,7 @@
 
 	gem "sus-fixtures-async"
 	gem "sus-fixtures-async-http"
+	gem "sus-fixtures-console"
 	gem "sus-fixtures-openssl"
 
 	gem "bake"

lib/falcon/command.rb

@@ -6,13 +6,20 @@
 
 require_relative "command/top"
 
+require "console"
+
 module Falcon
 	# @namespace
 	module Command
 		# The main entry point for the `falcon` executable.
 		# @parameter arguments [Array(String)] The command line arguments.
 		def self.call(*arguments)
 			Top.call(*arguments)
+		rescue Interrupt
+			# Ignore.
+		rescue => error
+			Console.error(self, error)
+			exit! 1
 		end
 	end
 end

lib/falcon/command/host.rb

@@ -8,6 +8,7 @@
 
 require "samovar"
 require "async/service/controller"
+require "console"
 
 module Falcon
 	module Command
@@ -17,6 +18,17 @@ module Command
 		class Host < Samovar::Command
 			self.description = "Host the specified applications."
 
+			# The main entry point for the `falcon-host` executable.
+			# @parameter arguments [Array(String)] The command line arguments.
+			def self.call(...)
+				super
+			rescue Interrupt
+				# Ignore.
+			rescue => error
+				Console.error(self, error)
+				exit! 1
+			end
+			
 			# One or more paths to the configuration files.
 			# @name paths
 			# @attribute [Array(String)]

lib/falcon/command/serve.rb

@@ -7,6 +7,7 @@
 require_relative "../server"
 require_relative "../endpoint"
 require_relative "../service/server"
+require_relative "../environment/server"
 require_relative "../environment/rackup"
 
 require "async/service/configuration"

lib/falcon/service/virtual.rb

@@ -4,6 +4,7 @@
 # Copyright, 2020-2024, by Samuel Williams.
 
 require "async/service/generic"
+require "console"
 
 module Falcon
 	module Service

test/falcon/command.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "falcon/command"
+require "sus/fixtures/console/captured_logger"
+
+describe Falcon::Command do
+	include Sus::Fixtures::Console::CapturedLogger
+	
+	it "reports errors from the command entry point" do
+		error = RuntimeError.new("boom")
+		captured_status = nil
+		
+		mock(Falcon::Command::Top) do |top|
+			top.replace(:call) do
+				raise error
+			end
+		end
+		
+		mock(subject) do |command|
+			command.replace(:exit!) do |status|
+				captured_status = status
+			end
+		end
+		
+		subject.call
+		
+		expect(captured_status).to be == 1
+		
+		expect_console.to have_logged(
+			severity: be == :error,
+			subject: be == subject,
+			arguments: be == [error],
+			message: be == "boom",
+		)
+	end
+end

test/falcon/command/host.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "falcon/command/host"
+require "sus/fixtures/console/captured_logger"
+
+describe Falcon::Command::Host do
+	include Sus::Fixtures::Console::CapturedLogger
+	
+	let(:command) do
+		subject[]
+	end
+	
+	it "runs the controller" do
+		captured_configuration = nil
+		captured_container_class = nil
+		
+		mock(Async::Service::Controller) do |controller|
+			controller.replace(:run) do |configuration, container_class:|
+				captured_configuration = configuration
+				captured_container_class = container_class
+			end
+		end
+		
+		command.call
+		
+		expect(captured_configuration).to be_a(Async::Service::Configuration)
+		expect(captured_container_class).to be == command.container_class
+		
+		expect_console.to have_logged(
+			severity: be == :info,
+			subject: be == command,
+			message: be(:include?, "Falcon Host v"),
+		)
+	end
+	
+	it "reports errors from the host entry point" do
+		error = RuntimeError.new("boom")
+		captured_status = nil
+		
+		mock(Async::Service::Controller) do |controller|
+			controller.replace(:run) do |configuration, container_class:|
+				raise error
+			end
+		end
+		
+		mock(subject) do |host|
+			host.replace(:exit!) do |status|
+				captured_status = status
+			end
+		end
+		
+		subject.call(["missing.rb"])
+		
+		expect(captured_status).to be == 1
+		
+		expect_console.to have_logged(
+			severity: be == :error,
+			subject: be == subject,
+			arguments: be == [error],
+			message: be == "boom",
+		)
+	end
+end