spikard 0.4.0-arm64-darwin-23

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 (138) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +1 -0
  3. data/README.md +659 -0
  4. data/ext/spikard_rb/Cargo.toml +17 -0
  5. data/ext/spikard_rb/extconf.rb +10 -0
  6. data/ext/spikard_rb/src/lib.rs +6 -0
  7. data/lib/spikard/app.rb +405 -0
  8. data/lib/spikard/background.rb +27 -0
  9. data/lib/spikard/config.rb +396 -0
  10. data/lib/spikard/converters.rb +13 -0
  11. data/lib/spikard/handler_wrapper.rb +113 -0
  12. data/lib/spikard/provide.rb +214 -0
  13. data/lib/spikard/response.rb +173 -0
  14. data/lib/spikard/schema.rb +243 -0
  15. data/lib/spikard/sse.rb +111 -0
  16. data/lib/spikard/streaming_response.rb +44 -0
  17. data/lib/spikard/testing.rb +221 -0
  18. data/lib/spikard/upload_file.rb +131 -0
  19. data/lib/spikard/version.rb +5 -0
  20. data/lib/spikard/websocket.rb +59 -0
  21. data/lib/spikard.rb +43 -0
  22. data/sig/spikard.rbs +366 -0
  23. data/vendor/bundle/ruby/3.4.0/gems/diff-lcs-1.6.2/mise.toml +5 -0
  24. data/vendor/bundle/ruby/3.4.0/gems/rake-compiler-dock-1.10.0/build/buildkitd.toml +2 -0
  25. data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -0
  26. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +139 -0
  27. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +561 -0
  28. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
  29. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
  30. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +403 -0
  31. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +274 -0
  32. data/vendor/crates/spikard-bindings-shared/src/lib.rs +25 -0
  33. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +298 -0
  34. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +637 -0
  35. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +309 -0
  36. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
  37. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +355 -0
  38. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +502 -0
  39. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +389 -0
  40. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +413 -0
  41. data/vendor/crates/spikard-core/Cargo.toml +40 -0
  42. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -0
  43. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -0
  44. data/vendor/crates/spikard-core/src/debug.rs +63 -0
  45. data/vendor/crates/spikard-core/src/di/container.rs +726 -0
  46. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -0
  47. data/vendor/crates/spikard-core/src/di/error.rs +118 -0
  48. data/vendor/crates/spikard-core/src/di/factory.rs +538 -0
  49. data/vendor/crates/spikard-core/src/di/graph.rs +545 -0
  50. data/vendor/crates/spikard-core/src/di/mod.rs +192 -0
  51. data/vendor/crates/spikard-core/src/di/resolved.rs +411 -0
  52. data/vendor/crates/spikard-core/src/di/value.rs +283 -0
  53. data/vendor/crates/spikard-core/src/errors.rs +39 -0
  54. data/vendor/crates/spikard-core/src/http.rs +153 -0
  55. data/vendor/crates/spikard-core/src/lib.rs +29 -0
  56. data/vendor/crates/spikard-core/src/lifecycle.rs +422 -0
  57. data/vendor/crates/spikard-core/src/metadata.rs +397 -0
  58. data/vendor/crates/spikard-core/src/parameters.rs +723 -0
  59. data/vendor/crates/spikard-core/src/problem.rs +310 -0
  60. data/vendor/crates/spikard-core/src/request_data.rs +189 -0
  61. data/vendor/crates/spikard-core/src/router.rs +249 -0
  62. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -0
  63. data/vendor/crates/spikard-core/src/type_hints.rs +304 -0
  64. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +689 -0
  65. data/vendor/crates/spikard-core/src/validation/mod.rs +459 -0
  66. data/vendor/crates/spikard-http/Cargo.toml +58 -0
  67. data/vendor/crates/spikard-http/examples/sse-notifications.rs +147 -0
  68. data/vendor/crates/spikard-http/examples/websocket-chat.rs +91 -0
  69. data/vendor/crates/spikard-http/src/auth.rs +247 -0
  70. data/vendor/crates/spikard-http/src/background.rs +1562 -0
  71. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -0
  72. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -0
  73. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -0
  74. data/vendor/crates/spikard-http/src/cors.rs +490 -0
  75. data/vendor/crates/spikard-http/src/debug.rs +63 -0
  76. data/vendor/crates/spikard-http/src/di_handler.rs +1878 -0
  77. data/vendor/crates/spikard-http/src/handler_response.rs +532 -0
  78. data/vendor/crates/spikard-http/src/handler_trait.rs +861 -0
  79. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +284 -0
  80. data/vendor/crates/spikard-http/src/lib.rs +524 -0
  81. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +149 -0
  82. data/vendor/crates/spikard-http/src/lifecycle.rs +428 -0
  83. data/vendor/crates/spikard-http/src/middleware/mod.rs +285 -0
  84. data/vendor/crates/spikard-http/src/middleware/multipart.rs +930 -0
  85. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +541 -0
  86. data/vendor/crates/spikard-http/src/middleware/validation.rs +287 -0
  87. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -0
  88. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -0
  89. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +867 -0
  90. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +678 -0
  91. data/vendor/crates/spikard-http/src/query_parser.rs +369 -0
  92. data/vendor/crates/spikard-http/src/response.rs +399 -0
  93. data/vendor/crates/spikard-http/src/server/handler.rs +1557 -0
  94. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +98 -0
  95. data/vendor/crates/spikard-http/src/server/mod.rs +806 -0
  96. data/vendor/crates/spikard-http/src/server/request_extraction.rs +630 -0
  97. data/vendor/crates/spikard-http/src/server/routing_factory.rs +497 -0
  98. data/vendor/crates/spikard-http/src/sse.rs +961 -0
  99. data/vendor/crates/spikard-http/src/testing/form.rs +14 -0
  100. data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -0
  101. data/vendor/crates/spikard-http/src/testing/test_client.rs +285 -0
  102. data/vendor/crates/spikard-http/src/testing.rs +377 -0
  103. data/vendor/crates/spikard-http/src/websocket.rs +831 -0
  104. data/vendor/crates/spikard-http/tests/background_behavior.rs +918 -0
  105. data/vendor/crates/spikard-http/tests/common/handlers.rs +308 -0
  106. data/vendor/crates/spikard-http/tests/common/mod.rs +21 -0
  107. data/vendor/crates/spikard-http/tests/di_integration.rs +202 -0
  108. data/vendor/crates/spikard-http/tests/doc_snippets.rs +4 -0
  109. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1135 -0
  110. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +688 -0
  111. data/vendor/crates/spikard-http/tests/server_config_builder.rs +324 -0
  112. data/vendor/crates/spikard-http/tests/sse_behavior.rs +728 -0
  113. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +724 -0
  114. data/vendor/crates/spikard-rb/Cargo.toml +43 -0
  115. data/vendor/crates/spikard-rb/build.rs +199 -0
  116. data/vendor/crates/spikard-rb/src/background.rs +63 -0
  117. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
  118. data/vendor/crates/spikard-rb/src/config/server_config.rs +283 -0
  119. data/vendor/crates/spikard-rb/src/conversion.rs +459 -0
  120. data/vendor/crates/spikard-rb/src/di/builder.rs +105 -0
  121. data/vendor/crates/spikard-rb/src/di/mod.rs +413 -0
  122. data/vendor/crates/spikard-rb/src/handler.rs +612 -0
  123. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
  124. data/vendor/crates/spikard-rb/src/lib.rs +1857 -0
  125. data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -0
  126. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
  127. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +427 -0
  128. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
  129. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +326 -0
  130. data/vendor/crates/spikard-rb/src/server.rs +283 -0
  131. data/vendor/crates/spikard-rb/src/sse.rs +231 -0
  132. data/vendor/crates/spikard-rb/src/testing/client.rs +404 -0
  133. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
  134. data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -0
  135. data/vendor/crates/spikard-rb/src/testing/websocket.rs +221 -0
  136. data/vendor/crates/spikard-rb/src/websocket.rs +233 -0
  137. data/vendor/crates/spikard-rb/tests/magnus_ffi_tests.rs +14 -0
  138. metadata +213 -0
@@ -0,0 +1,284 @@
1
+ //! Unit tests for the Handler trait and related functionality
2
+ //!
3
+ //! These tests verify the Handler trait works correctly and can be implemented
4
+ //! by different language bindings without requiring PyO3 or other FFI dependencies.
5
+
6
+ #[cfg(test)]
7
+ mod tests {
8
+ use crate::handler_trait::{Handler, HandlerResult, RequestData};
9
+ use axum::body::Body;
10
+ use axum::http::{Method, Request, Response, StatusCode};
11
+ use serde_json::{Value, json};
12
+ use std::collections::HashMap;
13
+ use std::future::Future;
14
+ use std::pin::Pin;
15
+ use std::sync::Arc;
16
+
17
+ /// Mock handler for testing - always returns 200 OK with echoed request data
18
+ struct EchoHandler;
19
+
20
+ impl Handler for EchoHandler {
21
+ fn call(
22
+ &self,
23
+ _request: Request<Body>,
24
+ request_data: RequestData,
25
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
26
+ Box::pin(async move {
27
+ let response_body = json!({
28
+ "path_params": &*request_data.path_params,
29
+ "query_params": request_data.query_params,
30
+ "body": request_data.body,
31
+ "headers_count": request_data.headers.len(),
32
+ "cookies_count": request_data.cookies.len(),
33
+ "method": request_data.method,
34
+ "path": request_data.path,
35
+ });
36
+
37
+ let response = Response::builder()
38
+ .status(StatusCode::OK)
39
+ .header("Content-Type", "application/json")
40
+ .body(Body::from(serde_json::to_string(&response_body).unwrap()))
41
+ .unwrap();
42
+
43
+ Ok(response)
44
+ })
45
+ }
46
+ }
47
+
48
+ /// Mock handler for testing - always returns errors
49
+ struct ErrorHandler;
50
+
51
+ impl Handler for ErrorHandler {
52
+ fn call(
53
+ &self,
54
+ _request: Request<Body>,
55
+ _request_data: RequestData,
56
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
57
+ Box::pin(async move { Err((StatusCode::INTERNAL_SERVER_ERROR, "Handler error".to_string())) })
58
+ }
59
+ }
60
+
61
+ /// Mock handler that checks for specific query parameters
62
+ struct QueryParamHandler {
63
+ required_param: String,
64
+ }
65
+
66
+ impl Handler for QueryParamHandler {
67
+ fn call(
68
+ &self,
69
+ _request: Request<Body>,
70
+ request_data: RequestData,
71
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
72
+ let required = self.required_param.clone();
73
+ Box::pin(async move {
74
+ if request_data.raw_query_params.contains_key(&required) {
75
+ let response = Response::builder()
76
+ .status(StatusCode::OK)
77
+ .body(Body::from("OK"))
78
+ .unwrap();
79
+ Ok(response)
80
+ } else {
81
+ Err((
82
+ StatusCode::BAD_REQUEST,
83
+ format!("Missing required parameter: {}", required),
84
+ ))
85
+ }
86
+ })
87
+ }
88
+ }
89
+
90
+ #[tokio::test]
91
+ async fn test_handler_trait_echo() {
92
+ let handler = Arc::new(EchoHandler);
93
+
94
+ let mut path_params = HashMap::new();
95
+ path_params.insert("id".to_string(), "123".to_string());
96
+
97
+ let mut headers = HashMap::new();
98
+ headers.insert("content-type".to_string(), "application/json".to_string());
99
+
100
+ let request_data = RequestData {
101
+ path_params: Arc::new(path_params),
102
+ query_params: json!({"page": 1}),
103
+ raw_query_params: Arc::new(HashMap::new()),
104
+ body: json!({"test": "data"}),
105
+ raw_body: None,
106
+ headers: Arc::new(headers),
107
+ cookies: Arc::new(HashMap::new()),
108
+ method: "POST".to_string(),
109
+ path: "/items/123".to_string(),
110
+ #[cfg(feature = "di")]
111
+ dependencies: None,
112
+ };
113
+
114
+ let request = Request::builder()
115
+ .method(Method::POST)
116
+ .uri("/items/123")
117
+ .body(Body::empty())
118
+ .unwrap();
119
+
120
+ let result = handler.call(request, request_data).await;
121
+ assert!(result.is_ok());
122
+
123
+ let response = result.unwrap();
124
+ assert_eq!(response.status(), StatusCode::OK);
125
+ }
126
+
127
+ #[tokio::test]
128
+ async fn test_handler_trait_error() {
129
+ let handler = Arc::new(ErrorHandler);
130
+
131
+ let request_data = RequestData {
132
+ path_params: Arc::new(HashMap::new()),
133
+ query_params: Value::Null,
134
+ raw_query_params: Arc::new(HashMap::new()),
135
+ body: Value::Null,
136
+ raw_body: None,
137
+ headers: Arc::new(HashMap::new()),
138
+ cookies: Arc::new(HashMap::new()),
139
+ method: "GET".to_string(),
140
+ path: "/error".to_string(),
141
+
142
+ #[cfg(feature = "di")]
143
+ dependencies: None,
144
+ };
145
+
146
+ let request = Request::builder()
147
+ .method(Method::GET)
148
+ .uri("/error")
149
+ .body(Body::empty())
150
+ .unwrap();
151
+
152
+ let result = handler.call(request, request_data).await;
153
+ assert!(result.is_err());
154
+
155
+ let (status, message) = result.unwrap_err();
156
+ assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR);
157
+ assert_eq!(message, "Handler error");
158
+ }
159
+
160
+ #[tokio::test]
161
+ async fn test_handler_trait_query_params() {
162
+ let handler = Arc::new(QueryParamHandler {
163
+ required_param: "api_key".to_string(),
164
+ });
165
+
166
+ let mut raw_query_params = HashMap::new();
167
+ raw_query_params.insert("api_key".to_string(), vec!["secret123".to_string()]);
168
+
169
+ let request_data = RequestData {
170
+ path_params: Arc::new(HashMap::new()),
171
+ query_params: json!({"api_key": "secret123"}),
172
+ raw_query_params: Arc::new(raw_query_params.clone()),
173
+ body: Value::Null,
174
+ raw_body: None,
175
+ headers: Arc::new(HashMap::new()),
176
+ cookies: Arc::new(HashMap::new()),
177
+ method: "GET".to_string(),
178
+ path: "/api/data".to_string(),
179
+ #[cfg(feature = "di")]
180
+ dependencies: None,
181
+ };
182
+
183
+ let request = Request::builder()
184
+ .method(Method::GET)
185
+ .uri("/api/data?api_key=secret123")
186
+ .body(Body::empty())
187
+ .unwrap();
188
+
189
+ let result = handler.call(request, request_data).await;
190
+ assert!(result.is_ok());
191
+
192
+ let request_data_no_param = RequestData {
193
+ path_params: Arc::new(HashMap::new()),
194
+ query_params: Value::Null,
195
+ raw_query_params: Arc::new(HashMap::new()),
196
+ body: Value::Null,
197
+ raw_body: None,
198
+ headers: Arc::new(HashMap::new()),
199
+ cookies: Arc::new(HashMap::new()),
200
+ method: "GET".to_string(),
201
+ path: "/api/data".to_string(),
202
+
203
+ #[cfg(feature = "di")]
204
+ dependencies: None,
205
+ };
206
+
207
+ let request_no_param = Request::builder()
208
+ .method(Method::GET)
209
+ .uri("/api/data")
210
+ .body(Body::empty())
211
+ .unwrap();
212
+
213
+ let result_err = handler.call(request_no_param, request_data_no_param).await;
214
+ assert!(result_err.is_err());
215
+
216
+ let (status, message) = result_err.unwrap_err();
217
+ assert_eq!(status, StatusCode::BAD_REQUEST);
218
+ assert!(message.contains("api_key"));
219
+ }
220
+
221
+ #[tokio::test]
222
+ async fn test_request_data_serialization() {
223
+ let mut path_params = HashMap::new();
224
+ path_params.insert("user_id".to_string(), "42".to_string());
225
+
226
+ let mut raw_query_params = HashMap::new();
227
+ raw_query_params.insert("filter".to_string(), vec!["active".to_string()]);
228
+
229
+ let request_data = RequestData {
230
+ path_params: Arc::new(path_params),
231
+ query_params: json!({"filter": "active"}),
232
+ raw_query_params: Arc::new(raw_query_params),
233
+ body: json!({"name": "test"}),
234
+ raw_body: None,
235
+ headers: Arc::new(HashMap::new()),
236
+ cookies: Arc::new(HashMap::new()),
237
+ method: "PUT".to_string(),
238
+ path: "/users/42".to_string(),
239
+ #[cfg(feature = "di")]
240
+ dependencies: None,
241
+ };
242
+
243
+ let json_str = serde_json::to_string(&request_data).unwrap();
244
+ let deserialized: RequestData = serde_json::from_str(&json_str).unwrap();
245
+
246
+ assert_eq!(deserialized.method, "PUT");
247
+ assert_eq!(deserialized.path, "/users/42");
248
+ assert_eq!(deserialized.path_params.get("user_id").unwrap(), "42");
249
+ assert_eq!(deserialized.body, json!({"name": "test"}));
250
+ }
251
+
252
+ #[test]
253
+ fn test_request_data_default_values() {
254
+ let request_data = RequestData {
255
+ path_params: Arc::new(HashMap::new()),
256
+ query_params: Value::Null,
257
+ raw_query_params: Arc::new(HashMap::new()),
258
+ body: Value::Null,
259
+ raw_body: None,
260
+ headers: Arc::new(HashMap::new()),
261
+ cookies: Arc::new(HashMap::new()),
262
+ method: "GET".to_string(),
263
+ path: "/".to_string(),
264
+
265
+ #[cfg(feature = "di")]
266
+ dependencies: None,
267
+ };
268
+
269
+ assert_eq!(request_data.method, "GET");
270
+ assert_eq!(request_data.path, "/");
271
+ assert!(request_data.path_params.is_empty());
272
+ assert!(request_data.raw_query_params.is_empty());
273
+ assert!(request_data.headers.is_empty());
274
+ assert!(request_data.cookies.is_empty());
275
+ assert_eq!(request_data.body, Value::Null);
276
+ assert_eq!(request_data.query_params, Value::Null);
277
+ }
278
+
279
+ #[test]
280
+ fn test_handler_is_send_sync() {
281
+ fn assert_send_sync<T: Send + Sync>() {}
282
+ assert_send_sync::<Arc<dyn Handler>>();
283
+ }
284
+ }