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,7 @@
1
+ //! Testing utilities for Ruby bindings.
2
+ //!
3
+ //! This module provides testing client implementations for HTTP, WebSocket, and SSE testing.
4
+
5
+ pub mod client;
6
+ pub mod sse;
7
+ pub mod websocket;
@@ -1,143 +1,143 @@
1
- //! SSE test client bindings for Ruby
2
-
3
- use magnus::prelude::*;
4
- use magnus::{Error, Ruby, Value, method};
5
- use serde_json::Value as JsonValue;
6
- use spikard_http::testing::{ResponseSnapshot, SseEvent as RustSseEvent, SseStream as RustSseStream};
7
-
8
- /// Ruby wrapper for SSE stream
9
- #[magnus::wrap(class = "Spikard::Native::SseStream", free_immediately)]
10
- pub struct SseStream {
11
- inner: RustSseStream,
12
- }
13
-
14
- impl SseStream {
15
- pub fn new(inner: RustSseStream) -> Self {
16
- Self { inner }
17
- }
18
-
19
- /// Get the raw body of the SSE response
20
- fn body(&self) -> String {
21
- self.inner.body().to_string()
22
- }
23
-
24
- /// Get all events from the stream
25
- fn events(ruby: &Ruby, this: &Self) -> Result<Value, Error> {
26
- let ruby_arr = ruby.ary_new();
27
- for event in this.inner.events() {
28
- let sse_event = SseEvent::new(event.clone());
29
- let ruby_event = ruby.obj_wrap(sse_event);
30
- ruby_arr.push(ruby_event)?;
31
- }
32
- Ok(ruby_arr.as_value())
33
- }
34
-
35
- /// Get events as JSON values
36
- fn events_as_json(ruby: &Ruby, this: &Self) -> Result<Value, Error> {
37
- let json_events = this.inner.events_as_json().map_err(|e| {
38
- Error::new(
39
- ruby.exception_runtime_error(),
40
- format!("Failed to parse events as JSON: {}", e),
41
- )
42
- })?;
43
-
44
- let ruby_arr = ruby.ary_new();
45
- for value in json_events {
46
- let ruby_val = json_to_ruby(ruby, &value)?;
47
- ruby_arr.push(ruby_val)?;
48
- }
49
- Ok(ruby_arr.as_value())
50
- }
51
- }
52
-
53
- /// Ruby wrapper for SSE event
54
- #[magnus::wrap(class = "Spikard::Native::SseEvent", free_immediately)]
55
- pub struct SseEvent {
56
- inner: RustSseEvent,
57
- }
58
-
59
- impl SseEvent {
60
- pub fn new(inner: RustSseEvent) -> Self {
61
- Self { inner }
62
- }
63
-
64
- /// Get the data field of the event
65
- fn data(&self) -> String {
66
- self.inner.data.clone()
67
- }
68
-
69
- /// Parse the event data as JSON
70
- fn as_json(ruby: &Ruby, this: &Self) -> Result<Value, Error> {
71
- let value = this
72
- .inner
73
- .as_json()
74
- .map_err(|e| Error::new(ruby.exception_runtime_error(), format!("Failed to parse JSON: {}", e)))?;
75
-
76
- json_to_ruby(ruby, &value)
77
- }
78
- }
79
-
80
- /// Create an SSE stream from a response snapshot
81
- pub fn sse_stream_from_response(ruby: &Ruby, response: &ResponseSnapshot) -> Result<Value, Error> {
82
- let stream = RustSseStream::from_response(response)
83
- .map_err(|e| Error::new(ruby.exception_runtime_error(), format!("Failed to parse SSE: {}", e)))?;
84
-
85
- let sse_stream = SseStream::new(stream);
86
- Ok(ruby.obj_wrap(sse_stream).as_value())
87
- }
88
-
89
- /// Helper to convert JSON to Ruby object
90
- fn json_to_ruby(ruby: &Ruby, value: &JsonValue) -> Result<Value, Error> {
91
- match value {
92
- JsonValue::Null => Ok(ruby.qnil().as_value()),
93
- JsonValue::Bool(b) => Ok(if *b {
94
- ruby.qtrue().as_value()
95
- } else {
96
- ruby.qfalse().as_value()
97
- }),
98
- JsonValue::Number(n) => {
99
- if let Some(i) = n.as_i64() {
100
- Ok(ruby.integer_from_i64(i).as_value())
101
- } else if let Some(u) = n.as_u64() {
102
- Ok(ruby.integer_from_i64(u as i64).as_value())
103
- } else if let Some(f) = n.as_f64() {
104
- Ok(ruby.float_from_f64(f).as_value())
105
- } else {
106
- Ok(ruby.qnil().as_value())
107
- }
108
- }
109
- JsonValue::String(s) => Ok(ruby.str_new(s).as_value()),
110
- JsonValue::Array(arr) => {
111
- let ruby_arr = ruby.ary_new();
112
- for item in arr {
113
- let ruby_val = json_to_ruby(ruby, item)?;
114
- ruby_arr.push(ruby_val)?;
115
- }
116
- Ok(ruby_arr.as_value())
117
- }
118
- JsonValue::Object(obj) => {
119
- let ruby_hash = ruby.hash_new();
120
- for (key, val) in obj {
121
- let ruby_val = json_to_ruby(ruby, val)?;
122
- ruby_hash.aset(ruby.str_new(key), ruby_val)?;
123
- }
124
- Ok(ruby_hash.as_value())
125
- }
126
- }
127
- }
128
-
129
- /// Initialize SSE test client bindings
130
- pub fn init(ruby: &Ruby, module: &magnus::RModule) -> Result<(), Error> {
131
- let native_module = module.define_module("Native")?;
132
-
133
- let sse_stream_class = native_module.define_class("SseStream", ruby.class_object())?;
134
- sse_stream_class.define_method("body", method!(SseStream::body, 0))?;
135
- sse_stream_class.define_method("events", method!(SseStream::events, 0))?;
136
- sse_stream_class.define_method("events_as_json", method!(SseStream::events_as_json, 0))?;
137
-
138
- let sse_event_class = native_module.define_class("SseEvent", ruby.class_object())?;
139
- sse_event_class.define_method("data", method!(SseEvent::data, 0))?;
140
- sse_event_class.define_method("as_json", method!(SseEvent::as_json, 0))?;
141
-
142
- Ok(())
143
- }
1
+ //! SSE test client bindings for Ruby
2
+
3
+ use magnus::prelude::*;
4
+ use magnus::{Error, Ruby, Value, method};
5
+ use serde_json::Value as JsonValue;
6
+ use spikard_http::testing::{ResponseSnapshot, SseEvent as RustSseEvent, SseStream as RustSseStream};
7
+
8
+ /// Ruby wrapper for SSE stream
9
+ #[magnus::wrap(class = "Spikard::Native::SseStream", free_immediately)]
10
+ pub struct SseStream {
11
+ inner: RustSseStream,
12
+ }
13
+
14
+ impl SseStream {
15
+ pub fn new(inner: RustSseStream) -> Self {
16
+ Self { inner }
17
+ }
18
+
19
+ /// Get the raw body of the SSE response
20
+ fn body(&self) -> String {
21
+ self.inner.body().to_string()
22
+ }
23
+
24
+ /// Get all events from the stream
25
+ fn events(ruby: &Ruby, this: &Self) -> Result<Value, Error> {
26
+ let ruby_arr = ruby.ary_new();
27
+ for event in this.inner.events() {
28
+ let sse_event = SseEvent::new(event.clone());
29
+ let ruby_event = ruby.obj_wrap(sse_event);
30
+ ruby_arr.push(ruby_event)?;
31
+ }
32
+ Ok(ruby_arr.as_value())
33
+ }
34
+
35
+ /// Get events as JSON values
36
+ fn events_as_json(ruby: &Ruby, this: &Self) -> Result<Value, Error> {
37
+ let json_events = this.inner.events_as_json().map_err(|e| {
38
+ Error::new(
39
+ ruby.exception_runtime_error(),
40
+ format!("Failed to parse events as JSON: {}", e),
41
+ )
42
+ })?;
43
+
44
+ let ruby_arr = ruby.ary_new();
45
+ for value in json_events {
46
+ let ruby_val = json_to_ruby(ruby, &value)?;
47
+ ruby_arr.push(ruby_val)?;
48
+ }
49
+ Ok(ruby_arr.as_value())
50
+ }
51
+ }
52
+
53
+ /// Ruby wrapper for SSE event
54
+ #[magnus::wrap(class = "Spikard::Native::SseEvent", free_immediately)]
55
+ pub struct SseEvent {
56
+ inner: RustSseEvent,
57
+ }
58
+
59
+ impl SseEvent {
60
+ pub fn new(inner: RustSseEvent) -> Self {
61
+ Self { inner }
62
+ }
63
+
64
+ /// Get the data field of the event
65
+ fn data(&self) -> String {
66
+ self.inner.data.clone()
67
+ }
68
+
69
+ /// Parse the event data as JSON
70
+ fn as_json(ruby: &Ruby, this: &Self) -> Result<Value, Error> {
71
+ let value = this
72
+ .inner
73
+ .as_json()
74
+ .map_err(|e| Error::new(ruby.exception_runtime_error(), format!("Failed to parse JSON: {}", e)))?;
75
+
76
+ json_to_ruby(ruby, &value)
77
+ }
78
+ }
79
+
80
+ /// Create an SSE stream from a response snapshot
81
+ pub fn sse_stream_from_response(ruby: &Ruby, response: &ResponseSnapshot) -> Result<Value, Error> {
82
+ let stream = RustSseStream::from_response(response)
83
+ .map_err(|e| Error::new(ruby.exception_runtime_error(), format!("Failed to parse SSE: {}", e)))?;
84
+
85
+ let sse_stream = SseStream::new(stream);
86
+ Ok(ruby.obj_wrap(sse_stream).as_value())
87
+ }
88
+
89
+ /// Helper to convert JSON to Ruby object
90
+ fn json_to_ruby(ruby: &Ruby, value: &JsonValue) -> Result<Value, Error> {
91
+ match value {
92
+ JsonValue::Null => Ok(ruby.qnil().as_value()),
93
+ JsonValue::Bool(b) => Ok(if *b {
94
+ ruby.qtrue().as_value()
95
+ } else {
96
+ ruby.qfalse().as_value()
97
+ }),
98
+ JsonValue::Number(n) => {
99
+ if let Some(i) = n.as_i64() {
100
+ Ok(ruby.integer_from_i64(i).as_value())
101
+ } else if let Some(u) = n.as_u64() {
102
+ Ok(ruby.integer_from_i64(u as i64).as_value())
103
+ } else if let Some(f) = n.as_f64() {
104
+ Ok(ruby.float_from_f64(f).as_value())
105
+ } else {
106
+ Ok(ruby.qnil().as_value())
107
+ }
108
+ }
109
+ JsonValue::String(s) => Ok(ruby.str_new(s).as_value()),
110
+ JsonValue::Array(arr) => {
111
+ let ruby_arr = ruby.ary_new();
112
+ for item in arr {
113
+ let ruby_val = json_to_ruby(ruby, item)?;
114
+ ruby_arr.push(ruby_val)?;
115
+ }
116
+ Ok(ruby_arr.as_value())
117
+ }
118
+ JsonValue::Object(obj) => {
119
+ let ruby_hash = ruby.hash_new();
120
+ for (key, val) in obj {
121
+ let ruby_val = json_to_ruby(ruby, val)?;
122
+ ruby_hash.aset(ruby.str_new(key), ruby_val)?;
123
+ }
124
+ Ok(ruby_hash.as_value())
125
+ }
126
+ }
127
+ }
128
+
129
+ /// Initialize SSE test client bindings
130
+ pub fn init(ruby: &Ruby, module: &magnus::RModule) -> Result<(), Error> {
131
+ let native_module = module.define_module("Native")?;
132
+
133
+ let sse_stream_class = native_module.define_class("SseStream", ruby.class_object())?;
134
+ sse_stream_class.define_method("body", method!(SseStream::body, 0))?;
135
+ sse_stream_class.define_method("events", method!(SseStream::events, 0))?;
136
+ sse_stream_class.define_method("events_as_json", method!(SseStream::events_as_json, 0))?;
137
+
138
+ let sse_event_class = native_module.define_class("SseEvent", ruby.class_object())?;
139
+ sse_event_class.define_method("data", method!(SseEvent::data, 0))?;
140
+ sse_event_class.define_method("as_json", method!(SseEvent::as_json, 0))?;
141
+
142
+ Ok(())
143
+ }