Class: Puma::Runner
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Subclasses:
|
|
Inherits: | Object |
Defined in: | lib/puma/runner.rb |
Overview
Generic class that is used by Cluster
and Single
to serve requests. This class spawns a new instance of Server
via a call to #start_server.
Class Method Summary
- .new(cli, events) ⇒ Runner constructor
Instance Attribute Summary
- #daemon? ⇒ Boolean readonly
- #development? ⇒ Boolean readonly
- #redirected_io? ⇒ Boolean readonly
- #test? ⇒ Boolean readonly
Instance Method Summary
Constructor Details
.new(cli, events) ⇒ Runner
# File 'lib/puma/runner.rb', line 12
def initialize(cli, events) @launcher = cli @events = events @options = cli. @app = nil @control = nil @started_at = Time.now end
Instance Attribute Details
#daemon? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/puma/runner.rb', line 21
def daemon? @options[:daemon] end
#development? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/puma/runner.rb', line 25
def development? @options[:environment] == "development" end
#redirected_io? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/puma/runner.rb', line 117
def redirected_io? @options[:redirect_stdout] || @options[:redirect_stderr] end
#test? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/puma/runner.rb', line 29
def test? @options[:environment] == "test" end
Instance Method Details
#app
[ GitHub ]# File 'lib/puma/runner.rb', line 164
def app @app ||= @launcher.config.app end
#before_restart
[ GitHub ]# File 'lib/puma/runner.rb', line 37
def before_restart @control.stop(true) if @control end
#debug(str)
[ GitHub ]# File 'lib/puma/runner.rb', line 45
def debug(str) @events.log "- #{str}" if @options[:debug] end
#error(str)
[ GitHub ]# File 'lib/puma/runner.rb', line 41
def error(str) @events.error str end
#load_and_bind
[ GitHub ]# File 'lib/puma/runner.rb', line 147
def load_and_bind unless @launcher.config.app_configured? error "No application configured, nothing to run" exit 1 end # Load the app before we daemonize. begin @app = @launcher.config.app rescue Exception => e log "! Unable to load application: #{e.class}: #{e.}" raise e end @launcher.binder.parse @options[:binds], self end
#log(str)
[ GitHub ]# File 'lib/puma/runner.rb', line 33
def log(str) @events.log str end
#output_header(mode)
[ GitHub ]# File 'lib/puma/runner.rb', line 103
def output_header(mode) min_t = @options[:min_threads] max_t = @options[:max_threads] log "Puma starting in #{mode} mode..." log "* Version #{Puma::Const::PUMA_VERSION} (#{ruby_engine}), codename: #{Puma::Const::CODE_NAME}" log "* Min threads: #{min_t}, max threads: #{max_t}" log "* Environment: #{ENV['RACK_ENV']}" if @options[:mode] == :tcp log "* Mode: Lopez Express (tcp)" end end
#redirect_io
[ GitHub ]# File 'lib/puma/runner.rb', line 121
def redirect_io stdout = @options[:redirect_stdout] stderr = @options[:redirect_stderr] append = @options[:redirect_append] if stdout unless Dir.exist?(File.dirname(stdout)) raise "Cannot redirect STDOUT to #{stdout}" end STDOUT.reopen stdout, (append ? "a" : "w") STDOUT.sync = true STDOUT.puts "=== puma startup: #{Time.now} ===" end if stderr unless Dir.exist?(File.dirname(stderr)) raise "Cannot redirect STDERR to #{stderr}" end STDERR.reopen stderr, (append ? "a" : "w") STDERR.sync = true STDERR.puts "=== puma startup: #{Time.now} ===" end end
#ruby_engine
[ GitHub ]# File 'lib/puma/runner.rb', line 91
def ruby_engine if !defined?(RUBY_ENGINE) || RUBY_ENGINE == "ruby" "ruby #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" else if defined?(RUBY_ENGINE_VERSION) "#{RUBY_ENGINE} #{RUBY_ENGINE_VERSION} - ruby #{RUBY_VERSION}" else "#{RUBY_ENGINE} #{RUBY_VERSION}" end end end
#start_control
[ GitHub ]# File 'lib/puma/runner.rb', line 49
def start_control str = @options[:control_url] return unless str require 'puma/app/status' uri = URI.parse str if token = @options[:control_auth_token] token = nil if token.empty? || token == 'none' end app = Puma::App::Status.new @launcher, token control = Puma::Server.new app, @launcher.events control.min_threads = 0 control.max_threads = 1 case uri.scheme when "ssl" log "* Starting control server on #{str}" params = Util.parse_query uri.query ctx = MiniSSL::ContextBuilder.new(params, @events).context control.add_ssl_listener uri.host, uri.port, ctx when "tcp" log "* Starting control server on #{str}" control.add_tcp_listener uri.host, uri.port when "unix" log "* Starting control server on #{str}" path = "#{uri.host}#{uri.path}" mask = @options[:control_url_umask] control.add_unix_listener path, mask else error "Invalid control URI: #{str}" end control.run @control = control end
#start_server
[ GitHub ]# File 'lib/puma/runner.rb', line 168
def start_server min_t = @options[:min_threads] max_t = @options[:max_threads] server = Puma::Server.new app, @launcher.events, @options server.min_threads = min_t server.max_threads = max_t server.inherit_binder @launcher.binder if @options[:mode] == :tcp server.tcp_mode! end if @options[:early_hints] server.early_hints = true end unless development? || test? server.leak_stack_on_error = false end server end