spikard 0.5.0 → 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 (135) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +1 -1
  3. data/README.md +674 -674
  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 -405
  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 -256
  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 -63
  24. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -132
  25. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -752
  26. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -194
  27. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -246
  28. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -401
  29. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -238
  30. data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -24
  31. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -292
  32. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -616
  33. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -305
  34. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -248
  35. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -351
  36. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -454
  37. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -383
  38. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -280
  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 -127
  43. data/vendor/crates/spikard-core/src/di/container.rs +702 -702
  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 -534
  47. data/vendor/crates/spikard-core/src/di/graph.rs +506 -506
  48. data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
  49. data/vendor/crates/spikard-core/src/di/resolved.rs +405 -405
  50. data/vendor/crates/spikard-core/src/di/value.rs +281 -281
  51. data/vendor/crates/spikard-core/src/errors.rs +69 -69
  52. data/vendor/crates/spikard-core/src/http.rs +415 -415
  53. data/vendor/crates/spikard-core/src/lib.rs +29 -29
  54. data/vendor/crates/spikard-core/src/lifecycle.rs +1186 -1186
  55. data/vendor/crates/spikard-core/src/metadata.rs +389 -389
  56. data/vendor/crates/spikard-core/src/parameters.rs +2525 -2525
  57. data/vendor/crates/spikard-core/src/problem.rs +344 -344
  58. data/vendor/crates/spikard-core/src/request_data.rs +1154 -1154
  59. data/vendor/crates/spikard-core/src/router.rs +510 -510
  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 -688
  63. data/vendor/crates/spikard-core/src/validation/mod.rs +457 -457
  64. data/vendor/crates/spikard-http/Cargo.toml +62 -64
  65. data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -148
  66. data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -92
  67. data/vendor/crates/spikard-http/src/auth.rs +296 -296
  68. data/vendor/crates/spikard-http/src/background.rs +1860 -1860
  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 -1005
  73. data/vendor/crates/spikard-http/src/debug.rs +128 -128
  74. data/vendor/crates/spikard-http/src/di_handler.rs +1668 -1668
  75. data/vendor/crates/spikard-http/src/handler_response.rs +901 -901
  76. data/vendor/crates/spikard-http/src/handler_trait.rs +838 -830
  77. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +290 -290
  78. data/vendor/crates/spikard-http/src/lib.rs +534 -534
  79. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +230 -230
  80. data/vendor/crates/spikard-http/src/lifecycle.rs +1193 -1193
  81. data/vendor/crates/spikard-http/src/middleware/mod.rs +560 -540
  82. data/vendor/crates/spikard-http/src/middleware/multipart.rs +912 -912
  83. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +513 -513
  84. data/vendor/crates/spikard-http/src/middleware/validation.rs +768 -735
  85. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
  86. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -535
  87. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1363 -1363
  88. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +665 -665
  89. data/vendor/crates/spikard-http/src/query_parser.rs +793 -793
  90. data/vendor/crates/spikard-http/src/response.rs +720 -720
  91. data/vendor/crates/spikard-http/src/server/handler.rs +1650 -1650
  92. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +234 -234
  93. data/vendor/crates/spikard-http/src/server/mod.rs +1593 -1502
  94. data/vendor/crates/spikard-http/src/server/request_extraction.rs +789 -770
  95. data/vendor/crates/spikard-http/src/server/routing_factory.rs +629 -599
  96. data/vendor/crates/spikard-http/src/sse.rs +1409 -1409
  97. data/vendor/crates/spikard-http/src/testing/form.rs +52 -52
  98. data/vendor/crates/spikard-http/src/testing/multipart.rs +64 -60
  99. data/vendor/crates/spikard-http/src/testing/test_client.rs +311 -283
  100. data/vendor/crates/spikard-http/src/testing.rs +406 -377
  101. data/vendor/crates/spikard-http/src/websocket.rs +1404 -1375
  102. data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -832
  103. data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -309
  104. data/vendor/crates/spikard-http/tests/common/mod.rs +26 -26
  105. data/vendor/crates/spikard-http/tests/di_integration.rs +192 -192
  106. data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -5
  107. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -1093
  108. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -656
  109. data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -314
  110. data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -620
  111. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -663
  112. data/vendor/crates/spikard-rb/Cargo.toml +48 -48
  113. data/vendor/crates/spikard-rb/build.rs +199 -199
  114. data/vendor/crates/spikard-rb/src/background.rs +63 -63
  115. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -5
  116. data/vendor/crates/spikard-rb/src/config/server_config.rs +285 -285
  117. data/vendor/crates/spikard-rb/src/conversion.rs +554 -554
  118. data/vendor/crates/spikard-rb/src/di/builder.rs +100 -100
  119. data/vendor/crates/spikard-rb/src/di/mod.rs +375 -375
  120. data/vendor/crates/spikard-rb/src/handler.rs +618 -618
  121. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -3
  122. data/vendor/crates/spikard-rb/src/lib.rs +1806 -1810
  123. data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -275
  124. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -5
  125. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +442 -447
  126. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -5
  127. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -324
  128. data/vendor/crates/spikard-rb/src/server.rs +305 -308
  129. data/vendor/crates/spikard-rb/src/sse.rs +231 -231
  130. data/vendor/crates/spikard-rb/src/testing/client.rs +538 -551
  131. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -7
  132. data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -143
  133. data/vendor/crates/spikard-rb/src/testing/websocket.rs +608 -635
  134. data/vendor/crates/spikard-rb/src/websocket.rs +377 -374
  135. metadata +15 -1
@@ -1,309 +1,309 @@
1
- //! Standard mock handlers for testing
2
- //!
3
- //! This module provides reusable mock handler implementations that cover common
4
- //! test scenarios without requiring language bindings. All handlers implement the
5
- //! Handler trait and are suitable for integration testing.
6
-
7
- use axum::body::Body;
8
- use axum::http::{Request, Response, StatusCode};
9
- use serde_json::json;
10
- use spikard_http::{Handler, HandlerResult, RequestData};
11
- use std::future::Future;
12
- use std::pin::Pin;
13
-
14
- /// Handler that always returns 200 OK with plain text response
15
- ///
16
- /// Useful for testing basic handler execution and middleware chains.
17
- ///
18
- /// # Example
19
- ///
20
- /// ```ignore
21
- /// let handler = SuccessHandler;
22
- /// assert_eq!(handler.call(request, request_data).await.is_ok(), true);
23
- /// ```
24
- pub struct SuccessHandler;
25
-
26
- impl Handler for SuccessHandler {
27
- fn call(
28
- &self,
29
- _request: Request<Body>,
30
- _request_data: RequestData,
31
- ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
32
- Box::pin(async move {
33
- let response = Response::builder()
34
- .status(StatusCode::OK)
35
- .header("content-type", "text/plain")
36
- .body(Body::from("OK"))
37
- .unwrap();
38
- Ok(response)
39
- })
40
- }
41
- }
42
-
43
- /// Handler that always returns 400 Bad Request with error message
44
- ///
45
- /// Useful for testing error handling in middleware and response processing.
46
- ///
47
- /// # Example
48
- ///
49
- /// ```ignore
50
- /// let handler = ErrorHandler;
51
- /// assert_eq!(handler.call(request, request_data).await.is_err(), true);
52
- /// ```
53
- pub struct ErrorHandler;
54
-
55
- impl Handler for ErrorHandler {
56
- fn call(
57
- &self,
58
- _request: Request<Body>,
59
- _request_data: RequestData,
60
- ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
61
- Box::pin(async move { Err((StatusCode::BAD_REQUEST, "Bad Request".to_string())) })
62
- }
63
- }
64
-
65
- /// Handler that intentionally panics during execution
66
- ///
67
- /// Useful for testing panic recovery and error handling in the HTTP server.
68
- /// This handler demonstrates that panics in handlers should be caught and
69
- /// converted to HTTP error responses.
70
- ///
71
- /// # Example
72
- ///
73
- /// ```ignore
74
- /// let handler = PanicHandler;
75
- /// // This will panic, should be caught by server middleware
76
- /// ```
77
- pub struct PanicHandler;
78
-
79
- impl Handler for PanicHandler {
80
- fn call(
81
- &self,
82
- _request: Request<Body>,
83
- _request_data: RequestData,
84
- ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
85
- Box::pin(async move {
86
- panic!("Intentional panic for testing");
87
- })
88
- }
89
- }
90
-
91
- /// Handler that echoes the request body back as response
92
- ///
93
- /// Useful for testing request body parsing and serialization/deserialization.
94
- /// The response will be a JSON object containing the received body.
95
- ///
96
- /// # Example
97
- ///
98
- /// ```ignore
99
- /// let handler = EchoHandler;
100
- /// // Request with body {"key": "value"} returns same body
101
- /// ```
102
- pub struct EchoHandler;
103
-
104
- impl Handler for EchoHandler {
105
- fn call(
106
- &self,
107
- _request: Request<Body>,
108
- request_data: RequestData,
109
- ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
110
- Box::pin(async move {
111
- let response = Response::builder()
112
- .status(StatusCode::OK)
113
- .header("content-type", "application/json")
114
- .body(Body::from(request_data.body.to_string()))
115
- .unwrap();
116
- Ok(response)
117
- })
118
- }
119
- }
120
-
121
- /// Handler that returns a JSON response with configurable status code and body
122
- ///
123
- /// Useful for testing content negotiation and JSON serialization.
124
- /// The response body is configurable via the `body` field, and the status code
125
- /// via the `status_code` field.
126
- ///
127
- /// # Example
128
- ///
129
- /// ```ignore
130
- /// let handler = JsonHandler {
131
- /// status_code: StatusCode::CREATED,
132
- /// body: json!({"id": 1, "name": "test"}),
133
- /// };
134
- /// ```
135
- pub struct JsonHandler {
136
- /// HTTP status code for the response
137
- pub status_code: StatusCode,
138
- /// JSON body to return in response
139
- pub body: serde_json::Value,
140
- }
141
-
142
- impl JsonHandler {
143
- /// Create a new JSON handler with given status code and body
144
- pub fn new(status_code: StatusCode, body: serde_json::Value) -> Self {
145
- Self { status_code, body }
146
- }
147
-
148
- /// Create a JSON handler with 200 OK status
149
- pub fn ok(body: serde_json::Value) -> Self {
150
- Self {
151
- status_code: StatusCode::OK,
152
- body,
153
- }
154
- }
155
-
156
- /// Create a JSON handler with 201 Created status
157
- pub fn created(body: serde_json::Value) -> Self {
158
- Self {
159
- status_code: StatusCode::CREATED,
160
- body,
161
- }
162
- }
163
-
164
- /// Create a JSON handler with 400 Bad Request status
165
- pub fn bad_request(body: serde_json::Value) -> Self {
166
- Self {
167
- status_code: StatusCode::BAD_REQUEST,
168
- body,
169
- }
170
- }
171
-
172
- /// Create a JSON handler with 500 Internal Server Error status
173
- pub fn server_error(body: serde_json::Value) -> Self {
174
- Self {
175
- status_code: StatusCode::INTERNAL_SERVER_ERROR,
176
- body,
177
- }
178
- }
179
- }
180
-
181
- impl Handler for JsonHandler {
182
- fn call(
183
- &self,
184
- _request: Request<Body>,
185
- _request_data: RequestData,
186
- ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
187
- let status_code = self.status_code;
188
- let body = self.body.clone();
189
-
190
- Box::pin(async move {
191
- let response = Response::builder()
192
- .status(status_code)
193
- .header("content-type", "application/json")
194
- .body(Body::from(body.to_string()))
195
- .unwrap();
196
- Ok(response)
197
- })
198
- }
199
- }
200
-
201
- #[cfg(test)]
202
- mod tests {
203
- use super::*;
204
- use std::collections::HashMap;
205
- use std::sync::Arc;
206
-
207
- fn create_test_request_data() -> RequestData {
208
- RequestData {
209
- path_params: Arc::new(HashMap::new()),
210
- query_params: serde_json::Value::Null,
211
- validated_params: None,
212
- raw_query_params: Arc::new(HashMap::new()),
213
- body: json!({"test": "data"}),
214
- raw_body: None,
215
- headers: Arc::new(HashMap::new()),
216
- cookies: Arc::new(HashMap::new()),
217
- method: "GET".to_string(),
218
- path: "/test".to_string(),
219
- #[cfg(feature = "di")]
220
- dependencies: None,
221
- }
222
- }
223
-
224
- #[tokio::test]
225
- async fn test_success_handler() {
226
- let handler = SuccessHandler;
227
- let request = Request::builder().body(Body::empty()).unwrap();
228
- let request_data = create_test_request_data();
229
-
230
- let result = handler.call(request, request_data).await;
231
- assert!(result.is_ok());
232
-
233
- let response = result.unwrap();
234
- assert_eq!(response.status(), StatusCode::OK);
235
- }
236
-
237
- #[tokio::test]
238
- async fn test_error_handler() {
239
- let handler = ErrorHandler;
240
- let request = Request::builder().body(Body::empty()).unwrap();
241
- let request_data = create_test_request_data();
242
-
243
- let result = handler.call(request, request_data).await;
244
- assert!(result.is_err());
245
-
246
- let (status, msg) = result.unwrap_err();
247
- assert_eq!(status, StatusCode::BAD_REQUEST);
248
- assert_eq!(msg, "Bad Request");
249
- }
250
-
251
- #[tokio::test]
252
- async fn test_echo_handler() {
253
- let handler = EchoHandler;
254
- let request = Request::builder().body(Body::empty()).unwrap();
255
- let request_data = create_test_request_data();
256
-
257
- let result = handler.call(request, request_data.clone()).await;
258
- assert!(result.is_ok());
259
-
260
- let response = result.unwrap();
261
- assert_eq!(response.status(), StatusCode::OK);
262
- assert_eq!(
263
- response.headers().get("content-type").unwrap().to_str().unwrap(),
264
- "application/json"
265
- );
266
- }
267
-
268
- #[tokio::test]
269
- async fn test_json_handler_ok() {
270
- let body = json!({"id": 1, "name": "test"});
271
- let handler = JsonHandler::ok(body.clone());
272
- let request = Request::builder().body(Body::empty()).unwrap();
273
- let request_data = create_test_request_data();
274
-
275
- let result = handler.call(request, request_data).await;
276
- assert!(result.is_ok());
277
-
278
- let response = result.unwrap();
279
- assert_eq!(response.status(), StatusCode::OK);
280
- }
281
-
282
- #[tokio::test]
283
- async fn test_json_handler_created() {
284
- let body = json!({"id": 1});
285
- let handler = JsonHandler::created(body);
286
- let request = Request::builder().body(Body::empty()).unwrap();
287
- let request_data = create_test_request_data();
288
-
289
- let result = handler.call(request, request_data).await;
290
- assert!(result.is_ok());
291
-
292
- let response = result.unwrap();
293
- assert_eq!(response.status(), StatusCode::CREATED);
294
- }
295
-
296
- #[tokio::test]
297
- async fn test_json_handler_custom() {
298
- let body = json!({"error": "Custom error"});
299
- let handler = JsonHandler::new(StatusCode::NOT_FOUND, body);
300
- let request = Request::builder().body(Body::empty()).unwrap();
301
- let request_data = create_test_request_data();
302
-
303
- let result = handler.call(request, request_data).await;
304
- assert!(result.is_ok());
305
-
306
- let response = result.unwrap();
307
- assert_eq!(response.status(), StatusCode::NOT_FOUND);
308
- }
309
- }
1
+ //! Standard mock handlers for testing
2
+ //!
3
+ //! This module provides reusable mock handler implementations that cover common
4
+ //! test scenarios without requiring language bindings. All handlers implement the
5
+ //! Handler trait and are suitable for integration testing.
6
+
7
+ use axum::body::Body;
8
+ use axum::http::{Request, Response, StatusCode};
9
+ use serde_json::json;
10
+ use spikard_http::{Handler, HandlerResult, RequestData};
11
+ use std::future::Future;
12
+ use std::pin::Pin;
13
+
14
+ /// Handler that always returns 200 OK with plain text response
15
+ ///
16
+ /// Useful for testing basic handler execution and middleware chains.
17
+ ///
18
+ /// # Example
19
+ ///
20
+ /// ```ignore
21
+ /// let handler = SuccessHandler;
22
+ /// assert_eq!(handler.call(request, request_data).await.is_ok(), true);
23
+ /// ```
24
+ pub struct SuccessHandler;
25
+
26
+ impl Handler for SuccessHandler {
27
+ fn call(
28
+ &self,
29
+ _request: Request<Body>,
30
+ _request_data: RequestData,
31
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
32
+ Box::pin(async move {
33
+ let response = Response::builder()
34
+ .status(StatusCode::OK)
35
+ .header("content-type", "text/plain")
36
+ .body(Body::from("OK"))
37
+ .unwrap();
38
+ Ok(response)
39
+ })
40
+ }
41
+ }
42
+
43
+ /// Handler that always returns 400 Bad Request with error message
44
+ ///
45
+ /// Useful for testing error handling in middleware and response processing.
46
+ ///
47
+ /// # Example
48
+ ///
49
+ /// ```ignore
50
+ /// let handler = ErrorHandler;
51
+ /// assert_eq!(handler.call(request, request_data).await.is_err(), true);
52
+ /// ```
53
+ pub struct ErrorHandler;
54
+
55
+ impl Handler for ErrorHandler {
56
+ fn call(
57
+ &self,
58
+ _request: Request<Body>,
59
+ _request_data: RequestData,
60
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
61
+ Box::pin(async move { Err((StatusCode::BAD_REQUEST, "Bad Request".to_string())) })
62
+ }
63
+ }
64
+
65
+ /// Handler that intentionally panics during execution
66
+ ///
67
+ /// Useful for testing panic recovery and error handling in the HTTP server.
68
+ /// This handler demonstrates that panics in handlers should be caught and
69
+ /// converted to HTTP error responses.
70
+ ///
71
+ /// # Example
72
+ ///
73
+ /// ```ignore
74
+ /// let handler = PanicHandler;
75
+ /// // This will panic, should be caught by server middleware
76
+ /// ```
77
+ pub struct PanicHandler;
78
+
79
+ impl Handler for PanicHandler {
80
+ fn call(
81
+ &self,
82
+ _request: Request<Body>,
83
+ _request_data: RequestData,
84
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
85
+ Box::pin(async move {
86
+ panic!("Intentional panic for testing");
87
+ })
88
+ }
89
+ }
90
+
91
+ /// Handler that echoes the request body back as response
92
+ ///
93
+ /// Useful for testing request body parsing and serialization/deserialization.
94
+ /// The response will be a JSON object containing the received body.
95
+ ///
96
+ /// # Example
97
+ ///
98
+ /// ```ignore
99
+ /// let handler = EchoHandler;
100
+ /// // Request with body {"key": "value"} returns same body
101
+ /// ```
102
+ pub struct EchoHandler;
103
+
104
+ impl Handler for EchoHandler {
105
+ fn call(
106
+ &self,
107
+ _request: Request<Body>,
108
+ request_data: RequestData,
109
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
110
+ Box::pin(async move {
111
+ let response = Response::builder()
112
+ .status(StatusCode::OK)
113
+ .header("content-type", "application/json")
114
+ .body(Body::from(request_data.body.to_string()))
115
+ .unwrap();
116
+ Ok(response)
117
+ })
118
+ }
119
+ }
120
+
121
+ /// Handler that returns a JSON response with configurable status code and body
122
+ ///
123
+ /// Useful for testing content negotiation and JSON serialization.
124
+ /// The response body is configurable via the `body` field, and the status code
125
+ /// via the `status_code` field.
126
+ ///
127
+ /// # Example
128
+ ///
129
+ /// ```ignore
130
+ /// let handler = JsonHandler {
131
+ /// status_code: StatusCode::CREATED,
132
+ /// body: json!({"id": 1, "name": "test"}),
133
+ /// };
134
+ /// ```
135
+ pub struct JsonHandler {
136
+ /// HTTP status code for the response
137
+ pub status_code: StatusCode,
138
+ /// JSON body to return in response
139
+ pub body: serde_json::Value,
140
+ }
141
+
142
+ impl JsonHandler {
143
+ /// Create a new JSON handler with given status code and body
144
+ pub fn new(status_code: StatusCode, body: serde_json::Value) -> Self {
145
+ Self { status_code, body }
146
+ }
147
+
148
+ /// Create a JSON handler with 200 OK status
149
+ pub fn ok(body: serde_json::Value) -> Self {
150
+ Self {
151
+ status_code: StatusCode::OK,
152
+ body,
153
+ }
154
+ }
155
+
156
+ /// Create a JSON handler with 201 Created status
157
+ pub fn created(body: serde_json::Value) -> Self {
158
+ Self {
159
+ status_code: StatusCode::CREATED,
160
+ body,
161
+ }
162
+ }
163
+
164
+ /// Create a JSON handler with 400 Bad Request status
165
+ pub fn bad_request(body: serde_json::Value) -> Self {
166
+ Self {
167
+ status_code: StatusCode::BAD_REQUEST,
168
+ body,
169
+ }
170
+ }
171
+
172
+ /// Create a JSON handler with 500 Internal Server Error status
173
+ pub fn server_error(body: serde_json::Value) -> Self {
174
+ Self {
175
+ status_code: StatusCode::INTERNAL_SERVER_ERROR,
176
+ body,
177
+ }
178
+ }
179
+ }
180
+
181
+ impl Handler for JsonHandler {
182
+ fn call(
183
+ &self,
184
+ _request: Request<Body>,
185
+ _request_data: RequestData,
186
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
187
+ let status_code = self.status_code;
188
+ let body = self.body.clone();
189
+
190
+ Box::pin(async move {
191
+ let response = Response::builder()
192
+ .status(status_code)
193
+ .header("content-type", "application/json")
194
+ .body(Body::from(body.to_string()))
195
+ .unwrap();
196
+ Ok(response)
197
+ })
198
+ }
199
+ }
200
+
201
+ #[cfg(test)]
202
+ mod tests {
203
+ use super::*;
204
+ use std::collections::HashMap;
205
+ use std::sync::Arc;
206
+
207
+ fn create_test_request_data() -> RequestData {
208
+ RequestData {
209
+ path_params: Arc::new(HashMap::new()),
210
+ query_params: serde_json::Value::Null,
211
+ validated_params: None,
212
+ raw_query_params: Arc::new(HashMap::new()),
213
+ body: json!({"test": "data"}),
214
+ raw_body: None,
215
+ headers: Arc::new(HashMap::new()),
216
+ cookies: Arc::new(HashMap::new()),
217
+ method: "GET".to_string(),
218
+ path: "/test".to_string(),
219
+ #[cfg(feature = "di")]
220
+ dependencies: None,
221
+ }
222
+ }
223
+
224
+ #[tokio::test]
225
+ async fn test_success_handler() {
226
+ let handler = SuccessHandler;
227
+ let request = Request::builder().body(Body::empty()).unwrap();
228
+ let request_data = create_test_request_data();
229
+
230
+ let result = handler.call(request, request_data).await;
231
+ assert!(result.is_ok());
232
+
233
+ let response = result.unwrap();
234
+ assert_eq!(response.status(), StatusCode::OK);
235
+ }
236
+
237
+ #[tokio::test]
238
+ async fn test_error_handler() {
239
+ let handler = ErrorHandler;
240
+ let request = Request::builder().body(Body::empty()).unwrap();
241
+ let request_data = create_test_request_data();
242
+
243
+ let result = handler.call(request, request_data).await;
244
+ assert!(result.is_err());
245
+
246
+ let (status, msg) = result.unwrap_err();
247
+ assert_eq!(status, StatusCode::BAD_REQUEST);
248
+ assert_eq!(msg, "Bad Request");
249
+ }
250
+
251
+ #[tokio::test]
252
+ async fn test_echo_handler() {
253
+ let handler = EchoHandler;
254
+ let request = Request::builder().body(Body::empty()).unwrap();
255
+ let request_data = create_test_request_data();
256
+
257
+ let result = handler.call(request, request_data.clone()).await;
258
+ assert!(result.is_ok());
259
+
260
+ let response = result.unwrap();
261
+ assert_eq!(response.status(), StatusCode::OK);
262
+ assert_eq!(
263
+ response.headers().get("content-type").unwrap().to_str().unwrap(),
264
+ "application/json"
265
+ );
266
+ }
267
+
268
+ #[tokio::test]
269
+ async fn test_json_handler_ok() {
270
+ let body = json!({"id": 1, "name": "test"});
271
+ let handler = JsonHandler::ok(body.clone());
272
+ let request = Request::builder().body(Body::empty()).unwrap();
273
+ let request_data = create_test_request_data();
274
+
275
+ let result = handler.call(request, request_data).await;
276
+ assert!(result.is_ok());
277
+
278
+ let response = result.unwrap();
279
+ assert_eq!(response.status(), StatusCode::OK);
280
+ }
281
+
282
+ #[tokio::test]
283
+ async fn test_json_handler_created() {
284
+ let body = json!({"id": 1});
285
+ let handler = JsonHandler::created(body);
286
+ let request = Request::builder().body(Body::empty()).unwrap();
287
+ let request_data = create_test_request_data();
288
+
289
+ let result = handler.call(request, request_data).await;
290
+ assert!(result.is_ok());
291
+
292
+ let response = result.unwrap();
293
+ assert_eq!(response.status(), StatusCode::CREATED);
294
+ }
295
+
296
+ #[tokio::test]
297
+ async fn test_json_handler_custom() {
298
+ let body = json!({"error": "Custom error"});
299
+ let handler = JsonHandler::new(StatusCode::NOT_FOUND, body);
300
+ let request = Request::builder().body(Body::empty()).unwrap();
301
+ let request_data = create_test_request_data();
302
+
303
+ let result = handler.call(request, request_data).await;
304
+ assert!(result.is_ok());
305
+
306
+ let response = result.unwrap();
307
+ assert_eq!(response.status(), StatusCode::NOT_FOUND);
308
+ }
309
+ }
@@ -1,26 +1,26 @@
1
- //! Common test utilities for spikard-http tests
2
- //!
3
- //! This module provides reusable test fixtures and mock handlers that implement
4
- //! the Handler trait for testing various scenarios without requiring language bindings.
5
- //!
6
- //! # Examples
7
- //!
8
- //! ```ignore
9
- //! use common::handlers::SuccessHandler;
10
- //! use common::test_builders::{HandlerBuilder, RequestBuilder};
11
- //! use spikard_http::Handler;
12
- //!
13
- //! let handler = SuccessHandler;
14
- //! let fluent_handler = HandlerBuilder::new().status(200).build();
15
- //! // Use in tests...
16
- //! ```
17
-
18
- #![allow(dead_code)]
19
-
20
- pub mod handlers;
21
- pub mod test_builders;
22
-
23
- #[allow(unused_imports)]
24
- pub use handlers::{EchoHandler, ErrorHandler, JsonHandler, PanicHandler, SuccessHandler};
25
- #[allow(unused_imports)]
26
- pub use test_builders::{HandlerBuilder, RequestBuilder, assert_status, load_fixture, parse_json_body};
1
+ //! Common test utilities for spikard-http tests
2
+ //!
3
+ //! This module provides reusable test fixtures and mock handlers that implement
4
+ //! the Handler trait for testing various scenarios without requiring language bindings.
5
+ //!
6
+ //! # Examples
7
+ //!
8
+ //! ```ignore
9
+ //! use common::handlers::SuccessHandler;
10
+ //! use common::test_builders::{HandlerBuilder, RequestBuilder};
11
+ //! use spikard_http::Handler;
12
+ //!
13
+ //! let handler = SuccessHandler;
14
+ //! let fluent_handler = HandlerBuilder::new().status(200).build();
15
+ //! // Use in tests...
16
+ //! ```
17
+
18
+ #![allow(dead_code)]
19
+
20
+ pub mod handlers;
21
+ pub mod test_builders;
22
+
23
+ #[allow(unused_imports)]
24
+ pub use handlers::{EchoHandler, ErrorHandler, JsonHandler, PanicHandler, SuccessHandler};
25
+ #[allow(unused_imports)]
26
+ pub use test_builders::{HandlerBuilder, RequestBuilder, assert_status, load_fixture, parse_json_body};