Class: Rack::Server::Options

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

Instance Method Summary collapse

Instance Method Details

#handler_opts(options) ⇒ Object 



106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
 
# File 'lib/rack/server.rb', line 106

def handler_opts(options)
  begin
    info = []
    server = Rack::Handler.get(options[:server]) || Rack::Handler.default
    if server && server.respond_to?(:valid_options)
      info << ""
      info << "Server-specific options for #{server.name}:"

      has_options = false
      server.valid_options.each do |name, description|
        next if name.to_s.match(/^(Host|Port)[^a-zA-Z]/) # ignore handler's host and port options, we do our own.
        info << "  -O %-21s %s" % [name, description]
        has_options = true
      end
      return "" if !has_options
    end
    info.join("\n")
  rescue NameError
    return "Warning: Could not find handler specified (#{options[:server] || 'default'}) to determine handler-specific options"
  end
end

#parse!(args) ⇒ Object 



9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'lib/rack/server.rb', line 9

def parse!(args)
  options = {}
  opt_parser = OptionParser.new("", 24, '  ') do |opts|
    opts.banner = "Usage: rackup [ruby options] [rack options] [rackup config]"

    opts.separator ""
    opts.separator "Ruby options:"

    lineno = 1
    opts.on("-e", "--eval LINE", "evaluate a LINE of code") { |line|
      eval line, TOPLEVEL_BINDING, "-e", lineno
      lineno += 1
    }

    opts.on("-b", "--builder BUILDER_LINE", "evaluate a BUILDER_LINE of code as a builder script") { |line|
      options[:builder] = line
    }

    opts.on("-d", "--debug", "set debugging flags (set $DEBUG to true)") {
      options[:debug] = true
    }
    opts.on("-w", "--warn", "turn warnings on for your script") {
      options[:warn] = true
    }
    opts.on("-q", "--quiet", "turn off logging") {
      options[:quiet] = true
    }

    opts.on("-I", "--include PATH",
            "specify $LOAD_PATH (may be used more than once)") { |path|
      (options[:include] ||= []).concat(path.split(":"))
    }

    opts.on("-r", "--require LIBRARY",
            "require the library, before executing your script") { |library|
      options[:require] = library
    }

    opts.separator ""
    opts.separator "Rack options:"
    opts.on("-s", "--server SERVER", "serve using SERVER (thin/puma/webrick/mongrel)") { |s|
      options[:server] = s
    }

    opts.on("-o", "--host HOST", "listen on HOST (default: localhost)") { |host|
      options[:Host] = host
    }

    opts.on("-p", "--port PORT", "use PORT (default: 9292)") { |port|
      options[:Port] = port
    }

    opts.on("-O", "--option NAME[=VALUE]", "pass VALUE to the server as option NAME. If no VALUE, sets it to true. Run '#{$0} -s SERVER -h' to get a list of options for SERVER") { |name|
      name, value = name.split('=', 2)
      value = true if value.nil?
      options[name.to_sym] = value
    }

    opts.on("-E", "--env ENVIRONMENT", "use ENVIRONMENT for defaults (default: development)") { |e|
      options[:environment] = e
    }

    opts.on("-D", "--daemonize", "run daemonized in the background") { |d|
      options[:daemonize] = d ? true : false
    }

    opts.on("-P", "--pid FILE", "file to store PID") { |f|
      options[:pid] = ::File.expand_path(f)
    }

    opts.separator ""
    opts.separator "Common options:"

    opts.on_tail("-h", "-?", "--help", "Show this message") do
      puts opts
      puts handler_opts(options)

      exit
    end

    opts.on_tail("--version", "Show version") do
      puts "Rack #{Rack.version} (Release: #{Rack.release})"
      exit
    end
  end

  begin
    opt_parser.parse! args
  rescue OptionParser::InvalidOption => e
    warn e.message
    abort opt_parser.to_s
  end

  options[:config] = args.last if args.last && !args.last.empty?
  options
end