rack 2.2.6.4 → 3.0.4.2

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of rack might be problematic. Click here for more details.

Files changed (87) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +193 -84
  3. data/CONTRIBUTING.md +53 -47
  4. data/MIT-LICENSE +1 -1
  5. data/README.md +309 -0
  6. data/SPEC.rdoc +183 -131
  7. data/lib/rack/auth/abstract/handler.rb +3 -1
  8. data/lib/rack/auth/abstract/request.rb +3 -1
  9. data/lib/rack/auth/basic.rb +0 -2
  10. data/lib/rack/auth/digest/md5.rb +1 -131
  11. data/lib/rack/auth/digest/nonce.rb +1 -54
  12. data/lib/rack/auth/digest/params.rb +1 -54
  13. data/lib/rack/auth/digest/request.rb +1 -43
  14. data/lib/rack/auth/digest.rb +256 -0
  15. data/lib/rack/body_proxy.rb +3 -1
  16. data/lib/rack/builder.rb +83 -63
  17. data/lib/rack/cascade.rb +2 -0
  18. data/lib/rack/chunked.rb +16 -13
  19. data/lib/rack/common_logger.rb +23 -18
  20. data/lib/rack/conditional_get.rb +18 -15
  21. data/lib/rack/constants.rb +64 -0
  22. data/lib/rack/content_length.rb +12 -16
  23. data/lib/rack/content_type.rb +8 -5
  24. data/lib/rack/deflater.rb +40 -26
  25. data/lib/rack/directory.rb +9 -3
  26. data/lib/rack/etag.rb +14 -23
  27. data/lib/rack/events.rb +4 -0
  28. data/lib/rack/file.rb +2 -0
  29. data/lib/rack/files.rb +15 -17
  30. data/lib/rack/head.rb +9 -8
  31. data/lib/rack/headers.rb +154 -0
  32. data/lib/rack/lint.rb +783 -682
  33. data/lib/rack/lock.rb +2 -5
  34. data/lib/rack/logger.rb +2 -0
  35. data/lib/rack/media_type.rb +1 -1
  36. data/lib/rack/method_override.rb +5 -1
  37. data/lib/rack/mime.rb +8 -0
  38. data/lib/rack/mock.rb +1 -271
  39. data/lib/rack/mock_request.rb +166 -0
  40. data/lib/rack/mock_response.rb +126 -0
  41. data/lib/rack/multipart/generator.rb +7 -5
  42. data/lib/rack/multipart/parser.rb +119 -61
  43. data/lib/rack/multipart/uploaded_file.rb +4 -0
  44. data/lib/rack/multipart.rb +20 -40
  45. data/lib/rack/null_logger.rb +9 -0
  46. data/lib/rack/query_parser.rb +76 -44
  47. data/lib/rack/recursive.rb +2 -0
  48. data/lib/rack/reloader.rb +0 -2
  49. data/lib/rack/request.rb +215 -108
  50. data/lib/rack/response.rb +136 -61
  51. data/lib/rack/rewindable_input.rb +24 -5
  52. data/lib/rack/runtime.rb +7 -6
  53. data/lib/rack/sendfile.rb +30 -25
  54. data/lib/rack/show_exceptions.rb +15 -2
  55. data/lib/rack/show_status.rb +17 -7
  56. data/lib/rack/static.rb +8 -8
  57. data/lib/rack/tempfile_reaper.rb +15 -4
  58. data/lib/rack/urlmap.rb +3 -1
  59. data/lib/rack/utils.rb +202 -176
  60. data/lib/rack/version.rb +9 -4
  61. data/lib/rack.rb +5 -76
  62. metadata +18 -38
  63. data/README.rdoc +0 -320
  64. data/Rakefile +0 -130
  65. data/bin/rackup +0 -5
  66. data/contrib/rack.png +0 -0
  67. data/contrib/rack.svg +0 -150
  68. data/contrib/rack_logo.svg +0 -164
  69. data/contrib/rdoc.css +0 -412
  70. data/example/lobster.ru +0 -6
  71. data/example/protectedlobster.rb +0 -16
  72. data/example/protectedlobster.ru +0 -10
  73. data/lib/rack/core_ext/regexp.rb +0 -14
  74. data/lib/rack/handler/cgi.rb +0 -59
  75. data/lib/rack/handler/fastcgi.rb +0 -100
  76. data/lib/rack/handler/lsws.rb +0 -61
  77. data/lib/rack/handler/scgi.rb +0 -71
  78. data/lib/rack/handler/thin.rb +0 -36
  79. data/lib/rack/handler/webrick.rb +0 -129
  80. data/lib/rack/handler.rb +0 -104
  81. data/lib/rack/lobster.rb +0 -70
  82. data/lib/rack/server.rb +0 -466
  83. data/lib/rack/session/abstract/id.rb +0 -523
  84. data/lib/rack/session/cookie.rb +0 -203
  85. data/lib/rack/session/memcache.rb +0 -10
  86. data/lib/rack/session/pool.rb +0 -85
  87. data/rack.gemspec +0 -46
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '078561a77beb0af3f12ba96b1a506598140482eec56592a6800e7bf14d5b57c9'
4
- data.tar.gz: d14d73096818a28e4dc1e9e98309164029ba0c24768468c6299d11d11fe6a839
3
+ metadata.gz: 36b4b5641dd1307c3ce6c486779ed3ff238dd2e102e65dc2eb07a83467cd0acd
4
+ data.tar.gz: 59205f18ca54c8c03018ccc532a05af39b52cb63bf50f8be6138301620e3b4b5
5
5
  SHA512:
6
- metadata.gz: 577296b45efdde2334fa386c57b6a9dcd8409cf8949875bcd78970041a078af1fa48e7cf030c6e4bf1377a7eecc771332aeec4c135df25ca74116ae56ab015de
7
- data.tar.gz: f589a73eb2b74eea08499e4e945df139612619c1d6543edc0d8ebe78bb2b8181625464d607150a3ef89b86659f6a1bb1838a7940bd64bd418d2ac21873a067db
6
+ metadata.gz: ad6b22a618316744e50fc27a90348d7208b764ef7734555dd32d51b88b13e75023e367926bb18a898d742f0e2c97c188949be1c47678a442f804d04bff4a2326
7
+ data.tar.gz: b05200d6b7d5c6a0d2035577ffb5c5098d2d78dee3a5f7de5754c65950d53c7dbe7438e1f1a8f6d13d2122e1e6f721541f12ec77886cc32f5c99dd5c0606f5f8
data/CHANGELOG.md CHANGED
@@ -2,33 +2,132 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file. For info on how to format all future additions to this file please reference [Keep A Changelog](https://keepachangelog.com/en/1.0.0/).
4
4
 
5
- ## [2.2.6.4] - 2023-03-13
6
-
7
- - [CVE-2023-27539] Avoid ReDoS in header parsing
8
-
9
- ## [2.2.6.3] - 2023-03-02
5
+ ## [3.0.4.1] - 2023-03-02
10
6
 
11
7
  - [CVE-2023-27530] Introduce multipart_total_part_limit to limit total parts
12
8
 
13
- ## [2.2.6.2] - 2022-01-17
14
-
15
- - [CVE-2022-44570] Fix ReDoS in Rack::Utils.get_byte_ranges
16
-
17
- ## [2.2.6.1] - 2022-01-17
9
+ ## [3.0.4.1] - 2023-01-17
18
10
 
19
11
  - [CVE-2022-44571] Fix ReDoS vulnerability in multipart parser
12
+ - [CVE-2022-44570] Fix ReDoS in Rack::Utils.get_byte_ranges
20
13
  - [CVE-2022-44572] Forbid control characters in attributes (also ReDoS)
21
14
 
22
- ## [2.2.6] - 2022-01-17
15
+ ## [3.0.4] - 2022-01-17
23
16
 
24
- - Extend `Rack::MethodOverride` to handle `QueryParser::ParamsTooDeepError` error. ([#2011](https://github.com/rack/rack/pull/2011), [@byroot](https://github.com/byroot))
17
+ - `Rack::Request#POST` should consistently raise errors. Cache errors that occur when invoking `Rack::Request#POST` so they can be raised again later. ([#2010](https://github.com/rack/rack/pull/2010), [@ioquatix])
18
+ - Fix `Rack::Lint` error message for `HTTP_CONTENT_TYPE` and `HTTP_CONTENT_LENGTH`. ([#2007](https://github.com/rack/rack/pull/2007), [@byroot](https://github.com/byroot))
19
+ - Extend `Rack::MethodOverride` to handle `QueryParser::ParamsTooDeepError` error. ([#2006](https://github.com/rack/rack/pull/2006), [@byroot](https://github.com/byroot))
25
20
 
26
- ## [2.2.5] - 2022-12-27
21
+ ## [3.0.3] - 2022-12-27
27
22
 
28
23
  ### Fixed
29
24
 
30
25
  - `Rack::URLMap` uses non-deprecated form of `Regexp.new`. ([#1998](https://github.com/rack/rack/pull/1998), [@weizheheng](https://github.com/weizheheng))
31
26
 
27
+ ## [3.0.2] - 2022-12-05
28
+
29
+ ### Fixed
30
+
31
+ - `Utils.build_nested_query` URL-encodes nested field names including the square brackets.
32
+ - Allow `Rack::Response` to pass through streaming bodies. ([#1993](https://github.com/rack/rack/pull/1993), [@ioquatix])
33
+
34
+ ## [3.0.1] - 2022-11-18
35
+
36
+ ### Fixed
37
+
38
+ - `MethodOverride` does not look for an override if a request does not include form/parseable data.
39
+ - `Rack::Lint::Wrapper` correctly handles `respond_to?` with `to_ary`, `each`, `call` and `to_path`, forwarding to the body. ([#1981](https://github.com/rack/rack/pull/1981), [@ioquatix])
40
+
41
+ ## [3.0.0] - 2022-09-06
42
+
43
+ - No changes
44
+
45
+ ## [3.0.0.rc1] - 2022-09-04
46
+
47
+ ### SPEC Changes
48
+
49
+ - Stream argument must implement `<<` https://github.com/rack/rack/pull/1959
50
+ - `close` may be called on `rack.input` https://github.com/rack/rack/pull/1956
51
+ - `rack.response_finished` may be used for executing code after the response has been finished https://github.com/rack/rack/pull/1952
52
+
53
+ ## [3.0.0.beta1] - 2022-08-08
54
+
55
+ ### Security
56
+
57
+ - Do not use semicolon as GET parameter separator. ([#1733](https://github.com/rack/rack/pull/1733), [@jeremyevans])
58
+
59
+ ### SPEC Changes
60
+
61
+ - Response array must now be non-frozen.
62
+ - Response `status` must now be an integer greater than or equal to 100.
63
+ - Response `headers` must now be an unfrozen hash.
64
+ - Response header keys can no longer include uppercase characters.
65
+ - Response header values can be an `Array` to handle multiple values (and no longer supports `\n` encoded headers).
66
+ - Response body can now respond to `#call` (streaming body) instead of `#each` (enumerable body), for the equivalent of response hijacking in previous versions.
67
+ - Middleware must no longer call `#each` on the body, but they can call `#to_ary` on the body if it responds to `#to_ary`.
68
+ - `rack.input` is no longer required to be rewindable.
69
+ - `rack.multithread`/`rack.multiprocess`/`rack.run_once`/`rack.version` are no longer required environment keys.
70
+ - `SERVER_PROTOCOL` is now a required environment key, matching the HTTP protocol used in the request.
71
+ - `rack.hijack?` (partial hijack) and `rack.hijack` (full hijack) are now independently optional.
72
+ - `rack.hijack_io` has been removed completely.
73
+ - `rack.response_finished` is an optional environment key which contains an array of callable objects that must accept `#call(env, status, headers, error)` and are invoked after the response is finished (either successfully or unsuccessfully).
74
+ - It is okay to call `#close` on `rack.input` to indicate that you no longer need or care about the input.
75
+ - The stream argument supplied to the streaming body and hijack must support `#<<` for writing output.
76
+
77
+ ### Removed
78
+
79
+ - Remove `rack.multithread`/`rack.multiprocess`/`rack.run_once`. These variables generally come too late to be useful. ([#1720](https://github.com/rack/rack/pull/1720), [@ioquatix], [@jeremyevans]))
80
+ - Remove deprecated Rack::Request::SCHEME_WHITELIST. ([@jeremyevans])
81
+ - Remove internal cookie deletion using pattern matching, there are very few practical cases where it would be useful and browsers handle it correctly without us doing anything special. ([#1844](https://github.com/rack/rack/pull/1844), [@ioquatix])
82
+ - Remove `rack.version` as it comes too late to be useful. ([#1938](https://github.com/rack/rack/pull/1938), [@ioquatix])
83
+ - Extract `rackup` command, `Rack::Server`, `Rack::Handler` and related code into a separate gem. ([#1937](https://github.com/rack/rack/pull/1937), [@ioquatix])
84
+
85
+ ### Added
86
+
87
+ - `Rack::Headers` added to support lower-case header keys. ([@jeremyevans])
88
+ - `Rack::Utils#set_cookie_header` now supports `escape_key: false` to avoid key escaping. ([@jeremyevans])
89
+ - `Rack::RewindableInput` supports size. ([@ahorek](https://github.com/ahorek))
90
+ - `Rack::RewindableInput::Middleware` added for making `rack.input` rewindable. ([@jeremyevans])
91
+ - The RFC 7239 Forwarded header is now supported and considered by default when looking for information on forwarding, falling back to the X-Forwarded-* headers. `Rack::Request.forwarded_priority` accessor has been added for configuring the priority of which header to check. ([#1423](https://github.com/rack/rack/issues/1423), [@jeremyevans])
92
+ - Allow response headers to contain array of values. ([#1598](https://github.com/rack/rack/issues/1598), [@ioquatix])
93
+ - Support callable body for explicit streaming support and clarify streaming response body behaviour. ([#1745](https://github.com/rack/rack/pull/1745), [@ioquatix], [#1748](https://github.com/rack/rack/pull/1748), [@wjordan])
94
+ - Allow `Rack::Builder#run` to take a block instead of an argument. ([#1942](https://github.com/rack/rack/pull/1942), [@ioquatix])
95
+ - Add `rack.response_finished` to `Rack::Lint`. ([#1802](https://github.com/rack/rack/pull/1802), [@BlakeWilliams], [#1952](https://github.com/rack/rack/pull/1952), [@ioquatix])
96
+ - The stream argument must implement `#<<`. ([#1959](https://github.com/rack/rack/pull/1959), [@ioquatix])
97
+
98
+ ### Changed
99
+
100
+ - BREAKING CHANGE: Require `status` to be an Integer. ([#1662](https://github.com/rack/rack/pull/1662), [@olleolleolle](https://github.com/olleolleolle))
101
+ - BREAKING CHANGE: Query parsing now treats parameters without `=` as having the empty string value instead of nil value, to conform to the URL spec. ([#1696](https://github.com/rack/rack/issues/1696), [@jeremyevans])
102
+ - Relax validations around `Rack::Request#host` and `Rack::Request#hostname`. ([#1606](https://github.com/rack/rack/issues/1606), [@pvande](https://github.com/pvande))
103
+ - Removed antiquated handlers: FCGI, LSWS, SCGI, Thin. ([#1658](https://github.com/rack/rack/pull/1658), [@ioquatix])
104
+ - Removed options from `Rack::Builder.parse_file` and `Rack::Builder.load_file`. ([#1663](https://github.com/rack/rack/pull/1663), [@ioquatix])
105
+ - `Rack::HTTP_VERSION` has been removed and the `HTTP_VERSION` env setting is no longer set in the CGI and Webrick handlers. ([#970](https://github.com/rack/rack/issues/970), [@jeremyevans])
106
+ - `Rack::Request#[]` and `#[]=` now warn even in non-verbose mode. ([#1277](https://github.com/rack/rack/issues/1277), [@jeremyevans])
107
+ - Decrease default allowed parameter recursion level from 100 to 32. ([#1640](https://github.com/rack/rack/issues/1640), [@jeremyevans])
108
+ - Attempting to parse a multipart response with an empty body now raises Rack::Multipart::EmptyContentError. ([#1603](https://github.com/rack/rack/issues/1603), [@jeremyevans])
109
+ - `Rack::Utils.secure_compare` uses OpenSSL's faster implementation if available. ([#1711](https://github.com/rack/rack/pull/1711), [@bdewater](https://github.com/bdewater))
110
+ - `Rack::Request#POST` now caches an empty hash if input content type is not parseable. ([#749](https://github.com/rack/rack/pull/749), [@jeremyevans])
111
+ - BREAKING CHANGE: Updated `trusted_proxy?` to match full 127.0.0.0/8 network. ([#1781](https://github.com/rack/rack/pull/1781), [@snbloch](https://github.com/snbloch))
112
+ - Explicitly deprecate `Rack::File` which was an alias for `Rack::Files`. ([#1811](https://github.com/rack/rack/pull/1720), [@ioquatix]).
113
+ - Moved `Rack::Session` into [separate gem](https://github.com/rack/rack-session). ([#1805](https://github.com/rack/rack/pull/1805), [@ioquatix])
114
+ - `rackup -D` option to daemonizes no longer changes the working directory to the root. ([#1813](https://github.com/rack/rack/pull/1813), [@jeremyevans])
115
+ - The `x-forwarded-proto` header is now considered before the `x-forwarded-scheme` header for determining the forwarded protocol. `Rack::Request.x_forwarded_proto_priority` accessor has been added for configuring the priority of which header to check. ([#1809](https://github.com/rack/rack/issues/1809), [@jeremyevans])
116
+ - `Rack::Request.forwarded_authority` (and methods that call it, such as `host`) now returns the last authority in the forwarded header, instead of the first, as earlier forwarded authorities can be forged by clients. This restores the Rack 2.1 behavior. ([#1829](https://github.com/rack/rack/issues/1809), [@jeremyevans])
117
+ - Use lower case cookie attributes when creating cookies, and fold cookie attributes to lower case when reading cookies (specifically impacting `secure` and `httponly` attributes). ([#1849](https://github.com/rack/rack/pull/1849), [@ioquatix])
118
+ - The response array must now be mutable (non-frozen) so middleware can modify it without allocating a new Array,therefore reducing object allocations. ([#1887](https://github.com/rack/rack/pull/1887), [#1927](https://github.com/rack/rack/pull/1927), [@amatsuda], [@ioquatix])
119
+ - `rack.hijack?` (partial hijack) and `rack.hijack` (full hijack) are now independently optional. `rack.hijack_io` is no longer required/specified. ([#1939](https://github.com/rack/rack/pull/1939), [@ioquatix])
120
+ - Allow calling close on `rack.input`. ([#1956](https://github.com/rack/rack/pull/1956), [@ioquatix])
121
+
122
+ ### Fixed
123
+
124
+ - Make Rack::MockResponse handle non-hash headers. ([#1629](https://github.com/rack/rack/issues/1629), [@jeremyevans])
125
+ - TempfileReaper now deletes temp files if application raises an exception. ([#1679](https://github.com/rack/rack/issues/1679), [@jeremyevans])
126
+ - Handle cookies with values that end in '=' ([#1645](https://github.com/rack/rack/pull/1645), [@lukaso](https://github.com/lukaso))
127
+ - Make `Rack::NullLogger` respond to `#fatal!` [@jeremyevans])
128
+ - Fix multipart filename generation for filenames that contain spaces. Encode spaces as "%20" instead of "+" which will be decoded properly by the multipart parser. ([#1736](https://github.com/rack/rack/pull/1645), [@muirdm](https://github.com/muirdm))
129
+ - `Rack::Request#scheme` returns `ws` or `wss` when one of the `X-Forwarded-Scheme` / `X-Forwarded-Proto` headers is set to `ws` or `wss`, respectively. ([#1730](https://github.com/rack/rack/issues/1730), [@erwanst](https://github.com/erwanst))
130
+
32
131
  ## [2.2.4] - 2022-06-30
33
132
 
34
133
  - Better support for lower case headers in `Rack::ETag` middleware. ([#1919](https://github.com/rack/rack/pull/1919), [@ioquatix](https://github.com/ioquatix))
@@ -36,23 +135,21 @@ All notable changes to this project will be documented in this file. For info on
36
135
 
37
136
  ## [2.2.3.1] - 2022-05-27
38
137
 
39
- ### Security
40
-
41
138
  - [CVE-2022-30123] Fix shell escaping issue in Common Logger
42
139
  - [CVE-2022-30122] Restrict parsing of broken MIME attachments
43
140
 
44
- ## [2.2.3] - 2020-02-11
141
+ ## [2.2.3] - 2020-06-15
45
142
 
46
143
  ### Security
47
144
 
48
- - [CVE-2020-8184] Only decode cookie values
145
+ - [[CVE-2020-8184](https://nvd.nist.gov/vuln/detail/CVE-2020-8184)] Do not allow percent-encoded cookie name to override existing cookie names. BREAKING CHANGE: Accessing cookie names that require URL encoding with decoded name no longer works. ([@fletchto99](https://github.com/fletchto99))
49
146
 
50
147
  ## [2.2.2] - 2020-02-11
51
148
 
52
149
  ### Fixed
53
150
 
54
- - Fix incorrect `Rack::Request#host` value. ([#1591](https://github.com/rack/rack/pull/1591), [@ioquatix](https://github.com/ioquatix))
55
- - Revert `Rack::Handler::Thin` implementation. ([#1583](https://github.com/rack/rack/pull/1583), [@jeremyevans](https://github.com/jeremyevans))
151
+ - Fix incorrect `Rack::Request#host` value. ([#1591](https://github.com/rack/rack/pull/1591), [@ioquatix])
152
+ - Revert `Rack::Handler::Thin` implementation. ([#1583](https://github.com/rack/rack/pull/1583), [@jeremyevans])
56
153
  - Double assignment is still needed to prevent an "unused variable" warning. ([#1589](https://github.com/rack/rack/pull/1589), [@kamipo](https://github.com/kamipo))
57
154
  - Fix to handle same_site option for session pool. ([#1587](https://github.com/rack/rack/pull/1587), [@kamipo](https://github.com/kamipo))
58
155
 
@@ -60,105 +157,111 @@ All notable changes to this project will be documented in this file. For info on
60
157
 
61
158
  ### Fixed
62
159
 
63
- - Rework `Rack::Request#ip` to handle empty `forwarded_for`. ([#1577](https://github.com/rack/rack/pull/1577), [@ioquatix](https://github.com/ioquatix))
160
+ - Rework `Rack::Request#ip` to handle empty `forwarded_for`. ([#1577](https://github.com/rack/rack/pull/1577), [@ioquatix])
64
161
 
65
162
  ## [2.2.0] - 2020-02-08
66
163
 
67
164
  ### SPEC Changes
68
165
 
69
- - `rack.session` request environment entry must respond to `to_hash` and return unfrozen Hash. ([@jeremyevans](https://github.com/jeremyevans))
70
- - Request environment cannot be frozen. ([@jeremyevans](https://github.com/jeremyevans))
71
- - CGI values in the request environment with non-ASCII characters must use ASCII-8BIT encoding. ([@jeremyevans](https://github.com/jeremyevans))
72
- - Improve SPEC/lint relating to SERVER_NAME, SERVER_PORT and HTTP_HOST. ([#1561](https://github.com/rack/rack/pull/1561), [@ioquatix](https://github.com/ioquatix))
166
+ - `rack.session` request environment entry must respond to `to_hash` and return unfrozen Hash. ([@jeremyevans])
167
+ - Request environment cannot be frozen. ([@jeremyevans])
168
+ - CGI values in the request environment with non-ASCII characters must use ASCII-8BIT encoding. ([@jeremyevans])
169
+ - Improve SPEC/lint relating to SERVER_NAME, SERVER_PORT and HTTP_HOST. ([#1561](https://github.com/rack/rack/pull/1561), [@ioquatix])
73
170
 
74
171
  ### Added
75
172
 
76
- - `rackup` supports multiple `-r` options and will require all arguments. ([@jeremyevans](https://github.com/jeremyevans))
173
+ - `rackup` supports multiple `-r` options and will require all arguments. ([@jeremyevans])
77
174
  - `Server` supports an array of paths to require for the `:require` option. ([@khotta](https://github.com/khotta))
78
175
  - `Files` supports multipart range requests. ([@fatkodima](https://github.com/fatkodima))
79
- - `Multipart::UploadedFile` supports an IO-like object instead of using the filesystem, using `:filename` and `:io` options. ([@jeremyevans](https://github.com/jeremyevans))
80
- - `Multipart::UploadedFile` supports keyword arguments `:path`, `:content_type`, and `:binary` in addition to positional arguments. ([@jeremyevans](https://github.com/jeremyevans))
81
- - `Static` supports a `:cascade` option for calling the app if there is no matching file. ([@jeremyevans](https://github.com/jeremyevans))
82
- - `Session::Abstract::SessionHash#dig`. ([@jeremyevans](https://github.com/jeremyevans))
83
- - `Response.[]` and `MockResponse.[]` for creating instances using status, headers, and body. ([@ioquatix](https://github.com/ioquatix))
84
- - Convenient cache and content type methods for `Rack::Response`. ([#1555](https://github.com/rack/rack/pull/1555), [@ioquatix](https://github.com/ioquatix))
176
+ - `Multipart::UploadedFile` supports an IO-like object instead of using the filesystem, using `:filename` and `:io` options. ([@jeremyevans])
177
+ - `Multipart::UploadedFile` supports keyword arguments `:path`, `:content_type`, and `:binary` in addition to positional arguments. ([@jeremyevans])
178
+ - `Static` supports a `:cascade` option for calling the app if there is no matching file. ([@jeremyevans])
179
+ - `Session::Abstract::SessionHash#dig`. ([@jeremyevans])
180
+ - `Response.[]` and `MockResponse.[]` for creating instances using status, headers, and body. ([@ioquatix])
181
+ - Convenient cache and content type methods for `Rack::Response`. ([#1555](https://github.com/rack/rack/pull/1555), [@ioquatix])
85
182
 
86
183
  ### Changed
87
184
 
88
- - `Request#params` no longer rescues EOFError. ([@jeremyevans](https://github.com/jeremyevans))
89
- - `Directory` uses a streaming approach, significantly improving time to first byte for large directories. ([@jeremyevans](https://github.com/jeremyevans))
90
- - `Directory` no longer includes a Parent directory link in the root directory index. ([@jeremyevans](https://github.com/jeremyevans))
91
- - `QueryParser#parse_nested_query` uses original backtrace when reraising exception with new class. ([@jeremyevans](https://github.com/jeremyevans))
92
- - `ConditionalGet` follows RFC 7232 precedence if both If-None-Match and If-Modified-Since headers are provided. ([@jeremyevans](https://github.com/jeremyevans))
185
+ - `Request#params` no longer rescues EOFError. ([@jeremyevans])
186
+ - `Directory` uses a streaming approach, significantly improving time to first byte for large directories. ([@jeremyevans])
187
+ - `Directory` no longer includes a Parent directory link in the root directory index. ([@jeremyevans])
188
+ - `QueryParser#parse_nested_query` uses original backtrace when reraising exception with new class. ([@jeremyevans])
189
+ - `ConditionalGet` follows RFC 7232 precedence if both If-None-Match and If-Modified-Since headers are provided. ([@jeremyevans])
93
190
  - `.ru` files supports the `frozen-string-literal` magic comment. ([@eregon](https://github.com/eregon))
94
- - Rely on autoload to load constants instead of requiring internal files, make sure to require 'rack' and not just 'rack/...'. ([@jeremyevans](https://github.com/jeremyevans))
95
- - `Etag` will continue sending ETag even if the response should not be cached. ([@henm](https://github.com/henm))
191
+ - Rely on autoload to load constants instead of requiring internal files, make sure to require 'rack' and not just 'rack/...'. ([@jeremyevans])
192
+ - BREAKING CHANGE: `Etag` will continue sending ETag even if the response should not be cached. Streaming no longer works without a workaround, see [#1619](https://github.com/rack/rack/issues/1619#issuecomment-848460528). ([@henm](https://github.com/henm))
96
193
  - `Request#host_with_port` no longer includes a colon for a missing or empty port. ([@AlexWayfer](https://github.com/AlexWayfer))
97
- - All handlers uses keywords arguments instead of an options hash argument. ([@ioquatix](https://github.com/ioquatix))
98
- - `Files` handling of range requests no longer return a body that supports `to_path`, to ensure range requests are handled correctly. ([@jeremyevans](https://github.com/jeremyevans))
99
- - `Multipart::Generator` only includes `Content-Length` for files with paths, and `Content-Disposition` `filename` if the `UploadedFile` instance has one. ([@jeremyevans](https://github.com/jeremyevans))
100
- - `Request#ssl?` is true for the `wss` scheme (secure websockets). ([@jeremyevans](https://github.com/jeremyevans))
101
- - `Rack::HeaderHash` is memoized by default. ([#1549](https://github.com/rack/rack/pull/1549), [@ioquatix](https://github.com/ioquatix))
194
+ - All handlers uses keywords arguments instead of an options hash argument. ([@ioquatix])
195
+ - `Files` handling of range requests no longer return a body that supports `to_path`, to ensure range requests are handled correctly. ([@jeremyevans])
196
+ - `Multipart::Generator` only includes `Content-Length` for files with paths, and `Content-Disposition` `filename` if the `UploadedFile` instance has one. ([@jeremyevans])
197
+ - `Request#ssl?` is true for the `wss` scheme (secure websockets). ([@jeremyevans])
198
+ - `Rack::HeaderHash` is memoized by default. ([#1549](https://github.com/rack/rack/pull/1549), [@ioquatix])
102
199
  - `Rack::Directory` allow directory traversal inside root directory. ([#1417](https://github.com/rack/rack/pull/1417), [@ThomasSevestre](https://github.com/ThomasSevestre))
103
- - Sort encodings by server preference. ([#1184](https://github.com/rack/rack/pull/1184), [@ioquatix](https://github.com/ioquatix), [@wjordan](https://github.com/wjordan))
104
- - Rework host/hostname/authority implementation in `Rack::Request`. `#host` and `#host_with_port` have been changed to correctly return IPv6 addresses formatted with square brackets, as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-3.2.2). ([#1561](https://github.com/rack/rack/pull/1561), [@ioquatix](https://github.com/ioquatix))
105
- - `Rack::Builder` parsing options on first `#\` line is deprecated. ([#1574](https://github.com/rack/rack/pull/1574), [@ioquatix](https://github.com/ioquatix))
200
+ - Sort encodings by server preference. ([#1184](https://github.com/rack/rack/pull/1184), [@ioquatix], [@wjordan](https://github.com/wjordan))
201
+ - Rework host/hostname/authority implementation in `Rack::Request`. `#host` and `#host_with_port` have been changed to correctly return IPv6 addresses formatted with square brackets, as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-3.2.2). ([#1561](https://github.com/rack/rack/pull/1561), [@ioquatix])
202
+ - `Rack::Builder` parsing options on first `#\` line is deprecated. ([#1574](https://github.com/rack/rack/pull/1574), [@ioquatix])
106
203
 
107
204
  ### Removed
108
205
 
109
- - `Directory#path` as it was not used and always returned nil. ([@jeremyevans](https://github.com/jeremyevans))
110
- - `BodyProxy#each` as it was only needed to work around a bug in Ruby <1.9.3. ([@jeremyevans](https://github.com/jeremyevans))
206
+ - `Directory#path` as it was not used and always returned nil. ([@jeremyevans])
207
+ - `BodyProxy#each` as it was only needed to work around a bug in Ruby <1.9.3. ([@jeremyevans])
111
208
  - `URLMap::INFINITY` and `URLMap::NEGATIVE_INFINITY`, in favor of `Float::INFINITY`. ([@ch1c0t](https://github.com/ch1c0t))
112
209
  - Deprecation of `Rack::File`. It will be deprecated again in rack 2.2 or 3.0. ([@rafaelfranca](https://github.com/rafaelfranca))
113
- - Support for Ruby 2.2 as it is well past EOL. ([@ioquatix](https://github.com/ioquatix))
114
- - Remove `Rack::Files#response_body` as the implementation was broken. ([#1153](https://github.com/rack/rack/pull/1153), [@ioquatix](https://github.com/ioquatix))
115
- - Remove `SERVER_ADDR` which was never part of the original SPEC. ([#1573](https://github.com/rack/rack/pull/1573), [@ioquatix](https://github.com/ioquatix))
210
+ - Support for Ruby 2.2 as it is well past EOL. ([@ioquatix])
211
+ - Remove `Rack::Files#response_body` as the implementation was broken. ([#1153](https://github.com/rack/rack/pull/1153), [@ioquatix])
212
+ - Remove `SERVER_ADDR` which was never part of the original SPEC. ([#1573](https://github.com/rack/rack/pull/1573), [@ioquatix])
116
213
 
117
214
  ### Fixed
118
215
 
119
- - `Directory` correctly handles root paths containing glob metacharacters. ([@jeremyevans](https://github.com/jeremyevans))
120
- - `Cascade` uses a new response object for each call if initialized with no apps. ([@jeremyevans](https://github.com/jeremyevans))
121
- - `BodyProxy` correctly delegates keyword arguments to the body object on Ruby 2.7+. ([@jeremyevans](https://github.com/jeremyevans))
122
- - `BodyProxy#method` correctly handles methods delegated to the body object. ([@jeremyevans](https://github.com/jeremyevans))
216
+ - `Directory` correctly handles root paths containing glob metacharacters. ([@jeremyevans])
217
+ - `Cascade` uses a new response object for each call if initialized with no apps. ([@jeremyevans])
218
+ - `BodyProxy` correctly delegates keyword arguments to the body object on Ruby 2.7+. ([@jeremyevans])
219
+ - `BodyProxy#method` correctly handles methods delegated to the body object. ([@jeremyevans])
123
220
  - `Request#host` and `Request#host_with_port` handle IPv6 addresses correctly. ([@AlexWayfer](https://github.com/AlexWayfer))
124
- - `Lint` checks when response hijacking that `rack.hijack` is called with a valid object. ([@jeremyevans](https://github.com/jeremyevans))
125
- - `Response#write` correctly updates `Content-Length` if initialized with a body. ([@jeremyevans](https://github.com/jeremyevans))
221
+ - `Lint` checks when response hijacking that `rack.hijack` is called with a valid object. ([@jeremyevans])
222
+ - `Response#write` correctly updates `Content-Length` if initialized with a body. ([@jeremyevans])
126
223
  - `CommonLogger` includes `SCRIPT_NAME` when logging. ([@Erol](https://github.com/Erol))
127
- - `Utils.parse_nested_query` correctly handles empty queries, using an empty instance of the params class instead of a hash. ([@jeremyevans](https://github.com/jeremyevans))
224
+ - `Utils.parse_nested_query` correctly handles empty queries, using an empty instance of the params class instead of a hash. ([@jeremyevans])
128
225
  - `Directory` correctly escapes paths in links. ([@yous](https://github.com/yous))
129
- - `Request#delete_cookie` and related `Utils` methods handle `:domain` and `:path` options in same call. ([@jeremyevans](https://github.com/jeremyevans))
130
- - `Request#delete_cookie` and related `Utils` methods do an exact match on `:domain` and `:path` options. ([@jeremyevans](https://github.com/jeremyevans))
226
+ - `Request#delete_cookie` and related `Utils` methods handle `:domain` and `:path` options in same call. ([@jeremyevans])
227
+ - `Request#delete_cookie` and related `Utils` methods do an exact match on `:domain` and `:path` options. ([@jeremyevans])
131
228
  - `Static` no longer adds headers when a gzipped file request has a 304 response. ([@chooh](https://github.com/chooh))
132
- - `ContentLength` sets `Content-Length` response header even for bodies not responding to `to_ary`. ([@jeremyevans](https://github.com/jeremyevans))
133
- - Thin handler supports options passed directly to `Thin::Controllers::Controller`. ([@jeremyevans](https://github.com/jeremyevans))
134
- - WEBrick handler no longer ignores `:BindAddress` option. ([@jeremyevans](https://github.com/jeremyevans))
135
- - `ShowExceptions` handles invalid POST data. ([@jeremyevans](https://github.com/jeremyevans))
136
- - Basic authentication requires a password, even if the password is empty. ([@jeremyevans](https://github.com/jeremyevans))
137
- - `Lint` checks response is array with 3 elements, per SPEC. ([@jeremyevans](https://github.com/jeremyevans))
229
+ - `ContentLength` sets `Content-Length` response header even for bodies not responding to `to_ary`. ([@jeremyevans])
230
+ - Thin handler supports options passed directly to `Thin::Controllers::Controller`. ([@jeremyevans])
231
+ - WEBrick handler no longer ignores `:BindAddress` option. ([@jeremyevans])
232
+ - `ShowExceptions` handles invalid POST data. ([@jeremyevans])
233
+ - Basic authentication requires a password, even if the password is empty. ([@jeremyevans])
234
+ - `Lint` checks response is array with 3 elements, per SPEC. ([@jeremyevans])
138
235
  - Support for using `:SSLEnable` option when using WEBrick handler. (Gregor Melhorn)
139
- - Close response body after buffering it when buffering. ([@ioquatix](https://github.com/ioquatix))
236
+ - Close response body after buffering it when buffering. ([@ioquatix])
140
237
  - Only accept `;` as delimiter when parsing cookies. ([@mrageh](https://github.com/mrageh))
141
- - `Utils::HeaderHash#clear` clears the name mapping as well. ([@raxoft](https://github.com/raxoft))
142
- - Support for passing `nil` `Rack::Files.new`, which notably fixes Rails' current `ActiveStorage::FileServer` implementation. ([@ioquatix](https://github.com/ioquatix))
238
+ - `Utils::HeaderHash#clear` clears the name mapping as well. ([@raxoft](https://github.com/raxoft))
239
+ - Support for passing `nil` `Rack::Files.new`, which notably fixes Rails' current `ActiveStorage::FileServer` implementation. ([@ioquatix])
143
240
 
144
241
  ### Documentation
145
242
 
146
243
  - CHANGELOG updates. ([@aupajo](https://github.com/aupajo))
147
244
  - Added [CONTRIBUTING](CONTRIBUTING.md). ([@dblock](https://github.com/dblock))
148
245
 
246
+ ## [2.0.9] - 2020-02-08
247
+
248
+ - Handle case where session id key is requested but missing ([@jeremyevans])
249
+ - Restore support for code relying on `SessionId#to_s`. ([@jeremyevans])
250
+ - Add support for `SameSite=None` cookie value. ([@hennikul](https://github.com/hennikul))
251
+
149
252
  ## [2.1.2] - 2020-01-27
150
253
 
151
254
  - Fix multipart parser for some files to prevent denial of service ([@aiomaster](https://github.com/aiomaster))
152
255
  - Fix `Rack::Builder#use` with keyword arguments ([@kamipo](https://github.com/kamipo))
153
- - Skip deflating in Rack::Deflater if Content-Length is 0 ([@jeremyevans](https://github.com/jeremyevans))
256
+ - Skip deflating in Rack::Deflater if Content-Length is 0 ([@jeremyevans])
154
257
  - Remove `SessionHash#transform_keys`, no longer needed ([@pavel](https://github.com/pavel))
155
258
  - Add to_hash to wrap Hash and Session classes ([@oleh-demyanyuk](https://github.com/oleh-demyanyuk))
156
- - Handle case where session id key is requested but missing ([@jeremyevans](https://github.com/jeremyevans))
259
+ - Handle case where session id key is requested but missing ([@jeremyevans])
157
260
 
158
261
  ## [2.1.1] - 2020-01-12
159
262
 
160
- - Remove `Rack::Chunked` from `Rack::Server` default middleware. ([#1475](https://github.com/rack/rack/pull/1475), [@ioquatix](https://github.com/ioquatix))
161
- - Restore support for code relying on `SessionId#to_s`. ([@jeremyevans](https://github.com/jeremyevans))
263
+ - Remove `Rack::Chunked` from `Rack::Server` default middleware. ([#1475](https://github.com/rack/rack/pull/1475), [@ioquatix])
264
+ - Restore support for code relying on `SessionId#to_s`. ([@jeremyevans])
162
265
 
163
266
  ## [2.1.0] - 2020-01-10
164
267
 
@@ -175,13 +278,13 @@ All notable changes to this project will be documented in this file. For info on
175
278
  - Add boot-time profiling capabilities to `rackup`. ([@tenderlove](https://github.com/tenderlove))
176
279
  - Add multi mapping support for `X-Accel-Mappings` header. ([@yoshuki](https://github.com/yoshuki))
177
280
  - Add `sync: false` option to `Rack::Deflater`. (Eric Wong)
178
- - Add `Builder#freeze_app` to freeze application and all middleware instances. ([@jeremyevans](https://github.com/jeremyevans))
281
+ - Add `Builder#freeze_app` to freeze application and all middleware instances. ([@jeremyevans])
179
282
  - Add API to extract cookies from `Rack::MockResponse`. ([@petercline](https://github.com/petercline))
180
283
 
181
284
  ### Changed
182
285
 
183
- - Don't propagate nil values from middleware. ([@ioquatix](https://github.com/ioquatix))
184
- - Lazily initialize the response body and only buffer it if required. ([@ioquatix](https://github.com/ioquatix))
286
+ - Don't propagate nil values from middleware. ([@ioquatix])
287
+ - Lazily initialize the response body and only buffer it if required. ([@ioquatix])
185
288
  - Fix deflater zlib buffer errors on empty body part. ([@felixbuenemann](https://github.com/felixbuenemann))
186
289
  - Set `X-Accel-Redirect` to percent-encoded path. ([@diskkid](https://github.com/diskkid))
187
290
  - Remove unnecessary buffer growing when parsing multipart. ([@tainoe](https://github.com/tainoe))
@@ -194,15 +297,15 @@ All notable changes to this project will be documented in this file. For info on
194
297
  - Make `Utils.status_code` raise an error when the status symbol is invalid instead of `500`. ([@adambutler](https://github.com/adambutler))
195
298
  - Rename `Request::SCHEME_WHITELIST` to `Request::ALLOWED_SCHEMES`.
196
299
  - Make `Multipart::Parser.get_filename` accept files with `+` in their name. ([@lucaskanashiro](https://github.com/lucaskanashiro))
197
- - Add Falcon to the default handler fallbacks. ([@ioquatix](https://github.com/ioquatix))
300
+ - Add Falcon to the default handler fallbacks. ([@ioquatix])
198
301
  - Update codebase to avoid string mutations in preparation for `frozen_string_literals`. ([@pat](https://github.com/pat))
199
302
  - Change `MockRequest#env_for` to rely on the input optionally responding to `#size` instead of `#length`. ([@janko](https://github.com/janko))
200
- - Rename `Rack::File` -> `Rack::Files` and add deprecation notice. ([@postmodern](https://github.com/postmodern)).
201
- - Prefer Base64 “strict encoding” for Base64 cookies. ([@ioquatix](https://github.com/ioquatix))
303
+ - Rename `Rack::File` -> `Rack::Files` and add deprecation notice. ([@postmodern](https://github.com/postmodern))
304
+ - Prefer Base64 “strict encoding” for Base64 cookies. ([@ioquatix])
202
305
 
203
306
  ### Removed
204
307
 
205
- - Remove `to_ary` from Response ([@tenderlove](https://github.com/tenderlove))
308
+ - BREAKING CHANGE: Remove `to_ary` from Response ([@tenderlove](https://github.com/tenderlove))
206
309
  - Deprecate `Rack::Session::Memcache` in favor of `Rack::Session::Dalli` from dalli gem ([@fatkodima](https://github.com/fatkodima))
207
310
 
208
311
  ### Fixed
@@ -283,7 +386,7 @@ All notable changes to this project will be documented in this file. For info on
283
386
  ### Added
284
387
 
285
388
  - Allow `Session::Abstract::SessionHash#fetch` to accept a block with a default value. ([@yannvanhalewyn](https://github.com/yannvanhalewyn))
286
- - Add `Builder#freeze_app` to freeze application and all middleware. ([@jeremyevans](https://github.com/jeremyevans))
389
+ - Add `Builder#freeze_app` to freeze application and all middleware. ([@jeremyevans])
287
390
 
288
391
  ### Changed
289
392
 
@@ -295,9 +398,9 @@ All notable changes to this project will be documented in this file. For info on
295
398
  ### Fixed
296
399
 
297
400
  - Handle `NULL` bytes in multipart filenames. ([@casperisfine](https://github.com/casperisfine))
298
- - Remove warnings due to miscapitalized global. ([@ioquatix](https://github.com/ioquatix))
401
+ - Remove warnings due to miscapitalized global. ([@ioquatix])
299
402
  - Prevent exceptions caused by a race condition on multi-threaded servers. ([@sophiedeziel](https://github.com/sophiedeziel))
300
- - Add RDoc as an explicit depencency for `doc` group. ([@tonytonyjan](https://github.com/tonytonyjan))
403
+ - Add RDoc as an explicit dependency for `doc` group. ([@tonytonyjan](https://github.com/tonytonyjan))
301
404
  - Record errors originating from `Multipart::Parser` in the `MethodOverride` middleware instead of letting them bubble up. ([@carlzulauf](https://github.com/carlzulauf))
302
405
  - Remove remaining use of removed `Utils#bytesize` method from the `File` middleware. ([@brauliomartinezlm](https://github.com/brauliomartinezlm))
303
406
 
@@ -615,7 +718,7 @@ Items below this line are from the previously maintained HISTORY.md and NEWS.md
615
718
  - Moved Auth::OpenID to rack-contrib.
616
719
  - SPEC change that relaxes Lint slightly to allow subclasses of the
617
720
  required types
618
- - SPEC change to document rack.input binary mode in greator detail
721
+ - SPEC change to document rack.input binary mode in greater detail
619
722
  - SPEC define optional rack.logger specification
620
723
  - File servers support X-Cascade header
621
724
  - Imported Config middleware
@@ -733,3 +836,9 @@ Items below this line are from the previously maintained HISTORY.md and NEWS.md
733
836
  - Removed Rails adapter, was too alpha.
734
837
 
735
838
  ## [0.1] 2007-03-03
839
+
840
+ [@ioquatix]: https://github.com/ioquatix "Samuel Williams"
841
+ [@jeremyevans]: https://github.com/jeremyevans "Jeremy Evans"
842
+ [@amatsuda]: https://github.com/amatsuda "Akira Matsuda"
843
+ [@wjordan]: https://github.com/wjordan "Will Jordan"
844
+ [@BlakeWilliams]: https://github.com/BlakeWilliams "Blake Williams"
data/CONTRIBUTING.md CHANGED
@@ -1,29 +1,33 @@
1
- Contributing to Rack
2
- =====================
1
+ # Contributing to Rack
3
2
 
4
- Rack is work of [hundreds of contributors](https://github.com/rack/rack/graphs/contributors). You're encouraged to submit [pull requests](https://github.com/rack/rack/pulls), [propose features and discuss issues](https://github.com/rack/rack/issues). When in doubt, post to the [rack-devel](http://groups.google.com/group/rack-devel) mailing list.
3
+ Rack is work of [hundreds of
4
+ contributors](https://github.com/rack/rack/graphs/contributors). You're
5
+ encouraged to submit [pull requests](https://github.com/rack/rack/pulls) and
6
+ [propose features and discuss issues](https://github.com/rack/rack/issues).
5
7
 
6
- #### Fork the Project
8
+ ## Fork the Project
7
9
 
8
- Fork the [project on Github](https://github.com/rack/rack) and check out your copy.
10
+ Fork the [project on GitHub](https://github.com/rack/rack) and check out your
11
+ copy.
9
12
 
10
13
  ```
11
- git clone https://github.com/contributor/rack.git
14
+ git clone https://github.com/(your-github-username)/rack.git
12
15
  cd rack
13
16
  git remote add upstream https://github.com/rack/rack.git
14
17
  ```
15
18
 
16
- #### Create a Topic Branch
19
+ ## Create a Topic Branch
17
20
 
18
- Make sure your fork is up-to-date and create a topic branch for your feature or bug fix.
21
+ Make sure your fork is up-to-date and create a topic branch for your feature or
22
+ bug fix.
19
23
 
20
24
  ```
21
- git checkout master
22
- git pull upstream master
25
+ git checkout main
26
+ git pull upstream main
23
27
  git checkout -b my-feature-branch
24
28
  ```
25
29
 
26
- #### Bundle Install and Quick Test
30
+ ## Bundle Install and Quick Test
27
31
 
28
32
  Ensure that you can build the project and run quick tests.
29
33
 
@@ -32,7 +36,7 @@ bundle install --without extra
32
36
  bundle exec rake test
33
37
  ```
34
38
 
35
- #### Running All Tests
39
+ ## Running All Tests
36
40
 
37
41
  Install all dependencies.
38
42
 
@@ -46,39 +50,33 @@ Run all tests.
46
50
  rake test
47
51
  ```
48
52
 
49
- The test suite has no dependencies outside of the core Ruby installation and bacon.
53
+ ## Write Tests
50
54
 
51
- Some tests will be skipped if a dependency is not found.
55
+ Try to write a test that reproduces the problem you're trying to fix or
56
+ describes a feature that you want to build.
52
57
 
53
- To run the test suite completely, you need:
58
+ We definitely appreciate pull requests that highlight or reproduce a problem,
59
+ even without a fix.
54
60
 
55
- * fcgi
56
- * dalli
57
- * thin
58
-
59
- To test Memcache sessions, you need memcached (will be run on port 11211) and dalli installed.
60
-
61
- #### Write Tests
62
-
63
- Try to write a test that reproduces the problem you're trying to fix or describes a feature that you want to build.
64
-
65
- We definitely appreciate pull requests that highlight or reproduce a problem, even without a fix.
66
-
67
- #### Write Code
61
+ ## Write Code
68
62
 
69
63
  Implement your feature or bug fix.
70
64
 
71
- Make sure that `bundle exec rake fulltest` completes without errors.
65
+ Make sure that all tests pass:
66
+
67
+ ```
68
+ bundle exec rake test
69
+ ```
72
70
 
73
- #### Write Documentation
71
+ ## Write Documentation
74
72
 
75
- Document any external behavior in the [README](README.rdoc).
73
+ Document any external behavior in the [README](README.md).
76
74
 
77
- #### Update Changelog
75
+ ## Update Changelog
78
76
 
79
77
  Add a line to [CHANGELOG](CHANGELOG.md).
80
78
 
81
- #### Commit Changes
79
+ ## Commit Changes
82
80
 
83
81
  Make sure git knows your name and email address:
84
82
 
@@ -87,34 +85,37 @@ git config --global user.name "Your Name"
87
85
  git config --global user.email "contributor@example.com"
88
86
  ```
89
87
 
90
- Writing good commit logs is important. A commit log should describe what changed and why.
88
+ Writing good commit logs is important. A commit log should describe what changed
89
+ and why.
91
90
 
92
91
  ```
93
92
  git add ...
94
93
  git commit
95
94
  ```
96
95
 
97
- #### Push
96
+ ## Push
98
97
 
99
98
  ```
100
99
  git push origin my-feature-branch
101
100
  ```
102
101
 
103
- #### Make a Pull Request
102
+ ## Make a Pull Request
104
103
 
105
- Go to https://github.com/contributor/rack and select your feature branch. Click the 'Pull Request' button and fill out the form. Pull requests are usually reviewed within a few days.
104
+ Go to your fork of rack on GitHub and select your feature branch. Click the
105
+ 'Pull Request' button and fill out the form. Pull requests are usually
106
+ reviewed within a few days.
106
107
 
107
- #### Rebase
108
+ ## Rebase
108
109
 
109
- If you've been working on a change for a while, rebase with upstream/master.
110
+ If you've been working on a change for a while, rebase with upstream/main.
110
111
 
111
112
  ```
112
113
  git fetch upstream
113
- git rebase upstream/master
114
+ git rebase upstream/main
114
115
  git push origin my-feature-branch -f
115
116
  ```
116
117
 
117
- #### Make Required Changes
118
+ ## Make Required Changes
118
119
 
119
120
  Amend your previous commit and force push the changes.
120
121
 
@@ -123,14 +124,19 @@ git commit --amend
123
124
  git push origin my-feature-branch -f
124
125
  ```
125
126
 
126
- #### Check on Your Pull Request
127
+ ## Check on Your Pull Request
127
128
 
128
- Go back to your pull request after a few minutes and see whether it passed muster with Travis-CI. Everything should look green, otherwise fix issues and amend your commit as described above.
129
+ Go back to your pull request after a few minutes and see whether it passed
130
+ tests with GitHub Actions. Everything should look green, otherwise fix issues and
131
+ amend your commit as described above.
129
132
 
130
- #### Be Patient
133
+ ## Be Patient
131
134
 
132
- It's likely that your change will not be merged and that the nitpicky maintainers will ask you to do more, or fix seemingly benign problems. Hang on there!
135
+ It's likely that your change will not be merged and that the nitpicky
136
+ maintainers will ask you to do more, or fix seemingly benign problems. Hang in
137
+ there!
133
138
 
134
- #### Thank You
139
+ ## Thank You
135
140
 
136
- Please do know that we really appreciate and value your time and work. We love you, really.
141
+ Please do know that we really appreciate and value your time and work. We love
142
+ you, really.
data/MIT-LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  The MIT License (MIT)
2
2
 
3
- Copyright (C) 2007-2019 Leah Neukirchen <http://leahneukirchen.org/infopage.html>
3
+ Copyright (C) 2007-2021 Leah Neukirchen <http://leahneukirchen.org/infopage.html>
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to