spikard 0.2.5 → 0.3.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 (92) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +34 -1
  3. data/ext/spikard_rb/Cargo.toml +3 -3
  4. data/lib/spikard/app.rb +61 -49
  5. data/lib/spikard/converters.rb +3 -75
  6. data/lib/spikard/handler_wrapper.rb +6 -9
  7. data/lib/spikard/provide.rb +14 -28
  8. data/lib/spikard/response.rb +75 -11
  9. data/lib/spikard/streaming_response.rb +24 -1
  10. data/lib/spikard/testing.rb +1 -1
  11. data/lib/spikard/version.rb +1 -1
  12. data/sig/spikard.rbs +14 -3
  13. data/vendor/bundle/ruby/3.3.0/gems/rake-compiler-dock-1.10.0/build/buildkitd.toml +2 -0
  14. metadata +3 -80
  15. data/vendor/crates/spikard-core/Cargo.toml +0 -40
  16. data/vendor/crates/spikard-core/src/bindings/mod.rs +0 -3
  17. data/vendor/crates/spikard-core/src/bindings/response.rs +0 -133
  18. data/vendor/crates/spikard-core/src/debug.rs +0 -63
  19. data/vendor/crates/spikard-core/src/di/container.rs +0 -726
  20. data/vendor/crates/spikard-core/src/di/dependency.rs +0 -273
  21. data/vendor/crates/spikard-core/src/di/error.rs +0 -118
  22. data/vendor/crates/spikard-core/src/di/factory.rs +0 -538
  23. data/vendor/crates/spikard-core/src/di/graph.rs +0 -545
  24. data/vendor/crates/spikard-core/src/di/mod.rs +0 -192
  25. data/vendor/crates/spikard-core/src/di/resolved.rs +0 -411
  26. data/vendor/crates/spikard-core/src/di/value.rs +0 -283
  27. data/vendor/crates/spikard-core/src/http.rs +0 -153
  28. data/vendor/crates/spikard-core/src/lib.rs +0 -28
  29. data/vendor/crates/spikard-core/src/lifecycle.rs +0 -422
  30. data/vendor/crates/spikard-core/src/parameters.rs +0 -719
  31. data/vendor/crates/spikard-core/src/problem.rs +0 -310
  32. data/vendor/crates/spikard-core/src/request_data.rs +0 -189
  33. data/vendor/crates/spikard-core/src/router.rs +0 -249
  34. data/vendor/crates/spikard-core/src/schema_registry.rs +0 -183
  35. data/vendor/crates/spikard-core/src/type_hints.rs +0 -304
  36. data/vendor/crates/spikard-core/src/validation.rs +0 -699
  37. data/vendor/crates/spikard-http/Cargo.toml +0 -58
  38. data/vendor/crates/spikard-http/src/auth.rs +0 -247
  39. data/vendor/crates/spikard-http/src/background.rs +0 -249
  40. data/vendor/crates/spikard-http/src/bindings/mod.rs +0 -3
  41. data/vendor/crates/spikard-http/src/bindings/response.rs +0 -1
  42. data/vendor/crates/spikard-http/src/body_metadata.rs +0 -8
  43. data/vendor/crates/spikard-http/src/cors.rs +0 -490
  44. data/vendor/crates/spikard-http/src/debug.rs +0 -63
  45. data/vendor/crates/spikard-http/src/di_handler.rs +0 -423
  46. data/vendor/crates/spikard-http/src/handler_response.rs +0 -190
  47. data/vendor/crates/spikard-http/src/handler_trait.rs +0 -228
  48. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +0 -284
  49. data/vendor/crates/spikard-http/src/lib.rs +0 -529
  50. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +0 -149
  51. data/vendor/crates/spikard-http/src/lifecycle.rs +0 -428
  52. data/vendor/crates/spikard-http/src/middleware/mod.rs +0 -285
  53. data/vendor/crates/spikard-http/src/middleware/multipart.rs +0 -86
  54. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +0 -147
  55. data/vendor/crates/spikard-http/src/middleware/validation.rs +0 -287
  56. data/vendor/crates/spikard-http/src/openapi/mod.rs +0 -309
  57. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +0 -190
  58. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +0 -308
  59. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +0 -195
  60. data/vendor/crates/spikard-http/src/parameters.rs +0 -1
  61. data/vendor/crates/spikard-http/src/problem.rs +0 -1
  62. data/vendor/crates/spikard-http/src/query_parser.rs +0 -369
  63. data/vendor/crates/spikard-http/src/response.rs +0 -399
  64. data/vendor/crates/spikard-http/src/router.rs +0 -1
  65. data/vendor/crates/spikard-http/src/schema_registry.rs +0 -1
  66. data/vendor/crates/spikard-http/src/server/handler.rs +0 -80
  67. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +0 -98
  68. data/vendor/crates/spikard-http/src/server/mod.rs +0 -805
  69. data/vendor/crates/spikard-http/src/server/request_extraction.rs +0 -119
  70. data/vendor/crates/spikard-http/src/sse.rs +0 -447
  71. data/vendor/crates/spikard-http/src/testing/form.rs +0 -14
  72. data/vendor/crates/spikard-http/src/testing/multipart.rs +0 -60
  73. data/vendor/crates/spikard-http/src/testing/test_client.rs +0 -285
  74. data/vendor/crates/spikard-http/src/testing.rs +0 -377
  75. data/vendor/crates/spikard-http/src/type_hints.rs +0 -1
  76. data/vendor/crates/spikard-http/src/validation.rs +0 -1
  77. data/vendor/crates/spikard-http/src/websocket.rs +0 -324
  78. data/vendor/crates/spikard-rb/Cargo.toml +0 -42
  79. data/vendor/crates/spikard-rb/build.rs +0 -8
  80. data/vendor/crates/spikard-rb/src/background.rs +0 -63
  81. data/vendor/crates/spikard-rb/src/config.rs +0 -294
  82. data/vendor/crates/spikard-rb/src/conversion.rs +0 -392
  83. data/vendor/crates/spikard-rb/src/di.rs +0 -409
  84. data/vendor/crates/spikard-rb/src/handler.rs +0 -534
  85. data/vendor/crates/spikard-rb/src/lib.rs +0 -2020
  86. data/vendor/crates/spikard-rb/src/lifecycle.rs +0 -267
  87. data/vendor/crates/spikard-rb/src/server.rs +0 -283
  88. data/vendor/crates/spikard-rb/src/sse.rs +0 -231
  89. data/vendor/crates/spikard-rb/src/test_client.rs +0 -404
  90. data/vendor/crates/spikard-rb/src/test_sse.rs +0 -143
  91. data/vendor/crates/spikard-rb/src/test_websocket.rs +0 -221
  92. data/vendor/crates/spikard-rb/src/websocket.rs +0 -233
@@ -1,283 +0,0 @@
1
- //! Value dependency implementation
2
- //!
3
- //! This module provides `ValueDependency<T>`, a simple dependency that wraps
4
- //! a static value and returns it whenever resolved.
5
-
6
- use super::dependency::Dependency;
7
- use super::error::DependencyError;
8
- use super::resolved::ResolvedDependencies;
9
- use crate::request_data::RequestData;
10
- use http::Request;
11
- use std::any::Any;
12
- use std::future::Future;
13
- use std::marker::PhantomData;
14
- use std::pin::Pin;
15
- use std::sync::Arc;
16
-
17
- /// A dependency that wraps a static value
18
- ///
19
- /// This is the simplest form of dependency - it just returns a pre-configured
20
- /// value whenever resolved. Useful for configuration values, constants, or
21
- /// pre-built objects.
22
- ///
23
- /// # Type Parameters
24
- ///
25
- /// * `T` - The type of value to provide. Must be `Clone + Send + Sync + 'static`.
26
- ///
27
- /// # Examples
28
- ///
29
- /// ```ignore
30
- /// use spikard_core::di::{Dependency, ValueDependency};
31
- /// use http::Request;
32
- /// use crate::request_data::RequestData;
33
- /// use std::collections::HashMap;
34
- /// use std::sync::Arc;
35
- ///
36
- /// # tokio_test::block_on(async {
37
- /// // Create a value dependency with a configuration string
38
- /// let config = ValueDependency::new("database_url", "postgresql://localhost/mydb");
39
- ///
40
- /// // Resolve it (returns the same value every time)
41
- /// let request = Request::builder().body(()).unwrap();
42
- /// let request_data = RequestData {
43
- /// path_params: Arc::new(HashMap::new()),
44
- /// query_params: serde_json::Value::Null,
45
- /// raw_query_params: Arc::new(HashMap::new()),
46
- /// body: serde_json::Value::Null,
47
- /// raw_body: None,
48
- /// headers: Arc::new(HashMap::new()),
49
- /// cookies: Arc::new(HashMap::new()),
50
- /// method: "GET".to_string(),
51
- /// path: "/".to_string(),
52
- /// };
53
- /// let resolved = spikard_core::di::ResolvedDependencies::new();
54
- ///
55
- /// let result = config.resolve(&request, &request_data, &resolved).await.unwrap();
56
- /// let value: Arc<String> = result.downcast().unwrap();
57
- /// assert_eq!(*value, "postgresql://localhost/mydb");
58
- /// # });
59
- /// ```
60
- pub struct ValueDependency<T: Clone + Send + Sync + 'static> {
61
- key: String,
62
- value: Arc<T>,
63
- _phantom: PhantomData<T>,
64
- }
65
-
66
- impl<T: Clone + Send + Sync + 'static> ValueDependency<T> {
67
- /// Create a new value dependency
68
- ///
69
- /// # Arguments
70
- ///
71
- /// * `key` - The unique key for this dependency
72
- /// * `value` - The value to provide when resolved
73
- ///
74
- /// # Examples
75
- ///
76
- /// ```ignore
77
- /// use spikard_core::di::ValueDependency;
78
- ///
79
- /// // Simple value
80
- /// let port = ValueDependency::new("port", 8080u16);
81
- ///
82
- /// // Complex value
83
- /// #[derive(Clone)]
84
- /// struct Config {
85
- /// debug: bool,
86
- /// timeout: u64,
87
- /// }
88
- ///
89
- /// let config = ValueDependency::new("config", Config {
90
- /// debug: true,
91
- /// timeout: 30,
92
- /// });
93
- /// ```
94
- pub fn new(key: impl Into<String>, value: T) -> Self {
95
- Self {
96
- key: key.into(),
97
- value: Arc::new(value),
98
- _phantom: PhantomData,
99
- }
100
- }
101
- }
102
-
103
- impl<T: Clone + Send + Sync + 'static> Dependency for ValueDependency<T> {
104
- fn resolve(
105
- &self,
106
- _request: &Request<()>,
107
- _request_data: &RequestData,
108
- _resolved: &ResolvedDependencies,
109
- ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn Any + Send + Sync>, DependencyError>> + Send>> {
110
- let value = Arc::clone(&self.value);
111
- Box::pin(async move { Ok(value as Arc<dyn Any + Send + Sync>) })
112
- }
113
-
114
- fn key(&self) -> &str {
115
- &self.key
116
- }
117
-
118
- fn depends_on(&self) -> Vec<String> {
119
- // Value dependencies have no dependencies
120
- vec![]
121
- }
122
-
123
- fn cacheable(&self) -> bool {
124
- // Values are inherently cacheable (they never change)
125
- true
126
- }
127
-
128
- fn singleton(&self) -> bool {
129
- // Values can be singletons (they never change)
130
- true
131
- }
132
- }
133
-
134
- impl<T: Clone + Send + Sync + 'static> std::fmt::Debug for ValueDependency<T> {
135
- fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
136
- f.debug_struct("ValueDependency")
137
- .field("key", &self.key)
138
- .field("value_type", &std::any::type_name::<T>())
139
- .finish()
140
- }
141
- }
142
-
143
- #[cfg(test)]
144
- mod tests {
145
- use super::*;
146
- use std::collections::HashMap;
147
-
148
- fn make_request_data() -> RequestData {
149
- RequestData {
150
- path_params: Arc::new(HashMap::new()),
151
- query_params: serde_json::Value::Null,
152
- raw_query_params: Arc::new(HashMap::new()),
153
- body: serde_json::Value::Null,
154
- raw_body: None,
155
- headers: Arc::new(HashMap::new()),
156
- cookies: Arc::new(HashMap::new()),
157
- method: "GET".to_string(),
158
- path: "/".to_string(),
159
- #[cfg(feature = "di")]
160
- dependencies: None,
161
- }
162
- }
163
-
164
- #[test]
165
- fn test_new() {
166
- let dep = ValueDependency::new("test", 42i32);
167
- assert_eq!(dep.key(), "test");
168
- }
169
-
170
- #[test]
171
- fn test_key() {
172
- let dep = ValueDependency::new("my_key", "value");
173
- assert_eq!(dep.key(), "my_key");
174
- }
175
-
176
- #[test]
177
- fn test_depends_on() {
178
- let dep = ValueDependency::new("test", 42i32);
179
- assert_eq!(dep.depends_on(), Vec::<String>::new());
180
- }
181
-
182
- #[test]
183
- fn test_cacheable() {
184
- let dep = ValueDependency::new("test", 42i32);
185
- assert!(dep.cacheable());
186
- }
187
-
188
- #[test]
189
- fn test_singleton() {
190
- let dep = ValueDependency::new("test", 42i32);
191
- assert!(dep.singleton());
192
- }
193
-
194
- #[tokio::test]
195
- async fn test_resolve_simple() {
196
- let dep = ValueDependency::new("answer", 42i32);
197
- let request = Request::builder().body(()).unwrap();
198
- let request_data = make_request_data();
199
- let resolved = ResolvedDependencies::new();
200
-
201
- let result = dep.resolve(&request, &request_data, &resolved).await;
202
- assert!(result.is_ok());
203
-
204
- let value: Arc<i32> = result.unwrap().downcast().unwrap();
205
- assert_eq!(*value, 42);
206
- }
207
-
208
- #[tokio::test]
209
- async fn test_resolve_string() {
210
- let dep = ValueDependency::new("message", "Hello, World!".to_string());
211
- let request = Request::builder().body(()).unwrap();
212
- let request_data = make_request_data();
213
- let resolved = ResolvedDependencies::new();
214
-
215
- let result = dep.resolve(&request, &request_data, &resolved).await;
216
- assert!(result.is_ok());
217
-
218
- let value: Arc<String> = result.unwrap().downcast().unwrap();
219
- assert_eq!(*value, "Hello, World!");
220
- }
221
-
222
- #[tokio::test]
223
- async fn test_resolve_concurrent() {
224
- let dep = Arc::new(ValueDependency::new("shared", 100i32));
225
- let request = Request::builder().body(()).unwrap();
226
- let request_data = make_request_data();
227
-
228
- // Resolve concurrently from multiple tasks
229
- let handles: Vec<_> = (0..10)
230
- .map(|_| {
231
- let dep = Arc::clone(&dep);
232
- let req = request.clone();
233
- let data = request_data.clone();
234
- tokio::spawn(async move {
235
- let resolved = ResolvedDependencies::new();
236
- let result = dep.resolve(&req, &data, &resolved).await.unwrap();
237
- let value: Arc<i32> = result.downcast().unwrap();
238
- *value
239
- })
240
- })
241
- .collect();
242
-
243
- for handle in handles {
244
- let value = handle.await.unwrap();
245
- assert_eq!(value, 100);
246
- }
247
- }
248
-
249
- #[derive(Clone, Debug, PartialEq)]
250
- struct ComplexValue {
251
- name: String,
252
- count: i32,
253
- tags: Vec<String>,
254
- }
255
-
256
- #[tokio::test]
257
- async fn test_resolve_complex_type() {
258
- let complex = ComplexValue {
259
- name: "test".to_string(),
260
- count: 42,
261
- tags: vec!["tag1".to_string(), "tag2".to_string()],
262
- };
263
-
264
- let dep = ValueDependency::new("complex", complex.clone());
265
- let request = Request::builder().body(()).unwrap();
266
- let request_data = make_request_data();
267
- let resolved = ResolvedDependencies::new();
268
-
269
- let result = dep.resolve(&request, &request_data, &resolved).await;
270
- assert!(result.is_ok());
271
-
272
- let value: Arc<ComplexValue> = result.unwrap().downcast().unwrap();
273
- assert_eq!(*value, complex);
274
- }
275
-
276
- #[test]
277
- fn test_debug() {
278
- let dep = ValueDependency::new("test", 42i32);
279
- let debug_str = format!("{:?}", dep);
280
- assert!(debug_str.contains("ValueDependency"));
281
- assert!(debug_str.contains("test"));
282
- }
283
- }
@@ -1,153 +0,0 @@
1
- use serde::{Deserialize, Serialize};
2
- use serde_json::Value;
3
-
4
- /// HTTP method
5
- #[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)]
6
- pub enum Method {
7
- Get,
8
- Post,
9
- Put,
10
- Patch,
11
- Delete,
12
- Head,
13
- Options,
14
- Trace,
15
- }
16
-
17
- impl Method {
18
- pub fn as_str(&self) -> &'static str {
19
- match self {
20
- Method::Get => "GET",
21
- Method::Post => "POST",
22
- Method::Put => "PUT",
23
- Method::Patch => "PATCH",
24
- Method::Delete => "DELETE",
25
- Method::Head => "HEAD",
26
- Method::Options => "OPTIONS",
27
- Method::Trace => "TRACE",
28
- }
29
- }
30
- }
31
-
32
- impl std::fmt::Display for Method {
33
- fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
34
- write!(f, "{}", self.as_str())
35
- }
36
- }
37
-
38
- impl std::str::FromStr for Method {
39
- type Err = String;
40
-
41
- fn from_str(s: &str) -> Result<Self, Self::Err> {
42
- match s.to_uppercase().as_str() {
43
- "GET" => Ok(Method::Get),
44
- "POST" => Ok(Method::Post),
45
- "PUT" => Ok(Method::Put),
46
- "PATCH" => Ok(Method::Patch),
47
- "DELETE" => Ok(Method::Delete),
48
- "HEAD" => Ok(Method::Head),
49
- "OPTIONS" => Ok(Method::Options),
50
- "TRACE" => Ok(Method::Trace),
51
- _ => Err(format!("Unknown HTTP method: {}", s)),
52
- }
53
- }
54
- }
55
-
56
- /// CORS configuration for a route
57
- #[derive(Debug, Clone, Serialize, Deserialize)]
58
- pub struct CorsConfig {
59
- pub allowed_origins: Vec<String>,
60
- pub allowed_methods: Vec<String>,
61
- #[serde(default)]
62
- pub allowed_headers: Vec<String>,
63
- #[serde(skip_serializing_if = "Option::is_none")]
64
- pub expose_headers: Option<Vec<String>>,
65
- #[serde(skip_serializing_if = "Option::is_none")]
66
- pub max_age: Option<u32>,
67
- #[serde(skip_serializing_if = "Option::is_none")]
68
- pub allow_credentials: Option<bool>,
69
- }
70
-
71
- /// Route metadata extracted from bindings
72
- #[derive(Debug, Clone, Serialize, Deserialize)]
73
- pub struct RouteMetadata {
74
- pub method: String,
75
- pub path: String,
76
- pub handler_name: String,
77
- pub request_schema: Option<Value>,
78
- pub response_schema: Option<Value>,
79
- pub parameter_schema: Option<Value>,
80
- #[serde(skip_serializing_if = "Option::is_none")]
81
- pub file_params: Option<Value>,
82
- pub is_async: bool,
83
- pub cors: Option<CorsConfig>,
84
- /// Name of the body parameter (defaults to "body" if not specified)
85
- #[serde(skip_serializing_if = "Option::is_none")]
86
- pub body_param_name: Option<String>,
87
- /// List of dependency keys this handler requires (for DI)
88
- #[cfg(feature = "di")]
89
- #[serde(skip_serializing_if = "Option::is_none")]
90
- pub handler_dependencies: Option<Vec<String>>,
91
- }
92
-
93
- /// Compression configuration shared across runtimes
94
- #[derive(Debug, Clone, Serialize, Deserialize)]
95
- pub struct CompressionConfig {
96
- /// Enable gzip compression
97
- #[serde(default = "default_true")]
98
- pub gzip: bool,
99
- /// Enable brotli compression
100
- #[serde(default = "default_true")]
101
- pub brotli: bool,
102
- /// Minimum response size to compress (bytes)
103
- #[serde(default = "default_compression_min_size")]
104
- pub min_size: usize,
105
- /// Compression quality (0-11 for brotli, 0-9 for gzip)
106
- #[serde(default = "default_compression_quality")]
107
- pub quality: u32,
108
- }
109
-
110
- const fn default_true() -> bool {
111
- true
112
- }
113
-
114
- const fn default_compression_min_size() -> usize {
115
- 1024
116
- }
117
-
118
- const fn default_compression_quality() -> u32 {
119
- 6
120
- }
121
-
122
- impl Default for CompressionConfig {
123
- fn default() -> Self {
124
- Self {
125
- gzip: true,
126
- brotli: true,
127
- min_size: default_compression_min_size(),
128
- quality: default_compression_quality(),
129
- }
130
- }
131
- }
132
-
133
- /// Rate limiting configuration shared across runtimes
134
- #[derive(Debug, Clone, Serialize, Deserialize)]
135
- pub struct RateLimitConfig {
136
- /// Requests per second
137
- pub per_second: u64,
138
- /// Burst allowance
139
- pub burst: u32,
140
- /// Use IP-based rate limiting
141
- #[serde(default = "default_true")]
142
- pub ip_based: bool,
143
- }
144
-
145
- impl Default for RateLimitConfig {
146
- fn default() -> Self {
147
- Self {
148
- per_second: 100,
149
- burst: 200,
150
- ip_based: true,
151
- }
152
- }
153
- }
@@ -1,28 +0,0 @@
1
- pub mod bindings;
2
- pub mod debug;
3
- #[cfg(feature = "di")]
4
- pub mod di;
5
- pub mod http;
6
- pub mod lifecycle;
7
- pub mod parameters;
8
- pub mod problem;
9
- pub mod request_data;
10
- pub mod router;
11
- pub mod schema_registry;
12
- pub mod type_hints;
13
- pub mod validation;
14
-
15
- pub use bindings::response::{RawResponse, StaticAsset};
16
- #[cfg(feature = "di")]
17
- pub use di::{
18
- Dependency, DependencyContainer, DependencyError, DependencyGraph, FactoryDependency, FactoryDependencyBuilder,
19
- ResolvedDependencies, ValueDependency,
20
- };
21
- pub use http::{CompressionConfig, CorsConfig, Method, RateLimitConfig, RouteMetadata};
22
- pub use lifecycle::{HookResult, LifecycleHook, LifecycleHooks, LifecycleHooksBuilder, request_hook, response_hook};
23
- pub use parameters::ParameterValidator;
24
- pub use problem::ProblemDetails;
25
- pub use request_data::RequestData;
26
- pub use router::{Route, RouteHandler, Router};
27
- pub use schema_registry::SchemaRegistry;
28
- pub use validation::{SchemaValidator, ValidationError, ValidationErrorDetail};