falcon 0.36.4

data/lib/falcon/proxy_endpoint.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright, 2018, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'async/io/unix_endpoint'
+
+module Falcon
+	class ProxyEndpoint < Async::IO::Endpoint
+		def initialize(endpoint, **options)
+			super(**options)
+			
+			@endpoint = endpoint
+		end
+		
+		def to_s
+			"\#<#{self.class} endpoint=#{@endpoint}>"
+		end
+		
+		attr :endpoint
+		
+		def protocol
+			@options[:protocol]
+		end
+		
+		def scheme
+			@options[:scheme]
+		end
+		
+		def authority
+			@options[:authority]
+		end
+		
+		def connect(&block)
+			@endpoint.connect(&block)
+		end
+		
+		def bind(&block)
+			@endpoint.bind(&block)
+		end
+		
+		def each
+			return to_enum unless block_given?
+			
+			@endpoint.each do |endpoint|
+				yield self.class.new(endpoint, **@options)
+			end
+		end
+		
+		def self.unix(path, **options)
+			self.new(::Async::IO::Endpoint.unix(path), **options)
+		end
+	end
+end

data/lib/falcon/server.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'async/http/server'
+
+require 'protocol/http/middleware/builder'
+require 'protocol/http/content_encoding'
+
+require 'async/http/cache'
+
+require_relative 'verbose'
+require_relative 'adapters/rewindable'
+require_relative 'adapters/rack'
+
+module Falcon
+	class Server < Async::HTTP::Server
+		def self.middleware(rack_app, verbose: false, cache: true)
+			::Protocol::HTTP::Middleware.build do
+				if verbose
+					use Verbose
+				end
+				
+				if cache
+					use Async::HTTP::Cache::General
+				end
+				
+				use ::Protocol::HTTP::ContentEncoding
+				use Adapters::Rewindable
+				use Adapters::Rack
+				
+				run rack_app
+			end
+		end
+	end
+end

data/lib/falcon/service/application.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+# Copyright, 2018, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'proxy'
+
+require 'async/http/endpoint'
+require 'async/io/shared_endpoint'
+
+module Falcon
+	module Service
+		class Application < Proxy
+			def initialize(environment)
+				super
+				
+				@bound_endpoint = nil
+			end
+			
+			def middleware
+				# In a multi-threaded container, we don't want to modify the shared evaluator's cache, so we create a new evaluator:
+				@environment.evaluator.middleware
+			end
+			
+			def preload!
+				if scripts = @evaluator.preload
+					scripts.each do |path|
+						Async.logger.info(self) {"Preloading #{path}..."}
+						full_path = File.expand_path(path, self.root)
+						load(full_path)
+					end
+				end
+			end
+			
+			def start
+				Async.logger.info(self) {"Binding to #{self.endpoint}..."}
+				
+				@bound_endpoint = Async::Reactor.run do
+					Async::IO::SharedEndpoint.bound(self.endpoint)
+				end.wait
+				
+				preload!
+				
+				super
+			end
+			
+			def setup(container)
+				protocol = self.protocol
+				scheme = self.scheme
+				
+				container.run(name: self.name, restart: true) do |instance|
+					Async(logger: logger) do |task|
+						Async.logger.info(self) {"Starting application server for #{self.root}..."}
+						
+						server = Server.new(self.middleware, @bound_endpoint, protocol, scheme)
+						
+						server.run
+						
+						instance.ready!
+						
+						task.children.each(&:wait)
+					end
+				end
+				
+				super
+			end
+			
+			def stop
+				@bound_endpoint&.close
+				@bound_endpoint = nil
+				
+				super
+			end
+		end
+	end
+end

data/lib/falcon/service/generic.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# Copyright, 201, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Falcon
+	module Service
+		class Generic
+			def self.wrap(environment)
+				evaluator = environment.evaluator
+				service = evaluator.service || self
+				
+				return service.new(environment)
+			end
+			
+			def initialize(environment)
+				@environment = environment
+				@evaluator = @environment.evaluator
+			end
+			
+			def include?(keys)
+				keys.all?{|key| @environment.include?(key)}
+			end
+			
+			def name
+				@evaluator.name
+			end
+			
+			def logger
+				return Async.logger # .with(name: name)
+			end
+			
+			def start
+			end
+			
+			def setup(container)
+			end
+			
+			def stop
+			end
+		end
+	end
+end

data/lib/falcon/service/proxy.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# Copyright, 2018, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'generic'
+
+require 'async/http/endpoint'
+require 'async/io/shared_endpoint'
+
+module Falcon
+	module Service
+		class Proxy < Generic
+			def name
+				"#{self.class} for #{self.authority}"
+			end
+			
+			def authority
+				@evaluator.authority
+			end
+			
+			def endpoint
+				@evaluator.endpoint
+			end
+			
+			def ssl_context
+				@evaluator.ssl_context
+			end
+			
+			def root
+				@evaluator.root
+			end
+			
+			def protocol
+				endpoint.protocol
+			end
+			
+			def scheme
+				endpoint.scheme
+			end
+		end
+	end
+end

data/lib/falcon/service/supervisor.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+# Copyright, 2018, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'process/metrics'
+require 'json'
+
+require 'async/io/endpoint'
+require 'async/io/shared_endpoint'
+
+module Falcon
+	module Service
+		class Supervisor < Generic
+			def initialize(environment)
+				super
+				
+				@bound_endpoint = nil
+			end
+			
+			def endpoint
+				@evaluator.endpoint
+			end
+			
+			def do_restart(message)
+				# Tell the parent of this process group to spin up a new process group/container.
+				# Wait for that to start accepting new connections.
+				# Stop accepting connections.
+				# Wait for existing connnections to drain.
+				# Terminate this process group.
+				
+				signal = message[:signal] || :INT
+				
+				Process.kill(signal, Process.ppid)
+			end
+			
+			def do_metrics(message)
+				Process::Metrics::General.capture(pid: Process.ppid, ppid: Process.ppid)
+			end
+			
+			def handle(message)
+				case message[:please]
+				when 'restart'
+					self.do_restart(message)
+				when 'metrics'
+					self.do_metrics(message)
+				end
+			end
+			
+			def start
+				Async.logger.info(self) {"Binding to #{self.endpoint}..."}
+				
+				@bound_endpoint = Async::Reactor.run do
+					Async::IO::SharedEndpoint.bound(self.endpoint)
+				end.wait
+				
+				super
+			end
+			
+			def setup(container)
+				container.run(name: self.name, restart: true, count: 1) do |instance|
+					Async do
+						@bound_endpoint.accept do |peer|
+							stream = Async::IO::Stream.new(peer)
+							
+							while message = stream.gets("\0")
+								response = handle(JSON.parse(message, symbolize_names: true))
+								stream.puts(response.to_json, separator: "\0")
+							end
+						end
+						
+						instance.ready!
+					end
+				end
+				
+				super
+			end
+			
+			def stop
+				@bound_endpoint&.close
+				@bound_endpoint = nil
+				
+				super
+			end
+		end
+	end
+end