falcon 0.36.4

data/lib/falcon/command/supervisor.rb

@@ -0,0 +1,78 @@
+# 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 'samovar'
+require 'async'
+require 'json'
+
+require 'async/io/stream'
+require 'async/io/unix_endpoint'
+
+module Falcon
+	module Command
+		class Supervisor < Samovar::Command
+			self.description = "Control and query a specific host."
+			
+			options do
+				option "--path <path>", "The control IPC path.", default: "supervisor.ipc"
+			end
+			
+			class Restart < Samovar::Command
+				self.description = "Restart the process group."
+				
+				def call(stream)
+					stream.puts({please: 'restart'}.to_json, separator: "\0")
+				end
+			end
+			
+			class Metrics < Samovar::Command
+				self.description = "Show metrics about the falcon processes."
+				
+				def call(stream)
+					stream.puts({please: 'metrics'}.to_json, separator: "\0")
+					response = JSON.parse(stream.gets("\0"), symbolize_names: true)
+					
+					pp response
+				end
+			end
+			
+			nested :command, {
+				'restart' => Restart,
+				'metrics' => Metrics,
+			}, default: 'metrics'
+			
+			def endpoint
+				Async::IO::Endpoint.unix(@options[:path])
+			end
+			
+			def call
+				Async do
+					endpoint.connect do |socket|
+						stream = Async::IO::Stream.new(socket)
+						
+						@command.call(stream)
+					end
+				end
+			end
+		end
+	end
+end

data/lib/falcon/command/top.rb

@@ -0,0 +1,94 @@
+# 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_relative 'serve'
+require_relative 'host'
+require_relative 'virtual'
+require_relative 'proxy'
+require_relative 'redirect'
+require_relative 'supervisor'
+
+require_relative '../version'
+
+require 'samovar'
+
+module Falcon
+	module Command
+		class Top < Samovar::Command
+			self.description = "An asynchronous HTTP server."
+			
+			options do
+				option '--verbose | --quiet', "Verbosity of output for debugging.", key: :logging
+				option '-h/--help', "Print out help information."
+				option '-v/--version', "Print out the application version."
+				option '-e/--encoding', "Specify the default external encoding of the server.", default: "UTF-8"
+			end
+			
+			nested :command, {
+				'serve' => Serve,
+				'host' => Host,
+				'virtual' => Virtual,
+				'proxy' => Proxy,
+				'redirect' => Redirect,
+				'supervisor' => Supervisor,
+			}, default: 'serve'
+			
+			def verbose?
+				@options[:logging] == :verbose
+			end
+			
+			def quiet?
+				@options[:logging] == :quiet
+			end
+			
+			# If you don't specify these, it's possible to have issues when encodings mismatch on the server.
+			def update_external_encoding!(encoding = Encoding::UTF_8)
+				if Encoding.default_external != encoding
+					Console.logger.warn(self) {"Updating Encoding.default_external from #{Encoding.default_external} to #{encoding}"}
+					Encoding.default_external = encoding
+				end
+			end
+			
+			def encoding
+				if name = @options[:encoding]
+					Encoding.find(name)
+				end
+			end
+			
+			def call
+				if encoding = self.encoding
+					update_external_encoding!(encoding)
+				else
+					update_external_encoding!
+				end
+				
+				if @options[:version]
+					puts "#{self.name} v#{Falcon::VERSION}"
+				elsif @options[:help]
+					self.print_usage
+				else
+					@command.call
+				end
+			end
+		end
+	end
+end

data/lib/falcon/command/virtual.rb

@@ -0,0 +1,89 @@
+# 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 '../controller/virtual'
+require_relative 'paths'
+
+require 'samovar'
+
+module Falcon
+	module Command
+		class Virtual < Samovar::Command
+			self.description = "Run one or more virtual hosts with a front-end proxy."
+			
+			options do
+				option '--bind-insecure <address>', "Bind redirection to the given hostname/address", default: "http://[::]:80"
+				option '--bind-secure <address>', "Bind proxy to the given hostname/address", default: "https://[::]:443"
+				
+				option '-t/--timeout <duration>', "Specify the maximum time to wait for non-blocking operations.", type: Float, default: 30
+			end
+			
+			many :paths
+			
+			include Paths
+			
+			def controller
+				Controller::Virtual.new(self)
+			end
+			
+			def bind_secure
+				@options[:bind_secure]
+			end
+			
+			def bind_insecure
+				@options[:bind_insecure]
+			end
+			
+			def timeout
+				@options[:timeout]
+			end
+			
+			def call
+				Async.logger.info(self) do |buffer|
+					buffer.puts "Falcon Virtual v#{VERSION} taking flight!"
+					buffer.puts "- To terminate: Ctrl-C or kill #{Process.pid}"
+					buffer.puts "- To reload all sites: kill -HUP #{Process.pid}"
+				end
+				
+				self.controller.run
+			end
+			
+			def insecure_endpoint(**options)
+				Async::HTTP::Endpoint.parse(@options[:bind_insecure], **options)
+			end
+			
+			def secure_endpoint(**options)
+				Async::HTTP::Endpoint.parse(@options[:bind_secure], **options)
+			end
+			
+			# An endpoint suitable for connecting to the specified hostname.
+			def host_endpoint(hostname, **options)
+				endpoint = secure_endpoint(**options)
+				
+				url = URI.parse(@options[:bind_secure])
+				url.hostname = hostname
+				
+				return Async::HTTP::Endpoint.new(url, hostname: endpoint.hostname)
+			end
+		end
+	end
+end

data/lib/falcon/configuration.rb

@@ -0,0 +1,147 @@
+# 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 'build/environment'
+
+module Falcon
+	class Configuration
+		def initialize(verbose = false)
+			@environments = {}
+		end
+		
+		attr :environments
+		
+		def each(key = :authority)
+			return to_enum(key) unless block_given?
+			
+			@environments.each do |name, environment|
+				environment = environment.flatten
+				
+				if environment.include?(key)
+					yield environment
+				end
+			end
+		end
+		
+		def add(environment)
+			name = environment.name
+			
+			unless name
+				raise ArgumentError, "Environment name is nil #{environment.inspect}"
+			end
+			
+			environment = environment.flatten
+			
+			raise KeyError.new("#{name.inspect} is already set", key: name) if @environments.key?(name)
+			
+			@environments[name] = environment
+		end
+		
+		def load_file(path)
+			Loader.load_file(self, path)
+		end
+		
+		class Loader
+			def initialize(configuration, root = nil)
+				@loaded = {}
+				@configuration = configuration
+				@environments = {}
+				@root = root
+			end
+			
+			attr :path
+			attr :configuration
+			
+			def self.load_file(configuration, path)
+				path = File.realpath(path)
+				root = File.dirname(path)
+				
+				loader = self.new(configuration, root)
+				
+				loader.instance_eval(File.read(path), path)
+			end
+			
+			def load(*features)
+				features.each do |feature|
+					next if @loaded.include?(feature)
+					
+					relative_path = File.join(__dir__, "configuration", "#{feature}.rb")
+					
+					self.instance_eval(File.read(relative_path), relative_path)
+					
+					@loaded[feature] = relative_path
+				end
+			end
+			
+			def add(name, *parents, &block)
+				raise KeyError.new("#{name} is already set", key: name) if @environments.key?(name)
+				@environments[name] = merge(name, *parents, &block)
+			end
+				
+			def host(name, *parents, &block)
+				environment = merge(name, :host, *parents, &block)
+				
+				environment[:root] = @root
+				environment[:authority] = name
+				
+				@configuration.add(environment.flatten)
+			end
+			
+			def proxy(name, *parents, &block)
+				environment = merge(name, :proxy, *parents, &block)
+				
+				environment[:root] = @root
+				environment[:authority] = name
+				
+				@configuration.add(environment.flatten)
+			end
+			
+			def rack(name, *parents, &block)
+				environment = merge(name, :rack, *parents, &block)
+				
+				environment[:root] = @root
+				environment[:authority] = name
+				
+				@configuration.add(environment.flatten)
+			end
+			
+			def supervisor
+				name = File.join(@root, "supervisor")
+				environment = merge(name, :supervisor)
+				
+				environment[:root] = @root
+				
+				@configuration.add(environment.flatten)
+			end
+				
+			private
+			
+			def merge(name, *parents, &block)
+				environments = parents.map{|name| @environments.fetch(name)}
+				
+				parent = Build::Environment.combine(*environments)
+				
+				Build::Environment.new(parent, name: name, &block)
+			end
+		end
+	end
+end

data/lib/falcon/configuration/application.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Copyright, 2019, 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_endpoint'
+require_relative '../server'
+
+require_relative '../service/application'
+
+add(:application) do
+	middleware do
+		::Protocol::HTTP::Middleware::HelloWorld
+	end
+	
+	scheme 'https'
+	protocol {Async::HTTP::Protocol::HTTP2}
+	ipc_path {::File.expand_path("application.ipc", root)}
+	
+	endpoint do
+		::Falcon::ProxyEndpoint.unix(ipc_path,
+			protocol: protocol,
+			scheme: scheme,
+			authority: authority
+		)
+	end
+	
+	service ::Falcon::Service::Application
+end