Class: Rack::Server
- Inherits:
-
Object
- Object
- Rack::Server
- Defined in:
- lib/rack/server.rb,
lib/rack/server/options.rb
Defined Under Namespace
Classes: Options
Instance Attribute Summary collapse
Class Method Summary collapse
- .default_middleware_by_environment ⇒ Object
- .logging_middleware ⇒ Object
- .middleware ⇒ Object
-
.start(options = nil) ⇒ Object
Start a new rack server (like running rackup).
Instance Method Summary collapse
- #app ⇒ Object
- #default_options ⇒ Object
-
#initialize(options = nil) ⇒ Server
constructor
Options may include: * :app a rack application to run (overrides :config) * :config a rackup configuration file path to load (.ru) * :environment this selects the middleware that will be wrapped around your application.
- #middleware ⇒ Object
- #server ⇒ Object
- #start(&block) ⇒ Object
Constructor Details
#initialize(options = nil) ⇒ Server
Options may include:
-
:app
a rack application to run (overrides :config)
-
:config
a rackup configuration file path to load (.ru)
-
:environment
this selects the middleware that will be wrapped around your application. Default options available are: - development: CommonLogger, ShowExceptions, and Lint - deployment: CommonLogger - none: no extra middleware note: when the server is a cgi server, CommonLogger is not included.
-
:server
choose a specific Rack::Handler, e.g. cgi, fcgi, webrick
-
:daemonize
if true, the server will daemonize itself (fork, detach, etc)
-
:pid
path to write a pid file after daemonize
-
:Host
the host address to bind to (used by supporting Rack::Handler)
-
:Port
the port to bind to (used by supporting Rack::Handler)
-
:AccessLog
webrick access log options (or supporting Rack::Handler)
-
:debug
turn on debug output ($DEBUG = true)
-
:warn
turn on warnings ($-w = true)
-
:include
add given paths to $LOAD_PATH
-
:require
require the given libraries
60 61 62 63 |
# File 'lib/rack/server.rb', line 60 def initialize( = nil) @options = @app = [:app] if && [:app] end |
Instance Attribute Details
#options ⇒ Object
65 66 67 |
# File 'lib/rack/server.rb', line 65 def @options ||= (ARGV) end |
Class Method Details
.default_middleware_by_environment ⇒ Object
93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 |
# File 'lib/rack/server.rb', line 93 def self.default_middleware_by_environment m = Hash.new {|h,k| h[k] = []} m["deployment"] = [ [Rack::ContentLength], [Rack::Chunked], logging_middleware, [Rack::TempfileReaper] ] m["development"] = [ [Rack::ContentLength], [Rack::Chunked], logging_middleware, [Rack::ShowExceptions], [Rack::Lint], [Rack::TempfileReaper] ] m end |
.logging_middleware ⇒ Object
87 88 89 90 91 |
# File 'lib/rack/server.rb', line 87 def self.logging_middleware lambda { |server| server.server.name =~ /CGI/ || server.[:quiet] ? nil : [Rack::CommonLogger, $stderr] } end |
.middleware ⇒ Object
113 114 115 |
# File 'lib/rack/server.rb', line 113 def self.middleware default_middleware_by_environment end |
.start(options = nil) ⇒ Object
Start a new rack server (like running rackup). This will parse ARGV and provide standard ARGV rackup options, defaulting to load ‘config.ru’.
Providing an options hash will prevent ARGV parsing and will not include any default options.
This method can be used to very easily launch a CGI application, for example:
Rack::Server.start(
:app => lambda do |e|
[200, {'Content-Type' => 'text/html'}, ['hello world']]
end,
:server => 'cgi'
)
Further options available here are documented on Rack::Server#initialize
22 23 24 |
# File 'lib/rack/server.rb', line 22 def self.start( = nil) new().start end |
Instance Method Details
#app ⇒ Object
83 84 85 |
# File 'lib/rack/server.rb', line 83 def app @app ||= [:builder] ? build_app_from_string : end |
#default_options ⇒ Object
69 70 71 72 73 74 75 76 77 78 79 80 81 |
# File 'lib/rack/server.rb', line 69 def environment = ENV['RACK_ENV'] || 'development' default_host = environment == 'development' ? 'localhost' : '0.0.0.0' { :environment => environment, :pid => nil, :Port => 9292, :Host => default_host, :AccessLog => [], :config => "config.ru" } end |
#middleware ⇒ Object
117 118 119 |
# File 'lib/rack/server.rb', line 117 def middleware self.class.middleware end |
#server ⇒ Object
163 164 165 |
# File 'lib/rack/server.rb', line 163 def server @_server ||= Rack::Handler.get([:server]) || Rack::Handler.default() end |
#start(&block) ⇒ Object
121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 |
# File 'lib/rack/server.rb', line 121 def start(&block) if [:warn] $-w = true end if includes = [:include] $LOAD_PATH.unshift(*includes) end if library = [:require] require library end if [:debug] $DEBUG = true require 'pp' p [:server] pp wrapped_app pp app end check_pid! if [:pid] # Touch the wrapped app, so that the config.ru is loaded before # daemonization (i.e. before chdir, etc). wrapped_app daemonize_app if [:daemonize] write_pid if [:pid] trap(:INT) do if server.respond_to?(:shutdown) server.shutdown else exit end end server.run wrapped_app, , &block end |