spikard 0.3.6 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +1 -1
  3. data/README.md +674 -659
  4. data/ext/spikard_rb/Cargo.toml +17 -17
  5. data/ext/spikard_rb/extconf.rb +13 -10
  6. data/ext/spikard_rb/src/lib.rs +6 -6
  7. data/lib/spikard/app.rb +405 -386
  8. data/lib/spikard/background.rb +27 -27
  9. data/lib/spikard/config.rb +396 -396
  10. data/lib/spikard/converters.rb +13 -13
  11. data/lib/spikard/handler_wrapper.rb +113 -113
  12. data/lib/spikard/provide.rb +214 -214
  13. data/lib/spikard/response.rb +173 -173
  14. data/lib/spikard/schema.rb +243 -243
  15. data/lib/spikard/sse.rb +111 -111
  16. data/lib/spikard/streaming_response.rb +44 -44
  17. data/lib/spikard/testing.rb +256 -221
  18. data/lib/spikard/upload_file.rb +131 -131
  19. data/lib/spikard/version.rb +5 -5
  20. data/lib/spikard/websocket.rb +59 -59
  21. data/lib/spikard.rb +43 -43
  22. data/sig/spikard.rbs +366 -366
  23. data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -0
  24. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -0
  25. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -0
  26. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
  27. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
  28. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -0
  29. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -0
  30. data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -0
  31. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -0
  32. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -0
  33. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -0
  34. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
  35. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -0
  36. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -0
  37. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -0
  38. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -0
  39. data/vendor/crates/spikard-core/Cargo.toml +40 -40
  40. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -3
  41. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -133
  42. data/vendor/crates/spikard-core/src/debug.rs +127 -63
  43. data/vendor/crates/spikard-core/src/di/container.rs +702 -726
  44. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -273
  45. data/vendor/crates/spikard-core/src/di/error.rs +118 -118
  46. data/vendor/crates/spikard-core/src/di/factory.rs +534 -538
  47. data/vendor/crates/spikard-core/src/di/graph.rs +506 -545
  48. data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
  49. data/vendor/crates/spikard-core/src/di/resolved.rs +405 -411
  50. data/vendor/crates/spikard-core/src/di/value.rs +281 -283
  51. data/vendor/crates/spikard-core/src/errors.rs +69 -39
  52. data/vendor/crates/spikard-core/src/http.rs +415 -153
  53. data/vendor/crates/spikard-core/src/lib.rs +29 -29
  54. data/vendor/crates/spikard-core/src/lifecycle.rs +1186 -422
  55. data/vendor/crates/spikard-core/src/metadata.rs +389 -0
  56. data/vendor/crates/spikard-core/src/parameters.rs +2525 -722
  57. data/vendor/crates/spikard-core/src/problem.rs +344 -310
  58. data/vendor/crates/spikard-core/src/request_data.rs +1154 -189
  59. data/vendor/crates/spikard-core/src/router.rs +510 -249
  60. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -183
  61. data/vendor/crates/spikard-core/src/type_hints.rs +304 -304
  62. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +696 -0
  63. data/vendor/crates/spikard-core/src/{validation.rs → validation/mod.rs} +457 -699
  64. data/vendor/crates/spikard-http/Cargo.toml +62 -68
  65. data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -0
  66. data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -0
  67. data/vendor/crates/spikard-http/src/auth.rs +296 -247
  68. data/vendor/crates/spikard-http/src/background.rs +1860 -249
  69. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -3
  70. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -1
  71. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -8
  72. data/vendor/crates/spikard-http/src/cors.rs +1005 -490
  73. data/vendor/crates/spikard-http/src/debug.rs +128 -63
  74. data/vendor/crates/spikard-http/src/di_handler.rs +1668 -423
  75. data/vendor/crates/spikard-http/src/handler_response.rs +901 -190
  76. data/vendor/crates/spikard-http/src/handler_trait.rs +838 -228
  77. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +290 -284
  78. data/vendor/crates/spikard-http/src/lib.rs +534 -529
  79. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +230 -149
  80. data/vendor/crates/spikard-http/src/lifecycle.rs +1193 -428
  81. data/vendor/crates/spikard-http/src/middleware/mod.rs +560 -285
  82. data/vendor/crates/spikard-http/src/middleware/multipart.rs +912 -86
  83. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +513 -147
  84. data/vendor/crates/spikard-http/src/middleware/validation.rs +768 -287
  85. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
  86. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -190
  87. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1363 -308
  88. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +665 -195
  89. data/vendor/crates/spikard-http/src/query_parser.rs +793 -369
  90. data/vendor/crates/spikard-http/src/response.rs +720 -399
  91. data/vendor/crates/spikard-http/src/server/handler.rs +1650 -87
  92. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +234 -98
  93. data/vendor/crates/spikard-http/src/server/mod.rs +1593 -805
  94. data/vendor/crates/spikard-http/src/server/request_extraction.rs +789 -119
  95. data/vendor/crates/spikard-http/src/server/routing_factory.rs +629 -0
  96. data/vendor/crates/spikard-http/src/sse.rs +1409 -447
  97. data/vendor/crates/spikard-http/src/testing/form.rs +52 -14
  98. data/vendor/crates/spikard-http/src/testing/multipart.rs +64 -60
  99. data/vendor/crates/spikard-http/src/testing/test_client.rs +311 -285
  100. data/vendor/crates/spikard-http/src/testing.rs +406 -377
  101. data/vendor/crates/spikard-http/src/websocket.rs +1404 -324
  102. data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -0
  103. data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -0
  104. data/vendor/crates/spikard-http/tests/common/mod.rs +26 -0
  105. data/vendor/crates/spikard-http/tests/di_integration.rs +192 -0
  106. data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -0
  107. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -0
  108. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -0
  109. data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -0
  110. data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -0
  111. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -0
  112. data/vendor/crates/spikard-rb/Cargo.toml +48 -42
  113. data/vendor/crates/spikard-rb/build.rs +199 -8
  114. data/vendor/crates/spikard-rb/src/background.rs +63 -63
  115. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
  116. data/vendor/crates/spikard-rb/src/{config.rs → config/server_config.rs} +285 -294
  117. data/vendor/crates/spikard-rb/src/conversion.rs +554 -453
  118. data/vendor/crates/spikard-rb/src/di/builder.rs +100 -0
  119. data/vendor/crates/spikard-rb/src/{di.rs → di/mod.rs} +375 -409
  120. data/vendor/crates/spikard-rb/src/handler.rs +618 -625
  121. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
  122. data/vendor/crates/spikard-rb/src/lib.rs +1806 -2771
  123. data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -274
  124. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
  125. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +442 -0
  126. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
  127. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -0
  128. data/vendor/crates/spikard-rb/src/server.rs +305 -283
  129. data/vendor/crates/spikard-rb/src/sse.rs +231 -231
  130. data/vendor/crates/spikard-rb/src/{test_client.rs → testing/client.rs} +538 -404
  131. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
  132. data/vendor/crates/spikard-rb/src/{test_sse.rs → testing/sse.rs} +143 -143
  133. data/vendor/crates/spikard-rb/src/testing/websocket.rs +608 -0
  134. data/vendor/crates/spikard-rb/src/websocket.rs +377 -233
  135. metadata +60 -13
  136. data/vendor/crates/spikard-http/src/parameters.rs +0 -1
  137. data/vendor/crates/spikard-http/src/problem.rs +0 -1
  138. data/vendor/crates/spikard-http/src/router.rs +0 -1
  139. data/vendor/crates/spikard-http/src/schema_registry.rs +0 -1
  140. data/vendor/crates/spikard-http/src/type_hints.rs +0 -1
  141. data/vendor/crates/spikard-http/src/validation.rs +0 -1
  142. data/vendor/crates/spikard-rb/src/test_websocket.rs +0 -221
@@ -1,399 +1,720 @@
1
- //! HTTP Response types
2
- //!
3
- //! Response types for returning custom responses with status codes, headers, and content
4
-
5
- use serde_json::Value;
6
- use std::collections::HashMap;
7
-
8
- /// HTTP Response with custom status code, headers, and content
9
- #[derive(Debug, Clone)]
10
- pub struct Response {
11
- /// Response body content
12
- pub content: Option<Value>,
13
- /// HTTP status code (defaults to 200)
14
- pub status_code: u16,
15
- /// Response headers
16
- pub headers: HashMap<String, String>,
17
- }
18
-
19
- impl Response {
20
- /// Create a new Response with default status 200
21
- pub fn new(content: Option<Value>) -> Self {
22
- Self {
23
- content,
24
- status_code: 200,
25
- headers: HashMap::new(),
26
- }
27
- }
28
-
29
- /// Create a response with a specific status code
30
- pub fn with_status(content: Option<Value>, status_code: u16) -> Self {
31
- Self {
32
- content,
33
- status_code,
34
- headers: HashMap::new(),
35
- }
36
- }
37
-
38
- /// Set a header
39
- pub fn set_header(&mut self, key: String, value: String) {
40
- self.headers.insert(key, value);
41
- }
42
-
43
- /// Set a cookie in the response
44
- #[allow(clippy::too_many_arguments)]
45
- pub fn set_cookie(
46
- &mut self,
47
- key: String,
48
- value: String,
49
- max_age: Option<i64>,
50
- domain: Option<String>,
51
- path: Option<String>,
52
- secure: bool,
53
- http_only: bool,
54
- same_site: Option<String>,
55
- ) {
56
- let mut cookie_value = format!("{}={}", key, value);
57
-
58
- if let Some(age) = max_age {
59
- cookie_value.push_str(&format!("; Max-Age={}", age));
60
- }
61
- if let Some(d) = domain {
62
- cookie_value.push_str(&format!("; Domain={}", d));
63
- }
64
- if let Some(p) = path {
65
- cookie_value.push_str(&format!("; Path={}", p));
66
- }
67
- if secure {
68
- cookie_value.push_str("; Secure");
69
- }
70
- if http_only {
71
- cookie_value.push_str("; HttpOnly");
72
- }
73
- if let Some(ss) = same_site {
74
- cookie_value.push_str(&format!("; SameSite={}", ss));
75
- }
76
-
77
- self.headers.insert("set-cookie".to_string(), cookie_value);
78
- }
79
- }
80
-
81
- impl Default for Response {
82
- fn default() -> Self {
83
- Self::new(None)
84
- }
85
- }
86
-
87
- #[cfg(test)]
88
- mod tests {
89
- use super::*;
90
- use serde_json::json;
91
-
92
- #[test]
93
- fn response_new_creates_default_status() {
94
- let response = Response::new(None);
95
- assert_eq!(response.status_code, 200);
96
- assert!(response.headers.is_empty());
97
- assert!(response.content.is_none());
98
- }
99
-
100
- #[test]
101
- fn response_new_with_content() {
102
- let content = json!({"key": "value"});
103
- let response = Response::new(Some(content.clone()));
104
- assert_eq!(response.status_code, 200);
105
- assert_eq!(response.content, Some(content));
106
- }
107
-
108
- #[test]
109
- fn response_with_status() {
110
- let response = Response::with_status(None, 404);
111
- assert_eq!(response.status_code, 404);
112
- assert!(response.headers.is_empty());
113
- }
114
-
115
- #[test]
116
- fn response_with_status_and_content() {
117
- let content = json!({"error": "not found"});
118
- let response = Response::with_status(Some(content.clone()), 404);
119
- assert_eq!(response.status_code, 404);
120
- assert_eq!(response.content, Some(content));
121
- }
122
-
123
- #[test]
124
- fn response_set_header() {
125
- let mut response = Response::new(None);
126
- response.set_header("X-Custom".to_string(), "custom-value".to_string());
127
- assert_eq!(response.headers.get("X-Custom"), Some(&"custom-value".to_string()));
128
- }
129
-
130
- #[test]
131
- fn response_set_multiple_headers() {
132
- let mut response = Response::new(None);
133
- response.set_header("Content-Type".to_string(), "application/json".to_string());
134
- response.set_header("X-Custom".to_string(), "custom-value".to_string());
135
- assert_eq!(response.headers.len(), 2);
136
- assert_eq!(
137
- response.headers.get("Content-Type"),
138
- Some(&"application/json".to_string())
139
- );
140
- assert_eq!(response.headers.get("X-Custom"), Some(&"custom-value".to_string()));
141
- }
142
-
143
- #[test]
144
- fn response_set_header_overwrites() {
145
- let mut response = Response::new(None);
146
- response.set_header("X-Custom".to_string(), "value1".to_string());
147
- response.set_header("X-Custom".to_string(), "value2".to_string());
148
- assert_eq!(response.headers.get("X-Custom"), Some(&"value2".to_string()));
149
- }
150
-
151
- #[test]
152
- fn response_set_cookie_minimal() {
153
- let mut response = Response::new(None);
154
- response.set_cookie(
155
- "session_id".to_string(),
156
- "abc123".to_string(),
157
- None,
158
- None,
159
- None,
160
- false,
161
- false,
162
- None,
163
- );
164
- let cookie = response.headers.get("set-cookie").unwrap();
165
- assert_eq!(cookie, "session_id=abc123");
166
- }
167
-
168
- #[test]
169
- fn response_set_cookie_with_max_age() {
170
- let mut response = Response::new(None);
171
- response.set_cookie(
172
- "session".to_string(),
173
- "token".to_string(),
174
- Some(3600),
175
- None,
176
- None,
177
- false,
178
- false,
179
- None,
180
- );
181
- let cookie = response.headers.get("set-cookie").unwrap();
182
- assert!(cookie.contains("session=token"));
183
- assert!(cookie.contains("Max-Age=3600"));
184
- }
185
-
186
- #[test]
187
- fn response_set_cookie_with_domain() {
188
- let mut response = Response::new(None);
189
- response.set_cookie(
190
- "session".to_string(),
191
- "token".to_string(),
192
- None,
193
- Some("example.com".to_string()),
194
- None,
195
- false,
196
- false,
197
- None,
198
- );
199
- let cookie = response.headers.get("set-cookie").unwrap();
200
- assert!(cookie.contains("Domain=example.com"));
201
- }
202
-
203
- #[test]
204
- fn response_set_cookie_with_path() {
205
- let mut response = Response::new(None);
206
- response.set_cookie(
207
- "session".to_string(),
208
- "token".to_string(),
209
- None,
210
- None,
211
- Some("/app".to_string()),
212
- false,
213
- false,
214
- None,
215
- );
216
- let cookie = response.headers.get("set-cookie").unwrap();
217
- assert!(cookie.contains("Path=/app"));
218
- }
219
-
220
- #[test]
221
- fn response_set_cookie_secure() {
222
- let mut response = Response::new(None);
223
- response.set_cookie(
224
- "session".to_string(),
225
- "token".to_string(),
226
- None,
227
- None,
228
- None,
229
- true,
230
- false,
231
- None,
232
- );
233
- let cookie = response.headers.get("set-cookie").unwrap();
234
- assert!(cookie.contains("Secure"));
235
- }
236
-
237
- #[test]
238
- fn response_set_cookie_http_only() {
239
- let mut response = Response::new(None);
240
- response.set_cookie(
241
- "session".to_string(),
242
- "token".to_string(),
243
- None,
244
- None,
245
- None,
246
- false,
247
- true,
248
- None,
249
- );
250
- let cookie = response.headers.get("set-cookie").unwrap();
251
- assert!(cookie.contains("HttpOnly"));
252
- }
253
-
254
- #[test]
255
- fn response_set_cookie_same_site() {
256
- let mut response = Response::new(None);
257
- response.set_cookie(
258
- "session".to_string(),
259
- "token".to_string(),
260
- None,
261
- None,
262
- None,
263
- false,
264
- false,
265
- Some("Strict".to_string()),
266
- );
267
- let cookie = response.headers.get("set-cookie").unwrap();
268
- assert!(cookie.contains("SameSite=Strict"));
269
- }
270
-
271
- #[test]
272
- fn response_set_cookie_all_attributes() {
273
- let mut response = Response::new(None);
274
- response.set_cookie(
275
- "session".to_string(),
276
- "token123".to_string(),
277
- Some(3600),
278
- Some("example.com".to_string()),
279
- Some("/app".to_string()),
280
- true,
281
- true,
282
- Some("Lax".to_string()),
283
- );
284
- let cookie = response.headers.get("set-cookie").unwrap();
285
- assert!(cookie.contains("session=token123"));
286
- assert!(cookie.contains("Max-Age=3600"));
287
- assert!(cookie.contains("Domain=example.com"));
288
- assert!(cookie.contains("Path=/app"));
289
- assert!(cookie.contains("Secure"));
290
- assert!(cookie.contains("HttpOnly"));
291
- assert!(cookie.contains("SameSite=Lax"));
292
- }
293
-
294
- #[test]
295
- fn response_set_cookie_overwrites_previous() {
296
- let mut response = Response::new(None);
297
- response.set_cookie(
298
- "session".to_string(),
299
- "old_token".to_string(),
300
- None,
301
- None,
302
- None,
303
- false,
304
- false,
305
- None,
306
- );
307
- response.set_cookie(
308
- "session".to_string(),
309
- "new_token".to_string(),
310
- None,
311
- None,
312
- None,
313
- false,
314
- false,
315
- None,
316
- );
317
- let cookie = response.headers.get("set-cookie").unwrap();
318
- assert!(cookie.contains("new_token"));
319
- assert!(!cookie.contains("old_token"));
320
- }
321
-
322
- #[test]
323
- fn response_default() {
324
- let response = Response::default();
325
- assert_eq!(response.status_code, 200);
326
- assert!(response.headers.is_empty());
327
- assert!(response.content.is_none());
328
- }
329
-
330
- #[test]
331
- fn response_cookie_with_special_chars_in_value() {
332
- let mut response = Response::new(None);
333
- response.set_cookie(
334
- "name".to_string(),
335
- "value%3D123".to_string(),
336
- None,
337
- None,
338
- None,
339
- false,
340
- false,
341
- None,
342
- );
343
- let cookie = response.headers.get("set-cookie").unwrap();
344
- assert_eq!(cookie, "name=value%3D123");
345
- }
346
-
347
- #[test]
348
- fn response_same_site_variants() {
349
- for same_site in &["Strict", "Lax", "None"] {
350
- let mut response = Response::new(None);
351
- response.set_cookie(
352
- "test".to_string(),
353
- "value".to_string(),
354
- None,
355
- None,
356
- None,
357
- false,
358
- false,
359
- Some(same_site.to_string()),
360
- );
361
- let cookie = response.headers.get("set-cookie").unwrap();
362
- assert!(cookie.contains(&format!("SameSite={}", same_site)));
363
- }
364
- }
365
-
366
- #[test]
367
- fn response_zero_max_age() {
368
- let mut response = Response::new(None);
369
- response.set_cookie(
370
- "session".to_string(),
371
- "token".to_string(),
372
- Some(0),
373
- None,
374
- None,
375
- false,
376
- false,
377
- None,
378
- );
379
- let cookie = response.headers.get("set-cookie").unwrap();
380
- assert!(cookie.contains("Max-Age=0"));
381
- }
382
-
383
- #[test]
384
- fn response_negative_max_age() {
385
- let mut response = Response::new(None);
386
- response.set_cookie(
387
- "session".to_string(),
388
- "token".to_string(),
389
- Some(-1),
390
- None,
391
- None,
392
- false,
393
- false,
394
- None,
395
- );
396
- let cookie = response.headers.get("set-cookie").unwrap();
397
- assert!(cookie.contains("Max-Age=-1"));
398
- }
399
- }
1
+ //! HTTP Response types
2
+ //!
3
+ //! Response types for returning custom responses with status codes, headers, and content
4
+
5
+ use serde_json::Value;
6
+ use std::collections::HashMap;
7
+
8
+ /// HTTP Response with custom status code, headers, and content
9
+ #[derive(Debug, Clone)]
10
+ pub struct Response {
11
+ /// Response body content
12
+ pub content: Option<Value>,
13
+ /// HTTP status code (defaults to 200)
14
+ pub status_code: u16,
15
+ /// Response headers
16
+ pub headers: HashMap<String, String>,
17
+ }
18
+
19
+ impl Response {
20
+ /// Create a new Response with default status 200
21
+ pub fn new(content: Option<Value>) -> Self {
22
+ Self {
23
+ content,
24
+ status_code: 200,
25
+ headers: HashMap::new(),
26
+ }
27
+ }
28
+
29
+ /// Create a response with a specific status code
30
+ pub fn with_status(content: Option<Value>, status_code: u16) -> Self {
31
+ Self {
32
+ content,
33
+ status_code,
34
+ headers: HashMap::new(),
35
+ }
36
+ }
37
+
38
+ /// Set a header
39
+ pub fn set_header(&mut self, key: String, value: String) {
40
+ self.headers.insert(key, value);
41
+ }
42
+
43
+ /// Set a cookie in the response
44
+ #[allow(clippy::too_many_arguments)]
45
+ pub fn set_cookie(
46
+ &mut self,
47
+ key: String,
48
+ value: String,
49
+ max_age: Option<i64>,
50
+ domain: Option<String>,
51
+ path: Option<String>,
52
+ secure: bool,
53
+ http_only: bool,
54
+ same_site: Option<String>,
55
+ ) {
56
+ let mut cookie_value = format!("{}={}", key, value);
57
+
58
+ if let Some(age) = max_age {
59
+ cookie_value.push_str(&format!("; Max-Age={}", age));
60
+ }
61
+ if let Some(d) = domain {
62
+ cookie_value.push_str(&format!("; Domain={}", d));
63
+ }
64
+ if let Some(p) = path {
65
+ cookie_value.push_str(&format!("; Path={}", p));
66
+ }
67
+ if secure {
68
+ cookie_value.push_str("; Secure");
69
+ }
70
+ if http_only {
71
+ cookie_value.push_str("; HttpOnly");
72
+ }
73
+ if let Some(ss) = same_site {
74
+ cookie_value.push_str(&format!("; SameSite={}", ss));
75
+ }
76
+
77
+ self.headers.insert("set-cookie".to_string(), cookie_value);
78
+ }
79
+ }
80
+
81
+ impl Default for Response {
82
+ fn default() -> Self {
83
+ Self::new(None)
84
+ }
85
+ }
86
+
87
+ #[cfg(test)]
88
+ mod tests {
89
+ use super::*;
90
+ use serde_json::json;
91
+
92
+ #[test]
93
+ fn response_new_creates_default_status() {
94
+ let response = Response::new(None);
95
+ assert_eq!(response.status_code, 200);
96
+ assert!(response.headers.is_empty());
97
+ assert!(response.content.is_none());
98
+ }
99
+
100
+ #[test]
101
+ fn response_new_with_content() {
102
+ let content = json!({"key": "value"});
103
+ let response = Response::new(Some(content.clone()));
104
+ assert_eq!(response.status_code, 200);
105
+ assert_eq!(response.content, Some(content));
106
+ }
107
+
108
+ #[test]
109
+ fn response_with_status() {
110
+ let response = Response::with_status(None, 404);
111
+ assert_eq!(response.status_code, 404);
112
+ assert!(response.headers.is_empty());
113
+ }
114
+
115
+ #[test]
116
+ fn response_with_status_and_content() {
117
+ let content = json!({"error": "not found"});
118
+ let response = Response::with_status(Some(content.clone()), 404);
119
+ assert_eq!(response.status_code, 404);
120
+ assert_eq!(response.content, Some(content));
121
+ }
122
+
123
+ #[test]
124
+ fn response_set_header() {
125
+ let mut response = Response::new(None);
126
+ response.set_header("X-Custom".to_string(), "custom-value".to_string());
127
+ assert_eq!(response.headers.get("X-Custom"), Some(&"custom-value".to_string()));
128
+ }
129
+
130
+ #[test]
131
+ fn response_set_multiple_headers() {
132
+ let mut response = Response::new(None);
133
+ response.set_header("Content-Type".to_string(), "application/json".to_string());
134
+ response.set_header("X-Custom".to_string(), "custom-value".to_string());
135
+ assert_eq!(response.headers.len(), 2);
136
+ assert_eq!(
137
+ response.headers.get("Content-Type"),
138
+ Some(&"application/json".to_string())
139
+ );
140
+ assert_eq!(response.headers.get("X-Custom"), Some(&"custom-value".to_string()));
141
+ }
142
+
143
+ #[test]
144
+ fn response_set_header_overwrites() {
145
+ let mut response = Response::new(None);
146
+ response.set_header("X-Custom".to_string(), "value1".to_string());
147
+ response.set_header("X-Custom".to_string(), "value2".to_string());
148
+ assert_eq!(response.headers.get("X-Custom"), Some(&"value2".to_string()));
149
+ }
150
+
151
+ #[test]
152
+ fn response_set_cookie_minimal() {
153
+ let mut response = Response::new(None);
154
+ response.set_cookie(
155
+ "session_id".to_string(),
156
+ "abc123".to_string(),
157
+ None,
158
+ None,
159
+ None,
160
+ false,
161
+ false,
162
+ None,
163
+ );
164
+ let cookie = response.headers.get("set-cookie").unwrap();
165
+ assert_eq!(cookie, "session_id=abc123");
166
+ }
167
+
168
+ #[test]
169
+ fn response_set_cookie_with_max_age() {
170
+ let mut response = Response::new(None);
171
+ response.set_cookie(
172
+ "session".to_string(),
173
+ "token".to_string(),
174
+ Some(3600),
175
+ None,
176
+ None,
177
+ false,
178
+ false,
179
+ None,
180
+ );
181
+ let cookie = response.headers.get("set-cookie").unwrap();
182
+ assert!(cookie.contains("session=token"));
183
+ assert!(cookie.contains("Max-Age=3600"));
184
+ }
185
+
186
+ #[test]
187
+ fn response_set_cookie_with_domain() {
188
+ let mut response = Response::new(None);
189
+ response.set_cookie(
190
+ "session".to_string(),
191
+ "token".to_string(),
192
+ None,
193
+ Some("example.com".to_string()),
194
+ None,
195
+ false,
196
+ false,
197
+ None,
198
+ );
199
+ let cookie = response.headers.get("set-cookie").unwrap();
200
+ assert!(cookie.contains("Domain=example.com"));
201
+ }
202
+
203
+ #[test]
204
+ fn response_set_cookie_with_path() {
205
+ let mut response = Response::new(None);
206
+ response.set_cookie(
207
+ "session".to_string(),
208
+ "token".to_string(),
209
+ None,
210
+ None,
211
+ Some("/app".to_string()),
212
+ false,
213
+ false,
214
+ None,
215
+ );
216
+ let cookie = response.headers.get("set-cookie").unwrap();
217
+ assert!(cookie.contains("Path=/app"));
218
+ }
219
+
220
+ #[test]
221
+ fn response_set_cookie_secure() {
222
+ let mut response = Response::new(None);
223
+ response.set_cookie(
224
+ "session".to_string(),
225
+ "token".to_string(),
226
+ None,
227
+ None,
228
+ None,
229
+ true,
230
+ false,
231
+ None,
232
+ );
233
+ let cookie = response.headers.get("set-cookie").unwrap();
234
+ assert!(cookie.contains("Secure"));
235
+ }
236
+
237
+ #[test]
238
+ fn response_set_cookie_http_only() {
239
+ let mut response = Response::new(None);
240
+ response.set_cookie(
241
+ "session".to_string(),
242
+ "token".to_string(),
243
+ None,
244
+ None,
245
+ None,
246
+ false,
247
+ true,
248
+ None,
249
+ );
250
+ let cookie = response.headers.get("set-cookie").unwrap();
251
+ assert!(cookie.contains("HttpOnly"));
252
+ }
253
+
254
+ #[test]
255
+ fn response_set_cookie_same_site() {
256
+ let mut response = Response::new(None);
257
+ response.set_cookie(
258
+ "session".to_string(),
259
+ "token".to_string(),
260
+ None,
261
+ None,
262
+ None,
263
+ false,
264
+ false,
265
+ Some("Strict".to_string()),
266
+ );
267
+ let cookie = response.headers.get("set-cookie").unwrap();
268
+ assert!(cookie.contains("SameSite=Strict"));
269
+ }
270
+
271
+ #[test]
272
+ fn response_set_cookie_all_attributes() {
273
+ let mut response = Response::new(None);
274
+ response.set_cookie(
275
+ "session".to_string(),
276
+ "token123".to_string(),
277
+ Some(3600),
278
+ Some("example.com".to_string()),
279
+ Some("/app".to_string()),
280
+ true,
281
+ true,
282
+ Some("Lax".to_string()),
283
+ );
284
+ let cookie = response.headers.get("set-cookie").unwrap();
285
+ assert!(cookie.contains("session=token123"));
286
+ assert!(cookie.contains("Max-Age=3600"));
287
+ assert!(cookie.contains("Domain=example.com"));
288
+ assert!(cookie.contains("Path=/app"));
289
+ assert!(cookie.contains("Secure"));
290
+ assert!(cookie.contains("HttpOnly"));
291
+ assert!(cookie.contains("SameSite=Lax"));
292
+ }
293
+
294
+ #[test]
295
+ fn response_set_cookie_overwrites_previous() {
296
+ let mut response = Response::new(None);
297
+ response.set_cookie(
298
+ "session".to_string(),
299
+ "old_token".to_string(),
300
+ None,
301
+ None,
302
+ None,
303
+ false,
304
+ false,
305
+ None,
306
+ );
307
+ response.set_cookie(
308
+ "session".to_string(),
309
+ "new_token".to_string(),
310
+ None,
311
+ None,
312
+ None,
313
+ false,
314
+ false,
315
+ None,
316
+ );
317
+ let cookie = response.headers.get("set-cookie").unwrap();
318
+ assert!(cookie.contains("new_token"));
319
+ assert!(!cookie.contains("old_token"));
320
+ }
321
+
322
+ #[test]
323
+ fn response_default() {
324
+ let response = Response::default();
325
+ assert_eq!(response.status_code, 200);
326
+ assert!(response.headers.is_empty());
327
+ assert!(response.content.is_none());
328
+ }
329
+
330
+ #[test]
331
+ fn response_cookie_with_special_chars_in_value() {
332
+ let mut response = Response::new(None);
333
+ response.set_cookie(
334
+ "name".to_string(),
335
+ "value%3D123".to_string(),
336
+ None,
337
+ None,
338
+ None,
339
+ false,
340
+ false,
341
+ None,
342
+ );
343
+ let cookie = response.headers.get("set-cookie").unwrap();
344
+ assert_eq!(cookie, "name=value%3D123");
345
+ }
346
+
347
+ #[test]
348
+ fn response_same_site_variants() {
349
+ for same_site in &["Strict", "Lax", "None"] {
350
+ let mut response = Response::new(None);
351
+ response.set_cookie(
352
+ "test".to_string(),
353
+ "value".to_string(),
354
+ None,
355
+ None,
356
+ None,
357
+ false,
358
+ false,
359
+ Some(same_site.to_string()),
360
+ );
361
+ let cookie = response.headers.get("set-cookie").unwrap();
362
+ assert!(cookie.contains(&format!("SameSite={}", same_site)));
363
+ }
364
+ }
365
+
366
+ #[test]
367
+ fn response_zero_max_age() {
368
+ let mut response = Response::new(None);
369
+ response.set_cookie(
370
+ "session".to_string(),
371
+ "token".to_string(),
372
+ Some(0),
373
+ None,
374
+ None,
375
+ false,
376
+ false,
377
+ None,
378
+ );
379
+ let cookie = response.headers.get("set-cookie").unwrap();
380
+ assert!(cookie.contains("Max-Age=0"));
381
+ }
382
+
383
+ #[test]
384
+ fn response_negative_max_age() {
385
+ let mut response = Response::new(None);
386
+ response.set_cookie(
387
+ "session".to_string(),
388
+ "token".to_string(),
389
+ Some(-1),
390
+ None,
391
+ None,
392
+ false,
393
+ false,
394
+ None,
395
+ );
396
+ let cookie = response.headers.get("set-cookie").unwrap();
397
+ assert!(cookie.contains("Max-Age=-1"));
398
+ }
399
+
400
+ #[test]
401
+ fn response_various_status_codes() {
402
+ let status_codes = vec![
403
+ (200, "OK"),
404
+ (201, "Created"),
405
+ (204, "No Content"),
406
+ (301, "Moved Permanently"),
407
+ (302, "Found"),
408
+ (304, "Not Modified"),
409
+ (400, "Bad Request"),
410
+ (401, "Unauthorized"),
411
+ (403, "Forbidden"),
412
+ (404, "Not Found"),
413
+ (500, "Internal Server Error"),
414
+ (502, "Bad Gateway"),
415
+ (503, "Service Unavailable"),
416
+ ];
417
+
418
+ for (code, _name) in status_codes {
419
+ let response = Response::with_status(None, code);
420
+ assert_eq!(response.status_code, code);
421
+ assert!(response.headers.is_empty());
422
+ }
423
+ }
424
+
425
+ #[test]
426
+ fn response_with_large_json_body() {
427
+ let mut items = vec![];
428
+ for i in 0..1000 {
429
+ items.push(json!({"id": i, "name": format!("item_{}", i)}));
430
+ }
431
+ let large_array = serde_json::Value::Array(items);
432
+ let response = Response::new(Some(large_array.clone()));
433
+ assert_eq!(response.status_code, 200);
434
+ assert_eq!(response.content, Some(large_array));
435
+ }
436
+
437
+ #[test]
438
+ fn response_with_deeply_nested_json() {
439
+ let nested = json!({
440
+ "level1": {
441
+ "level2": {
442
+ "level3": {
443
+ "level4": {
444
+ "level5": {
445
+ "data": "deeply nested value"
446
+ }
447
+ }
448
+ }
449
+ }
450
+ }
451
+ });
452
+ let response = Response::new(Some(nested.clone()));
453
+ assert_eq!(response.content, Some(nested));
454
+ }
455
+
456
+ #[test]
457
+ fn response_with_empty_json_object() {
458
+ let empty_obj = json!({});
459
+ let response = Response::new(Some(empty_obj.clone()));
460
+ assert_eq!(response.content, Some(empty_obj));
461
+ assert_ne!(response.content, None);
462
+ }
463
+
464
+ #[test]
465
+ fn response_with_empty_json_array() {
466
+ let empty_array = json!([]);
467
+ let response = Response::new(Some(empty_array.clone()));
468
+ assert_eq!(response.content, Some(empty_array));
469
+ assert_ne!(response.content, None);
470
+ }
471
+
472
+ #[test]
473
+ fn response_with_null_vs_none() {
474
+ let null_value = json!(null);
475
+ let response_with_null = Response::new(Some(null_value.clone()));
476
+ let response_with_none = Response::new(None);
477
+
478
+ assert_eq!(response_with_null.content, Some(null_value));
479
+ assert_eq!(response_with_none.content, None);
480
+ assert_ne!(response_with_null.content, response_with_none.content);
481
+ }
482
+
483
+ #[test]
484
+ fn response_with_json_primitives() {
485
+ let test_cases = vec![
486
+ json!(true),
487
+ json!(false),
488
+ json!(0),
489
+ json!(-1),
490
+ json!(42),
491
+ json!(3.14),
492
+ json!("string"),
493
+ json!(""),
494
+ ];
495
+
496
+ for test_value in test_cases {
497
+ let response = Response::new(Some(test_value.clone()));
498
+ assert_eq!(response.content, Some(test_value));
499
+ }
500
+ }
501
+
502
+ #[test]
503
+ fn response_header_case_sensitivity() {
504
+ let mut response = Response::new(None);
505
+ response.set_header("Content-Type".to_string(), "application/json".to_string());
506
+ response.set_header("content-type".to_string(), "text/plain".to_string());
507
+
508
+ assert_eq!(response.headers.len(), 2);
509
+ assert_eq!(
510
+ response.headers.get("Content-Type"),
511
+ Some(&"application/json".to_string())
512
+ );
513
+ assert_eq!(response.headers.get("content-type"), Some(&"text/plain".to_string()));
514
+ }
515
+
516
+ #[test]
517
+ fn response_header_with_empty_value() {
518
+ let mut response = Response::new(None);
519
+ response.set_header("X-Empty".to_string(), "".to_string());
520
+ assert_eq!(response.headers.get("X-Empty"), Some(&"".to_string()));
521
+ }
522
+
523
+ #[test]
524
+ fn response_header_with_special_chars() {
525
+ let mut response = Response::new(None);
526
+ response.set_header("X-Special".to_string(), "value; charset=utf-8".to_string());
527
+ assert_eq!(
528
+ response.headers.get("X-Special"),
529
+ Some(&"value; charset=utf-8".to_string())
530
+ );
531
+ }
532
+
533
+ #[test]
534
+ fn response_multiple_different_cookies() {
535
+ let mut response = Response::new(None);
536
+ response.set_cookie(
537
+ "session".to_string(),
538
+ "abc123".to_string(),
539
+ None,
540
+ None,
541
+ None,
542
+ false,
543
+ false,
544
+ None,
545
+ );
546
+ let cookie_count = response.headers.iter().filter(|(k, _)| *k == "set-cookie").count();
547
+ assert_eq!(cookie_count, 1);
548
+ }
549
+
550
+ #[test]
551
+ fn response_cookie_empty_value() {
552
+ let mut response = Response::new(None);
553
+ response.set_cookie(
554
+ "empty".to_string(),
555
+ "".to_string(),
556
+ None,
557
+ None,
558
+ None,
559
+ false,
560
+ false,
561
+ None,
562
+ );
563
+ let cookie = response.headers.get("set-cookie").unwrap();
564
+ assert_eq!(cookie, "empty=");
565
+ }
566
+
567
+ #[test]
568
+ fn response_cookie_with_equals_in_value() {
569
+ let mut response = Response::new(None);
570
+ response.set_cookie(
571
+ "data".to_string(),
572
+ "key=value&other=123".to_string(),
573
+ None,
574
+ None,
575
+ None,
576
+ false,
577
+ false,
578
+ None,
579
+ );
580
+ let cookie = response.headers.get("set-cookie").unwrap();
581
+ assert!(cookie.contains("key=value&other=123"));
582
+ }
583
+
584
+ #[test]
585
+ fn response_cookie_attribute_order() {
586
+ let mut response = Response::new(None);
587
+ response.set_cookie(
588
+ "test".to_string(),
589
+ "value".to_string(),
590
+ Some(3600),
591
+ Some("example.com".to_string()),
592
+ Some("/".to_string()),
593
+ true,
594
+ true,
595
+ Some("Strict".to_string()),
596
+ );
597
+ let cookie = response.headers.get("set-cookie").unwrap();
598
+
599
+ let parts: Vec<&str> = cookie.split("; ").collect();
600
+ assert_eq!(parts.len(), 7);
601
+ assert!(parts[0].starts_with("test="));
602
+ assert!(parts[1].starts_with("Max-Age="));
603
+ assert!(parts[2].starts_with("Domain="));
604
+ assert!(parts[3].starts_with("Path="));
605
+ assert_eq!(parts[4], "Secure");
606
+ assert_eq!(parts[5], "HttpOnly");
607
+ assert!(parts[6].starts_with("SameSite="));
608
+ }
609
+
610
+ #[test]
611
+ fn response_cookie_with_very_long_value() {
612
+ let mut response = Response::new(None);
613
+ let long_value = "x".repeat(4096);
614
+ response.set_cookie(
615
+ "long".to_string(),
616
+ long_value.clone(),
617
+ None,
618
+ None,
619
+ None,
620
+ false,
621
+ false,
622
+ None,
623
+ );
624
+ let cookie = response.headers.get("set-cookie").unwrap();
625
+ assert!(cookie.contains(&format!("long={}", long_value)));
626
+ }
627
+
628
+ #[test]
629
+ fn response_cookie_max_age_large_value() {
630
+ let mut response = Response::new(None);
631
+ let max_age_value = 86400 * 365;
632
+ response.set_cookie(
633
+ "session".to_string(),
634
+ "token".to_string(),
635
+ Some(max_age_value),
636
+ None,
637
+ None,
638
+ false,
639
+ false,
640
+ None,
641
+ );
642
+ let cookie = response.headers.get("set-cookie").unwrap();
643
+ assert!(cookie.contains(&format!("Max-Age={}", max_age_value)));
644
+ }
645
+
646
+ #[test]
647
+ fn response_status_code_informational() {
648
+ let response = Response::with_status(None, 100);
649
+ assert_eq!(response.status_code, 100);
650
+ }
651
+
652
+ #[test]
653
+ fn response_status_code_redirect_with_location() {
654
+ let mut response = Response::with_status(None, 301);
655
+ response.set_header("Location".to_string(), "https://example.com/new".to_string());
656
+ assert_eq!(response.status_code, 301);
657
+ assert_eq!(
658
+ response.headers.get("Location"),
659
+ Some(&"https://example.com/new".to_string())
660
+ );
661
+ }
662
+
663
+ #[test]
664
+ fn response_with_error_status_and_content() {
665
+ let error_content = json!({
666
+ "error": "Unauthorized",
667
+ "code": 401,
668
+ "message": "Invalid credentials"
669
+ });
670
+ let response = Response::with_status(Some(error_content.clone()), 401);
671
+ assert_eq!(response.status_code, 401);
672
+ assert_eq!(response.content, Some(error_content));
673
+ }
674
+
675
+ #[test]
676
+ fn response_clone_preserves_state() {
677
+ let mut original = Response::with_status(Some(json!({"key": "value"})), 202);
678
+ original.set_header("X-Custom".to_string(), "header-value".to_string());
679
+ original.set_cookie(
680
+ "session".to_string(),
681
+ "token".to_string(),
682
+ Some(3600),
683
+ None,
684
+ None,
685
+ true,
686
+ false,
687
+ None,
688
+ );
689
+
690
+ let cloned = original.clone();
691
+
692
+ assert_eq!(cloned.status_code, 202);
693
+ assert_eq!(cloned.content, original.content);
694
+ assert_eq!(cloned.headers, original.headers);
695
+ }
696
+
697
+ #[test]
698
+ fn response_with_numeric_status_boundaries() {
699
+ let boundary_codes = vec![1, 99, 100, 199, 200, 299, 300, 399, 400, 499, 500, 599, 600, 999, 65535];
700
+ for code in boundary_codes {
701
+ let response = Response::with_status(None, code);
702
+ assert_eq!(response.status_code, code);
703
+ }
704
+ }
705
+
706
+ #[test]
707
+ fn response_header_unicode_value() {
708
+ let mut response = Response::new(None);
709
+ response.set_header("X-Unicode".to_string(), "こんにちは".to_string());
710
+ assert_eq!(response.headers.get("X-Unicode"), Some(&"こんにちは".to_string()));
711
+ }
712
+
713
+ #[test]
714
+ fn response_debug_trait() {
715
+ let response = Response::with_status(Some(json!({"test": "data"})), 200);
716
+ let debug_str = format!("{:?}", response);
717
+ assert!(debug_str.contains("Response"));
718
+ assert!(debug_str.contains("200"));
719
+ }
720
+ }