class Capybara::Server

@api private

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 21
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 14
def ports
  @ports ||= {}
end

Public Instance Methods

base_url() click to toggle source
# File lib/capybara/server.rb, line 89
def base_url
  "http#{'s' if using_ssl?}://#{host}:#{port}"
end
boot() click to toggle source
# File lib/capybara/server.rb, line 70
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 43
def error
  middleware.error
end
reset_error!() click to toggle source
# File lib/capybara/server.rb, line 39
def reset_error!
  middleware.clear_error
end
responsive?() click to toggle source
# File lib/capybara/server.rb, line 51
def responsive?
  return false if @server_thread&.join(0)

  res = @checker.request { |http| http.get('/__identify__') }

  return res.body == app.object_id.to_s if res.is_a?(Net::HTTPSuccess) || res.is_a?(Net::HTTPRedirection)
rescue SystemCallError, Net::ReadTimeout, OpenSSL::SSL::SSLError
  false
end
using_ssl?() click to toggle source
# File lib/capybara/server.rb, line 47
def using_ssl?
  @checker.ssl?
end
wait_for_pending_requests() click to toggle source
# File lib/capybara/server.rb, line 61
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 107
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 95
def middleware
  @middleware ||= Middleware.new(app, @reportable_errors, @extra_middleware)
end
pending_requests?() click to toggle source
# File lib/capybara/server.rb, line 103
def pending_requests?
  middleware.pending_requests?
end
port_key() click to toggle source
# File lib/capybara/server.rb, line 99
def port_key
  Capybara.reuse_server ? app.object_id : middleware.object_id
end