spikard 0.3.4 → 0.3.6

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 (180) 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 +366 -360
  23. data/vendor/crates/spikard-core/Cargo.toml +40 -40
  24. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -3
  25. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -133
  26. data/vendor/crates/spikard-core/src/debug.rs +63 -63
  27. data/vendor/crates/spikard-core/src/di/container.rs +726 -726
  28. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -273
  29. data/vendor/crates/spikard-core/src/di/error.rs +118 -118
  30. data/vendor/crates/spikard-core/src/di/factory.rs +538 -538
  31. data/vendor/crates/spikard-core/src/di/graph.rs +545 -545
  32. data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
  33. data/vendor/crates/spikard-core/src/di/resolved.rs +411 -411
  34. data/vendor/crates/spikard-core/src/di/value.rs +283 -283
  35. data/vendor/crates/spikard-core/src/errors.rs +39 -39
  36. data/vendor/crates/spikard-core/src/http.rs +153 -153
  37. data/vendor/crates/spikard-core/src/lib.rs +29 -29
  38. data/vendor/crates/spikard-core/src/lifecycle.rs +422 -422
  39. data/vendor/crates/spikard-core/src/parameters.rs +722 -722
  40. data/vendor/crates/spikard-core/src/problem.rs +310 -310
  41. data/vendor/crates/spikard-core/src/request_data.rs +189 -189
  42. data/vendor/crates/spikard-core/src/router.rs +249 -249
  43. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -183
  44. data/vendor/crates/spikard-core/src/type_hints.rs +304 -304
  45. data/vendor/crates/spikard-core/src/validation.rs +699 -699
  46. data/vendor/crates/spikard-http/Cargo.toml +68 -58
  47. data/vendor/crates/spikard-http/src/auth.rs +247 -247
  48. data/vendor/crates/spikard-http/src/background.rs +249 -249
  49. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -3
  50. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -1
  51. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -8
  52. data/vendor/crates/spikard-http/src/cors.rs +490 -490
  53. data/vendor/crates/spikard-http/src/debug.rs +63 -63
  54. data/vendor/crates/spikard-http/src/di_handler.rs +423 -423
  55. data/vendor/crates/spikard-http/src/handler_response.rs +190 -190
  56. data/vendor/crates/spikard-http/src/handler_trait.rs +228 -228
  57. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +284 -284
  58. data/vendor/crates/spikard-http/src/lib.rs +529 -529
  59. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +149 -149
  60. data/vendor/crates/spikard-http/src/lifecycle.rs +428 -428
  61. data/vendor/crates/spikard-http/src/middleware/mod.rs +285 -285
  62. data/vendor/crates/spikard-http/src/middleware/multipart.rs +86 -86
  63. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +147 -147
  64. data/vendor/crates/spikard-http/src/middleware/validation.rs +287 -287
  65. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
  66. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +190 -190
  67. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +308 -308
  68. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +195 -195
  69. data/vendor/crates/spikard-http/src/parameters.rs +1 -1
  70. data/vendor/crates/spikard-http/src/problem.rs +1 -1
  71. data/vendor/crates/spikard-http/src/query_parser.rs +369 -369
  72. data/vendor/crates/spikard-http/src/response.rs +399 -399
  73. data/vendor/crates/spikard-http/src/router.rs +1 -1
  74. data/vendor/crates/spikard-http/src/schema_registry.rs +1 -1
  75. data/vendor/crates/spikard-http/src/server/handler.rs +87 -87
  76. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +98 -98
  77. data/vendor/crates/spikard-http/src/server/mod.rs +805 -805
  78. data/vendor/crates/spikard-http/src/server/request_extraction.rs +119 -119
  79. data/vendor/crates/spikard-http/src/sse.rs +447 -447
  80. data/vendor/crates/spikard-http/src/testing/form.rs +14 -14
  81. data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -60
  82. data/vendor/crates/spikard-http/src/testing/test_client.rs +285 -285
  83. data/vendor/crates/spikard-http/src/testing.rs +377 -377
  84. data/vendor/crates/spikard-http/src/type_hints.rs +1 -1
  85. data/vendor/crates/spikard-http/src/validation.rs +1 -1
  86. data/vendor/crates/spikard-http/src/websocket.rs +324 -324
  87. data/vendor/crates/spikard-rb/Cargo.toml +42 -42
  88. data/vendor/crates/spikard-rb/build.rs +8 -8
  89. data/vendor/crates/spikard-rb/src/background.rs +63 -63
  90. data/vendor/crates/spikard-rb/src/config.rs +294 -294
  91. data/vendor/crates/spikard-rb/src/conversion.rs +453 -453
  92. data/vendor/crates/spikard-rb/src/di.rs +409 -409
  93. data/vendor/crates/spikard-rb/src/handler.rs +625 -625
  94. data/vendor/crates/spikard-rb/src/lib.rs +2771 -2771
  95. data/vendor/crates/spikard-rb/src/lifecycle.rs +274 -274
  96. data/vendor/crates/spikard-rb/src/server.rs +283 -283
  97. data/vendor/crates/spikard-rb/src/sse.rs +231 -231
  98. data/vendor/crates/spikard-rb/src/test_client.rs +404 -404
  99. data/vendor/crates/spikard-rb/src/test_sse.rs +143 -143
  100. data/vendor/crates/spikard-rb/src/test_websocket.rs +221 -221
  101. data/vendor/crates/spikard-rb/src/websocket.rs +233 -233
  102. metadata +1 -79
  103. data/vendor/spikard-core/Cargo.toml +0 -40
  104. data/vendor/spikard-core/src/bindings/mod.rs +0 -3
  105. data/vendor/spikard-core/src/bindings/response.rs +0 -133
  106. data/vendor/spikard-core/src/debug.rs +0 -63
  107. data/vendor/spikard-core/src/di/container.rs +0 -726
  108. data/vendor/spikard-core/src/di/dependency.rs +0 -273
  109. data/vendor/spikard-core/src/di/error.rs +0 -118
  110. data/vendor/spikard-core/src/di/factory.rs +0 -538
  111. data/vendor/spikard-core/src/di/graph.rs +0 -545
  112. data/vendor/spikard-core/src/di/mod.rs +0 -192
  113. data/vendor/spikard-core/src/di/resolved.rs +0 -411
  114. data/vendor/spikard-core/src/di/value.rs +0 -283
  115. data/vendor/spikard-core/src/http.rs +0 -153
  116. data/vendor/spikard-core/src/lib.rs +0 -28
  117. data/vendor/spikard-core/src/lifecycle.rs +0 -422
  118. data/vendor/spikard-core/src/parameters.rs +0 -719
  119. data/vendor/spikard-core/src/problem.rs +0 -310
  120. data/vendor/spikard-core/src/request_data.rs +0 -189
  121. data/vendor/spikard-core/src/router.rs +0 -249
  122. data/vendor/spikard-core/src/schema_registry.rs +0 -183
  123. data/vendor/spikard-core/src/type_hints.rs +0 -304
  124. data/vendor/spikard-core/src/validation.rs +0 -699
  125. data/vendor/spikard-http/Cargo.toml +0 -58
  126. data/vendor/spikard-http/src/auth.rs +0 -247
  127. data/vendor/spikard-http/src/background.rs +0 -249
  128. data/vendor/spikard-http/src/bindings/mod.rs +0 -3
  129. data/vendor/spikard-http/src/bindings/response.rs +0 -1
  130. data/vendor/spikard-http/src/body_metadata.rs +0 -8
  131. data/vendor/spikard-http/src/cors.rs +0 -490
  132. data/vendor/spikard-http/src/debug.rs +0 -63
  133. data/vendor/spikard-http/src/di_handler.rs +0 -423
  134. data/vendor/spikard-http/src/handler_response.rs +0 -190
  135. data/vendor/spikard-http/src/handler_trait.rs +0 -228
  136. data/vendor/spikard-http/src/handler_trait_tests.rs +0 -284
  137. data/vendor/spikard-http/src/lib.rs +0 -529
  138. data/vendor/spikard-http/src/lifecycle/adapter.rs +0 -149
  139. data/vendor/spikard-http/src/lifecycle.rs +0 -428
  140. data/vendor/spikard-http/src/middleware/mod.rs +0 -285
  141. data/vendor/spikard-http/src/middleware/multipart.rs +0 -86
  142. data/vendor/spikard-http/src/middleware/urlencoded.rs +0 -147
  143. data/vendor/spikard-http/src/middleware/validation.rs +0 -287
  144. data/vendor/spikard-http/src/openapi/mod.rs +0 -309
  145. data/vendor/spikard-http/src/openapi/parameter_extraction.rs +0 -190
  146. data/vendor/spikard-http/src/openapi/schema_conversion.rs +0 -308
  147. data/vendor/spikard-http/src/openapi/spec_generation.rs +0 -195
  148. data/vendor/spikard-http/src/parameters.rs +0 -1
  149. data/vendor/spikard-http/src/problem.rs +0 -1
  150. data/vendor/spikard-http/src/query_parser.rs +0 -369
  151. data/vendor/spikard-http/src/response.rs +0 -399
  152. data/vendor/spikard-http/src/router.rs +0 -1
  153. data/vendor/spikard-http/src/schema_registry.rs +0 -1
  154. data/vendor/spikard-http/src/server/handler.rs +0 -80
  155. data/vendor/spikard-http/src/server/lifecycle_execution.rs +0 -98
  156. data/vendor/spikard-http/src/server/mod.rs +0 -805
  157. data/vendor/spikard-http/src/server/request_extraction.rs +0 -119
  158. data/vendor/spikard-http/src/sse.rs +0 -447
  159. data/vendor/spikard-http/src/testing/form.rs +0 -14
  160. data/vendor/spikard-http/src/testing/multipart.rs +0 -60
  161. data/vendor/spikard-http/src/testing/test_client.rs +0 -285
  162. data/vendor/spikard-http/src/testing.rs +0 -377
  163. data/vendor/spikard-http/src/type_hints.rs +0 -1
  164. data/vendor/spikard-http/src/validation.rs +0 -1
  165. data/vendor/spikard-http/src/websocket.rs +0 -324
  166. data/vendor/spikard-rb/Cargo.toml +0 -42
  167. data/vendor/spikard-rb/build.rs +0 -8
  168. data/vendor/spikard-rb/src/background.rs +0 -63
  169. data/vendor/spikard-rb/src/config.rs +0 -294
  170. data/vendor/spikard-rb/src/conversion.rs +0 -392
  171. data/vendor/spikard-rb/src/di.rs +0 -409
  172. data/vendor/spikard-rb/src/handler.rs +0 -534
  173. data/vendor/spikard-rb/src/lib.rs +0 -2020
  174. data/vendor/spikard-rb/src/lifecycle.rs +0 -267
  175. data/vendor/spikard-rb/src/server.rs +0 -283
  176. data/vendor/spikard-rb/src/sse.rs +0 -231
  177. data/vendor/spikard-rb/src/test_client.rs +0 -404
  178. data/vendor/spikard-rb/src/test_sse.rs +0 -143
  179. data/vendor/spikard-rb/src/test_websocket.rs +0 -221
  180. data/vendor/spikard-rb/src/websocket.rs +0 -233
@@ -1,294 +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
- }
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
+ }