kjvarga-rack 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (112) hide show
  1. data/COPYING +18 -0
  2. data/KNOWN-ISSUES.rdoc +18 -0
  3. data/Manifest +117 -0
  4. data/README.rdoc +357 -0
  5. data/Rakefile +164 -0
  6. data/bin/rackup +176 -0
  7. data/contrib/rack_logo.svg +111 -0
  8. data/lib/rack.rb +90 -0
  9. data/lib/rack/adapter/camping.rb +22 -0
  10. data/lib/rack/auth/abstract/handler.rb +37 -0
  11. data/lib/rack/auth/abstract/request.rb +37 -0
  12. data/lib/rack/auth/basic.rb +58 -0
  13. data/lib/rack/auth/digest/md5.rb +124 -0
  14. data/lib/rack/auth/digest/nonce.rb +51 -0
  15. data/lib/rack/auth/digest/params.rb +55 -0
  16. data/lib/rack/auth/digest/request.rb +40 -0
  17. data/lib/rack/auth/openid.rb +487 -0
  18. data/lib/rack/builder.rb +63 -0
  19. data/lib/rack/cascade.rb +41 -0
  20. data/lib/rack/chunked.rb +49 -0
  21. data/lib/rack/commonlogger.rb +52 -0
  22. data/lib/rack/conditionalget.rb +47 -0
  23. data/lib/rack/content_length.rb +29 -0
  24. data/lib/rack/content_type.rb +23 -0
  25. data/lib/rack/deflater.rb +96 -0
  26. data/lib/rack/directory.rb +153 -0
  27. data/lib/rack/file.rb +88 -0
  28. data/lib/rack/handler.rb +69 -0
  29. data/lib/rack/handler/cgi.rb +61 -0
  30. data/lib/rack/handler/evented_mongrel.rb +8 -0
  31. data/lib/rack/handler/fastcgi.rb +88 -0
  32. data/lib/rack/handler/lsws.rb +60 -0
  33. data/lib/rack/handler/mongrel.rb +87 -0
  34. data/lib/rack/handler/scgi.rb +62 -0
  35. data/lib/rack/handler/swiftiplied_mongrel.rb +8 -0
  36. data/lib/rack/handler/thin.rb +18 -0
  37. data/lib/rack/handler/webrick.rb +71 -0
  38. data/lib/rack/head.rb +19 -0
  39. data/lib/rack/lint.rb +546 -0
  40. data/lib/rack/lobster.rb +65 -0
  41. data/lib/rack/lock.rb +16 -0
  42. data/lib/rack/methodoverride.rb +27 -0
  43. data/lib/rack/mime.rb +205 -0
  44. data/lib/rack/mock.rb +187 -0
  45. data/lib/rack/recursive.rb +57 -0
  46. data/lib/rack/reloader.rb +109 -0
  47. data/lib/rack/request.rb +248 -0
  48. data/lib/rack/response.rb +183 -0
  49. data/lib/rack/rewindable_input.rb +100 -0
  50. data/lib/rack/session/abstract/id.rb +142 -0
  51. data/lib/rack/session/cookie.rb +91 -0
  52. data/lib/rack/session/memcache.rb +109 -0
  53. data/lib/rack/session/pool.rb +100 -0
  54. data/lib/rack/showexceptions.rb +349 -0
  55. data/lib/rack/showstatus.rb +106 -0
  56. data/lib/rack/static.rb +38 -0
  57. data/lib/rack/urlmap.rb +55 -0
  58. data/lib/rack/utils.rb +528 -0
  59. data/rack.gemspec +140 -0
  60. data/test/cgi/lighttpd.conf +20 -0
  61. data/test/cgi/test +9 -0
  62. data/test/cgi/test.fcgi +8 -0
  63. data/test/cgi/test.ru +7 -0
  64. data/test/multipart/binary +0 -0
  65. data/test/multipart/empty +10 -0
  66. data/test/multipart/file1.txt +1 -0
  67. data/test/multipart/ie +6 -0
  68. data/test/multipart/nested +10 -0
  69. data/test/multipart/none +9 -0
  70. data/test/multipart/text +10 -0
  71. data/test/spec_rack_auth_basic.rb +73 -0
  72. data/test/spec_rack_auth_digest.rb +226 -0
  73. data/test/spec_rack_auth_openid.rb +84 -0
  74. data/test/spec_rack_builder.rb +84 -0
  75. data/test/spec_rack_camping.rb +51 -0
  76. data/test/spec_rack_cascade.rb +48 -0
  77. data/test/spec_rack_cgi.rb +89 -0
  78. data/test/spec_rack_chunked.rb +62 -0
  79. data/test/spec_rack_commonlogger.rb +61 -0
  80. data/test/spec_rack_conditionalget.rb +41 -0
  81. data/test/spec_rack_content_length.rb +43 -0
  82. data/test/spec_rack_content_type.rb +30 -0
  83. data/test/spec_rack_deflater.rb +127 -0
  84. data/test/spec_rack_directory.rb +61 -0
  85. data/test/spec_rack_fastcgi.rb +89 -0
  86. data/test/spec_rack_file.rb +75 -0
  87. data/test/spec_rack_handler.rb +43 -0
  88. data/test/spec_rack_head.rb +30 -0
  89. data/test/spec_rack_lint.rb +521 -0
  90. data/test/spec_rack_lobster.rb +45 -0
  91. data/test/spec_rack_lock.rb +38 -0
  92. data/test/spec_rack_methodoverride.rb +60 -0
  93. data/test/spec_rack_mock.rb +243 -0
  94. data/test/spec_rack_mongrel.rb +189 -0
  95. data/test/spec_rack_recursive.rb +77 -0
  96. data/test/spec_rack_request.rb +504 -0
  97. data/test/spec_rack_response.rb +218 -0
  98. data/test/spec_rack_rewindable_input.rb +118 -0
  99. data/test/spec_rack_session_cookie.rb +82 -0
  100. data/test/spec_rack_session_memcache.rb +250 -0
  101. data/test/spec_rack_session_pool.rb +172 -0
  102. data/test/spec_rack_showexceptions.rb +21 -0
  103. data/test/spec_rack_showstatus.rb +72 -0
  104. data/test/spec_rack_static.rb +37 -0
  105. data/test/spec_rack_thin.rb +91 -0
  106. data/test/spec_rack_urlmap.rb +185 -0
  107. data/test/spec_rack_utils.rb +467 -0
  108. data/test/spec_rack_webrick.rb +130 -0
  109. data/test/testrequest.rb +57 -0
  110. data/test/unregistered_handler/rack/handler/unregistered.rb +7 -0
  111. data/test/unregistered_handler/rack/handler/unregistered_long_one.rb +7 -0
  112. metadata +175 -0
data/lib/rack/file.rb ADDED
@@ -0,0 +1,88 @@
1
+ require 'time'
2
+ require 'rack/utils'
3
+ require 'rack/mime'
4
+
5
+ module Rack
6
+ # Rack::File serves files below the +root+ given, according to the
7
+ # path info of the Rack request.
8
+ #
9
+ # Handlers can detect if bodies are a Rack::File, and use mechanisms
10
+ # like sendfile on the +path+.
11
+
12
+ class File
13
+ attr_accessor :root
14
+ attr_accessor :path
15
+
16
+ alias :to_path :path
17
+
18
+ def initialize(root)
19
+ @root = root
20
+ end
21
+
22
+ def call(env)
23
+ dup._call(env)
24
+ end
25
+
26
+ F = ::File
27
+
28
+ def _call(env)
29
+ @path_info = Utils.unescape(env["PATH_INFO"])
30
+ return forbidden if @path_info.include? ".."
31
+
32
+ @path = F.join(@root, @path_info)
33
+
34
+ begin
35
+ if F.file?(@path) && F.readable?(@path)
36
+ serving
37
+ else
38
+ raise Errno::EPERM
39
+ end
40
+ rescue SystemCallError
41
+ not_found
42
+ end
43
+ end
44
+
45
+ def forbidden
46
+ body = "Forbidden\n"
47
+ [403, {"Content-Type" => "text/plain",
48
+ "Content-Length" => body.size.to_s},
49
+ [body]]
50
+ end
51
+
52
+ # NOTE:
53
+ # We check via File::size? whether this file provides size info
54
+ # via stat (e.g. /proc files often don't), otherwise we have to
55
+ # figure it out by reading the whole file into memory. And while
56
+ # we're at it we also use this as body then.
57
+
58
+ def serving
59
+ if size = F.size?(@path)
60
+ body = self
61
+ else
62
+ body = [F.read(@path)]
63
+ size = Utils.bytesize(body.first)
64
+ end
65
+
66
+ [200, {
67
+ "Last-Modified" => F.mtime(@path).httpdate,
68
+ "Content-Type" => Mime.mime_type(F.extname(@path), 'text/plain'),
69
+ "Content-Length" => size.to_s
70
+ }, body]
71
+ end
72
+
73
+ def not_found
74
+ body = "File not found: #{@path_info}\n"
75
+ [404, {"Content-Type" => "text/plain",
76
+ "Content-Length" => body.size.to_s},
77
+ [body]]
78
+ end
79
+
80
+ def each
81
+ F.open(@path, "rb") { |file|
82
+ while part = file.read(8192)
83
+ yield part
84
+ end
85
+ }
86
+ end
87
+ end
88
+ end
@@ -0,0 +1,69 @@
1
+ module Rack
2
+ # *Handlers* connect web servers with Rack.
3
+ #
4
+ # Rack includes Handlers for Mongrel, WEBrick, FastCGI, CGI, SCGI
5
+ # and LiteSpeed.
6
+ #
7
+ # Handlers usually are activated by calling <tt>MyHandler.run(myapp)</tt>.
8
+ # A second optional hash can be passed to include server-specific
9
+ # configuration.
10
+ module Handler
11
+ def self.get(server)
12
+ return unless server
13
+ server = server.to_s
14
+
15
+ if klass = @handlers[server]
16
+ obj = Object
17
+ klass.split("::").each { |x| obj = obj.const_get(x) }
18
+ obj
19
+ else
20
+ try_require('rack/handler', server)
21
+ const_get(server)
22
+ end
23
+ end
24
+
25
+ # Transforms server-name constants to their canonical form as filenames,
26
+ # then tries to require them but silences the LoadError if not found
27
+ #
28
+ # Naming convention:
29
+ #
30
+ # Foo # => 'foo'
31
+ # FooBar # => 'foo_bar.rb'
32
+ # FooBAR # => 'foobar.rb'
33
+ # FOObar # => 'foobar.rb'
34
+ # FOOBAR # => 'foobar.rb'
35
+ # FooBarBaz # => 'foo_bar_baz.rb'
36
+ def self.try_require(prefix, const_name)
37
+ file = const_name.gsub(/^[A-Z]+/) { |pre| pre.downcase }.
38
+ gsub(/[A-Z]+[^A-Z]/, '_\&').downcase
39
+
40
+ require(::File.join(prefix, file))
41
+ rescue LoadError
42
+ end
43
+
44
+ def self.register(server, klass)
45
+ @handlers ||= {}
46
+ @handlers[server] = klass
47
+ end
48
+
49
+ autoload :CGI, "rack/handler/cgi"
50
+ autoload :FastCGI, "rack/handler/fastcgi"
51
+ autoload :Mongrel, "rack/handler/mongrel"
52
+ autoload :EventedMongrel, "rack/handler/evented_mongrel"
53
+ autoload :SwiftipliedMongrel, "rack/handler/swiftiplied_mongrel"
54
+ autoload :WEBrick, "rack/handler/webrick"
55
+ autoload :LSWS, "rack/handler/lsws"
56
+ autoload :SCGI, "rack/handler/scgi"
57
+ autoload :Thin, "rack/handler/thin"
58
+
59
+ register 'cgi', 'Rack::Handler::CGI'
60
+ register 'fastcgi', 'Rack::Handler::FastCGI'
61
+ register 'mongrel', 'Rack::Handler::Mongrel'
62
+ register 'emongrel', 'Rack::Handler::EventedMongrel'
63
+ register 'smongrel', 'Rack::Handler::SwiftipliedMongrel'
64
+ register 'webrick', 'Rack::Handler::WEBrick'
65
+ register 'lsws', 'Rack::Handler::LSWS'
66
+ register 'scgi', 'Rack::Handler::SCGI'
67
+ register 'thin', 'Rack::Handler::Thin'
68
+ end
69
+ end
@@ -0,0 +1,61 @@
1
+ require 'rack/content_length'
2
+
3
+ module Rack
4
+ module Handler
5
+ class CGI
6
+ def self.run(app, options=nil)
7
+ serve app
8
+ end
9
+
10
+ def self.serve(app)
11
+ app = ContentLength.new(app)
12
+
13
+ env = ENV.to_hash
14
+ env.delete "HTTP_CONTENT_LENGTH"
15
+
16
+ env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
17
+
18
+ env.update({"rack.version" => [1,0],
19
+ "rack.input" => $stdin,
20
+ "rack.errors" => $stderr,
21
+
22
+ "rack.multithread" => false,
23
+ "rack.multiprocess" => true,
24
+ "rack.run_once" => true,
25
+
26
+ "rack.url_scheme" => ["yes", "on", "1"].include?(ENV["HTTPS"]) ? "https" : "http"
27
+ })
28
+
29
+ env["QUERY_STRING"] ||= ""
30
+ env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
31
+ env["REQUEST_PATH"] ||= "/"
32
+
33
+ status, headers, body = app.call(env)
34
+ begin
35
+ send_headers status, headers
36
+ send_body body
37
+ ensure
38
+ body.close if body.respond_to? :close
39
+ end
40
+ end
41
+
42
+ def self.send_headers(status, headers)
43
+ STDOUT.print "Status: #{status}\r\n"
44
+ headers.each { |k, vs|
45
+ vs.split("\n").each { |v|
46
+ STDOUT.print "#{k}: #{v}\r\n"
47
+ }
48
+ }
49
+ STDOUT.print "\r\n"
50
+ STDOUT.flush
51
+ end
52
+
53
+ def self.send_body(body)
54
+ body.each { |part|
55
+ STDOUT.print part
56
+ STDOUT.flush
57
+ }
58
+ end
59
+ end
60
+ end
61
+ end
@@ -0,0 +1,8 @@
1
+ require 'swiftcore/evented_mongrel'
2
+
3
+ module Rack
4
+ module Handler
5
+ class EventedMongrel < Handler::Mongrel
6
+ end
7
+ end
8
+ end
@@ -0,0 +1,88 @@
1
+ require 'fcgi'
2
+ require 'socket'
3
+ require 'rack/content_length'
4
+ require 'rack/rewindable_input'
5
+
6
+ class FCGI::Stream
7
+ def read(n, buffer=nil)
8
+ buf = _rack_read_without_buffer n
9
+ buffer.replace(buf.to_s) if buffer
10
+ buf
11
+ end
12
+
13
+ alias _rack_read_without_buffer read
14
+ end
15
+
16
+ module Rack
17
+ module Handler
18
+ class FastCGI
19
+ def self.run(app, options={})
20
+ file = options[:File] and STDIN.reopen(UNIXServer.new(file))
21
+ port = options[:Port] and STDIN.reopen(TCPServer.new(port))
22
+ FCGI.each { |request|
23
+ serve request, app
24
+ }
25
+ end
26
+
27
+ def self.serve(request, app)
28
+ app = Rack::ContentLength.new(app)
29
+
30
+ env = request.env
31
+ env.delete "HTTP_CONTENT_LENGTH"
32
+
33
+ env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
34
+
35
+ rack_input = RewindableInput.new(request.in)
36
+
37
+ env.update({"rack.version" => [1,0],
38
+ "rack.input" => rack_input,
39
+ "rack.errors" => request.err,
40
+
41
+ "rack.multithread" => false,
42
+ "rack.multiprocess" => true,
43
+ "rack.run_once" => false,
44
+
45
+ "rack.url_scheme" => ["yes", "on", "1"].include?(env["HTTPS"]) ? "https" : "http"
46
+ })
47
+
48
+ env["QUERY_STRING"] ||= ""
49
+ env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
50
+ env["REQUEST_PATH"] ||= "/"
51
+ env.delete "PATH_INFO" if env["PATH_INFO"] == ""
52
+ env.delete "CONTENT_TYPE" if env["CONTENT_TYPE"] == ""
53
+ env.delete "CONTENT_LENGTH" if env["CONTENT_LENGTH"] == ""
54
+
55
+ begin
56
+ status, headers, body = app.call(env)
57
+ begin
58
+ send_headers request.out, status, headers
59
+ send_body request.out, body
60
+ ensure
61
+ body.close if body.respond_to? :close
62
+ end
63
+ ensure
64
+ rack_input.close
65
+ request.finish
66
+ end
67
+ end
68
+
69
+ def self.send_headers(out, status, headers)
70
+ out.print "Status: #{status}\r\n"
71
+ headers.each { |k, vs|
72
+ vs.split("\n").each { |v|
73
+ out.print "#{k}: #{v}\r\n"
74
+ }
75
+ }
76
+ out.print "\r\n"
77
+ out.flush
78
+ end
79
+
80
+ def self.send_body(out, body)
81
+ body.each { |part|
82
+ out.print part
83
+ out.flush
84
+ }
85
+ end
86
+ end
87
+ end
88
+ end
@@ -0,0 +1,60 @@
1
+ require 'lsapi'
2
+ require 'rack/content_length'
3
+
4
+ module Rack
5
+ module Handler
6
+ class LSWS
7
+ def self.run(app, options=nil)
8
+ while LSAPI.accept != nil
9
+ serve app
10
+ end
11
+ end
12
+ def self.serve(app)
13
+ app = Rack::ContentLength.new(app)
14
+
15
+ env = ENV.to_hash
16
+ env.delete "HTTP_CONTENT_LENGTH"
17
+ env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
18
+
19
+ rack_input = RewindableInput.new($stdin.read.to_s)
20
+
21
+ env.update(
22
+ "rack.version" => [1,0],
23
+ "rack.input" => rack_input,
24
+ "rack.errors" => $stderr,
25
+ "rack.multithread" => false,
26
+ "rack.multiprocess" => true,
27
+ "rack.run_once" => false,
28
+ "rack.url_scheme" => ["yes", "on", "1"].include?(ENV["HTTPS"]) ? "https" : "http"
29
+ )
30
+
31
+ env["QUERY_STRING"] ||= ""
32
+ env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
33
+ env["REQUEST_PATH"] ||= "/"
34
+ status, headers, body = app.call(env)
35
+ begin
36
+ send_headers status, headers
37
+ send_body body
38
+ ensure
39
+ body.close if body.respond_to? :close
40
+ end
41
+ end
42
+ def self.send_headers(status, headers)
43
+ print "Status: #{status}\r\n"
44
+ headers.each { |k, vs|
45
+ vs.split("\n").each { |v|
46
+ print "#{k}: #{v}\r\n"
47
+ }
48
+ }
49
+ print "\r\n"
50
+ STDOUT.flush
51
+ end
52
+ def self.send_body(body)
53
+ body.each { |part|
54
+ print part
55
+ STDOUT.flush
56
+ }
57
+ end
58
+ end
59
+ end
60
+ end
@@ -0,0 +1,87 @@
1
+ require 'mongrel'
2
+ require 'stringio'
3
+ require 'rack/content_length'
4
+ require 'rack/chunked'
5
+
6
+ module Rack
7
+ module Handler
8
+ class Mongrel < ::Mongrel::HttpHandler
9
+ def self.run(app, options={})
10
+ server = ::Mongrel::HttpServer.new(options[:Host] || '0.0.0.0',
11
+ options[:Port] || 8080)
12
+ # Acts like Rack::URLMap, utilizing Mongrel's own path finding methods.
13
+ # Use is similar to #run, replacing the app argument with a hash of
14
+ # { path=>app, ... } or an instance of Rack::URLMap.
15
+ if options[:map]
16
+ if app.is_a? Hash
17
+ app.each do |path, appl|
18
+ path = '/'+path unless path[0] == ?/
19
+ server.register(path, Rack::Handler::Mongrel.new(appl))
20
+ end
21
+ elsif app.is_a? URLMap
22
+ app.instance_variable_get(:@mapping).each do |(host, path, appl)|
23
+ next if !host.nil? && !options[:Host].nil? && options[:Host] != host
24
+ path = '/'+path unless path[0] == ?/
25
+ server.register(path, Rack::Handler::Mongrel.new(appl))
26
+ end
27
+ else
28
+ raise ArgumentError, "first argument should be a Hash or URLMap"
29
+ end
30
+ else
31
+ server.register('/', Rack::Handler::Mongrel.new(app))
32
+ end
33
+ yield server if block_given?
34
+ server.run.join
35
+ end
36
+
37
+ def initialize(app)
38
+ @app = Rack::Chunked.new(Rack::ContentLength.new(app))
39
+ end
40
+
41
+ def process(request, response)
42
+ env = {}.replace(request.params)
43
+ env.delete "HTTP_CONTENT_TYPE"
44
+ env.delete "HTTP_CONTENT_LENGTH"
45
+
46
+ env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
47
+
48
+ rack_input = request.body || StringIO.new('')
49
+ rack_input.set_encoding(Encoding::BINARY) if rack_input.respond_to?(:set_encoding)
50
+
51
+ env.update({"rack.version" => [1,0],
52
+ "rack.input" => request.body || StringIO.new(""),
53
+ "rack.errors" => $stderr,
54
+
55
+ "rack.multithread" => true,
56
+ "rack.multiprocess" => false, # ???
57
+ "rack.run_once" => false,
58
+
59
+ "rack.url_scheme" => "http",
60
+ })
61
+ env["QUERY_STRING"] ||= ""
62
+ env.delete "PATH_INFO" if env["PATH_INFO"] == ""
63
+
64
+ status, headers, body = @app.call(env)
65
+
66
+ begin
67
+ response.status = status.to_i
68
+ response.send_status(nil)
69
+
70
+ headers.each { |k, vs|
71
+ vs.split("\n").each { |v|
72
+ response.header[k] = v
73
+ }
74
+ }
75
+ response.send_header
76
+
77
+ body.each { |part|
78
+ response.write part
79
+ response.socket.flush
80
+ }
81
+ ensure
82
+ body.close if body.respond_to? :close
83
+ end
84
+ end
85
+ end
86
+ end
87
+ end