Make it easy to start the configured server using a bake task. (#10)

Author: ioquatix

bake/rack/conform.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022, by Samuel Williams.
+
+def initialize(...)
+	super
+	require 'sus'
+	require 'rack/conform/server'
+end
+
+def server
+	@server = Rack::Conform::Server.current(log: $stdout)
+	assertions = Sus::Assertions.new(output: Sus::Output.default)
+	@server.start(assertions)
+	
+	begin
+		@server.wait
+	rescue Interrupt
+		# Ignore.
+	end
+end

lib/rack/conform/server.rb

@@ -11,22 +11,27 @@
 module Rack
 	module Conform
 		class Server
-			def self.current
+			def self.current(**options)
 				command = ENV['RACK_CONFORM_SERVER']
 				endpoint = ENV['RACK_CONFORM_ENDPOINT']
 
 				if command and endpoint
-					return self.new(command, endpoint)
+					return self.new(command, endpoint, **options)
 				end
 			end
 
-			def initialize(command, endpoint)
+			def initialize(command, endpoint, log: nil)
 				@command = command
 				@endpoint = endpoint
+				@log = log
 
 				@pid = nil
 			end
 
+			def log
+				@log ||= ::File.open("server.log", "w+")
+			end
+			
 			def print(output)
 				output.write "server ", :variable, @command.inspect, " ", @endpoint, :reset
 			end
@@ -40,6 +45,12 @@ def start(assertions)
 				end
 			end
 
+			def wait
+				if @pid
+					Process.wait(@pid)
+				end
+			end
+			
 			def close
 				if @pid
 					Process.kill(:INT, @pid)
@@ -50,7 +61,7 @@ def close
 
 			def startup(assertions, timeout: 10)
 				clock = Sus::Clock.start!
-				log = ::File.open("server.log", "w+")
+				log = self.log
 				pid = Process.spawn(@command, out: log, err: log)
 
 				Async do
@@ -78,8 +89,6 @@ def startup(assertions, timeout: 10)
 			rescue => error
 				Process.kill(:INT, pid) if pid
 				raise
-			ensure
-				log&.close
 			end
 		end
 	end

rack-conform.gemspec

@@ -20,8 +20,8 @@ Gem::Specification.new do |spec|
 	spec.required_ruby_version = ">= 2.5"
 
 	spec.add_dependency "async-http", "~> 0.50"
-	spec.add_dependency "rack", ">= 1.0"
 	spec.add_dependency "benchmark-http", "~> 0.2"
+	spec.add_dependency "rack", ">= 1.0"
 	spec.add_dependency "sus", "~> 0.12"
 	spec.add_dependency "sus-fixtures-async", "~> 0.1.0"
 end

readme.md

@@ -2,7 +2,7 @@
 
 Provides rack server conformance testing.
 
-[![Development Status](https://github.com/socketry/protocol-http/workflows/Test/badge.svg)](https://github.com/socketry/protocol-http/actions?workflow=Test)
+[![Development Status](https://github.com/socketry/rack-conform/workflows/Test/badge.svg)](https://github.com/socketry/rack-conform/actions?workflow=Test)
 
 ## Motivation
 
@@ -14,20 +14,32 @@ Rack has pretty decent support for validating applications do the right thing us
 
 ### Servers Tested
 
-- Falcon (Rack 2 & 3)
-- Puma (Rack 2)
-- Passenger (Rack 2)
-- Unicorn (Rack 2)
-- Thin (Rack 2)
+  - Falcon (Rack 2 & 3)
+  - Puma (Rack 2)
+  - Passenger (Rack 2)
+  - Unicorn (Rack 2)
+  - Thin (Rack 2)
 
 ## Usage
 
 This repository includes test suite execution for published versions of major web servers. You can also run it for a specific server:
 
-```bash
+``` bash
 export BUNDLE_GEMFILE=gems/falcon-v0-rack-v3.rb
 bundle install
 export RACK_CONFORM_SERVER="falcon --bind http://localhost:9292"
 export RACK_CONFORM_ENDPOINT="http://localhost:9292"
 bundle exec sus # run tests
 ```
+
+### Starting A Server
+
+You can also start a server running the conform application for independent testing (e.g. using `curl`).
+
+``` bash
+export BUNDLE_GEMFILE=gems/falcon-v0-rack-v3.rb
+bundle install
+export RACK_CONFORM_SERVER="falcon --bind http://localhost:9292"
+export RACK_CONFORM_ENDPOINT="http://localhost:9292"
+bundle exec bake rack:conform:server
+```