Class: Falcon::Rackup::Handler

Inherits:
Object
  • Object
show all
Defined in:
lib/falcon/rackup/handler.rb

Overview

The falcon adaptor for the ‘rackup` executable.

Constant Summary collapse

SCHEME =

The default scheme.

"http"

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(server, task) ⇒ Handler

Returns a new instance of Handler.



54
55
56
57
58
59
60
61
62
63
64
65
66
 
# File 'lib/falcon/rackup/handler.rb', line 54

def initialize(server, task)
	@server = server
	@task = task
	
	@notification = Thread::Queue.new
	
	@waiter = @task.async(transient: true) do
		@notification.pop
		
		@task&.stop
		@task = nil
	end
end

Class Method Details

.endpoint_for(**options) ⇒ Object

Generate an endpoint for the given ‘rackup` options.



25
26
27
28
29
30
 
# File 'lib/falcon/rackup/handler.rb', line 25

def self.endpoint_for(**options)
	host = options[:Host] || "localhost"
	port = Integer(options[:Port] || 9292)
	
	return ::IO::Endpoint.tcp(host, port)
end

.run(app, **options) ⇒ Object

Run the specified app using the given options:



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/falcon/rackup/handler.rb', line 34

def self.run(app, **options)
	app = ::Protocol::Rack::Adapter.new(app)
	
	Sync do |task|
		endpoint = endpoint_for(**options)
		server = ::Falcon::Server.new(app, endpoint, protocol: Async::HTTP::Protocol::HTTP1, scheme: SCHEME)
		
		server_task = server.run
		
		wrapper = self.new(server, task)
		
		yield wrapper if block_given?
		
		server_task.wait
	ensure
		server_task.stop
		wrapper.close
	end
end

.to_s ⇒ Object

The name of the handler.



19
20
21
 
# File 'lib/falcon/rackup/handler.rb', line 19

def self.to_s
	"Falcon v#{Falcon::VERSION}"
end

Instance Method Details

#close ⇒ Object 



72
73
74
75
76
77
78
 
# File 'lib/falcon/rackup/handler.rb', line 72

def close
	@notification&.close
	@notification = nil
	
	@waiter&.stop
	@waiter = nil
end

#stop ⇒ Object 



68
69
70
 
# File 'lib/falcon/rackup/handler.rb', line 68

def stop
	@notification&.push(true)
end