Class: Roger::Server

Inherits:
Object
  • Object
show all
Defined in:
lib/roger/server.rb

Overview

The Roger webserver. Initializes a rack server.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(project, options = {}) ⇒ Server

Returns a new instance of Server.



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/roger/server.rb', line 31

def initialize(project, options = {})
  @project = project

  @stack = initialize_rack_builder

  @server_options = {}

  # Defaults
  self.port = 9000
  self.handler = nil
  self.host = "0.0.0.0"
  self.auto_port = true

  @used_port = nil
  @used_handler = nil

  set_options(options)
end

Instance Attribute Details

#auto_port ⇒ Object

Returns the value of attribute auto_port.



29
30
31
 
# File 'lib/roger/server.rb', line 29

def auto_port
  @auto_port
end

#handler ⇒ Object

Returns the value of attribute handler.



29
30
31
 
# File 'lib/roger/server.rb', line 29

def handler
  @handler
end

#host ⇒ Object

Returns the value of attribute host.



29
30
31
 
# File 'lib/roger/server.rb', line 29

def host
  @host
end

#port ⇒ Object

Returns the value of attribute port.



29
30
31
 
# File 'lib/roger/server.rb', line 29

def port
  @port
end

#project ⇒ Object (readonly) 



19
20
21
 
# File 'lib/roger/server.rb', line 19

def project
  @project
end

#server_options ⇒ Object (readonly)

Returns the value of attribute server_options.



16
17
18
 
# File 'lib/roger/server.rb', line 16

def server_options
  @server_options
end

#used_handler ⇒ Object (readonly) 



27
28
29
 
# File 'lib/roger/server.rb', line 27

def used_handler
  @used_handler
end

#used_port ⇒ Object (readonly) 



23
24
25
 
# File 'lib/roger/server.rb', line 23

def used_port
  @used_port
end

Instance Method Details

#map(*args, &block) ⇒ Object

Use the map handler to map endpoints to certain urls

See Also:

  • Rack::Builder#map


69
70
71
 
# File 'lib/roger/server.rb', line 69

def map(*args, &block)
  @stack.map(*args, &block)
end

#run! ⇒ Object Also known as: run 



73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/roger/server.rb', line 73

def run!
  project.mode = :server

  options = server_options_for_handler
  @used_port = options[:Port]
  @used_handler = handler

  handler.run application, options do |server|
    trap(:INT) do
      ## Use thins' hard #stop! if available, otherwise just #stop
      server.respond_to?(:stop!) ? server.stop! : server.stop
      puts "Roger, out!"
    end

    yield server if block_given?
  end
ensure
  project.mode = nil
  @used_port = nil
  @used_handler = nil
end

#server_options_for_handler ⇒ Object 



96
97
98
99
100
101
102
103
104
105
 
# File 'lib/roger/server.rb', line 96

def server_options_for_handler
  # Search for available port
  options = server_options.dup
  if auto_port && !port_free?(options[:Host], options[:Port])
    options[:Port] = free_port_for_host_above(options[:Host], options[:Port])
  end

  # Return the options
  options
end

#set_options(options) ⇒ Object

Sets the options, this is a separate method as we want to override certain things set in the rogerfile from the commandline



52
53
54
55
56
57
 
# File 'lib/roger/server.rb', line 52

def set_options(options)
  self.port = options[:port].to_i if options.key?(:port)
  self.handler = options[:handler] if options.key?(:handler)
  self.host = options[:host] if options.key?(:host)
  self.auto_port = options[:auto_port] if options.key?(:auto_port)
end

#use(*args, &block) ⇒ Object

Use the specified Rack middleware

See Also:

  • Rack::Builder#use


62
63
64
 
# File 'lib/roger/server.rb', line 62

def use(*args, &block)
  @stack.use(*args, &block)
end