Sha256: 7cacac3d7ffb49603385899ded7c449b2f98d1f738b56b81bb90b064a7e4fc87

Contents?: true

Size: 1.86 KB

Versions: 9

Compression:

Stored size: 1.86 KB

Contents

# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2019-2024, by Samuel Williams.

require 'samovar'
require 'async'
require 'json'

require 'io/endpoint/unix_endpoint'
require 'io/stream'

module Falcon
	module Command
		# Implements the `falcon supervisor` command.
		#
		# Talks to an instance of the supervisor to issue commands and print results.
		class Supervisor < Samovar::Command
			self.description = "Control and query a specific supervisor."
			
			# The command line options.
			# @attribute [Samovar::Options]
			options do
				option "--path <path>", "The control IPC path.", default: "supervisor.ipc"
			end
			
			# Implements the `falcon supervisor restart` command.
			class Restart < Samovar::Command
				self.description = "Restart the process group."
				
				# Send the restart message to the supervisor.
				def call(stream)
					stream.puts({please: 'restart'}.to_json, separator: "\0")
				end
			end
			
			# Implements the `falcon supervisor metrics` command.
			class Metrics < Samovar::Command
				self.description = "Show metrics about the falcon processes."
				
				# Send the metrics message to the supervisor and print the results.
				def call(stream)
					stream.puts({please: 'metrics'}.to_json, separator: "\0")
					response = JSON.parse(stream.gets("\0"), symbolize_names: true)
					
					$stdout.puts response
				end
			end
			
			# The nested command to execute.
			# @name nested
			# @attribute [Command]
			nested :command, {
				'restart' => Restart,
				'metrics' => Metrics,
			}, default: 'metrics'
			
			# The endpoint the supervisor is bound to.
			def endpoint
				::IO::Endpoint.unix(@options[:path])
			end
			
			# Connect to the supervisor and execute the requested command.
			def call
				Sync do
					endpoint.connect do |socket|
						@command.call(IO::Stream(socket))
					end
				end
			end
		end
	end
end

Version data entries

9 entries across 9 versions & 1 rubygems

Version Path
falcon-0.48.2 lib/falcon/command/supervisor.rb
falcon-0.48.1 lib/falcon/command/supervisor.rb
falcon-0.48.0 lib/falcon/command/supervisor.rb
falcon-0.47.10 lib/falcon/command/supervisor.rb
falcon-0.47.9 lib/falcon/command/supervisor.rb
falcon-0.47.8 lib/falcon/command/supervisor.rb
falcon-0.47.7 lib/falcon/command/supervisor.rb
falcon-0.47.1 lib/falcon/command/supervisor.rb
falcon-0.47.0 lib/falcon/command/supervisor.rb