class Capybara::Server

Attributes

app[R]
host[R]
port[R]

Public Class Methods

new(app, *deprecated_options, port: Capybara.server_port, host: Capybara.server_host, reportable_errors: Capybara.server_errors, extra_middleware: []) click to toggle source
# File lib/capybara/server.rb, line 19
def initialize(app, *deprecated_options, port: Capybara.server_port, host: Capybara.server_host, reportable_errors: Capybara.server_errors, extra_middleware: [])
  warn 'Positional arguments, other than the application, to Server#new are deprecated, please use keyword arguments' unless deprecated_options.empty?
  @app = app
  @extra_middleware = extra_middleware
  @server_thread = nil # suppress warnings
  @host = deprecated_options[1] || host
  @reportable_errors = deprecated_options[2] || reportable_errors
  @port = deprecated_options[0] || port
  @port ||= Capybara::Server.ports[port_key]
  @port ||= find_available_port(host)
  @checker = Checker.new(@host, @port)
end
ports() click to toggle source
# File lib/capybara/server.rb, line 12
def ports
  @ports ||= {}
end

Public Instance Methods

boot() click to toggle source
# File lib/capybara/server.rb, line 63
def boot
  unless responsive?
    Capybara::Server.ports[port_key] = port

    @server_thread = Thread.new do
      Capybara.server.call(middleware, port, host)
    end

    timer = Capybara::Helpers.timer(expire_in: 60)
    until responsive?
      raise 'Rack application timed out during boot' if timer.expired?
      @server_thread.join(0.1)
    end
  end

  self
end
error() click to toggle source
# File lib/capybara/server.rb, line 36
def error
  middleware.error
end
reset_error!() click to toggle source
# File lib/capybara/server.rb, line 32
def reset_error!
  middleware.clear_error
end
responsive?() click to toggle source
# File lib/capybara/server.rb, line 44
def responsive?
  return false if @server_thread&.join(0)
  res = @checker.request { |http| http.get('/__identify__') }

  if res.is_a?(Net::HTTPSuccess) || res.is_a?(Net::HTTPRedirection)
    return res.body == app.object_id.to_s
  end
rescue SystemCallError, Net::ReadTimeout, OpenSSL::SSL::SSLError
  false
end
using_ssl?() click to toggle source
# File lib/capybara/server.rb, line 40
def using_ssl?
  @checker.ssl?
end
wait_for_pending_requests() click to toggle source
# File lib/capybara/server.rb, line 55
def wait_for_pending_requests
  timer = Capybara::Helpers.timer(expire_in: 60)
  while pending_requests?
    raise 'Requests did not finish in 60 seconds' if timer.expired?
    sleep 0.01
  end
end

Private Instance Methods

find_available_port(host) click to toggle source
# File lib/capybara/server.rb, line 95
def find_available_port(host)
  server = TCPServer.new(host, 0)
  server.addr[1]
ensure
  server&.close
end
middleware() click to toggle source
# File lib/capybara/server.rb, line 83
def middleware
  @middleware ||= Middleware.new(app, @reportable_errors, @extra_middleware)
end
pending_requests?() click to toggle source
# File lib/capybara/server.rb, line 91
def pending_requests?
  middleware.pending_requests?
end
port_key() click to toggle source
# File lib/capybara/server.rb, line 87
def port_key
  Capybara.reuse_server ? app.object_id : middleware.object_id
end