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,688 +0,0 @@
1
- //! Ruby ↔ Rust type conversion utilities.
2
- //!
3
- //! This module provides functions for converting between Ruby and Rust types,
4
- //! including JSON conversion, string conversion, and request/response building.
5
- //!
6
- //! The module implements the `JsonConverter` trait from `spikard-bindings-shared`
7
- //! to eliminate code duplication across bindings while preserving Ruby-specific features
8
- //! like lazy caching and upload file handling.
9
-
10
- #![allow(dead_code)]
11
- #![deny(clippy::unwrap_used)]
12
-
13
- use bytes::Bytes;
14
- use magnus::prelude::*;
15
- use magnus::{Error, RArray, RHash, RString, Ruby, Symbol, TryConvert, Value};
16
- use serde_json::Value as JsonValue;
17
- use spikard_bindings_shared::JsonConverter;
18
- use spikard_core::problem::ProblemDetails;
19
- use spikard_http::testing::MultipartFilePart;
20
- use std::collections::HashMap;
21
-
22
- use crate::testing::client::{RequestBody, RequestConfig, TestResponseData};
23
-
24
- /// Ruby implementation of the JsonConverter trait
25
- ///
26
- /// Provides bidirectional conversion between `serde_json::Value` and Ruby `Value`.
27
- /// Leverages the `JsonConversionHelper` for fast-path optimization on primitives.
28
- pub struct RubyJsonConverter;
29
-
30
- impl JsonConverter for RubyJsonConverter {
31
- type LanguageValue = Value;
32
- type Error = Error;
33
-
34
- fn json_to_language(value: &JsonValue) -> Result<Self::LanguageValue, Self::Error> {
35
- let ruby = Ruby::get().map_err(|err| {
36
- Error::new(
37
- magnus::exception::runtime_error(),
38
- format!("Failed to get Ruby runtime: {err}"),
39
- )
40
- })?;
41
- json_to_ruby(&ruby, value)
42
- }
43
-
44
- fn language_to_json(value: &Self::LanguageValue) -> Result<JsonValue, Self::Error> {
45
- let ruby = Ruby::get().map_err(|err| {
46
- Error::new(
47
- magnus::exception::runtime_error(),
48
- format!("Failed to get Ruby runtime: {err}"),
49
- )
50
- })?;
51
-
52
- // Get the JSON module from Ruby
53
- let json_module = ruby
54
- .class_object()
55
- .const_get("JSON")
56
- .map_err(|_| Error::new(ruby.exception_runtime_error(), "JSON module not available"))?;
57
-
58
- ruby_value_to_json(&ruby, json_module, *value)
59
- }
60
- }
61
-
62
- /// Convert a Ruby value to JSON.
63
- ///
64
- /// Fast-path converts common Ruby types directly in Rust to avoid
65
- /// `JSON.generate` + `serde_json::from_str` overhead.
66
- ///
67
- /// Falls back to Ruby JSON for unsupported types to preserve behavior.
68
- pub fn ruby_value_to_json(ruby: &Ruby, json_module: Value, value: Value) -> Result<JsonValue, Error> {
69
- if value.is_nil() {
70
- return Ok(JsonValue::Null);
71
- }
72
-
73
- if let Some(converted) = ruby_value_to_json_fast(ruby, json_module, value, 0)? {
74
- return Ok(converted);
75
- }
76
-
77
- ruby_value_to_json_fallback(ruby, json_module, value)
78
- }
79
-
80
- fn ruby_value_to_json_fallback(ruby: &Ruby, json_module: Value, value: Value) -> Result<JsonValue, Error> {
81
- let json_string: String = json_module.funcall("generate", (value,))?;
82
- serde_json::from_str(&json_string).map_err(|err| {
83
- Error::new(
84
- ruby.exception_runtime_error(),
85
- format!("Failed to convert Ruby value to JSON: {err}"),
86
- )
87
- })
88
- }
89
-
90
- fn ruby_value_to_json_fast(
91
- ruby: &Ruby,
92
- json_module: Value,
93
- value: Value,
94
- depth: usize,
95
- ) -> Result<Option<JsonValue>, Error> {
96
- // Cycle detection is non-trivial without tracking Ruby object IDs; a shallow
97
- // recursion guard avoids worst-case behavior and defers to Ruby JSON.
98
- if depth > 64 {
99
- return Ok(None);
100
- }
101
-
102
- if value.is_nil() {
103
- return Ok(Some(JsonValue::Null));
104
- }
105
-
106
- if value.is_kind_of(ruby.class_true_class()) {
107
- return Ok(Some(JsonValue::Bool(true)));
108
- }
109
-
110
- if value.is_kind_of(ruby.class_false_class()) {
111
- return Ok(Some(JsonValue::Bool(false)));
112
- }
113
-
114
- if let Ok(text) = RString::try_convert(value) {
115
- let slice = unsafe { text.as_slice() };
116
- // Performance: Use from_utf8() with explicit error handling to avoid unnecessary allocation.
117
- // from_utf8_lossy() always allocates even for valid UTF-8, while from_utf8() returns
118
- // a zero-copy reference when the bytes are valid UTF-8 (which is the common case).
119
- let string =
120
- String::from_utf8(slice.to_vec()).unwrap_or_else(|e| String::from_utf8_lossy(e.as_bytes()).into_owned());
121
- return Ok(Some(JsonValue::String(string)));
122
- }
123
-
124
- if value.is_kind_of(ruby.class_float()) {
125
- let n = f64::try_convert(value)?;
126
- let number = serde_json::Number::from_f64(n).ok_or_else(|| {
127
- Error::new(
128
- ruby.exception_runtime_error(),
129
- "Failed to convert Ruby Float to JSON number",
130
- )
131
- })?;
132
- return Ok(Some(JsonValue::Number(number)));
133
- }
134
-
135
- if value.is_kind_of(ruby.class_integer()) {
136
- if let Ok(n) = i64::try_convert(value) {
137
- return Ok(Some(JsonValue::from(n)));
138
- }
139
- if let Ok(n) = u64::try_convert(value) {
140
- return Ok(Some(JsonValue::from(n)));
141
- }
142
- }
143
-
144
- if let Some(array) = RArray::from_value(value) {
145
- let mut out = Vec::with_capacity(array.len());
146
- for idx in 0..array.len() {
147
- let item: Value = array.entry(idx as isize)?;
148
- let json_item = match ruby_value_to_json_fast(ruby, json_module, item, depth + 1)? {
149
- Some(v) => v,
150
- None => ruby_value_to_json_fallback(ruby, json_module, item)?,
151
- };
152
- out.push(json_item);
153
- }
154
- return Ok(Some(JsonValue::Array(out)));
155
- }
156
-
157
- if let Some(hash) = RHash::from_value(value) {
158
- let mut map = serde_json::Map::with_capacity(hash.len());
159
- hash.foreach(|key: Value, val: Value| {
160
- let key_str = if let Ok(key_text) = RString::try_convert(key) {
161
- let slice = unsafe { key_text.as_slice() };
162
- // Performance: Avoid unnecessary allocation for valid UTF-8 hash keys.
163
- // Most Ruby hash keys are valid UTF-8 strings, so from_utf8() is faster
164
- // than from_utf8_lossy() which always allocates.
165
- String::from_utf8(slice.to_vec()).unwrap_or_else(|e| String::from_utf8_lossy(e.as_bytes()).into_owned())
166
- } else if let Ok(sym) = Symbol::try_convert(key) {
167
- sym.name()?.into_owned()
168
- } else {
169
- let key_as_str: String = key.funcall("to_s", ())?;
170
- key_as_str
171
- };
172
-
173
- let json_val = match ruby_value_to_json_fast(ruby, json_module, val, depth + 1)? {
174
- Some(v) => v,
175
- None => ruby_value_to_json_fallback(ruby, json_module, val)?,
176
- };
177
-
178
- map.insert(key_str, json_val);
179
- Ok(magnus::r_hash::ForEach::Continue)
180
- })?;
181
- return Ok(Some(JsonValue::Object(map)));
182
- }
183
-
184
- Ok(None)
185
- }
186
-
187
- /// Convert JSON to a Ruby value.
188
- ///
189
- /// Recursively converts JSON types to native Ruby types:
190
- /// - null → nil
191
- /// - bool → true/false
192
- /// - number → integer or float
193
- /// - string → string
194
- /// - array → array
195
- /// - object → hash
196
- pub fn json_to_ruby(ruby: &Ruby, value: &JsonValue) -> Result<Value, Error> {
197
- json_to_ruby_with_uploads(ruby, value, None::<&Value>)
198
- }
199
-
200
- /// Convert JSON to a Ruby value, optionally materialising UploadFile objects.
201
- ///
202
- /// If `upload_file_class` is provided and the JSON object contains
203
- /// file-metadata keys (`filename`, `content`), this will instantiate
204
- /// `UploadFile` instead of returning a plain Hash.
205
- pub fn json_to_ruby_with_uploads(
206
- ruby: &Ruby,
207
- value: &JsonValue,
208
- upload_file_class: Option<&Value>,
209
- ) -> Result<Value, Error> {
210
- match value {
211
- JsonValue::Null => Ok(ruby.qnil().as_value()),
212
- JsonValue::Bool(b) => Ok(if *b {
213
- ruby.qtrue().as_value()
214
- } else {
215
- ruby.qfalse().as_value()
216
- }),
217
- JsonValue::Number(num) => {
218
- if let Some(i) = num.as_i64() {
219
- Ok(ruby.integer_from_i64(i).as_value())
220
- } else if let Some(f) = num.as_f64() {
221
- Ok(ruby.float_from_f64(f).as_value())
222
- } else {
223
- Ok(ruby.qnil().as_value())
224
- }
225
- }
226
- JsonValue::String(str_val) => Ok(ruby.str_new(str_val).as_value()),
227
- JsonValue::Array(items) => {
228
- let array = ruby.ary_new_capa(items.len());
229
- for item in items {
230
- array.push(json_to_ruby_with_uploads(ruby, item, upload_file_class)?)?;
231
- }
232
- Ok(array.as_value())
233
- }
234
- JsonValue::Object(map) => {
235
- if let Some(upload_file) = upload_file_class
236
- && let Some(upload) = try_build_upload_file(ruby, upload_file, map)?
237
- {
238
- return Ok(upload);
239
- }
240
-
241
- let hash = ruby.hash_new_capa(map.len());
242
- for (key, item) in map {
243
- hash.aset(
244
- ruby.str_new(key),
245
- json_to_ruby_with_uploads(ruby, item, upload_file_class)?,
246
- )?;
247
- }
248
- apply_indifferent_access(ruby, &hash)?;
249
- Ok(hash.as_value())
250
- }
251
- }
252
- }
253
-
254
- fn apply_indifferent_access(ruby: &Ruby, hash: &RHash) -> Result<(), Error> {
255
- let default_proc = ruby.eval::<Value>("->(h, k) { k.is_a?(Symbol) ? h[k.to_s] : nil }")?;
256
- let _: Value = hash.funcall("default_proc=", (default_proc,))?;
257
- Ok(())
258
- }
259
-
260
- /// Convert a HashMap to a Ruby Hash.
261
- pub fn map_to_ruby_hash(ruby: &Ruby, map: &HashMap<String, String>) -> Result<Value, Error> {
262
- let hash = ruby.hash_new_capa(map.len());
263
- for (key, value) in map {
264
- hash.aset(ruby.str_new(key), ruby.str_new(value))?;
265
- }
266
- apply_indifferent_access(ruby, &hash)?;
267
- Ok(hash.as_value())
268
- }
269
-
270
- /// Convert a HashMap of Vecs to a Ruby Hash with array values.
271
- pub fn multimap_to_ruby_hash(ruby: &Ruby, map: &HashMap<String, Vec<String>>) -> Result<Value, Error> {
272
- let hash = ruby.hash_new_capa(map.len());
273
- for (key, values) in map {
274
- let array = ruby.ary_new_capa(values.len());
275
- for value in values {
276
- array.push(ruby.str_new(value))?;
277
- }
278
- hash.aset(ruby.str_new(key), array)?;
279
- }
280
- apply_indifferent_access(ruby, &hash)?;
281
- Ok(hash.as_value())
282
- }
283
-
284
- fn try_build_upload_file(
285
- ruby: &Ruby,
286
- upload_file_class: &Value,
287
- map: &serde_json::Map<String, JsonValue>,
288
- ) -> Result<Option<Value>, Error> {
289
- let filename = match map.get("filename").and_then(|v| v.as_str()) {
290
- Some(name) => name,
291
- None => return Ok(None),
292
- };
293
- let content = match map.get("content") {
294
- Some(JsonValue::String(s)) => s.as_str(),
295
- _ => return Ok(None),
296
- };
297
-
298
- let content_type = map.get("content_type").and_then(|v| v.as_str());
299
- let size = map.get("size").and_then(|v| v.as_u64());
300
- let headers_value = map
301
- .get("headers")
302
- .and_then(|v| v.as_object())
303
- .map(|obj| {
304
- obj.iter()
305
- .filter_map(|(k, v)| v.as_str().map(|val| (k.clone(), val.to_string())))
306
- .collect::<HashMap<String, String>>()
307
- })
308
- .unwrap_or_default();
309
- let headers = map_to_ruby_hash(ruby, &headers_value)?;
310
- let content_encoding = map.get("content_encoding").and_then(|v| v.as_str());
311
-
312
- let kwargs = magnus::kwargs!(
313
- "content_type" => content_type,
314
- "size" => size,
315
- "headers" => headers,
316
- "content_encoding" => content_encoding
317
- );
318
-
319
- let upload = upload_file_class.funcall("new", (filename, content, kwargs))?;
320
- Ok(Some(upload))
321
- }
322
-
323
- /// Convert a Ruby value to Bytes.
324
- ///
325
- /// Accepts either String or Array of bytes.
326
- pub fn ruby_value_to_bytes(value: Value) -> Result<Bytes, std::io::Error> {
327
- if let Ok(str_value) = RString::try_convert(value) {
328
- let slice = unsafe { str_value.as_slice() };
329
- return Ok(Bytes::copy_from_slice(slice));
330
- }
331
-
332
- if let Ok(vec_bytes) = Vec::<u8>::try_convert(value) {
333
- return Ok(Bytes::from(vec_bytes));
334
- }
335
-
336
- Err(std::io::Error::other(
337
- "Streaming chunks must be Strings or Arrays of bytes",
338
- ))
339
- }
340
-
341
- /// Convert a response to a Ruby Hash.
342
- pub fn response_to_ruby(ruby: &Ruby, response: TestResponseData) -> Result<Value, Error> {
343
- let hash = ruby.hash_new();
344
-
345
- hash.aset(
346
- ruby.intern("status_code"),
347
- ruby.integer_from_i64(response.status as i64),
348
- )?;
349
-
350
- let headers_hash = ruby.hash_new();
351
- for (key, value) in response.headers {
352
- headers_hash.aset(ruby.str_new(&key), ruby.str_new(&value))?;
353
- }
354
- hash.aset(ruby.intern("headers"), headers_hash)?;
355
-
356
- if let Some(body) = response.body_text {
357
- let body_value = ruby.str_new(&body);
358
- hash.aset(ruby.intern("body"), body_value)?;
359
- hash.aset(ruby.intern("body_text"), body_value)?;
360
- } else {
361
- hash.aset(ruby.intern("body"), ruby.qnil())?;
362
- hash.aset(ruby.intern("body_text"), ruby.qnil())?;
363
- }
364
-
365
- Ok(hash.as_value())
366
- }
367
-
368
- /// Convert a ProblemDetails to a JSON string.
369
- pub fn problem_to_json(problem: &ProblemDetails) -> String {
370
- problem
371
- .to_json_pretty()
372
- .unwrap_or_else(|err| format!("Failed to serialise problem details: {err}"))
373
- }
374
-
375
- /// Ensure the handler value can be invoked via `call`.
376
- pub fn ensure_callable(ruby: &Ruby, value: Value, name: &str) -> Result<Value, Error> {
377
- if value.is_nil() {
378
- return Err(Error::new(
379
- ruby.exception_type_error(),
380
- format!("Handler '{name}' must respond to #call"),
381
- ));
382
- }
383
-
384
- let call_sym = ruby.intern("call");
385
- if !value.respond_to(call_sym, false)? {
386
- return Err(Error::new(
387
- ruby.exception_type_error(),
388
- format!("Handler '{name}' must respond to #call"),
389
- ));
390
- }
391
-
392
- Ok(value)
393
- }
394
-
395
- /// Fetch a handler from a Ruby Hash by name.
396
- ///
397
- /// Tries both symbol and string keys.
398
- pub fn fetch_handler(ruby: &Ruby, handlers: &RHash, name: &str) -> Result<Value, Error> {
399
- let symbol_key = ruby.intern(name);
400
- if let Some(value) = handlers.get(symbol_key) {
401
- return ensure_callable(ruby, value, name);
402
- }
403
-
404
- let string_key = ruby.str_new(name);
405
- if let Some(value) = handlers.get(string_key) {
406
- return ensure_callable(ruby, value, name);
407
- }
408
-
409
- Err(Error::new(
410
- ruby.exception_name_error(),
411
- format!("Handler '{name}' not provided"),
412
- ))
413
- }
414
-
415
- /// Get an optional keyword argument from a Ruby Hash.
416
- pub fn get_kw(ruby: &Ruby, hash: RHash, name: &str) -> Option<Value> {
417
- let sym = ruby.intern(name);
418
- hash.get(sym).or_else(|| hash.get(name))
419
- }
420
-
421
- /// Parse request configuration from a Ruby options Hash.
422
- ///
423
- /// Supports: query, headers, cookies, json, data, raw_body, files
424
- pub fn parse_request_config(ruby: &Ruby, options: Value) -> Result<RequestConfig, Error> {
425
- if options.is_nil() {
426
- return Ok(RequestConfig {
427
- query: None,
428
- headers: HashMap::new(),
429
- cookies: HashMap::new(),
430
- body: None,
431
- });
432
- }
433
-
434
- let hash = RHash::from_value(options)
435
- .ok_or_else(|| Error::new(ruby.exception_arg_error(), "request options must be a Hash"))?;
436
-
437
- let json_module = ruby
438
- .class_object()
439
- .const_get("JSON")
440
- .map_err(|_| Error::new(ruby.exception_runtime_error(), "JSON module not available"))?;
441
-
442
- let query = if let Some(value) = get_kw(ruby, hash, "query") {
443
- if value.is_nil() {
444
- None
445
- } else {
446
- Some(ruby_value_to_json(ruby, json_module, value)?)
447
- }
448
- } else {
449
- None
450
- };
451
-
452
- let headers = if let Some(value) = get_kw(ruby, hash, "headers") {
453
- if value.is_nil() {
454
- HashMap::new()
455
- } else {
456
- let hash = RHash::try_convert(value)?;
457
- hash.to_hash_map::<String, String>()?
458
- }
459
- } else {
460
- HashMap::new()
461
- };
462
-
463
- let cookies = if let Some(value) = get_kw(ruby, hash, "cookies") {
464
- if value.is_nil() {
465
- HashMap::new()
466
- } else {
467
- let hash = RHash::try_convert(value)?;
468
- hash.to_hash_map::<String, String>()?
469
- }
470
- } else {
471
- HashMap::new()
472
- };
473
-
474
- let files_opt = get_kw(ruby, hash, "files");
475
- let has_files = files_opt.as_ref().is_some_and(|f| !f.is_nil());
476
-
477
- let body = if has_files {
478
- let files_value = files_opt.ok_or_else(|| {
479
- Error::new(
480
- ruby.exception_runtime_error(),
481
- "Files option should be Some if has_files is true",
482
- )
483
- })?;
484
- let files = extract_files(ruby, files_value)?;
485
-
486
- let mut form_data = Vec::new();
487
- if let Some(data_value) = get_kw(ruby, hash, "data")
488
- && !data_value.is_nil()
489
- {
490
- let data_hash = RHash::try_convert(data_value)?;
491
-
492
- let keys_array: RArray = data_hash.funcall("keys", ())?;
493
-
494
- for i in 0..keys_array.len() {
495
- let key_val = keys_array.entry::<Value>(i as isize)?;
496
- let field_name = String::try_convert(key_val)?;
497
- let value = data_hash
498
- .get(key_val)
499
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "Failed to get hash value"))?;
500
-
501
- if let Some(array) = RArray::from_value(value) {
502
- for j in 0..array.len() {
503
- let item = array.entry::<Value>(j as isize)?;
504
- let item_str = String::try_convert(item)?;
505
- form_data.push((field_name.clone(), item_str));
506
- }
507
- } else {
508
- let value_str = String::try_convert(value)?;
509
- form_data.push((field_name, value_str));
510
- }
511
- }
512
- }
513
-
514
- Some(RequestBody::Multipart { form_data, files })
515
- } else if let Some(value) = get_kw(ruby, hash, "json") {
516
- if value.is_nil() {
517
- None
518
- } else {
519
- Some(RequestBody::Json(ruby_value_to_json(ruby, json_module, value)?))
520
- }
521
- } else if let Some(value) = get_kw(ruby, hash, "data") {
522
- if value.is_nil() {
523
- None
524
- } else {
525
- Some(RequestBody::Form(ruby_value_to_json(ruby, json_module, value)?))
526
- }
527
- } else if let Some(value) = get_kw(ruby, hash, "raw_body") {
528
- if value.is_nil() {
529
- None
530
- } else {
531
- Some(RequestBody::Raw(String::try_convert(value)?))
532
- }
533
- } else {
534
- None
535
- };
536
-
537
- Ok(RequestConfig {
538
- query,
539
- headers,
540
- cookies,
541
- body,
542
- })
543
- }
544
-
545
- /// Extract files from a Ruby Hash.
546
- ///
547
- /// Files can be provided as [filename, content] or [filename, content, content_type]
548
- pub fn extract_files(ruby: &Ruby, files_value: Value) -> Result<Vec<MultipartFilePart>, Error> {
549
- let files_hash = RHash::try_convert(files_value)?;
550
-
551
- let keys_array: RArray = files_hash.funcall("keys", ())?;
552
- let mut result = Vec::new();
553
-
554
- for i in 0..keys_array.len() {
555
- let key_val = keys_array.entry::<Value>(i as isize)?;
556
- let field_name = String::try_convert(key_val)?;
557
- let value = files_hash
558
- .get(key_val)
559
- .ok_or_else(|| Error::new(ruby.exception_runtime_error(), "Failed to get hash value"))?;
560
-
561
- if let Some(outer_array) = RArray::from_value(value) {
562
- if outer_array.is_empty() {
563
- continue;
564
- }
565
-
566
- let first_elem = outer_array.entry::<Value>(0)?;
567
-
568
- if RArray::from_value(first_elem).is_some() {
569
- for j in 0..outer_array.len() {
570
- let file_array = outer_array.entry::<Value>(j as isize)?;
571
- let file_data = extract_single_file(ruby, &field_name, file_array)?;
572
- result.push(file_data);
573
- }
574
- } else {
575
- let file_data = extract_single_file(ruby, &field_name, value)?;
576
- result.push(file_data);
577
- }
578
- }
579
- }
580
-
581
- Ok(result)
582
- }
583
-
584
- /// Extract a single file from a Ruby array [filename, content, content_type (optional)].
585
- pub fn extract_single_file(ruby: &Ruby, field_name: &str, array_value: Value) -> Result<MultipartFilePart, Error> {
586
- let array = RArray::from_value(array_value)
587
- .ok_or_else(|| Error::new(ruby.exception_arg_error(), "file must be an Array [filename, content]"))?;
588
-
589
- if array.len() < 2 {
590
- return Err(Error::new(
591
- ruby.exception_arg_error(),
592
- "file Array must have at least 2 elements: [filename, content]",
593
- ));
594
- }
595
-
596
- let filename: String = String::try_convert(array.shift()?)?;
597
- let content_str: String = String::try_convert(array.shift()?)?;
598
- let content = content_str.into_bytes();
599
-
600
- let content_type: Option<String> = if !array.is_empty() {
601
- String::try_convert(array.shift()?).ok()
602
- } else {
603
- None
604
- };
605
-
606
- Ok(MultipartFilePart {
607
- field_name: field_name.to_string(),
608
- filename,
609
- content,
610
- content_type,
611
- })
612
- }
613
-
614
- /// Extract an optional string from a Ruby Hash.
615
- pub fn get_optional_string_from_hash(hash: RHash, key: &str) -> Result<Option<String>, Error> {
616
- match hash.get(String::from(key)) {
617
- Some(v) if !v.is_nil() => Ok(Some(String::try_convert(v)?)),
618
- _ => Ok(None),
619
- }
620
- }
621
-
622
- /// Extract a required string from a Ruby Hash.
623
- pub fn get_required_string_from_hash(hash: RHash, key: &str, ruby: &Ruby) -> Result<String, Error> {
624
- let value = hash
625
- .get(String::from(key))
626
- .ok_or_else(|| Error::new(ruby.exception_arg_error(), format!("missing required key '{}'", key)))?;
627
- if value.is_nil() {
628
- return Err(Error::new(
629
- ruby.exception_arg_error(),
630
- format!("key '{}' cannot be nil", key),
631
- ));
632
- }
633
- String::try_convert(value)
634
- }
635
-
636
- #[cfg(test)]
637
- mod tests {
638
- use super::*;
639
- use serde_json::json;
640
-
641
- /// Test that RubyJsonConverter implements the JsonConverter trait correctly
642
- #[test]
643
- fn test_ruby_json_converter_trait_implemented() {
644
- // This test verifies that RubyJsonConverter can be used where JsonConverter is expected
645
- // The trait implementation ensures that conversion logic is centralized and reusable
646
- let _ = RubyJsonConverter;
647
- }
648
-
649
- /// Test the conversion flow matches the existing functions
650
- /// This validates that the trait implementation is compatible with existing code
651
- #[test]
652
- fn test_json_conversion_consistency() {
653
- // Test a simple JSON value
654
- let simple_json = json!(42);
655
- assert_eq!(simple_json, 42);
656
-
657
- // Test a complex JSON object
658
- let complex_json = json!({
659
- "name": "test",
660
- "count": 42,
661
- "active": true,
662
- "items": [1, 2, 3]
663
- });
664
- assert!(complex_json.is_object());
665
- assert_eq!(complex_json["count"], 42);
666
- assert_eq!(complex_json["active"], true);
667
- }
668
-
669
- /// Test that upload file metadata is properly handled
670
- #[test]
671
- fn test_upload_file_structure() {
672
- let upload_json = json!({
673
- "filename": "test.txt",
674
- "content": "test content",
675
- "content_type": "text/plain",
676
- "size": 12,
677
- "headers": {
678
- "X-Custom": "value"
679
- },
680
- "content_encoding": "utf-8"
681
- });
682
-
683
- assert_eq!(upload_json["filename"], "test.txt");
684
- assert_eq!(upload_json["content"], "test content");
685
- assert_eq!(upload_json["content_type"], "text/plain");
686
- assert_eq!(upload_json["size"], 12);
687
- }
688
- }