spikard 0.3.6 → 0.5.0

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 (113) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +21 -6
  3. data/ext/spikard_rb/Cargo.toml +2 -2
  4. data/lib/spikard/app.rb +33 -14
  5. data/lib/spikard/testing.rb +47 -12
  6. data/lib/spikard/version.rb +1 -1
  7. data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -0
  8. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -0
  9. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -0
  10. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
  11. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
  12. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -0
  13. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -0
  14. data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -0
  15. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -0
  16. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -0
  17. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -0
  18. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
  19. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -0
  20. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -0
  21. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -0
  22. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -0
  23. data/vendor/crates/spikard-core/Cargo.toml +4 -4
  24. data/vendor/crates/spikard-core/src/debug.rs +64 -0
  25. data/vendor/crates/spikard-core/src/di/container.rs +3 -27
  26. data/vendor/crates/spikard-core/src/di/factory.rs +1 -5
  27. data/vendor/crates/spikard-core/src/di/graph.rs +8 -47
  28. data/vendor/crates/spikard-core/src/di/mod.rs +1 -1
  29. data/vendor/crates/spikard-core/src/di/resolved.rs +1 -7
  30. data/vendor/crates/spikard-core/src/di/value.rs +2 -4
  31. data/vendor/crates/spikard-core/src/errors.rs +30 -0
  32. data/vendor/crates/spikard-core/src/http.rs +262 -0
  33. data/vendor/crates/spikard-core/src/lib.rs +1 -1
  34. data/vendor/crates/spikard-core/src/lifecycle.rs +764 -0
  35. data/vendor/crates/spikard-core/src/metadata.rs +389 -0
  36. data/vendor/crates/spikard-core/src/parameters.rs +1962 -159
  37. data/vendor/crates/spikard-core/src/problem.rs +34 -0
  38. data/vendor/crates/spikard-core/src/request_data.rs +966 -1
  39. data/vendor/crates/spikard-core/src/router.rs +263 -2
  40. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +688 -0
  41. data/vendor/crates/spikard-core/src/{validation.rs → validation/mod.rs} +26 -268
  42. data/vendor/crates/spikard-http/Cargo.toml +12 -16
  43. data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -0
  44. data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -0
  45. data/vendor/crates/spikard-http/src/auth.rs +65 -16
  46. data/vendor/crates/spikard-http/src/background.rs +1614 -3
  47. data/vendor/crates/spikard-http/src/cors.rs +515 -0
  48. data/vendor/crates/spikard-http/src/debug.rs +65 -0
  49. data/vendor/crates/spikard-http/src/di_handler.rs +1322 -77
  50. data/vendor/crates/spikard-http/src/handler_response.rs +711 -0
  51. data/vendor/crates/spikard-http/src/handler_trait.rs +607 -5
  52. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +6 -0
  53. data/vendor/crates/spikard-http/src/lib.rs +33 -28
  54. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +81 -0
  55. data/vendor/crates/spikard-http/src/lifecycle.rs +765 -0
  56. data/vendor/crates/spikard-http/src/middleware/mod.rs +372 -117
  57. data/vendor/crates/spikard-http/src/middleware/multipart.rs +836 -10
  58. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +409 -43
  59. data/vendor/crates/spikard-http/src/middleware/validation.rs +513 -65
  60. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +345 -0
  61. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1055 -0
  62. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +473 -3
  63. data/vendor/crates/spikard-http/src/query_parser.rs +455 -31
  64. data/vendor/crates/spikard-http/src/response.rs +321 -0
  65. data/vendor/crates/spikard-http/src/server/handler.rs +1572 -9
  66. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +136 -0
  67. data/vendor/crates/spikard-http/src/server/mod.rs +875 -178
  68. data/vendor/crates/spikard-http/src/server/request_extraction.rs +674 -23
  69. data/vendor/crates/spikard-http/src/server/routing_factory.rs +599 -0
  70. data/vendor/crates/spikard-http/src/sse.rs +983 -21
  71. data/vendor/crates/spikard-http/src/testing/form.rs +38 -0
  72. data/vendor/crates/spikard-http/src/testing/test_client.rs +0 -2
  73. data/vendor/crates/spikard-http/src/testing.rs +7 -7
  74. data/vendor/crates/spikard-http/src/websocket.rs +1055 -4
  75. data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -0
  76. data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -0
  77. data/vendor/crates/spikard-http/tests/common/mod.rs +26 -0
  78. data/vendor/crates/spikard-http/tests/di_integration.rs +192 -0
  79. data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -0
  80. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -0
  81. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -0
  82. data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -0
  83. data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -0
  84. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -0
  85. data/vendor/crates/spikard-rb/Cargo.toml +10 -4
  86. data/vendor/crates/spikard-rb/build.rs +196 -5
  87. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
  88. data/vendor/crates/spikard-rb/src/{config.rs → config/server_config.rs} +100 -109
  89. data/vendor/crates/spikard-rb/src/conversion.rs +121 -20
  90. data/vendor/crates/spikard-rb/src/di/builder.rs +100 -0
  91. data/vendor/crates/spikard-rb/src/{di.rs → di/mod.rs} +12 -46
  92. data/vendor/crates/spikard-rb/src/handler.rs +100 -107
  93. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
  94. data/vendor/crates/spikard-rb/src/lib.rs +467 -1428
  95. data/vendor/crates/spikard-rb/src/lifecycle.rs +1 -0
  96. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
  97. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +447 -0
  98. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
  99. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -0
  100. data/vendor/crates/spikard-rb/src/server.rs +47 -22
  101. data/vendor/crates/spikard-rb/src/{test_client.rs → testing/client.rs} +187 -40
  102. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
  103. data/vendor/crates/spikard-rb/src/testing/websocket.rs +635 -0
  104. data/vendor/crates/spikard-rb/src/websocket.rs +178 -37
  105. metadata +46 -13
  106. data/vendor/crates/spikard-http/src/parameters.rs +0 -1
  107. data/vendor/crates/spikard-http/src/problem.rs +0 -1
  108. data/vendor/crates/spikard-http/src/router.rs +0 -1
  109. data/vendor/crates/spikard-http/src/schema_registry.rs +0 -1
  110. data/vendor/crates/spikard-http/src/type_hints.rs +0 -1
  111. data/vendor/crates/spikard-http/src/validation.rs +0 -1
  112. data/vendor/crates/spikard-rb/src/test_websocket.rs +0 -221
  113. /data/vendor/crates/spikard-rb/src/{test_sse.rs → testing/sse.rs} +0 -0
@@ -96,3 +96,139 @@ pub async fn execute_with_lifecycle_hooks(
96
96
  .unwrap()),
97
97
  }
98
98
  }
99
+
100
+ #[cfg(test)]
101
+ mod tests {
102
+ use super::*;
103
+ use crate::lifecycle::{HookResult, request_hook, response_hook};
104
+ use axum::http::{Request, Response, StatusCode};
105
+ use http_body_util::BodyExt;
106
+ use serde_json::json;
107
+ use std::collections::HashMap;
108
+
109
+ struct OkHandler;
110
+
111
+ impl Handler for OkHandler {
112
+ fn call(
113
+ &self,
114
+ _request: Request<Body>,
115
+ _request_data: crate::handler_trait::RequestData,
116
+ ) -> std::pin::Pin<Box<dyn std::future::Future<Output = crate::handler_trait::HandlerResult> + Send + '_>>
117
+ {
118
+ Box::pin(async move {
119
+ Ok(Response::builder()
120
+ .status(StatusCode::OK)
121
+ .body(Body::from("ok"))
122
+ .unwrap())
123
+ })
124
+ }
125
+ }
126
+
127
+ struct ErrHandler;
128
+
129
+ impl Handler for ErrHandler {
130
+ fn call(
131
+ &self,
132
+ _request: Request<Body>,
133
+ _request_data: crate::handler_trait::RequestData,
134
+ ) -> std::pin::Pin<Box<dyn std::future::Future<Output = crate::handler_trait::HandlerResult> + Send + '_>>
135
+ {
136
+ Box::pin(async move { Err((StatusCode::BAD_REQUEST, "bad".to_string())) })
137
+ }
138
+ }
139
+
140
+ fn empty_request_data() -> crate::handler_trait::RequestData {
141
+ crate::handler_trait::RequestData {
142
+ path_params: std::sync::Arc::new(HashMap::new()),
143
+ query_params: json!({}),
144
+ validated_params: None,
145
+ raw_query_params: std::sync::Arc::new(HashMap::new()),
146
+ body: json!(null),
147
+ raw_body: None,
148
+ headers: std::sync::Arc::new(HashMap::new()),
149
+ cookies: std::sync::Arc::new(HashMap::new()),
150
+ method: "GET".to_string(),
151
+ path: "/".to_string(),
152
+ #[cfg(feature = "di")]
153
+ dependencies: None,
154
+ }
155
+ }
156
+
157
+ #[tokio::test]
158
+ async fn pre_validation_error_with_failing_on_error_hook_returns_fallback() {
159
+ let mut hooks = crate::LifecycleHooks::new();
160
+ hooks.add_pre_validation(request_hook("boom", |_req| async move { Err("boom".to_string()) }));
161
+ hooks.add_on_error(response_hook("fail-on-error", |_resp| async move {
162
+ Err("fail".to_string())
163
+ }));
164
+
165
+ let req = Request::builder().uri("/").body(Body::empty()).unwrap();
166
+ let resp = execute_with_lifecycle_hooks(req, empty_request_data(), Arc::new(OkHandler), Some(Arc::new(hooks)))
167
+ .await
168
+ .unwrap();
169
+
170
+ assert_eq!(resp.status(), StatusCode::INTERNAL_SERVER_ERROR);
171
+ let body = resp.into_body().collect().await.unwrap().to_bytes();
172
+ assert_eq!(body.as_ref(), b"{\"error\":\"Hook execution failed\"}");
173
+ }
174
+
175
+ #[tokio::test]
176
+ async fn handler_error_with_failing_on_error_hook_returns_on_error_hook_failed_response() {
177
+ let mut hooks = crate::LifecycleHooks::new();
178
+ hooks.add_on_error(response_hook("fail-on-error", |_resp| async move {
179
+ Err("boom".to_string())
180
+ }));
181
+
182
+ let req = Request::builder().uri("/").body(Body::empty()).unwrap();
183
+ let resp = execute_with_lifecycle_hooks(req, empty_request_data(), Arc::new(ErrHandler), Some(Arc::new(hooks)))
184
+ .await
185
+ .unwrap();
186
+
187
+ assert_eq!(resp.status(), StatusCode::INTERNAL_SERVER_ERROR);
188
+ let body = resp.into_body().collect().await.unwrap().to_bytes();
189
+ let body_str = std::str::from_utf8(body.as_ref()).unwrap();
190
+ assert!(body_str.contains("\"error\":\"onError hook failed:"));
191
+ assert!(body_str.contains("boom"));
192
+ }
193
+
194
+ #[tokio::test]
195
+ async fn on_response_hook_error_returns_on_response_hook_failed_response() {
196
+ let mut hooks = crate::LifecycleHooks::new();
197
+ hooks.add_on_response(response_hook("fail-on-response", |_resp| async move {
198
+ Err("boom".to_string())
199
+ }));
200
+
201
+ let req = Request::builder().uri("/").body(Body::empty()).unwrap();
202
+ let resp = execute_with_lifecycle_hooks(req, empty_request_data(), Arc::new(OkHandler), Some(Arc::new(hooks)))
203
+ .await
204
+ .unwrap();
205
+
206
+ assert_eq!(resp.status(), StatusCode::INTERNAL_SERVER_ERROR);
207
+ let body = resp.into_body().collect().await.unwrap().to_bytes();
208
+ let body_str = std::str::from_utf8(body.as_ref()).unwrap();
209
+ assert!(body_str.contains("\"error\":\"onResponse hook failed:"));
210
+ assert!(body_str.contains("boom"));
211
+ }
212
+
213
+ #[tokio::test]
214
+ async fn pre_validation_short_circuit_skips_handler_and_returns_response() {
215
+ let mut hooks = crate::LifecycleHooks::new();
216
+ hooks.add_pre_validation(request_hook("short-circuit", |_req| async move {
217
+ Ok(HookResult::ShortCircuit(
218
+ Response::builder()
219
+ .status(StatusCode::UNAUTHORIZED)
220
+ .body(Body::from("nope"))
221
+ .unwrap(),
222
+ ))
223
+ }));
224
+
225
+ let req = Request::builder().uri("/").body(Body::empty()).unwrap();
226
+ let resp = execute_with_lifecycle_hooks(req, empty_request_data(), Arc::new(ErrHandler), Some(Arc::new(hooks)))
227
+ .await
228
+ .unwrap();
229
+
230
+ assert_eq!(resp.status(), StatusCode::UNAUTHORIZED);
231
+ let body = resp.into_body().collect().await.unwrap().to_bytes();
232
+ assert_eq!(body.as_ref(), b"nope");
233
+ }
234
+ }