`class Serve`

Implements the falcon serve command. Designed for development.

Manages a Controller::Serve instance which is responsible for running applications in a development environment.

Definitions

`options { ... }`

The command line options.

Signature

attribute　Samovar::Options

Implementation

options do
	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 '-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 '--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 '--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
end

`def container_class`

The container class to use.

Implementation

def container_class
	case @options[:container]
	when :threaded
		return Async::Container::Threaded
	when :forked
		return Async::Container::Forked
	when :hybrid
		return Async::Container::Hybrid
	end
end

`def endpoint`

The endpoint to bind to.

Implementation

def endpoint
	Endpoint.parse(@options[:bind], **endpoint_options)
end

`def client_endpoint`

The endpoint suitable for a client to connect.

Implementation

def client_endpoint
	Async::HTTP::Endpoint.parse(@options[:bind], **endpoint_options)
end

`def client`

Create a new client suitable for accessing the application.

Implementation

def client
	Async::HTTP::Client.new(client_endpoint)
end

`def call`

Prepare the environment and run the controller.

Implementation

def call
	Console.logger.info(self) do |buffer|
		buffer.puts "Falcon v#{VERSION} taking flight! Using #{self.container_class} #{self.container_options}."
		buffer.puts "- Binding to: #{self.endpoint}"
		buffer.puts "- To terminate: Ctrl-C or kill #{Process.pid}"
		buffer.puts "- To reload configuration: kill -HUP #{Process.pid}"
	end
	
	Async::Service::Controller.run(self.configuration, container_class: self.container_class, graceful_stop: @options[:graceful_stop])
end