spikard 0.3.0 → 0.3.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 (182) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +1 -1
  3. data/README.md +659 -659
  4. data/ext/spikard_rb/Cargo.toml +17 -17
  5. data/ext/spikard_rb/extconf.rb +10 -10
  6. data/ext/spikard_rb/src/lib.rs +6 -6
  7. data/lib/spikard/app.rb +386 -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 +221 -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 +360 -360
  23. data/vendor/crates/spikard-core/Cargo.toml +40 -0
  24. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -0
  25. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -0
  26. data/vendor/crates/spikard-core/src/debug.rs +63 -0
  27. data/vendor/crates/spikard-core/src/di/container.rs +726 -0
  28. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -0
  29. data/vendor/crates/spikard-core/src/di/error.rs +118 -0
  30. data/vendor/crates/spikard-core/src/di/factory.rs +538 -0
  31. data/vendor/crates/spikard-core/src/di/graph.rs +545 -0
  32. data/vendor/crates/spikard-core/src/di/mod.rs +192 -0
  33. data/vendor/crates/spikard-core/src/di/resolved.rs +411 -0
  34. data/vendor/crates/spikard-core/src/di/value.rs +283 -0
  35. data/vendor/crates/spikard-core/src/errors.rs +39 -0
  36. data/vendor/crates/spikard-core/src/http.rs +153 -0
  37. data/vendor/crates/spikard-core/src/lib.rs +29 -0
  38. data/vendor/crates/spikard-core/src/lifecycle.rs +422 -0
  39. data/vendor/crates/spikard-core/src/parameters.rs +722 -0
  40. data/vendor/crates/spikard-core/src/problem.rs +310 -0
  41. data/vendor/crates/spikard-core/src/request_data.rs +189 -0
  42. data/vendor/crates/spikard-core/src/router.rs +249 -0
  43. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -0
  44. data/vendor/crates/spikard-core/src/type_hints.rs +304 -0
  45. data/vendor/crates/spikard-core/src/validation.rs +699 -0
  46. data/vendor/crates/spikard-http/Cargo.toml +58 -0
  47. data/vendor/crates/spikard-http/src/auth.rs +247 -0
  48. data/vendor/crates/spikard-http/src/background.rs +249 -0
  49. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -0
  50. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -0
  51. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -0
  52. data/vendor/crates/spikard-http/src/cors.rs +490 -0
  53. data/vendor/crates/spikard-http/src/debug.rs +63 -0
  54. data/vendor/crates/spikard-http/src/di_handler.rs +423 -0
  55. data/vendor/crates/spikard-http/src/handler_response.rs +190 -0
  56. data/vendor/crates/spikard-http/src/handler_trait.rs +228 -0
  57. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +284 -0
  58. data/vendor/crates/spikard-http/src/lib.rs +529 -0
  59. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +149 -0
  60. data/vendor/crates/spikard-http/src/lifecycle.rs +428 -0
  61. data/vendor/crates/spikard-http/src/middleware/mod.rs +285 -0
  62. data/vendor/crates/spikard-http/src/middleware/multipart.rs +86 -0
  63. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +147 -0
  64. data/vendor/crates/spikard-http/src/middleware/validation.rs +287 -0
  65. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -0
  66. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +190 -0
  67. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +308 -0
  68. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +195 -0
  69. data/vendor/crates/spikard-http/src/parameters.rs +1 -0
  70. data/vendor/crates/spikard-http/src/problem.rs +1 -0
  71. data/vendor/crates/spikard-http/src/query_parser.rs +369 -0
  72. data/vendor/crates/spikard-http/src/response.rs +399 -0
  73. data/vendor/crates/spikard-http/src/router.rs +1 -0
  74. data/vendor/crates/spikard-http/src/schema_registry.rs +1 -0
  75. data/vendor/crates/spikard-http/src/server/handler.rs +87 -0
  76. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +98 -0
  77. data/vendor/crates/spikard-http/src/server/mod.rs +805 -0
  78. data/vendor/crates/spikard-http/src/server/request_extraction.rs +119 -0
  79. data/vendor/crates/spikard-http/src/sse.rs +447 -0
  80. data/vendor/crates/spikard-http/src/testing/form.rs +14 -0
  81. data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -0
  82. data/vendor/crates/spikard-http/src/testing/test_client.rs +285 -0
  83. data/vendor/crates/spikard-http/src/testing.rs +377 -0
  84. data/vendor/crates/spikard-http/src/type_hints.rs +1 -0
  85. data/vendor/crates/spikard-http/src/validation.rs +1 -0
  86. data/vendor/crates/spikard-http/src/websocket.rs +324 -0
  87. data/vendor/crates/spikard-rb/Cargo.toml +42 -0
  88. data/vendor/crates/spikard-rb/build.rs +8 -0
  89. data/vendor/crates/spikard-rb/src/background.rs +63 -0
  90. data/vendor/crates/spikard-rb/src/config.rs +294 -0
  91. data/vendor/crates/spikard-rb/src/conversion.rs +453 -0
  92. data/vendor/crates/spikard-rb/src/di.rs +409 -0
  93. data/vendor/crates/spikard-rb/src/handler.rs +625 -0
  94. data/vendor/crates/spikard-rb/src/lib.rs +2771 -0
  95. data/vendor/crates/spikard-rb/src/lifecycle.rs +274 -0
  96. data/vendor/crates/spikard-rb/src/server.rs +283 -0
  97. data/vendor/crates/spikard-rb/src/sse.rs +231 -0
  98. data/vendor/crates/spikard-rb/src/test_client.rs +404 -0
  99. data/vendor/crates/spikard-rb/src/test_sse.rs +143 -0
  100. data/vendor/crates/spikard-rb/src/test_websocket.rs +221 -0
  101. data/vendor/crates/spikard-rb/src/websocket.rs +233 -0
  102. data/vendor/spikard-core/Cargo.toml +40 -0
  103. data/vendor/spikard-core/src/bindings/mod.rs +3 -0
  104. data/vendor/spikard-core/src/bindings/response.rs +133 -0
  105. data/vendor/spikard-core/src/debug.rs +63 -0
  106. data/vendor/spikard-core/src/di/container.rs +726 -0
  107. data/vendor/spikard-core/src/di/dependency.rs +273 -0
  108. data/vendor/spikard-core/src/di/error.rs +118 -0
  109. data/vendor/spikard-core/src/di/factory.rs +538 -0
  110. data/vendor/spikard-core/src/di/graph.rs +545 -0
  111. data/vendor/spikard-core/src/di/mod.rs +192 -0
  112. data/vendor/spikard-core/src/di/resolved.rs +411 -0
  113. data/vendor/spikard-core/src/di/value.rs +283 -0
  114. data/vendor/spikard-core/src/http.rs +153 -0
  115. data/vendor/spikard-core/src/lib.rs +28 -0
  116. data/vendor/spikard-core/src/lifecycle.rs +422 -0
  117. data/vendor/spikard-core/src/parameters.rs +719 -0
  118. data/vendor/spikard-core/src/problem.rs +310 -0
  119. data/vendor/spikard-core/src/request_data.rs +189 -0
  120. data/vendor/spikard-core/src/router.rs +249 -0
  121. data/vendor/spikard-core/src/schema_registry.rs +183 -0
  122. data/vendor/spikard-core/src/type_hints.rs +304 -0
  123. data/vendor/spikard-core/src/validation.rs +699 -0
  124. data/vendor/spikard-http/Cargo.toml +58 -0
  125. data/vendor/spikard-http/src/auth.rs +247 -0
  126. data/vendor/spikard-http/src/background.rs +249 -0
  127. data/vendor/spikard-http/src/bindings/mod.rs +3 -0
  128. data/vendor/spikard-http/src/bindings/response.rs +1 -0
  129. data/vendor/spikard-http/src/body_metadata.rs +8 -0
  130. data/vendor/spikard-http/src/cors.rs +490 -0
  131. data/vendor/spikard-http/src/debug.rs +63 -0
  132. data/vendor/spikard-http/src/di_handler.rs +423 -0
  133. data/vendor/spikard-http/src/handler_response.rs +190 -0
  134. data/vendor/spikard-http/src/handler_trait.rs +228 -0
  135. data/vendor/spikard-http/src/handler_trait_tests.rs +284 -0
  136. data/vendor/spikard-http/src/lib.rs +529 -0
  137. data/vendor/spikard-http/src/lifecycle/adapter.rs +149 -0
  138. data/vendor/spikard-http/src/lifecycle.rs +428 -0
  139. data/vendor/spikard-http/src/middleware/mod.rs +285 -0
  140. data/vendor/spikard-http/src/middleware/multipart.rs +86 -0
  141. data/vendor/spikard-http/src/middleware/urlencoded.rs +147 -0
  142. data/vendor/spikard-http/src/middleware/validation.rs +287 -0
  143. data/vendor/spikard-http/src/openapi/mod.rs +309 -0
  144. data/vendor/spikard-http/src/openapi/parameter_extraction.rs +190 -0
  145. data/vendor/spikard-http/src/openapi/schema_conversion.rs +308 -0
  146. data/vendor/spikard-http/src/openapi/spec_generation.rs +195 -0
  147. data/vendor/spikard-http/src/parameters.rs +1 -0
  148. data/vendor/spikard-http/src/problem.rs +1 -0
  149. data/vendor/spikard-http/src/query_parser.rs +369 -0
  150. data/vendor/spikard-http/src/response.rs +399 -0
  151. data/vendor/spikard-http/src/router.rs +1 -0
  152. data/vendor/spikard-http/src/schema_registry.rs +1 -0
  153. data/vendor/spikard-http/src/server/handler.rs +80 -0
  154. data/vendor/spikard-http/src/server/lifecycle_execution.rs +98 -0
  155. data/vendor/spikard-http/src/server/mod.rs +805 -0
  156. data/vendor/spikard-http/src/server/request_extraction.rs +119 -0
  157. data/vendor/spikard-http/src/sse.rs +447 -0
  158. data/vendor/spikard-http/src/testing/form.rs +14 -0
  159. data/vendor/spikard-http/src/testing/multipart.rs +60 -0
  160. data/vendor/spikard-http/src/testing/test_client.rs +285 -0
  161. data/vendor/spikard-http/src/testing.rs +377 -0
  162. data/vendor/spikard-http/src/type_hints.rs +1 -0
  163. data/vendor/spikard-http/src/validation.rs +1 -0
  164. data/vendor/spikard-http/src/websocket.rs +324 -0
  165. data/vendor/spikard-rb/Cargo.toml +42 -0
  166. data/vendor/spikard-rb/build.rs +8 -0
  167. data/vendor/spikard-rb/src/background.rs +63 -0
  168. data/vendor/spikard-rb/src/config.rs +294 -0
  169. data/vendor/spikard-rb/src/conversion.rs +392 -0
  170. data/vendor/spikard-rb/src/di.rs +409 -0
  171. data/vendor/spikard-rb/src/handler.rs +534 -0
  172. data/vendor/spikard-rb/src/lib.rs +2020 -0
  173. data/vendor/spikard-rb/src/lifecycle.rs +267 -0
  174. data/vendor/spikard-rb/src/server.rs +283 -0
  175. data/vendor/spikard-rb/src/sse.rs +231 -0
  176. data/vendor/spikard-rb/src/test_client.rs +404 -0
  177. data/vendor/spikard-rb/src/test_sse.rs +143 -0
  178. data/vendor/spikard-rb/src/test_websocket.rs +221 -0
  179. data/vendor/spikard-rb/src/websocket.rs +233 -0
  180. metadata +162 -8
  181. /data/vendor/bundle/ruby/{3.3.0 → 3.4.0}/gems/diff-lcs-1.6.2/mise.toml +0 -0
  182. /data/vendor/bundle/ruby/{3.3.0 → 3.4.0}/gems/rake-compiler-dock-1.10.0/build/buildkitd.toml +0 -0
@@ -0,0 +1,294 @@
1
+ //! ServerConfig extraction from Ruby configuration objects.
2
+ //!
3
+ //! This module handles conversion of Ruby ServerConfig objects
4
+ //! into Rust ServerConfig structs for Spikard HTTP server setup.
5
+
6
+ #![allow(dead_code)]
7
+
8
+ use magnus::prelude::*;
9
+ use magnus::{Error, RArray, RHash, Ruby, TryConvert, Value};
10
+ use spikard_http::{
11
+ ApiKeyConfig, CompressionConfig, ContactInfo, JwtConfig, LicenseInfo, OpenApiConfig, RateLimitConfig, ServerConfig,
12
+ ServerInfo, StaticFilesConfig,
13
+ };
14
+ use std::collections::HashMap;
15
+
16
+ use crate::conversion::{get_optional_string_from_hash, get_required_string_from_hash};
17
+
18
+ /// Extract a ServerConfig from a Ruby configuration object.
19
+ ///
20
+ /// Handles all ServerConfig properties including middleware configs,
21
+ /// authentication, static files, and OpenAPI documentation settings.
22
+ pub fn extract_server_config(ruby: &Ruby, config_value: Value) -> Result<ServerConfig, Error> {
23
+ let host: String = config_value.funcall("host", ())?;
24
+
25
+ let port: u32 = config_value.funcall("port", ())?;
26
+
27
+ let workers: usize = config_value.funcall("workers", ())?;
28
+
29
+ let enable_request_id: bool = config_value.funcall("enable_request_id", ())?;
30
+
31
+ let max_body_size_value: Value = config_value.funcall("max_body_size", ())?;
32
+ let max_body_size = if max_body_size_value.is_nil() {
33
+ None
34
+ } else {
35
+ Some(u64::try_convert(max_body_size_value)? as usize)
36
+ };
37
+
38
+ let request_timeout_value: Value = config_value.funcall("request_timeout", ())?;
39
+ let request_timeout = if request_timeout_value.is_nil() {
40
+ None
41
+ } else {
42
+ Some(u64::try_convert(request_timeout_value)?)
43
+ };
44
+
45
+ let graceful_shutdown: bool = config_value.funcall("graceful_shutdown", ())?;
46
+
47
+ let shutdown_timeout: u64 = config_value.funcall("shutdown_timeout", ())?;
48
+
49
+ // Compression config
50
+ let compression_value: Value = config_value.funcall("compression", ())?;
51
+ let compression = if compression_value.is_nil() {
52
+ None
53
+ } else {
54
+ let gzip: bool = compression_value.funcall("gzip", ())?;
55
+ let brotli: bool = compression_value.funcall("brotli", ())?;
56
+ let min_size: usize = compression_value.funcall("min_size", ())?;
57
+ let quality: u32 = compression_value.funcall("quality", ())?;
58
+ Some(CompressionConfig {
59
+ gzip,
60
+ brotli,
61
+ min_size,
62
+ quality,
63
+ })
64
+ };
65
+
66
+ // Rate limit config
67
+ let rate_limit_value: Value = config_value.funcall("rate_limit", ())?;
68
+ let rate_limit = if rate_limit_value.is_nil() {
69
+ None
70
+ } else {
71
+ let per_second: u64 = rate_limit_value.funcall("per_second", ())?;
72
+ let burst: u32 = rate_limit_value.funcall("burst", ())?;
73
+ let ip_based: bool = rate_limit_value.funcall("ip_based", ())?;
74
+ Some(RateLimitConfig {
75
+ per_second,
76
+ burst,
77
+ ip_based,
78
+ })
79
+ };
80
+
81
+ // JWT auth config
82
+ let jwt_auth_value: Value = config_value.funcall("jwt_auth", ())?;
83
+ let jwt_auth = if jwt_auth_value.is_nil() {
84
+ None
85
+ } else {
86
+ let secret: String = jwt_auth_value.funcall("secret", ())?;
87
+ let algorithm: String = jwt_auth_value.funcall("algorithm", ())?;
88
+ let audience_value: Value = jwt_auth_value.funcall("audience", ())?;
89
+ let audience = if audience_value.is_nil() {
90
+ None
91
+ } else {
92
+ Some(Vec::<String>::try_convert(audience_value)?)
93
+ };
94
+ let issuer_value: Value = jwt_auth_value.funcall("issuer", ())?;
95
+ let issuer = if issuer_value.is_nil() {
96
+ None
97
+ } else {
98
+ Some(String::try_convert(issuer_value)?)
99
+ };
100
+ let leeway: u64 = jwt_auth_value.funcall("leeway", ())?;
101
+ Some(JwtConfig {
102
+ secret,
103
+ algorithm,
104
+ audience,
105
+ issuer,
106
+ leeway,
107
+ })
108
+ };
109
+
110
+ // API key auth config
111
+ let api_key_auth_value: Value = config_value.funcall("api_key_auth", ())?;
112
+ let api_key_auth = if api_key_auth_value.is_nil() {
113
+ None
114
+ } else {
115
+ let keys: Vec<String> = api_key_auth_value.funcall("keys", ())?;
116
+ let header_name: String = api_key_auth_value.funcall("header_name", ())?;
117
+ Some(ApiKeyConfig { keys, header_name })
118
+ };
119
+
120
+ // Static files config
121
+ let static_files_value: Value = config_value.funcall("static_files", ())?;
122
+ let static_files_array = RArray::from_value(static_files_value)
123
+ .ok_or_else(|| Error::new(ruby.exception_type_error(), "static_files must be an Array"))?;
124
+
125
+ let mut static_files = Vec::new();
126
+ for i in 0..static_files_array.len() {
127
+ let sf_value = static_files_array.entry::<Value>(i as isize)?;
128
+ let directory: String = sf_value.funcall("directory", ())?;
129
+ let route_prefix: String = sf_value.funcall("route_prefix", ())?;
130
+ let index_file: bool = sf_value.funcall("index_file", ())?;
131
+ let cache_control_value: Value = sf_value.funcall("cache_control", ())?;
132
+ let cache_control = if cache_control_value.is_nil() {
133
+ None
134
+ } else {
135
+ Some(String::try_convert(cache_control_value)?)
136
+ };
137
+ static_files.push(StaticFilesConfig {
138
+ directory,
139
+ route_prefix,
140
+ index_file,
141
+ cache_control,
142
+ });
143
+ }
144
+
145
+ // OpenAPI config
146
+ let openapi_value: Value = config_value.funcall("openapi", ())?;
147
+ let openapi = if openapi_value.is_nil() {
148
+ None
149
+ } else {
150
+ let enabled: bool = openapi_value.funcall("enabled", ())?;
151
+ let title: String = openapi_value.funcall("title", ())?;
152
+ let version: String = openapi_value.funcall("version", ())?;
153
+ let description_value: Value = openapi_value.funcall("description", ())?;
154
+ let description = if description_value.is_nil() {
155
+ None
156
+ } else {
157
+ Some(String::try_convert(description_value)?)
158
+ };
159
+ let swagger_ui_path: String = openapi_value.funcall("swagger_ui_path", ())?;
160
+ let redoc_path: String = openapi_value.funcall("redoc_path", ())?;
161
+ let openapi_json_path: String = openapi_value.funcall("openapi_json_path", ())?;
162
+
163
+ let contact = extract_contact_info(ruby, &openapi_value)?;
164
+ let license = extract_license_info(ruby, &openapi_value)?;
165
+ let servers = extract_servers(ruby, &openapi_value)?;
166
+
167
+ let security_schemes = HashMap::new();
168
+
169
+ Some(OpenApiConfig {
170
+ enabled,
171
+ title,
172
+ version,
173
+ description,
174
+ swagger_ui_path,
175
+ redoc_path,
176
+ openapi_json_path,
177
+ contact,
178
+ license,
179
+ servers,
180
+ security_schemes,
181
+ })
182
+ };
183
+
184
+ Ok(ServerConfig {
185
+ host,
186
+ port: port as u16,
187
+ workers,
188
+ enable_request_id,
189
+ max_body_size,
190
+ request_timeout,
191
+ compression,
192
+ rate_limit,
193
+ jwt_auth,
194
+ api_key_auth,
195
+ static_files,
196
+ graceful_shutdown,
197
+ shutdown_timeout,
198
+ background_tasks: spikard_http::BackgroundTaskConfig::default(),
199
+ openapi,
200
+ lifecycle_hooks: None,
201
+ #[cfg(feature = "di")]
202
+ di_container: None,
203
+ })
204
+ }
205
+
206
+ /// Extract contact information from OpenAPI config.
207
+ fn extract_contact_info(_ruby: &Ruby, openapi_value: &Value) -> Result<Option<ContactInfo>, Error> {
208
+ let contact_value: Value = openapi_value.funcall("contact", ())?;
209
+ if contact_value.is_nil() {
210
+ return Ok(None);
211
+ }
212
+
213
+ if let Some(contact_hash) = RHash::from_value(contact_value) {
214
+ let name = get_optional_string_from_hash(contact_hash, "name")?;
215
+ let email = get_optional_string_from_hash(contact_hash, "email")?;
216
+ let url = get_optional_string_from_hash(contact_hash, "url")?;
217
+ return Ok(Some(ContactInfo { name, email, url }));
218
+ }
219
+
220
+ let name_value: Value = contact_value.funcall("name", ())?;
221
+ let email_value: Value = contact_value.funcall("email", ())?;
222
+ let url_value: Value = contact_value.funcall("url", ())?;
223
+ Ok(Some(ContactInfo {
224
+ name: if name_value.is_nil() {
225
+ None
226
+ } else {
227
+ Some(String::try_convert(name_value)?)
228
+ },
229
+ email: if email_value.is_nil() {
230
+ None
231
+ } else {
232
+ Some(String::try_convert(email_value)?)
233
+ },
234
+ url: if url_value.is_nil() {
235
+ None
236
+ } else {
237
+ Some(String::try_convert(url_value)?)
238
+ },
239
+ }))
240
+ }
241
+
242
+ /// Extract license information from OpenAPI config.
243
+ fn extract_license_info(ruby: &Ruby, openapi_value: &Value) -> Result<Option<LicenseInfo>, Error> {
244
+ let license_value: Value = openapi_value.funcall("license", ())?;
245
+ if license_value.is_nil() {
246
+ return Ok(None);
247
+ }
248
+
249
+ if let Some(license_hash) = RHash::from_value(license_value) {
250
+ let name = get_required_string_from_hash(license_hash, "name", ruby)?;
251
+ let url = get_optional_string_from_hash(license_hash, "url")?;
252
+ return Ok(Some(LicenseInfo { name, url }));
253
+ }
254
+
255
+ let name: String = license_value.funcall("name", ())?;
256
+ let url_value: Value = license_value.funcall("url", ())?;
257
+ let url = if url_value.is_nil() {
258
+ None
259
+ } else {
260
+ Some(String::try_convert(url_value)?)
261
+ };
262
+ Ok(Some(LicenseInfo { name, url }))
263
+ }
264
+
265
+ /// Extract server information from OpenAPI config.
266
+ fn extract_servers(ruby: &Ruby, openapi_value: &Value) -> Result<Vec<ServerInfo>, Error> {
267
+ let servers_value: Value = openapi_value.funcall("servers", ())?;
268
+ let servers_array = RArray::from_value(servers_value)
269
+ .ok_or_else(|| Error::new(ruby.exception_type_error(), "servers must be an Array"))?;
270
+
271
+ let mut servers = Vec::new();
272
+ for i in 0..servers_array.len() {
273
+ let server_value = servers_array.entry::<Value>(i as isize)?;
274
+
275
+ let (url, description) = if let Some(server_hash) = RHash::from_value(server_value) {
276
+ let url = get_required_string_from_hash(server_hash, "url", ruby)?;
277
+ let description = get_optional_string_from_hash(server_hash, "description")?;
278
+ (url, description)
279
+ } else {
280
+ let url: String = server_value.funcall("url", ())?;
281
+ let description_value: Value = server_value.funcall("description", ())?;
282
+ let description = if description_value.is_nil() {
283
+ None
284
+ } else {
285
+ Some(String::try_convert(description_value)?)
286
+ };
287
+ (url, description)
288
+ };
289
+
290
+ servers.push(ServerInfo { url, description });
291
+ }
292
+
293
+ Ok(servers)
294
+ }