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
@@ -0,0 +1,314 @@
1
+ #![allow(clippy::pedantic, clippy::nursery, clippy::all)]
2
+ //! Tests for ServerConfig builder with dependency injection
3
+
4
+ mod common;
5
+
6
+ #[cfg(feature = "di")]
7
+ mod di_builder_tests {
8
+ use spikard_core::di::ValueDependency;
9
+ use spikard_http::ServerConfig;
10
+ use std::sync::Arc;
11
+
12
+ #[test]
13
+ fn test_builder_basic() {
14
+ let config = ServerConfig::builder().port(3000).host("0.0.0.0").build();
15
+
16
+ assert_eq!(config.port, 3000);
17
+ assert_eq!(config.host, "0.0.0.0");
18
+ }
19
+
20
+ #[test]
21
+ fn test_provide_value() {
22
+ let config = ServerConfig::builder()
23
+ .provide_value("test", "value".to_string())
24
+ .build();
25
+
26
+ assert!(config.di_container.is_some());
27
+ let container = config.di_container.unwrap();
28
+
29
+ assert!(Arc::strong_count(&container) >= 1);
30
+ }
31
+
32
+ #[test]
33
+ fn test_provide_multiple_values() {
34
+ let config = ServerConfig::builder()
35
+ .provide_value("val1", 1)
36
+ .provide_value("val2", 2)
37
+ .provide_value("val3", "three".to_string())
38
+ .build();
39
+
40
+ assert!(config.di_container.is_some());
41
+ }
42
+
43
+ #[test]
44
+ fn test_provide_factory() {
45
+ let config = ServerConfig::builder()
46
+ .provide_factory("counter", |_resolved| async { Ok(42) })
47
+ .build();
48
+
49
+ assert!(config.di_container.is_some());
50
+ }
51
+
52
+ #[test]
53
+ fn test_provide_value_and_factory() {
54
+ let config = ServerConfig::builder()
55
+ .provide_value("base_value", 10)
56
+ .provide_factory("computed", |_resolved| async { Ok(100) })
57
+ .build();
58
+
59
+ assert!(config.di_container.is_some());
60
+ }
61
+
62
+ #[test]
63
+ fn test_provide_custom_dependency() {
64
+ let dep = ValueDependency::new("custom", "value".to_string());
65
+
66
+ let config = ServerConfig::builder().provide(Arc::new(dep)).build();
67
+
68
+ assert!(config.di_container.is_some());
69
+ }
70
+
71
+ #[test]
72
+ fn test_builder_chaining() {
73
+ let config = ServerConfig::builder()
74
+ .port(8080)
75
+ .host("localhost")
76
+ .enable_request_id(false)
77
+ .provide_value("app_name", "TestApp".to_string())
78
+ .provide_value("version", "1.0.0".to_string())
79
+ .build();
80
+
81
+ assert_eq!(config.port, 8080);
82
+ assert_eq!(config.host, "localhost");
83
+ assert!(!config.enable_request_id);
84
+ assert!(config.di_container.is_some());
85
+ }
86
+
87
+ #[test]
88
+ fn test_builder_with_all_options() {
89
+ use spikard_http::{BackgroundTaskConfig, CompressionConfig, RateLimitConfig};
90
+
91
+ let config = ServerConfig::builder()
92
+ .port(9000)
93
+ .host("127.0.0.1")
94
+ .workers(4)
95
+ .enable_request_id(true)
96
+ .max_body_size(Some(5 * 1024 * 1024))
97
+ .request_timeout(Some(60))
98
+ .compression(Some(CompressionConfig::default()))
99
+ .rate_limit(Some(RateLimitConfig::default()))
100
+ .graceful_shutdown(true)
101
+ .shutdown_timeout(30)
102
+ .background_tasks(BackgroundTaskConfig::default())
103
+ .provide_value("config_value", "test".to_string())
104
+ .build();
105
+
106
+ assert_eq!(config.port, 9000);
107
+ assert_eq!(config.host, "127.0.0.1");
108
+ assert_eq!(config.workers, 4);
109
+ assert!(config.enable_request_id);
110
+ assert_eq!(config.max_body_size, Some(5 * 1024 * 1024));
111
+ assert_eq!(config.request_timeout, Some(60));
112
+ assert!(config.compression.is_some());
113
+ assert!(config.rate_limit.is_some());
114
+ assert!(config.graceful_shutdown);
115
+ assert_eq!(config.shutdown_timeout, 30);
116
+ assert!(config.di_container.is_some());
117
+ }
118
+
119
+ #[test]
120
+ fn test_factory_with_dependencies() {
121
+ let config = ServerConfig::builder()
122
+ .provide_value("multiplier", 2)
123
+ .provide_factory("result", |resolved| {
124
+ let multiplier = resolved.get::<i32>("multiplier").map(|v| *v);
125
+ async move {
126
+ let mult = multiplier.ok_or("multiplier not found")?;
127
+ Ok(mult * 21)
128
+ }
129
+ })
130
+ .build();
131
+
132
+ assert!(config.di_container.is_some());
133
+ }
134
+
135
+ #[test]
136
+ fn test_builder_without_di() {
137
+ let config = ServerConfig::builder().port(3000).host("localhost").build();
138
+
139
+ assert_eq!(config.port, 3000);
140
+ assert_eq!(config.host, "localhost");
141
+ assert!(config.di_container.is_none());
142
+ }
143
+
144
+ #[test]
145
+ fn test_multiple_factories() {
146
+ let config = ServerConfig::builder()
147
+ .provide_factory("factory1", |_resolved| async { Ok(1) })
148
+ .provide_factory("factory2", |_resolved| async { Ok(2) })
149
+ .provide_factory("factory3", |_resolved| async { Ok(3) })
150
+ .build();
151
+
152
+ assert!(config.di_container.is_some());
153
+ }
154
+
155
+ #[test]
156
+ fn test_mixed_dependencies() {
157
+ let config = ServerConfig::builder()
158
+ .provide_value("static1", "value1".to_string())
159
+ .provide_factory("dynamic1", |_resolved| async { Ok("computed1".to_string()) })
160
+ .provide_value("static2", 42)
161
+ .provide_factory("dynamic2", |_resolved| async { Ok(100) })
162
+ .build();
163
+
164
+ assert!(config.di_container.is_some());
165
+ }
166
+
167
+ #[test]
168
+ fn test_type_inference() {
169
+ let config = ServerConfig::builder()
170
+ .provide_value("string", "test")
171
+ .provide_value("number", 42)
172
+ .provide_value("bool", true)
173
+ .provide_value("vec", vec![1, 2, 3])
174
+ .build();
175
+
176
+ assert!(config.di_container.is_some());
177
+ }
178
+
179
+ #[test]
180
+ fn test_builder_default() {
181
+ let builder = ServerConfig::builder();
182
+ let config = builder.build();
183
+
184
+ assert_eq!(config.port, 8000);
185
+ assert_eq!(config.host, "127.0.0.1");
186
+ assert_eq!(config.workers, 1);
187
+ assert!(!config.enable_request_id);
188
+ assert_eq!(config.max_body_size, Some(10 * 1024 * 1024));
189
+ assert_eq!(config.request_timeout, None);
190
+ assert!(config.graceful_shutdown);
191
+ assert_eq!(config.shutdown_timeout, 30);
192
+ }
193
+
194
+ #[test]
195
+ fn test_builder_override_defaults() {
196
+ let config = ServerConfig::builder()
197
+ .port(9999)
198
+ .enable_request_id(false)
199
+ .max_body_size(None)
200
+ .build();
201
+
202
+ assert_eq!(config.port, 9999);
203
+ assert!(!config.enable_request_id);
204
+ assert_eq!(config.max_body_size, None);
205
+ }
206
+
207
+ #[test]
208
+ fn test_provide_with_arc() {
209
+ let shared_value = Arc::new("shared".to_string());
210
+
211
+ let config = ServerConfig::builder()
212
+ .provide_value("shared", shared_value.clone())
213
+ .build();
214
+
215
+ assert!(config.di_container.is_some());
216
+ assert_eq!(*shared_value, "shared");
217
+ }
218
+ }
219
+
220
+ #[cfg(not(feature = "di"))]
221
+ mod no_di_tests {
222
+ use spikard_http::ServerConfig;
223
+
224
+ #[test]
225
+ fn test_builder_without_di_feature() {
226
+ let config = ServerConfig::builder().port(3000).host("localhost").build();
227
+
228
+ assert_eq!(config.port, 3000);
229
+ assert_eq!(config.host, "localhost");
230
+ }
231
+ }
232
+
233
+ /// Integration tests for common test handlers
234
+ ///
235
+ /// These tests verify that the mock handlers in common module work correctly
236
+ /// and can be used for testing HTTP server components.
237
+ mod common_handler_tests {
238
+ use crate::common::handlers::{EchoHandler, ErrorHandler, JsonHandler, SuccessHandler};
239
+ use axum::body::Body;
240
+ use axum::http::Request;
241
+ use serde_json::json;
242
+ use spikard_http::{Handler, RequestData};
243
+ use std::collections::HashMap;
244
+ use std::sync::Arc;
245
+
246
+ fn create_test_request_data() -> RequestData {
247
+ RequestData {
248
+ path_params: Arc::new(HashMap::new()),
249
+ query_params: serde_json::Value::Null,
250
+ validated_params: None,
251
+ raw_query_params: Arc::new(HashMap::new()),
252
+ body: json!({"test": "data"}),
253
+ raw_body: None,
254
+ headers: Arc::new(HashMap::new()),
255
+ cookies: Arc::new(HashMap::new()),
256
+ method: "GET".to_string(),
257
+ path: "/test".to_string(),
258
+ #[cfg(feature = "di")]
259
+ dependencies: None,
260
+ }
261
+ }
262
+
263
+ #[tokio::test]
264
+ async fn test_success_handler_integration() {
265
+ let handler = SuccessHandler;
266
+ let request = Request::builder().body(Body::empty()).unwrap();
267
+ let request_data = create_test_request_data();
268
+
269
+ let result = handler.call(request, request_data).await;
270
+ assert!(result.is_ok(), "SuccessHandler should return Ok response");
271
+ }
272
+
273
+ #[tokio::test]
274
+ async fn test_error_handler_integration() {
275
+ let handler = ErrorHandler;
276
+ let request = Request::builder().body(Body::empty()).unwrap();
277
+ let request_data = create_test_request_data();
278
+
279
+ let result = handler.call(request, request_data).await;
280
+ assert!(result.is_err(), "ErrorHandler should return Err response");
281
+ }
282
+
283
+ #[tokio::test]
284
+ async fn test_echo_handler_integration() {
285
+ let handler = EchoHandler;
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(), "EchoHandler should return Ok response");
291
+ }
292
+
293
+ #[tokio::test]
294
+ async fn test_json_handler_ok_integration() {
295
+ let body = json!({"status": "ok", "data": [1, 2, 3]});
296
+ let handler = JsonHandler::ok(body);
297
+ let request = Request::builder().body(Body::empty()).unwrap();
298
+ let request_data = create_test_request_data();
299
+
300
+ let result = handler.call(request, request_data).await;
301
+ assert!(result.is_ok(), "JsonHandler::ok should return Ok response");
302
+ }
303
+
304
+ #[tokio::test]
305
+ async fn test_json_handler_created_integration() {
306
+ let body = json!({"id": 123, "created": true});
307
+ let handler = JsonHandler::created(body);
308
+ let request = Request::builder().body(Body::empty()).unwrap();
309
+ let request_data = create_test_request_data();
310
+
311
+ let result = handler.call(request, request_data).await;
312
+ assert!(result.is_ok(), "JsonHandler::created should return Ok response");
313
+ }
314
+ }