spikard 0.13.0 → 0.15.2

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 (207) hide show
  1. checksums.yaml +4 -4
  2. data/Steepfile +6 -0
  3. data/ext/spikard_rb/extconf.rb +1 -2
  4. data/ext/spikard_rb/{Cargo.lock → native/Cargo.lock} +819 -424
  5. data/ext/spikard_rb/native/Cargo.toml +24 -0
  6. data/ext/spikard_rb/src/lib.rs +5366 -3
  7. data/lib/spikard/native.rb +86 -0
  8. data/lib/spikard/version.rb +6 -1
  9. data/lib/spikard.rb +8 -52
  10. data/lib/spikard_rb.so +0 -0
  11. data/sig/types.rbs +427 -0
  12. metadata +14 -243
  13. data/LICENSE +0 -1
  14. data/README.md +0 -285
  15. data/ext/spikard_rb/Cargo.toml +0 -17
  16. data/lib/spikard/app.rb +0 -458
  17. data/lib/spikard/background.rb +0 -58
  18. data/lib/spikard/config.rb +0 -506
  19. data/lib/spikard/converters.rb +0 -13
  20. data/lib/spikard/grpc.rb +0 -232
  21. data/lib/spikard/handler_wrapper.rb +0 -113
  22. data/lib/spikard/provide.rb +0 -315
  23. data/lib/spikard/response.rb +0 -198
  24. data/lib/spikard/schema.rb +0 -243
  25. data/lib/spikard/sse.rb +0 -111
  26. data/lib/spikard/streaming_response.rb +0 -44
  27. data/lib/spikard/testing.rb +0 -474
  28. data/lib/spikard/upload_file.rb +0 -131
  29. data/lib/spikard/websocket.rb +0 -59
  30. data/sig/spikard.rbs +0 -739
  31. data/vendor/crates/spikard-bindings-shared/Cargo.toml +0 -75
  32. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +0 -132
  33. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +0 -905
  34. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +0 -210
  35. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +0 -252
  36. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +0 -404
  37. data/vendor/crates/spikard-bindings-shared/src/grpc_metadata.rs +0 -199
  38. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +0 -252
  39. data/vendor/crates/spikard-bindings-shared/src/json_conversion.rs +0 -829
  40. data/vendor/crates/spikard-bindings-shared/src/lazy_cache.rs +0 -587
  41. data/vendor/crates/spikard-bindings-shared/src/lib.rs +0 -33
  42. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +0 -298
  43. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +0 -594
  44. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +0 -743
  45. data/vendor/crates/spikard-bindings-shared/src/response_interpreter.rs +0 -944
  46. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +0 -260
  47. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +0 -369
  48. data/vendor/crates/spikard-bindings-shared/tests/config_extractor_behavior.rs +0 -192
  49. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +0 -383
  50. data/vendor/crates/spikard-bindings-shared/tests/full_coverage.rs +0 -459
  51. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +0 -280
  52. data/vendor/crates/spikard-bindings-shared/tests/integration_tests.rs +0 -669
  53. data/vendor/crates/spikard-core/Cargo.toml +0 -55
  54. data/vendor/crates/spikard-core/src/bindings/mod.rs +0 -3
  55. data/vendor/crates/spikard-core/src/bindings/response.rs +0 -130
  56. data/vendor/crates/spikard-core/src/debug.rs +0 -127
  57. data/vendor/crates/spikard-core/src/di/container.rs +0 -711
  58. data/vendor/crates/spikard-core/src/di/dependency.rs +0 -273
  59. data/vendor/crates/spikard-core/src/di/error.rs +0 -118
  60. data/vendor/crates/spikard-core/src/di/factory.rs +0 -548
  61. data/vendor/crates/spikard-core/src/di/graph.rs +0 -507
  62. data/vendor/crates/spikard-core/src/di/mod.rs +0 -192
  63. data/vendor/crates/spikard-core/src/di/resolved.rs +0 -428
  64. data/vendor/crates/spikard-core/src/di/value.rs +0 -282
  65. data/vendor/crates/spikard-core/src/errors.rs +0 -72
  66. data/vendor/crates/spikard-core/src/http.rs +0 -492
  67. data/vendor/crates/spikard-core/src/lib.rs +0 -29
  68. data/vendor/crates/spikard-core/src/lifecycle.rs +0 -1273
  69. data/vendor/crates/spikard-core/src/metadata.rs +0 -378
  70. data/vendor/crates/spikard-core/src/parameters.rs +0 -2546
  71. data/vendor/crates/spikard-core/src/problem.rs +0 -358
  72. data/vendor/crates/spikard-core/src/request_data.rs +0 -1146
  73. data/vendor/crates/spikard-core/src/router.rs +0 -530
  74. data/vendor/crates/spikard-core/src/schema_registry.rs +0 -197
  75. data/vendor/crates/spikard-core/src/type_hints.rs +0 -311
  76. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +0 -710
  77. data/vendor/crates/spikard-core/src/validation/mod.rs +0 -470
  78. data/vendor/crates/spikard-core/tests/bindings_response_tests.rs +0 -136
  79. data/vendor/crates/spikard-core/tests/di_dependency_defaults.rs +0 -37
  80. data/vendor/crates/spikard-core/tests/error_mapper.rs +0 -761
  81. data/vendor/crates/spikard-core/tests/parameters_edge_cases.rs +0 -106
  82. data/vendor/crates/spikard-core/tests/parameters_full.rs +0 -701
  83. data/vendor/crates/spikard-core/tests/parameters_schema_and_formats.rs +0 -301
  84. data/vendor/crates/spikard-core/tests/request_data_roundtrip.rs +0 -67
  85. data/vendor/crates/spikard-core/tests/validation_coverage.rs +0 -250
  86. data/vendor/crates/spikard-core/tests/validation_error_paths.rs +0 -45
  87. data/vendor/crates/spikard-http/Cargo.toml +0 -82
  88. data/vendor/crates/spikard-http/examples/sse-notifications.rs +0 -148
  89. data/vendor/crates/spikard-http/examples/websocket-chat.rs +0 -92
  90. data/vendor/crates/spikard-http/src/auth.rs +0 -301
  91. data/vendor/crates/spikard-http/src/background.rs +0 -1859
  92. data/vendor/crates/spikard-http/src/bindings/mod.rs +0 -3
  93. data/vendor/crates/spikard-http/src/bindings/response.rs +0 -1
  94. data/vendor/crates/spikard-http/src/body_metadata.rs +0 -8
  95. data/vendor/crates/spikard-http/src/cors.rs +0 -1026
  96. data/vendor/crates/spikard-http/src/debug.rs +0 -128
  97. data/vendor/crates/spikard-http/src/di_handler.rs +0 -1672
  98. data/vendor/crates/spikard-http/src/grpc/framing.rs +0 -653
  99. data/vendor/crates/spikard-http/src/grpc/handler.rs +0 -1211
  100. data/vendor/crates/spikard-http/src/grpc/mod.rs +0 -556
  101. data/vendor/crates/spikard-http/src/grpc/service.rs +0 -706
  102. data/vendor/crates/spikard-http/src/grpc/streaming.rs +0 -319
  103. data/vendor/crates/spikard-http/src/handler_response.rs +0 -901
  104. data/vendor/crates/spikard-http/src/handler_trait.rs +0 -1015
  105. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +0 -290
  106. data/vendor/crates/spikard-http/src/jsonrpc/http_handler.rs +0 -502
  107. data/vendor/crates/spikard-http/src/jsonrpc/method_registry.rs +0 -648
  108. data/vendor/crates/spikard-http/src/jsonrpc/mod.rs +0 -60
  109. data/vendor/crates/spikard-http/src/jsonrpc/openrpc.rs +0 -325
  110. data/vendor/crates/spikard-http/src/jsonrpc/protocol.rs +0 -1207
  111. data/vendor/crates/spikard-http/src/jsonrpc/router.rs +0 -2262
  112. data/vendor/crates/spikard-http/src/lib.rs +0 -566
  113. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +0 -230
  114. data/vendor/crates/spikard-http/src/lifecycle.rs +0 -1193
  115. data/vendor/crates/spikard-http/src/middleware/mod.rs +0 -560
  116. data/vendor/crates/spikard-http/src/middleware/multipart.rs +0 -912
  117. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +0 -513
  118. data/vendor/crates/spikard-http/src/middleware/validation.rs +0 -768
  119. data/vendor/crates/spikard-http/src/openapi/mod.rs +0 -309
  120. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +0 -535
  121. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +0 -1363
  122. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +0 -667
  123. data/vendor/crates/spikard-http/src/query_parser.rs +0 -793
  124. data/vendor/crates/spikard-http/src/response.rs +0 -720
  125. data/vendor/crates/spikard-http/src/server/fast_router.rs +0 -186
  126. data/vendor/crates/spikard-http/src/server/grpc_routing.rs +0 -1243
  127. data/vendor/crates/spikard-http/src/server/handler.rs +0 -1661
  128. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +0 -253
  129. data/vendor/crates/spikard-http/src/server/mod.rs +0 -1717
  130. data/vendor/crates/spikard-http/src/server/request_extraction.rs +0 -871
  131. data/vendor/crates/spikard-http/src/server/routing_factory.rs +0 -618
  132. data/vendor/crates/spikard-http/src/sse.rs +0 -1409
  133. data/vendor/crates/spikard-http/src/testing/form.rs +0 -52
  134. data/vendor/crates/spikard-http/src/testing/multipart.rs +0 -64
  135. data/vendor/crates/spikard-http/src/testing/test_client.rs +0 -825
  136. data/vendor/crates/spikard-http/src/testing.rs +0 -617
  137. data/vendor/crates/spikard-http/src/websocket.rs +0 -1477
  138. data/vendor/crates/spikard-http/tests/auth_integration.rs +0 -645
  139. data/vendor/crates/spikard-http/tests/background_behavior.rs +0 -832
  140. data/vendor/crates/spikard-http/tests/common/grpc_helpers.rs +0 -1012
  141. data/vendor/crates/spikard-http/tests/common/handlers.rs +0 -309
  142. data/vendor/crates/spikard-http/tests/common/mod.rs +0 -33
  143. data/vendor/crates/spikard-http/tests/common/test_builders.rs +0 -628
  144. data/vendor/crates/spikard-http/tests/di_handler_error_responses.rs +0 -162
  145. data/vendor/crates/spikard-http/tests/di_integration.rs +0 -192
  146. data/vendor/crates/spikard-http/tests/doc_snippets.rs +0 -5
  147. data/vendor/crates/spikard-http/tests/grpc_bidirectional_streaming.rs +0 -430
  148. data/vendor/crates/spikard-http/tests/grpc_client_streaming.rs +0 -738
  149. data/vendor/crates/spikard-http/tests/grpc_error_handling_test.rs +0 -652
  150. data/vendor/crates/spikard-http/tests/grpc_integration_test.rs +0 -334
  151. data/vendor/crates/spikard-http/tests/grpc_metadata_test.rs +0 -532
  152. data/vendor/crates/spikard-http/tests/grpc_server_integration.rs +0 -495
  153. data/vendor/crates/spikard-http/tests/grpc_server_streaming.rs +0 -975
  154. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +0 -1093
  155. data/vendor/crates/spikard-http/tests/middleware_stack_integration.rs +0 -389
  156. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +0 -656
  157. data/vendor/crates/spikard-http/tests/request_extraction_full.rs +0 -513
  158. data/vendor/crates/spikard-http/tests/server_auth_middleware_behavior.rs +0 -328
  159. data/vendor/crates/spikard-http/tests/server_config_builder.rs +0 -335
  160. data/vendor/crates/spikard-http/tests/server_configured_router_behavior.rs +0 -374
  161. data/vendor/crates/spikard-http/tests/server_cors_preflight.rs +0 -83
  162. data/vendor/crates/spikard-http/tests/server_handler_wrappers.rs +0 -464
  163. data/vendor/crates/spikard-http/tests/server_method_router_additional_behavior.rs +0 -286
  164. data/vendor/crates/spikard-http/tests/server_method_router_coverage.rs +0 -118
  165. data/vendor/crates/spikard-http/tests/server_middleware_behavior.rs +0 -99
  166. data/vendor/crates/spikard-http/tests/server_middleware_branches.rs +0 -204
  167. data/vendor/crates/spikard-http/tests/server_openapi_jsonrpc_static.rs +0 -427
  168. data/vendor/crates/spikard-http/tests/server_router_behavior.rs +0 -121
  169. data/vendor/crates/spikard-http/tests/sse_behavior.rs +0 -620
  170. data/vendor/crates/spikard-http/tests/sse_full_behavior.rs +0 -584
  171. data/vendor/crates/spikard-http/tests/sse_handler_behavior.rs +0 -130
  172. data/vendor/crates/spikard-http/tests/test_client_requests.rs +0 -167
  173. data/vendor/crates/spikard-http/tests/testing_helpers.rs +0 -87
  174. data/vendor/crates/spikard-http/tests/testing_module_coverage.rs +0 -155
  175. data/vendor/crates/spikard-http/tests/urlencoded_content_type.rs +0 -82
  176. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +0 -663
  177. data/vendor/crates/spikard-http/tests/websocket_full_behavior.rs +0 -440
  178. data/vendor/crates/spikard-http/tests/websocket_integration.rs +0 -150
  179. data/vendor/crates/spikard-rb/Cargo.toml +0 -63
  180. data/vendor/crates/spikard-rb/build.rs +0 -200
  181. data/vendor/crates/spikard-rb/src/background.rs +0 -63
  182. data/vendor/crates/spikard-rb/src/config/mod.rs +0 -5
  183. data/vendor/crates/spikard-rb/src/config/server_config.rs +0 -401
  184. data/vendor/crates/spikard-rb/src/conversion.rs +0 -688
  185. data/vendor/crates/spikard-rb/src/di/builder.rs +0 -100
  186. data/vendor/crates/spikard-rb/src/di/mod.rs +0 -410
  187. data/vendor/crates/spikard-rb/src/grpc/handler.rs +0 -875
  188. data/vendor/crates/spikard-rb/src/grpc/mod.rs +0 -13
  189. data/vendor/crates/spikard-rb/src/gvl.rs +0 -80
  190. data/vendor/crates/spikard-rb/src/handler.rs +0 -699
  191. data/vendor/crates/spikard-rb/src/integration/mod.rs +0 -3
  192. data/vendor/crates/spikard-rb/src/lib.rs +0 -2268
  193. data/vendor/crates/spikard-rb/src/lifecycle.rs +0 -334
  194. data/vendor/crates/spikard-rb/src/metadata/mod.rs +0 -5
  195. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +0 -507
  196. data/vendor/crates/spikard-rb/src/request.rs +0 -439
  197. data/vendor/crates/spikard-rb/src/runtime/mod.rs +0 -5
  198. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +0 -368
  199. data/vendor/crates/spikard-rb/src/server.rs +0 -304
  200. data/vendor/crates/spikard-rb/src/sse.rs +0 -231
  201. data/vendor/crates/spikard-rb/src/testing/client.rs +0 -698
  202. data/vendor/crates/spikard-rb/src/testing/mod.rs +0 -7
  203. data/vendor/crates/spikard-rb/src/testing/sse.rs +0 -108
  204. data/vendor/crates/spikard-rb/src/testing/websocket.rs +0 -573
  205. data/vendor/crates/spikard-rb/src/websocket.rs +0 -521
  206. data/vendor/crates/spikard-rb-macros/Cargo.toml +0 -20
  207. data/vendor/crates/spikard-rb-macros/src/lib.rs +0 -51
@@ -1,698 +0,0 @@
1
- //! Native Ruby test client for HTTP testing.
2
- //!
3
- //! This module implements `NativeTestClient`, a wrapped Ruby class that provides
4
- //! HTTP testing capabilities against a Spikard server. It manages test servers
5
- //! for both HTTP and WebSocket/SSE transports.
6
-
7
- #![allow(dead_code)]
8
-
9
- use axum::Router;
10
- use axum::http::Method;
11
- use axum_test::{TestServer, TestServerConfig, Transport};
12
- use bytes::Bytes;
13
- use cookie::Cookie;
14
- use magnus::prelude::*;
15
- use magnus::{Error, RHash, Ruby, Value, gc::Marker};
16
- use serde_json::Value as JsonValue;
17
- use spikard_http::testing::{
18
- MultipartFilePart, ResponseSnapshot, SnapshotError, build_multipart_body, encode_urlencoded_body, snapshot_response,
19
- };
20
- use spikard_http::{Route, RouteMetadata};
21
- use std::cell::RefCell;
22
- use std::collections::HashMap;
23
- use std::sync::Arc;
24
- use std::time::Duration;
25
- use url::Url;
26
-
27
- use crate::conversion::{parse_request_config, response_to_ruby};
28
- use crate::handler::RubyHandler;
29
-
30
- /// Request configuration built from Ruby options hash.
31
- pub struct RequestConfig {
32
- pub query: Option<JsonValue>,
33
- pub headers: HashMap<String, String>,
34
- pub cookies: HashMap<String, String>,
35
- pub body: Option<RequestBody>,
36
- }
37
-
38
- /// HTTP request body variants.
39
- pub enum RequestBody {
40
- Json(JsonValue),
41
- Form(JsonValue),
42
- Raw(String),
43
- Multipart {
44
- form_data: Vec<(String, String)>,
45
- files: Vec<MultipartFilePart>,
46
- },
47
- }
48
-
49
- /// Snapshot of an HTTP response.
50
- pub struct TestResponseData {
51
- pub status: u16,
52
- pub headers: HashMap<String, String>,
53
- pub body_text: Option<String>,
54
- }
55
-
56
- /// Error wrapper for native request failures.
57
- #[derive(Debug)]
58
- pub struct NativeRequestError(pub String);
59
-
60
- #[derive(Debug)]
61
- enum WebSocketConnectError {
62
- Timeout,
63
- Other(String),
64
- }
65
-
66
- /// Inner client state containing the test servers and handlers.
67
- pub struct ClientInner {
68
- pub http_server: Arc<TestServer>,
69
- pub transport_server: Arc<TestServer>,
70
- /// Keep Ruby handler closures alive for GC; accessed via the `mark` hook.
71
- #[allow(dead_code)]
72
- pub handlers: Vec<RubyHandler>,
73
- }
74
-
75
- /// Native Ruby TestClient wrapper for integration testing.
76
- ///
77
- /// Wraps an optional `ClientInner` that holds the HTTP test servers
78
- /// and keeps handler references alive for Ruby's garbage collector.
79
- #[derive(Default)]
80
- #[magnus::wrap(class = "Spikard::Native::TestClient", free_immediately, mark)]
81
- pub struct NativeTestClient {
82
- pub inner: RefCell<Option<ClientInner>>,
83
- }
84
-
85
- impl NativeTestClient {
86
- /// Initialize the test client with routes, handlers, and server config.
87
- ///
88
- /// # Arguments
89
- ///
90
- /// * `ruby` - Ruby VM reference
91
- /// * `this` - The wrapped NativeTestClient instance
92
- /// * `routes_json` - JSON string containing route metadata
93
- /// * `handlers` - Ruby Hash mapping handler_name => Proc
94
- /// * `config_value` - Ruby ServerConfig object
95
- /// * `ws_handlers` - Ruby Hash of WebSocket handlers (optional)
96
- /// * `sse_producers` - Ruby Hash of SSE producers (optional)
97
- pub fn initialize(
98
- ruby: &Ruby,
99
- this: &Self,
100
- routes_json: String,
101
- handlers: Value,
102
- config_value: Value,
103
- ws_handlers: Value,
104
- sse_producers: Value,
105
- ) -> Result<(), Error> {
106
- trace_step("initialize:start");
107
- let metadata: Vec<RouteMetadata> = serde_json::from_str(&routes_json)
108
- .map_err(|err| Error::new(ruby.exception_arg_error(), format!("Invalid routes JSON: {err}")))?;
109
-
110
- let handlers_hash = RHash::from_value(handlers).ok_or_else(|| {
111
- Error::new(
112
- ruby.exception_arg_error(),
113
- "handlers parameter must be a Hash of handler_name => Proc",
114
- )
115
- })?;
116
-
117
- let json_module = ruby
118
- .class_object()
119
- .const_get("JSON")
120
- .map_err(|_| Error::new(ruby.exception_runtime_error(), "JSON module not available"))?;
121
-
122
- let server_config = crate::config::extract_server_config(ruby, config_value)?;
123
-
124
- let schema_registry = spikard_http::SchemaRegistry::new();
125
- let mut prepared_routes = Vec::with_capacity(metadata.len());
126
- let mut handler_refs = Vec::with_capacity(metadata.len());
127
- let mut route_metadata_vec = Vec::with_capacity(metadata.len());
128
-
129
- for meta in metadata.clone() {
130
- crate::validate_route_metadata(ruby, &meta)?;
131
- let route = Route::from_metadata(meta.clone(), &schema_registry)
132
- .map_err(|err| Error::new(ruby.exception_runtime_error(), format!("Failed to build route: {err}")))?;
133
- let handler_value = crate::conversion::fetch_handler(ruby, &handlers_hash, &meta.handler_name)?;
134
-
135
- let handler = RubyHandler::new(&route, handler_value, json_module)?;
136
- prepared_routes.push((route, Arc::new(handler.clone()) as Arc<dyn spikard_http::Handler>));
137
- handler_refs.push(handler);
138
- route_metadata_vec.push(meta);
139
- }
140
-
141
- trace_step("initialize:build_router");
142
- let mut router = spikard_http::server::build_router_with_handlers_and_config(
143
- prepared_routes,
144
- server_config,
145
- route_metadata_vec,
146
- )
147
- .map_err(|err| Error::new(ruby.exception_runtime_error(), format!("Failed to build router: {err}")))?;
148
-
149
- let mut ws_endpoints = Vec::new();
150
- if !ws_handlers.is_nil() {
151
- trace_step("initialize:ws_handlers");
152
- let ws_hash = RHash::from_value(ws_handlers)
153
- .ok_or_else(|| Error::new(ruby.exception_arg_error(), "WebSocket handlers must be a Hash"))?;
154
-
155
- ws_hash.foreach(
156
- |path: String, factory: Value| -> Result<magnus::r_hash::ForEach, Error> {
157
- if let Some(ws_state) = crate::websocket::create_websocket_state(ruby, factory)? {
158
- ws_endpoints.push((path, ws_state));
159
- }
160
-
161
- Ok(magnus::r_hash::ForEach::Continue)
162
- },
163
- )?;
164
- }
165
-
166
- let mut sse_endpoints = Vec::new();
167
- if !sse_producers.is_nil() {
168
- trace_step("initialize:sse_producers");
169
- let sse_hash = RHash::from_value(sse_producers)
170
- .ok_or_else(|| Error::new(ruby.exception_arg_error(), "SSE producers must be a Hash"))?;
171
-
172
- sse_hash.foreach(
173
- |path: String, factory: Value| -> Result<magnus::r_hash::ForEach, Error> {
174
- let producer_instance = factory.funcall::<_, _, Value>("call", ()).map_err(|e| {
175
- Error::new(
176
- ruby.exception_runtime_error(),
177
- format!("Failed to create SSE producer: {}", e),
178
- )
179
- })?;
180
-
181
- let sse_state = crate::sse::create_sse_state(ruby, producer_instance)?;
182
-
183
- sse_endpoints.push((path, sse_state));
184
-
185
- Ok(magnus::r_hash::ForEach::Continue)
186
- },
187
- )?;
188
- }
189
-
190
- use axum::routing::get;
191
- for (path, ws_state) in ws_endpoints {
192
- router = router.route(
193
- &path,
194
- get(spikard_http::websocket_handler::<crate::websocket::RubyWebSocketHandler>).with_state(ws_state),
195
- );
196
- }
197
-
198
- for (path, sse_state) in sse_endpoints {
199
- router = router.route(
200
- &path,
201
- get(spikard_http::sse_handler::<crate::sse::RubySseEventProducer>).with_state(sse_state),
202
- );
203
- }
204
-
205
- trace_step("initialize:test_server_http");
206
- let timeout_duration = test_server_timeout();
207
- let http_server = init_test_server(router.clone(), timeout_duration, "test server", ruby)?;
208
-
209
- trace_step("initialize:test_server_ws");
210
- let ws_config = TestServerConfig {
211
- transport: Some(Transport::HttpRandomPort),
212
- ..Default::default()
213
- };
214
- let transport_server =
215
- init_test_server_with_config(router, ws_config, timeout_duration, "WebSocket transport server", ruby)?;
216
-
217
- trace_step("initialize:done");
218
- *this.inner.borrow_mut() = Some(ClientInner {
219
- http_server: Arc::new(http_server),
220
- transport_server: Arc::new(transport_server),
221
- handlers: handler_refs,
222
- });
223
-
224
- Ok(())
225
- }
226
-
227
- /// Execute an HTTP request against the test server.
228
- ///
229
- /// # Arguments
230
- ///
231
- /// * `ruby` - Ruby VM reference
232
- /// * `this` - The wrapped NativeTestClient instance
233
- /// * `method` - HTTP method (GET, POST, etc.)
234
- /// * `path` - URL path
235
- /// * `options` - Ruby Hash with query, headers, cookies, body, etc.
236
- pub fn request(ruby: &Ruby, this: &Self, method: String, path: String, options: Value) -> Result<Value, Error> {
237
- let inner_borrow = this.inner.borrow();
238
- let inner = inner_borrow
239
- .as_ref()
240
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "TestClient not initialised"))?;
241
- let method_upper = method.to_ascii_uppercase();
242
- let http_method = Method::from_bytes(method_upper.as_bytes()).map_err(|err| {
243
- Error::new(
244
- ruby.exception_arg_error(),
245
- format!("Unsupported method {method_upper}: {err}"),
246
- )
247
- })?;
248
-
249
- let request_config = parse_request_config(ruby, options)?;
250
-
251
- let runtime = crate::server::global_runtime(ruby)?;
252
- let server = inner.http_server.clone();
253
- let path_value = path.clone();
254
- let request_config_value = request_config;
255
- let response = crate::call_without_gvl!(
256
- block_on_request,
257
- args: (
258
- runtime, &tokio::runtime::Runtime,
259
- server, Arc<TestServer>,
260
- http_method, Method,
261
- path_value, String,
262
- request_config_value, RequestConfig
263
- ),
264
- return_type: Result<TestResponseData, NativeRequestError>
265
- )
266
- .map_err(|err| {
267
- Error::new(
268
- ruby.exception_runtime_error(),
269
- format!("Request failed for {method_upper} {path}: {}", err.0),
270
- )
271
- })?;
272
-
273
- response_to_ruby(ruby, response)
274
- }
275
-
276
- /// Close the test client and clean up resources.
277
- pub fn close(&self) -> Result<(), Error> {
278
- *self.inner.borrow_mut() = None;
279
- Ok(())
280
- }
281
-
282
- /// Connect to a WebSocket endpoint on the test server.
283
- pub fn websocket(ruby: &Ruby, this: &Self, path: String) -> Result<Value, Error> {
284
- let inner_borrow = this.inner.borrow();
285
- let inner = inner_borrow
286
- .as_ref()
287
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "TestClient not initialised"))?;
288
-
289
- let server = Arc::clone(&inner.transport_server);
290
-
291
- drop(inner_borrow);
292
-
293
- let timeout_duration = websocket_timeout();
294
- let ws = crate::call_without_gvl!(
295
- block_on_websocket_connect,
296
- args: (
297
- server, Arc<TestServer>,
298
- path, String,
299
- timeout_duration, Duration
300
- ),
301
- return_type: Result<crate::testing::websocket::WebSocketConnection, WebSocketConnectError>
302
- )
303
- .map_err(|err| match err {
304
- WebSocketConnectError::Timeout => Error::new(
305
- ruby.exception_runtime_error(),
306
- format!("WebSocket connect timed out after {}ms", timeout_duration.as_millis()),
307
- ),
308
- WebSocketConnectError::Other(message) => Error::new(
309
- ruby.exception_runtime_error(),
310
- format!("WebSocket connect failed: {}", message),
311
- ),
312
- })?;
313
-
314
- let ws_conn = crate::testing::websocket::WebSocketTestConnection::new(ws);
315
- Ok(ruby.obj_wrap(ws_conn).as_value())
316
- }
317
-
318
- /// Connect to an SSE endpoint on the test server.
319
- pub fn sse(ruby: &Ruby, this: &Self, path: String) -> Result<Value, Error> {
320
- let inner_borrow = this.inner.borrow();
321
- let inner = inner_borrow
322
- .as_ref()
323
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "TestClient not initialised"))?;
324
-
325
- let runtime = crate::server::global_runtime(ruby)?;
326
- let server = inner.http_server.clone();
327
- let http_method = Method::GET;
328
- let request_config = RequestConfig {
329
- query: None,
330
- headers: HashMap::new(),
331
- cookies: HashMap::new(),
332
- body: None,
333
- };
334
- let response = crate::call_without_gvl!(
335
- block_on_request,
336
- args: (
337
- runtime, &tokio::runtime::Runtime,
338
- server, Arc<TestServer>,
339
- http_method, Method,
340
- path, String,
341
- request_config, RequestConfig
342
- ),
343
- return_type: Result<TestResponseData, NativeRequestError>
344
- )
345
- .map_err(|err| Error::new(ruby.exception_runtime_error(), format!("SSE request failed: {}", err.0)))?;
346
-
347
- let body = response.body_text.unwrap_or_default().into_bytes();
348
- let snapshot = ResponseSnapshot {
349
- status: response.status,
350
- headers: response.headers,
351
- body,
352
- };
353
-
354
- crate::testing::sse::sse_stream_from_response(ruby, &snapshot)
355
- }
356
-
357
- /// Send a GraphQL query/mutation
358
- pub fn graphql(
359
- ruby: &Ruby,
360
- this: &Self,
361
- query: String,
362
- variables: Value,
363
- operation_name: Value,
364
- ) -> Result<Value, Error> {
365
- let inner_borrow = this.inner.borrow();
366
- let inner = inner_borrow
367
- .as_ref()
368
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "TestClient not initialised"))?;
369
-
370
- let json_module = ruby
371
- .class_object()
372
- .const_get("JSON")
373
- .map_err(|_| Error::new(ruby.exception_runtime_error(), "JSON module not available"))?;
374
-
375
- let variables_json = if variables.is_nil() {
376
- None
377
- } else {
378
- Some(crate::conversion::ruby_value_to_json(ruby, json_module, variables)?)
379
- };
380
-
381
- let operation_name_str = if operation_name.is_nil() {
382
- None
383
- } else {
384
- Some(String::try_convert(operation_name)?)
385
- };
386
-
387
- let runtime = crate::server::global_runtime(ruby)?;
388
- let server = inner.http_server.clone();
389
- let query_value = query.clone();
390
-
391
- let snapshot = crate::call_without_gvl!(
392
- block_on_graphql,
393
- args: (
394
- runtime, &tokio::runtime::Runtime,
395
- server, Arc<TestServer>,
396
- query_value, String,
397
- variables_json, Option<JsonValue>,
398
- operation_name_str, Option<String>
399
- ),
400
- return_type: Result<ResponseSnapshot, NativeRequestError>
401
- )
402
- .map_err(|err| {
403
- Error::new(
404
- ruby.exception_runtime_error(),
405
- format!("GraphQL request failed: {}", err.0),
406
- )
407
- })?;
408
-
409
- response_snapshot_to_ruby(ruby, snapshot)
410
- }
411
-
412
- /// Send a GraphQL query and get HTTP status separately
413
- pub fn graphql_with_status(
414
- ruby: &Ruby,
415
- this: &Self,
416
- query: String,
417
- variables: Value,
418
- operation_name: Value,
419
- ) -> Result<Value, Error> {
420
- let inner_borrow = this.inner.borrow();
421
- let inner = inner_borrow
422
- .as_ref()
423
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "TestClient not initialised"))?;
424
-
425
- let json_module = ruby
426
- .class_object()
427
- .const_get("JSON")
428
- .map_err(|_| Error::new(ruby.exception_runtime_error(), "JSON module not available"))?;
429
-
430
- let variables_json = if variables.is_nil() {
431
- None
432
- } else {
433
- Some(crate::conversion::ruby_value_to_json(ruby, json_module, variables)?)
434
- };
435
-
436
- let operation_name_str = if operation_name.is_nil() {
437
- None
438
- } else {
439
- Some(String::try_convert(operation_name)?)
440
- };
441
-
442
- let runtime = crate::server::global_runtime(ruby)?;
443
- let server = inner.http_server.clone();
444
- let query_value = query.clone();
445
-
446
- let snapshot = crate::call_without_gvl!(
447
- block_on_graphql,
448
- args: (
449
- runtime, &tokio::runtime::Runtime,
450
- server, Arc<TestServer>,
451
- query_value, String,
452
- variables_json, Option<JsonValue>,
453
- operation_name_str, Option<String>
454
- ),
455
- return_type: Result<ResponseSnapshot, NativeRequestError>
456
- )
457
- .map_err(|err| {
458
- Error::new(
459
- ruby.exception_runtime_error(),
460
- format!("GraphQL request failed: {}", err.0),
461
- )
462
- })?;
463
-
464
- let status = snapshot.status;
465
- let response = response_snapshot_to_ruby(ruby, snapshot)?;
466
-
467
- let array = ruby.ary_new_capa(2);
468
- array.push(ruby.integer_from_i64(status as i64))?;
469
- array.push(response)?;
470
- Ok(array.as_value())
471
- }
472
-
473
- /// GC mark hook so Ruby keeps handler closures alive.
474
- #[allow(dead_code)]
475
- pub fn mark(&self, marker: &Marker) {
476
- let inner_ref = self.inner.borrow();
477
- if let Some(inner) = inner_ref.as_ref() {
478
- for handler in &inner.handlers {
479
- handler.mark(marker);
480
- }
481
- }
482
- }
483
- }
484
-
485
- fn websocket_timeout() -> Duration {
486
- const DEFAULT_TIMEOUT_MS: u64 = 30_000;
487
- let timeout_ms = std::env::var("SPIKARD_RB_WS_TIMEOUT_MS")
488
- .ok()
489
- .and_then(|value| value.parse::<u64>().ok())
490
- .unwrap_or(DEFAULT_TIMEOUT_MS);
491
- Duration::from_millis(timeout_ms)
492
- }
493
-
494
- pub fn block_on_request(
495
- runtime: &tokio::runtime::Runtime,
496
- server: Arc<TestServer>,
497
- method: Method,
498
- path: String,
499
- config: RequestConfig,
500
- ) -> Result<TestResponseData, NativeRequestError> {
501
- runtime.block_on(execute_request(server, method, path, config))
502
- }
503
-
504
- fn block_on_websocket_connect(
505
- server: Arc<TestServer>,
506
- path: String,
507
- timeout_duration: Duration,
508
- ) -> Result<crate::testing::websocket::WebSocketConnection, WebSocketConnectError> {
509
- let url = server
510
- .server_url(&path)
511
- .map_err(|err| WebSocketConnectError::Other(err.to_string()))?;
512
- let ws_url = to_ws_url(url)?;
513
-
514
- match crate::testing::websocket::WebSocketConnection::connect(ws_url, timeout_duration) {
515
- Ok(ws) => Ok(ws),
516
- Err(crate::testing::websocket::WebSocketIoError::Timeout) => Err(WebSocketConnectError::Timeout),
517
- Err(err) => Err(WebSocketConnectError::Other(format!("{:?}", err))),
518
- }
519
- }
520
-
521
- fn to_ws_url(mut url: Url) -> Result<Url, WebSocketConnectError> {
522
- let scheme = match url.scheme() {
523
- "https" => "wss",
524
- _ => "ws",
525
- };
526
- url.set_scheme(scheme)
527
- .map_err(|_| WebSocketConnectError::Other("Failed to set WebSocket scheme".to_string()))?;
528
- Ok(url)
529
- }
530
-
531
- fn test_server_timeout() -> Duration {
532
- const DEFAULT_TIMEOUT_MS: u64 = 30_000;
533
- let timeout_ms = std::env::var("SPIKARD_RB_TESTSERVER_TIMEOUT_MS")
534
- .ok()
535
- .and_then(|value| value.parse::<u64>().ok())
536
- .unwrap_or(DEFAULT_TIMEOUT_MS);
537
- Duration::from_millis(timeout_ms)
538
- }
539
-
540
- fn trace_step(message: &str) {
541
- if std::env::var("SPIKARD_RB_TEST_TRACE").ok().as_deref() == Some("1") {
542
- eprintln!("[spikard-rb-test] {}", message);
543
- }
544
- }
545
-
546
- fn init_test_server(router: Router, _timeout: Duration, label: &str, ruby: &Ruby) -> Result<TestServer, Error> {
547
- let runtime = crate::server::global_runtime(ruby)?;
548
- let _guard = runtime.enter();
549
- TestServer::try_new(router).map_err(|err| {
550
- Error::new(
551
- ruby.exception_runtime_error(),
552
- format!("Failed to initialise {label}: {err}"),
553
- )
554
- })
555
- }
556
-
557
- fn init_test_server_with_config(
558
- router: Router,
559
- config: TestServerConfig,
560
- _timeout: Duration,
561
- label: &str,
562
- ruby: &Ruby,
563
- ) -> Result<TestServer, Error> {
564
- let runtime = crate::server::global_runtime(ruby)?;
565
- let _guard = runtime.enter();
566
- TestServer::try_new_with_config(router, config).map_err(|err| {
567
- Error::new(
568
- ruby.exception_runtime_error(),
569
- format!("Failed to initialise {label}: {err}"),
570
- )
571
- })
572
- }
573
-
574
- /// Execute an HTTP request against a test server.
575
- ///
576
- /// Handles method routing, query params, headers, cookies, and various body formats.
577
- pub async fn execute_request(
578
- server: Arc<TestServer>,
579
- method: Method,
580
- path: String,
581
- config: RequestConfig,
582
- ) -> Result<TestResponseData, NativeRequestError> {
583
- let mut request = match method {
584
- Method::GET => server.get(&path),
585
- Method::POST => server.post(&path),
586
- Method::PUT => server.put(&path),
587
- Method::PATCH => server.patch(&path),
588
- Method::DELETE => server.delete(&path),
589
- Method::HEAD => server.method(Method::HEAD, &path),
590
- Method::OPTIONS => server.method(Method::OPTIONS, &path),
591
- Method::TRACE => server.method(Method::TRACE, &path),
592
- other => return Err(NativeRequestError(format!("Unsupported HTTP method {other}"))),
593
- };
594
-
595
- if let Some(query) = config.query {
596
- request = request.add_query_params(&query);
597
- }
598
-
599
- for (name, value) in config.headers {
600
- request = request.add_header(name.as_str(), value.as_str());
601
- }
602
-
603
- for (name, value) in config.cookies {
604
- request = request.add_cookie(Cookie::new(name, value));
605
- }
606
-
607
- if let Some(body) = config.body {
608
- match body {
609
- RequestBody::Json(json_value) => {
610
- request = request.json(&json_value);
611
- }
612
- RequestBody::Form(form_value) => {
613
- let encoded = encode_urlencoded_body(&form_value)
614
- .map_err(|err| NativeRequestError(format!("Failed to encode form body: {err}")))?;
615
- request = request
616
- .content_type("application/x-www-form-urlencoded")
617
- .bytes(Bytes::from(encoded));
618
- }
619
- RequestBody::Raw(raw) => {
620
- request = request.bytes(Bytes::from(raw));
621
- }
622
- RequestBody::Multipart { form_data, files } => {
623
- let (multipart_body, boundary) = build_multipart_body(&form_data, &files);
624
- request = request
625
- .content_type(&format!("multipart/form-data; boundary={}", boundary))
626
- .bytes(Bytes::from(multipart_body));
627
- }
628
- }
629
- }
630
-
631
- let response = request.await;
632
- let snapshot = snapshot_response(response).await.map_err(snapshot_err_to_native)?;
633
- let body_text = if snapshot.body.is_empty() {
634
- None
635
- } else {
636
- Some(String::from_utf8_lossy(&snapshot.body).into_owned())
637
- };
638
-
639
- Ok(TestResponseData {
640
- status: snapshot.status,
641
- headers: snapshot.headers,
642
- body_text,
643
- })
644
- }
645
-
646
- fn snapshot_err_to_native(err: SnapshotError) -> NativeRequestError {
647
- NativeRequestError(err.to_string())
648
- }
649
-
650
- pub fn block_on_graphql(
651
- runtime: &tokio::runtime::Runtime,
652
- server: Arc<TestServer>,
653
- query: String,
654
- variables: Option<JsonValue>,
655
- operation_name: Option<String>,
656
- ) -> Result<ResponseSnapshot, NativeRequestError> {
657
- runtime.block_on(execute_graphql_request(server, query, variables, operation_name))
658
- }
659
-
660
- async fn execute_graphql_request(
661
- server: Arc<TestServer>,
662
- query: String,
663
- variables: Option<JsonValue>,
664
- operation_name: Option<String>,
665
- ) -> Result<ResponseSnapshot, NativeRequestError> {
666
- let mut body = serde_json::json!({ "query": query });
667
- if let Some(vars) = variables {
668
- body["variables"] = vars;
669
- }
670
- if let Some(op_name) = operation_name {
671
- body["operationName"] = JsonValue::String(op_name);
672
- }
673
-
674
- let response = server.post("/graphql").json(&body).await;
675
- let snapshot = snapshot_response(response).await.map_err(snapshot_err_to_native)?;
676
- Ok(snapshot)
677
- }
678
-
679
- fn response_snapshot_to_ruby(ruby: &Ruby, snapshot: ResponseSnapshot) -> Result<Value, Error> {
680
- let hash = ruby.hash_new();
681
-
682
- hash.aset(
683
- ruby.intern("status_code"),
684
- ruby.integer_from_i64(snapshot.status as i64),
685
- )?;
686
-
687
- let headers_hash = ruby.hash_new();
688
- for (key, value) in snapshot.headers {
689
- headers_hash.aset(ruby.str_new(&key), ruby.str_new(&value))?;
690
- }
691
- hash.aset(ruby.intern("headers"), headers_hash)?;
692
-
693
- let body_value = ruby.str_new(&String::from_utf8_lossy(&snapshot.body));
694
- hash.aset(ruby.intern("body"), body_value)?;
695
- hash.aset(ruby.intern("body_text"), body_value)?;
696
-
697
- Ok(hash.as_value())
698
- }
@@ -1,7 +0,0 @@
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;