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.
- checksums.yaml +4 -4
- data/LICENSE +1 -1
- data/README.md +674 -674
- data/ext/spikard_rb/Cargo.toml +17 -17
- data/ext/spikard_rb/extconf.rb +13 -10
- data/ext/spikard_rb/src/lib.rs +6 -6
- data/lib/spikard/app.rb +405 -405
- data/lib/spikard/background.rb +27 -27
- data/lib/spikard/config.rb +396 -396
- data/lib/spikard/converters.rb +13 -13
- data/lib/spikard/handler_wrapper.rb +113 -113
- data/lib/spikard/provide.rb +214 -214
- data/lib/spikard/response.rb +173 -173
- data/lib/spikard/schema.rb +243 -243
- data/lib/spikard/sse.rb +111 -111
- data/lib/spikard/streaming_response.rb +44 -44
- data/lib/spikard/testing.rb +256 -256
- data/lib/spikard/upload_file.rb +131 -131
- data/lib/spikard/version.rb +5 -5
- data/lib/spikard/websocket.rb +59 -59
- data/lib/spikard.rb +43 -43
- data/sig/spikard.rbs +366 -366
- data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -63
- data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -132
- data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -752
- data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -194
- data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -246
- data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -401
- data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -238
- data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -24
- data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -292
- data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -616
- data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -305
- data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -248
- data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -351
- data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -454
- data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -383
- data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -280
- data/vendor/crates/spikard-core/Cargo.toml +40 -40
- data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -3
- data/vendor/crates/spikard-core/src/bindings/response.rs +133 -133
- data/vendor/crates/spikard-core/src/debug.rs +127 -127
- data/vendor/crates/spikard-core/src/di/container.rs +702 -702
- data/vendor/crates/spikard-core/src/di/dependency.rs +273 -273
- data/vendor/crates/spikard-core/src/di/error.rs +118 -118
- data/vendor/crates/spikard-core/src/di/factory.rs +534 -534
- data/vendor/crates/spikard-core/src/di/graph.rs +506 -506
- data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
- data/vendor/crates/spikard-core/src/di/resolved.rs +405 -405
- data/vendor/crates/spikard-core/src/di/value.rs +281 -281
- data/vendor/crates/spikard-core/src/errors.rs +69 -69
- data/vendor/crates/spikard-core/src/http.rs +415 -415
- data/vendor/crates/spikard-core/src/lib.rs +29 -29
- data/vendor/crates/spikard-core/src/lifecycle.rs +1186 -1186
- data/vendor/crates/spikard-core/src/metadata.rs +389 -389
- data/vendor/crates/spikard-core/src/parameters.rs +2525 -2525
- data/vendor/crates/spikard-core/src/problem.rs +344 -344
- data/vendor/crates/spikard-core/src/request_data.rs +1154 -1154
- data/vendor/crates/spikard-core/src/router.rs +510 -510
- data/vendor/crates/spikard-core/src/schema_registry.rs +183 -183
- data/vendor/crates/spikard-core/src/type_hints.rs +304 -304
- data/vendor/crates/spikard-core/src/validation/error_mapper.rs +696 -688
- data/vendor/crates/spikard-core/src/validation/mod.rs +457 -457
- data/vendor/crates/spikard-http/Cargo.toml +62 -64
- data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -148
- data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -92
- data/vendor/crates/spikard-http/src/auth.rs +296 -296
- data/vendor/crates/spikard-http/src/background.rs +1860 -1860
- data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -3
- data/vendor/crates/spikard-http/src/bindings/response.rs +1 -1
- data/vendor/crates/spikard-http/src/body_metadata.rs +8 -8
- data/vendor/crates/spikard-http/src/cors.rs +1005 -1005
- data/vendor/crates/spikard-http/src/debug.rs +128 -128
- data/vendor/crates/spikard-http/src/di_handler.rs +1668 -1668
- data/vendor/crates/spikard-http/src/handler_response.rs +901 -901
- data/vendor/crates/spikard-http/src/handler_trait.rs +838 -830
- data/vendor/crates/spikard-http/src/handler_trait_tests.rs +290 -290
- data/vendor/crates/spikard-http/src/lib.rs +534 -534
- data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +230 -230
- data/vendor/crates/spikard-http/src/lifecycle.rs +1193 -1193
- data/vendor/crates/spikard-http/src/middleware/mod.rs +560 -540
- data/vendor/crates/spikard-http/src/middleware/multipart.rs +912 -912
- data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +513 -513
- data/vendor/crates/spikard-http/src/middleware/validation.rs +768 -735
- data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
- data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -535
- data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1363 -1363
- data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +665 -665
- data/vendor/crates/spikard-http/src/query_parser.rs +793 -793
- data/vendor/crates/spikard-http/src/response.rs +720 -720
- data/vendor/crates/spikard-http/src/server/handler.rs +1650 -1650
- data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +234 -234
- data/vendor/crates/spikard-http/src/server/mod.rs +1593 -1502
- data/vendor/crates/spikard-http/src/server/request_extraction.rs +789 -770
- data/vendor/crates/spikard-http/src/server/routing_factory.rs +629 -599
- data/vendor/crates/spikard-http/src/sse.rs +1409 -1409
- data/vendor/crates/spikard-http/src/testing/form.rs +52 -52
- data/vendor/crates/spikard-http/src/testing/multipart.rs +64 -60
- data/vendor/crates/spikard-http/src/testing/test_client.rs +311 -283
- data/vendor/crates/spikard-http/src/testing.rs +406 -377
- data/vendor/crates/spikard-http/src/websocket.rs +1404 -1375
- data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -832
- data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -309
- data/vendor/crates/spikard-http/tests/common/mod.rs +26 -26
- data/vendor/crates/spikard-http/tests/di_integration.rs +192 -192
- data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -5
- data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -1093
- data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -656
- data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -314
- data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -620
- data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -663
- data/vendor/crates/spikard-rb/Cargo.toml +48 -48
- data/vendor/crates/spikard-rb/build.rs +199 -199
- data/vendor/crates/spikard-rb/src/background.rs +63 -63
- data/vendor/crates/spikard-rb/src/config/mod.rs +5 -5
- data/vendor/crates/spikard-rb/src/config/server_config.rs +285 -285
- data/vendor/crates/spikard-rb/src/conversion.rs +554 -554
- data/vendor/crates/spikard-rb/src/di/builder.rs +100 -100
- data/vendor/crates/spikard-rb/src/di/mod.rs +375 -375
- data/vendor/crates/spikard-rb/src/handler.rs +618 -618
- data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -3
- data/vendor/crates/spikard-rb/src/lib.rs +1806 -1810
- data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -275
- data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -5
- data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +442 -447
- data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -5
- data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -324
- data/vendor/crates/spikard-rb/src/server.rs +305 -308
- data/vendor/crates/spikard-rb/src/sse.rs +231 -231
- data/vendor/crates/spikard-rb/src/testing/client.rs +538 -551
- data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -7
- data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -143
- data/vendor/crates/spikard-rb/src/testing/websocket.rs +608 -635
- data/vendor/crates/spikard-rb/src/websocket.rs +377 -374
- metadata +15 -1
|
@@ -1,238 +1,238 @@
|
|
|
1
|
-
//! Base handler traits and execution infrastructure
|
|
2
|
-
//!
|
|
3
|
-
//! This module provides language-agnostic handler execution patterns that
|
|
4
|
-
//! eliminate duplicate code across Node, Ruby, PHP, and WASM bindings.
|
|
5
|
-
|
|
6
|
-
use std::future::Future;
|
|
7
|
-
use std::pin::Pin;
|
|
8
|
-
use std::sync::Arc;
|
|
9
|
-
|
|
10
|
-
use axum::body::Body;
|
|
11
|
-
use axum::http::{Request, Response};
|
|
12
|
-
use spikard_core::validation::{SchemaValidator, ValidationError};
|
|
13
|
-
use spikard_http::Handler;
|
|
14
|
-
use spikard_http::handler_trait::{HandlerResult, RequestData};
|
|
15
|
-
|
|
16
|
-
use crate::error_response::ErrorResponseBuilder;
|
|
17
|
-
|
|
18
|
-
/// Error type for handler operations
|
|
19
|
-
#[derive(Debug, thiserror::Error)]
|
|
20
|
-
pub enum HandlerError {
|
|
21
|
-
#[error("Validation error: {0}")]
|
|
22
|
-
Validation(String),
|
|
23
|
-
|
|
24
|
-
#[error("Handler execution error: {0}")]
|
|
25
|
-
Execution(String),
|
|
26
|
-
|
|
27
|
-
#[error("Response conversion error: {0}")]
|
|
28
|
-
ResponseConversion(String),
|
|
29
|
-
|
|
30
|
-
#[error("Internal error: {0}")]
|
|
31
|
-
Internal(String),
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
impl From<ValidationError> for HandlerError {
|
|
35
|
-
fn from(err: ValidationError) -> Self {
|
|
36
|
-
HandlerError::Validation(format!("{:?}", err))
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
/// Language-specific handler implementation
|
|
41
|
-
///
|
|
42
|
-
/// This trait defines the three key operations that every language binding must implement:
|
|
43
|
-
/// 1. Prepare request data for the language runtime
|
|
44
|
-
/// 2. Invoke the handler in the language runtime
|
|
45
|
-
/// 3. Interpret the response from the language runtime
|
|
46
|
-
///
|
|
47
|
-
/// The `HandlerExecutor` handles all common logic (validation, error formatting)
|
|
48
|
-
/// while delegating language-specific operations to implementations of this trait.
|
|
49
|
-
pub trait LanguageHandler: Send + Sync {
|
|
50
|
-
/// Input type passed to the language handler
|
|
51
|
-
type Input: Send;
|
|
52
|
-
|
|
53
|
-
/// Output type returned from the language handler
|
|
54
|
-
type Output: Send;
|
|
55
|
-
|
|
56
|
-
/// Prepare request data for passing to the language handler
|
|
57
|
-
fn prepare_request(&self, request_data: &RequestData) -> Result<Self::Input, HandlerError>;
|
|
58
|
-
|
|
59
|
-
/// Invoke the language-specific handler with the prepared input
|
|
60
|
-
fn invoke_handler(
|
|
61
|
-
&self,
|
|
62
|
-
input: Self::Input,
|
|
63
|
-
) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>>;
|
|
64
|
-
|
|
65
|
-
/// Interpret the handler's output and convert it to an HTTP response
|
|
66
|
-
fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError>;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
/// Universal handler executor that works with any language binding
|
|
70
|
-
///
|
|
71
|
-
/// This struct consolidates the common handler execution flow:
|
|
72
|
-
/// - Request body validation
|
|
73
|
-
/// - Handler invocation
|
|
74
|
-
/// - Error handling and formatting
|
|
75
|
-
///
|
|
76
|
-
/// Language bindings provide thin wrappers that implement `LanguageHandler`.
|
|
77
|
-
pub struct HandlerExecutor<L: LanguageHandler> {
|
|
78
|
-
language_handler: Arc<L>,
|
|
79
|
-
request_validator: Option<Arc<SchemaValidator>>,
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
impl<L: LanguageHandler> HandlerExecutor<L> {
|
|
83
|
-
/// Create a new handler executor
|
|
84
|
-
pub fn new(language_handler: Arc<L>, request_validator: Option<Arc<SchemaValidator>>) -> Self {
|
|
85
|
-
Self {
|
|
86
|
-
language_handler,
|
|
87
|
-
request_validator,
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
/// Create a handler executor with only a language handler
|
|
92
|
-
pub fn with_handler(language_handler: Arc<L>) -> Self {
|
|
93
|
-
Self {
|
|
94
|
-
language_handler,
|
|
95
|
-
request_validator: None,
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
/// Add request validation to this executor
|
|
100
|
-
pub fn with_request_validator(mut self, validator: Arc<SchemaValidator>) -> Self {
|
|
101
|
-
self.request_validator = Some(validator);
|
|
102
|
-
self
|
|
103
|
-
}
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
impl<L: LanguageHandler + 'static> Handler for HandlerExecutor<L> {
|
|
107
|
-
fn call(
|
|
108
|
-
&self,
|
|
109
|
-
_request: Request<Body>,
|
|
110
|
-
request_data: RequestData,
|
|
111
|
-
) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
|
|
112
|
-
Box::pin(async move {
|
|
113
|
-
if let Some(validator) = &self.request_validator
|
|
114
|
-
&& let Err(validation_err) = validator.validate(&request_data.body)
|
|
115
|
-
{
|
|
116
|
-
return Err(ErrorResponseBuilder::validation_error(&validation_err));
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
let input = self
|
|
120
|
-
.language_handler
|
|
121
|
-
.prepare_request(&request_data)
|
|
122
|
-
.map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to prepare request: {}", e)))?;
|
|
123
|
-
|
|
124
|
-
let output = self
|
|
125
|
-
.language_handler
|
|
126
|
-
.invoke_handler(input)
|
|
127
|
-
.await
|
|
128
|
-
.map_err(|e| ErrorResponseBuilder::internal_error(format!("Handler execution failed: {}", e)))?;
|
|
129
|
-
|
|
130
|
-
let response = self
|
|
131
|
-
.language_handler
|
|
132
|
-
.interpret_response(output)
|
|
133
|
-
.map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to interpret response: {}", e)))?;
|
|
134
|
-
|
|
135
|
-
Ok(response)
|
|
136
|
-
})
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
#[cfg(test)]
|
|
141
|
-
mod tests {
|
|
142
|
-
use super::*;
|
|
143
|
-
use serde_json::json;
|
|
144
|
-
|
|
145
|
-
struct MockLanguageHandler;
|
|
146
|
-
|
|
147
|
-
impl LanguageHandler for MockLanguageHandler {
|
|
148
|
-
type Input = String;
|
|
149
|
-
type Output = String;
|
|
150
|
-
|
|
151
|
-
fn prepare_request(&self, _data: &RequestData) -> Result<Self::Input, HandlerError> {
|
|
152
|
-
Ok("test_input".to_string())
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
fn invoke_handler(
|
|
156
|
-
&self,
|
|
157
|
-
_input: Self::Input,
|
|
158
|
-
) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>> {
|
|
159
|
-
Box::pin(async { Ok("test_output".to_string()) })
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError> {
|
|
163
|
-
Ok(Response::builder().status(200).body(Body::from(output)).unwrap())
|
|
164
|
-
}
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
#[tokio::test]
|
|
168
|
-
async fn test_handler_executor_basic() {
|
|
169
|
-
let mock_handler = Arc::new(MockLanguageHandler);
|
|
170
|
-
let executor = HandlerExecutor::new(mock_handler, None);
|
|
171
|
-
|
|
172
|
-
let request = Request::builder().body(Body::empty()).unwrap();
|
|
173
|
-
let request_data = RequestData {
|
|
174
|
-
path_params: Arc::new(std::collections::HashMap::new()),
|
|
175
|
-
query_params: json!({}),
|
|
176
|
-
validated_params: None,
|
|
177
|
-
raw_query_params: Arc::new(std::collections::HashMap::new()),
|
|
178
|
-
body: json!({}),
|
|
179
|
-
raw_body: None,
|
|
180
|
-
headers: Arc::new(std::collections::HashMap::new()),
|
|
181
|
-
cookies: Arc::new(std::collections::HashMap::new()),
|
|
182
|
-
method: "GET".to_string(),
|
|
183
|
-
path: "/test".to_string(),
|
|
184
|
-
dependencies: None,
|
|
185
|
-
};
|
|
186
|
-
|
|
187
|
-
let result = executor.call(request, request_data).await;
|
|
188
|
-
assert!(result.is_ok());
|
|
189
|
-
}
|
|
190
|
-
|
|
191
|
-
#[tokio::test]
|
|
192
|
-
async fn test_handler_executor_with_handler_only() {
|
|
193
|
-
let mock_handler = Arc::new(MockLanguageHandler);
|
|
194
|
-
let executor = HandlerExecutor::with_handler(mock_handler);
|
|
195
|
-
|
|
196
|
-
let request = Request::builder().body(Body::empty()).unwrap();
|
|
197
|
-
let request_data = RequestData {
|
|
198
|
-
path_params: Arc::new(std::collections::HashMap::new()),
|
|
199
|
-
query_params: json!({}),
|
|
200
|
-
validated_params: None,
|
|
201
|
-
raw_query_params: Arc::new(std::collections::HashMap::new()),
|
|
202
|
-
body: json!({}),
|
|
203
|
-
raw_body: None,
|
|
204
|
-
headers: Arc::new(std::collections::HashMap::new()),
|
|
205
|
-
cookies: Arc::new(std::collections::HashMap::new()),
|
|
206
|
-
method: "GET".to_string(),
|
|
207
|
-
path: "/test".to_string(),
|
|
208
|
-
dependencies: None,
|
|
209
|
-
};
|
|
210
|
-
|
|
211
|
-
let result = executor.call(request, request_data).await;
|
|
212
|
-
assert!(result.is_ok());
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
#[test]
|
|
216
|
-
fn test_handler_error_validation() {
|
|
217
|
-
let err = HandlerError::Validation("test error".to_string());
|
|
218
|
-
assert_eq!(err.to_string(), "Validation error: test error");
|
|
219
|
-
}
|
|
220
|
-
|
|
221
|
-
#[test]
|
|
222
|
-
fn test_handler_error_execution() {
|
|
223
|
-
let err = HandlerError::Execution("test error".to_string());
|
|
224
|
-
assert_eq!(err.to_string(), "Handler execution error: test error");
|
|
225
|
-
}
|
|
226
|
-
|
|
227
|
-
#[test]
|
|
228
|
-
fn test_handler_error_response_conversion() {
|
|
229
|
-
let err = HandlerError::ResponseConversion("test error".to_string());
|
|
230
|
-
assert_eq!(err.to_string(), "Response conversion error: test error");
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
#[test]
|
|
234
|
-
fn test_handler_error_internal() {
|
|
235
|
-
let err = HandlerError::Internal("test error".to_string());
|
|
236
|
-
assert_eq!(err.to_string(), "Internal error: test error");
|
|
237
|
-
}
|
|
238
|
-
}
|
|
1
|
+
//! Base handler traits and execution infrastructure
|
|
2
|
+
//!
|
|
3
|
+
//! This module provides language-agnostic handler execution patterns that
|
|
4
|
+
//! eliminate duplicate code across Node, Ruby, PHP, and WASM bindings.
|
|
5
|
+
|
|
6
|
+
use std::future::Future;
|
|
7
|
+
use std::pin::Pin;
|
|
8
|
+
use std::sync::Arc;
|
|
9
|
+
|
|
10
|
+
use axum::body::Body;
|
|
11
|
+
use axum::http::{Request, Response};
|
|
12
|
+
use spikard_core::validation::{SchemaValidator, ValidationError};
|
|
13
|
+
use spikard_http::Handler;
|
|
14
|
+
use spikard_http::handler_trait::{HandlerResult, RequestData};
|
|
15
|
+
|
|
16
|
+
use crate::error_response::ErrorResponseBuilder;
|
|
17
|
+
|
|
18
|
+
/// Error type for handler operations
|
|
19
|
+
#[derive(Debug, thiserror::Error)]
|
|
20
|
+
pub enum HandlerError {
|
|
21
|
+
#[error("Validation error: {0}")]
|
|
22
|
+
Validation(String),
|
|
23
|
+
|
|
24
|
+
#[error("Handler execution error: {0}")]
|
|
25
|
+
Execution(String),
|
|
26
|
+
|
|
27
|
+
#[error("Response conversion error: {0}")]
|
|
28
|
+
ResponseConversion(String),
|
|
29
|
+
|
|
30
|
+
#[error("Internal error: {0}")]
|
|
31
|
+
Internal(String),
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
impl From<ValidationError> for HandlerError {
|
|
35
|
+
fn from(err: ValidationError) -> Self {
|
|
36
|
+
HandlerError::Validation(format!("{:?}", err))
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/// Language-specific handler implementation
|
|
41
|
+
///
|
|
42
|
+
/// This trait defines the three key operations that every language binding must implement:
|
|
43
|
+
/// 1. Prepare request data for the language runtime
|
|
44
|
+
/// 2. Invoke the handler in the language runtime
|
|
45
|
+
/// 3. Interpret the response from the language runtime
|
|
46
|
+
///
|
|
47
|
+
/// The `HandlerExecutor` handles all common logic (validation, error formatting)
|
|
48
|
+
/// while delegating language-specific operations to implementations of this trait.
|
|
49
|
+
pub trait LanguageHandler: Send + Sync {
|
|
50
|
+
/// Input type passed to the language handler
|
|
51
|
+
type Input: Send;
|
|
52
|
+
|
|
53
|
+
/// Output type returned from the language handler
|
|
54
|
+
type Output: Send;
|
|
55
|
+
|
|
56
|
+
/// Prepare request data for passing to the language handler
|
|
57
|
+
fn prepare_request(&self, request_data: &RequestData) -> Result<Self::Input, HandlerError>;
|
|
58
|
+
|
|
59
|
+
/// Invoke the language-specific handler with the prepared input
|
|
60
|
+
fn invoke_handler(
|
|
61
|
+
&self,
|
|
62
|
+
input: Self::Input,
|
|
63
|
+
) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>>;
|
|
64
|
+
|
|
65
|
+
/// Interpret the handler's output and convert it to an HTTP response
|
|
66
|
+
fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError>;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/// Universal handler executor that works with any language binding
|
|
70
|
+
///
|
|
71
|
+
/// This struct consolidates the common handler execution flow:
|
|
72
|
+
/// - Request body validation
|
|
73
|
+
/// - Handler invocation
|
|
74
|
+
/// - Error handling and formatting
|
|
75
|
+
///
|
|
76
|
+
/// Language bindings provide thin wrappers that implement `LanguageHandler`.
|
|
77
|
+
pub struct HandlerExecutor<L: LanguageHandler> {
|
|
78
|
+
language_handler: Arc<L>,
|
|
79
|
+
request_validator: Option<Arc<SchemaValidator>>,
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
impl<L: LanguageHandler> HandlerExecutor<L> {
|
|
83
|
+
/// Create a new handler executor
|
|
84
|
+
pub fn new(language_handler: Arc<L>, request_validator: Option<Arc<SchemaValidator>>) -> Self {
|
|
85
|
+
Self {
|
|
86
|
+
language_handler,
|
|
87
|
+
request_validator,
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/// Create a handler executor with only a language handler
|
|
92
|
+
pub fn with_handler(language_handler: Arc<L>) -> Self {
|
|
93
|
+
Self {
|
|
94
|
+
language_handler,
|
|
95
|
+
request_validator: None,
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/// Add request validation to this executor
|
|
100
|
+
pub fn with_request_validator(mut self, validator: Arc<SchemaValidator>) -> Self {
|
|
101
|
+
self.request_validator = Some(validator);
|
|
102
|
+
self
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
impl<L: LanguageHandler + 'static> Handler for HandlerExecutor<L> {
|
|
107
|
+
fn call(
|
|
108
|
+
&self,
|
|
109
|
+
_request: Request<Body>,
|
|
110
|
+
request_data: RequestData,
|
|
111
|
+
) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
|
|
112
|
+
Box::pin(async move {
|
|
113
|
+
if let Some(validator) = &self.request_validator
|
|
114
|
+
&& let Err(validation_err) = validator.validate(&request_data.body)
|
|
115
|
+
{
|
|
116
|
+
return Err(ErrorResponseBuilder::validation_error(&validation_err));
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
let input = self
|
|
120
|
+
.language_handler
|
|
121
|
+
.prepare_request(&request_data)
|
|
122
|
+
.map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to prepare request: {}", e)))?;
|
|
123
|
+
|
|
124
|
+
let output = self
|
|
125
|
+
.language_handler
|
|
126
|
+
.invoke_handler(input)
|
|
127
|
+
.await
|
|
128
|
+
.map_err(|e| ErrorResponseBuilder::internal_error(format!("Handler execution failed: {}", e)))?;
|
|
129
|
+
|
|
130
|
+
let response = self
|
|
131
|
+
.language_handler
|
|
132
|
+
.interpret_response(output)
|
|
133
|
+
.map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to interpret response: {}", e)))?;
|
|
134
|
+
|
|
135
|
+
Ok(response)
|
|
136
|
+
})
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
#[cfg(test)]
|
|
141
|
+
mod tests {
|
|
142
|
+
use super::*;
|
|
143
|
+
use serde_json::json;
|
|
144
|
+
|
|
145
|
+
struct MockLanguageHandler;
|
|
146
|
+
|
|
147
|
+
impl LanguageHandler for MockLanguageHandler {
|
|
148
|
+
type Input = String;
|
|
149
|
+
type Output = String;
|
|
150
|
+
|
|
151
|
+
fn prepare_request(&self, _data: &RequestData) -> Result<Self::Input, HandlerError> {
|
|
152
|
+
Ok("test_input".to_string())
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
fn invoke_handler(
|
|
156
|
+
&self,
|
|
157
|
+
_input: Self::Input,
|
|
158
|
+
) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>> {
|
|
159
|
+
Box::pin(async { Ok("test_output".to_string()) })
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError> {
|
|
163
|
+
Ok(Response::builder().status(200).body(Body::from(output)).unwrap())
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
#[tokio::test]
|
|
168
|
+
async fn test_handler_executor_basic() {
|
|
169
|
+
let mock_handler = Arc::new(MockLanguageHandler);
|
|
170
|
+
let executor = HandlerExecutor::new(mock_handler, None);
|
|
171
|
+
|
|
172
|
+
let request = Request::builder().body(Body::empty()).unwrap();
|
|
173
|
+
let request_data = RequestData {
|
|
174
|
+
path_params: Arc::new(std::collections::HashMap::new()),
|
|
175
|
+
query_params: json!({}),
|
|
176
|
+
validated_params: None,
|
|
177
|
+
raw_query_params: Arc::new(std::collections::HashMap::new()),
|
|
178
|
+
body: json!({}),
|
|
179
|
+
raw_body: None,
|
|
180
|
+
headers: Arc::new(std::collections::HashMap::new()),
|
|
181
|
+
cookies: Arc::new(std::collections::HashMap::new()),
|
|
182
|
+
method: "GET".to_string(),
|
|
183
|
+
path: "/test".to_string(),
|
|
184
|
+
dependencies: None,
|
|
185
|
+
};
|
|
186
|
+
|
|
187
|
+
let result = executor.call(request, request_data).await;
|
|
188
|
+
assert!(result.is_ok());
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
#[tokio::test]
|
|
192
|
+
async fn test_handler_executor_with_handler_only() {
|
|
193
|
+
let mock_handler = Arc::new(MockLanguageHandler);
|
|
194
|
+
let executor = HandlerExecutor::with_handler(mock_handler);
|
|
195
|
+
|
|
196
|
+
let request = Request::builder().body(Body::empty()).unwrap();
|
|
197
|
+
let request_data = RequestData {
|
|
198
|
+
path_params: Arc::new(std::collections::HashMap::new()),
|
|
199
|
+
query_params: json!({}),
|
|
200
|
+
validated_params: None,
|
|
201
|
+
raw_query_params: Arc::new(std::collections::HashMap::new()),
|
|
202
|
+
body: json!({}),
|
|
203
|
+
raw_body: None,
|
|
204
|
+
headers: Arc::new(std::collections::HashMap::new()),
|
|
205
|
+
cookies: Arc::new(std::collections::HashMap::new()),
|
|
206
|
+
method: "GET".to_string(),
|
|
207
|
+
path: "/test".to_string(),
|
|
208
|
+
dependencies: None,
|
|
209
|
+
};
|
|
210
|
+
|
|
211
|
+
let result = executor.call(request, request_data).await;
|
|
212
|
+
assert!(result.is_ok());
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
#[test]
|
|
216
|
+
fn test_handler_error_validation() {
|
|
217
|
+
let err = HandlerError::Validation("test error".to_string());
|
|
218
|
+
assert_eq!(err.to_string(), "Validation error: test error");
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
#[test]
|
|
222
|
+
fn test_handler_error_execution() {
|
|
223
|
+
let err = HandlerError::Execution("test error".to_string());
|
|
224
|
+
assert_eq!(err.to_string(), "Handler execution error: test error");
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
#[test]
|
|
228
|
+
fn test_handler_error_response_conversion() {
|
|
229
|
+
let err = HandlerError::ResponseConversion("test error".to_string());
|
|
230
|
+
assert_eq!(err.to_string(), "Response conversion error: test error");
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
#[test]
|
|
234
|
+
fn test_handler_error_internal() {
|
|
235
|
+
let err = HandlerError::Internal("test error".to_string());
|
|
236
|
+
assert_eq!(err.to_string(), "Internal error: test error");
|
|
237
|
+
}
|
|
238
|
+
}
|
|
@@ -1,24 +1,24 @@
|
|
|
1
|
-
//! Shared utilities for language bindings
|
|
2
|
-
//!
|
|
3
|
-
//! This crate provides common functionality used across all language bindings
|
|
4
|
-
//! (Python, Node.js, Ruby, PHP, WASM) to eliminate code duplication and ensure
|
|
5
|
-
//! consistent behavior.
|
|
6
|
-
|
|
7
|
-
pub mod config_extractor;
|
|
8
|
-
pub mod conversion_traits;
|
|
9
|
-
pub mod di_traits;
|
|
10
|
-
pub mod error_response;
|
|
11
|
-
pub mod handler_base;
|
|
12
|
-
pub mod lifecycle_base;
|
|
13
|
-
pub mod lifecycle_executor;
|
|
14
|
-
pub mod response_builder;
|
|
15
|
-
pub mod test_client_base;
|
|
16
|
-
pub mod validation_helpers;
|
|
17
|
-
|
|
18
|
-
pub use config_extractor::{ConfigExtractor, ConfigSource};
|
|
19
|
-
pub use di_traits::{FactoryDependencyAdapter, ValueDependencyAdapter};
|
|
20
|
-
pub use error_response::ErrorResponseBuilder;
|
|
21
|
-
pub use handler_base::{HandlerError, HandlerExecutor, LanguageHandler};
|
|
22
|
-
pub use lifecycle_executor::{
|
|
23
|
-
HookResultData, LanguageLifecycleHook, LifecycleExecutor, RequestModifications, extract_body,
|
|
24
|
-
};
|
|
1
|
+
//! Shared utilities for language bindings
|
|
2
|
+
//!
|
|
3
|
+
//! This crate provides common functionality used across all language bindings
|
|
4
|
+
//! (Python, Node.js, Ruby, PHP, WASM) to eliminate code duplication and ensure
|
|
5
|
+
//! consistent behavior.
|
|
6
|
+
|
|
7
|
+
pub mod config_extractor;
|
|
8
|
+
pub mod conversion_traits;
|
|
9
|
+
pub mod di_traits;
|
|
10
|
+
pub mod error_response;
|
|
11
|
+
pub mod handler_base;
|
|
12
|
+
pub mod lifecycle_base;
|
|
13
|
+
pub mod lifecycle_executor;
|
|
14
|
+
pub mod response_builder;
|
|
15
|
+
pub mod test_client_base;
|
|
16
|
+
pub mod validation_helpers;
|
|
17
|
+
|
|
18
|
+
pub use config_extractor::{ConfigExtractor, ConfigSource};
|
|
19
|
+
pub use di_traits::{FactoryDependencyAdapter, ValueDependencyAdapter};
|
|
20
|
+
pub use error_response::ErrorResponseBuilder;
|
|
21
|
+
pub use handler_base::{HandlerError, HandlerExecutor, LanguageHandler};
|
|
22
|
+
pub use lifecycle_executor::{
|
|
23
|
+
HookResultData, LanguageLifecycleHook, LifecycleExecutor, RequestModifications, extract_body,
|
|
24
|
+
};
|