spikard 0.3.1 → 0.3.3

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 +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 +158 -1
@@ -1,13 +1,13 @@
1
- # frozen_string_literal: true
2
-
3
- module Spikard
4
- # Conversion helpers between native Rust values and Ruby types.
5
- module Converters
6
- module_function
7
-
8
- # No-op conversion now that Rust materialises UploadFile.
9
- def convert_handler_body(body)
10
- body
11
- end
12
- end
13
- end
1
+ # frozen_string_literal: true
2
+
3
+ module Spikard
4
+ # Conversion helpers between native Rust values and Ruby types.
5
+ module Converters
6
+ module_function
7
+
8
+ # No-op conversion now that Rust materialises UploadFile.
9
+ def convert_handler_body(body)
10
+ body
11
+ end
12
+ end
13
+ end
@@ -1,113 +1,113 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative 'converters'
4
-
5
- module Spikard
6
- # Handler wrapper utilities.
7
- #
8
- # UploadFile conversion now happens in the Rust binding, so these wrappers
9
- # simply forward the already-converted body/params.
10
- #
11
- # @example Basic usage with body only
12
- # app.post('/upload', &wrap_body_handler do |body|
13
- # {
14
- # filename: body[:file].filename,
15
- # content: body[:file].read
16
- # }
17
- # end)
18
- #
19
- # @example With all parameters
20
- # app.post('/upload', &wrap_handler do |params, query, body|
21
- # {
22
- # id: params[:id],
23
- # search: query[:q],
24
- # file: body[:file].filename
25
- # }
26
- # end)
27
- module HandlerWrapper
28
- module_function
29
-
30
- # Wrap a handler that receives only the request body
31
- #
32
- # Automatically converts file metadata in the body to UploadFile instances.
33
- #
34
- # @yield [body] Handler block that receives converted body
35
- # @yieldparam body [Hash] Request body with file metadata converted to UploadFile
36
- # @yieldreturn [Hash, Spikard::Response] Response data or Response object
37
- # @return [Proc] Wrapped handler proc
38
- #
39
- # @example
40
- # app.post('/upload', &wrap_body_handler do |body|
41
- # { filename: body[:file].filename }
42
- # end)
43
- def wrap_body_handler(&handler)
44
- raise ArgumentError, 'block required for wrap_body_handler' unless handler
45
-
46
- # Return a proc that matches the signature expected by Spikard::App
47
- # The actual handler receives path params, query params, and body from Rust
48
- lambda do |_params, _query, body|
49
- handler.call(body)
50
- end
51
- end
52
-
53
- # Wrap a handler that receives path params, query params, and body
54
- #
55
- # Automatically converts file metadata in the body to UploadFile instances.
56
- #
57
- # @yield [params, query, body] Handler block that receives all request data
58
- # @yieldparam params [Hash] Path parameters
59
- # @yieldparam query [Hash] Query parameters
60
- # @yieldparam body [Hash] Request body with file metadata converted to UploadFile
61
- # @yieldreturn [Hash, Spikard::Response] Response data or Response object
62
- # @return [Proc] Wrapped handler proc
63
- #
64
- # @example
65
- # app.post('/users/{id}/upload', &wrap_handler do |params, query, body|
66
- # {
67
- # user_id: params[:id],
68
- # description: query[:desc],
69
- # file: body[:file].filename
70
- # }
71
- # end)
72
- def wrap_handler(&handler)
73
- raise ArgumentError, 'block required for wrap_handler' unless handler
74
-
75
- lambda do |params, query, body|
76
- handler.call(params, query, body)
77
- end
78
- end
79
-
80
- # Wrap a handler that receives a context hash with all request data
81
- #
82
- # Automatically converts file metadata in the body to UploadFile instances.
83
- # Useful when you want all request data in a single hash.
84
- #
85
- # @yield [context] Handler block that receives context hash
86
- # @yieldparam context [Hash] Request context with:
87
- # - :params [Hash] Path parameters
88
- # - :query [Hash] Query parameters
89
- # - :body [Hash] Request body with file metadata converted to UploadFile
90
- # @yieldreturn [Hash, Spikard::Response] Response data or Response object
91
- # @return [Proc] Wrapped handler proc
92
- #
93
- # @example
94
- # app.post('/upload', &wrap_handler_with_context do |ctx|
95
- # {
96
- # file: ctx[:body][:file].filename,
97
- # query_params: ctx[:query]
98
- # }
99
- # end)
100
- def wrap_handler_with_context(&handler)
101
- raise ArgumentError, 'block required for wrap_handler_with_context' unless handler
102
-
103
- lambda do |params, query, body|
104
- context = {
105
- params: params,
106
- query: query,
107
- body: body
108
- }
109
- handler.call(context)
110
- end
111
- end
112
- end
113
- end
1
+ # frozen_string_literal: true
2
+
3
+ require_relative 'converters'
4
+
5
+ module Spikard
6
+ # Handler wrapper utilities.
7
+ #
8
+ # UploadFile conversion now happens in the Rust binding, so these wrappers
9
+ # simply forward the already-converted body/params.
10
+ #
11
+ # @example Basic usage with body only
12
+ # app.post('/upload', &wrap_body_handler do |body|
13
+ # {
14
+ # filename: body[:file].filename,
15
+ # content: body[:file].read
16
+ # }
17
+ # end)
18
+ #
19
+ # @example With all parameters
20
+ # app.post('/upload', &wrap_handler do |params, query, body|
21
+ # {
22
+ # id: params[:id],
23
+ # search: query[:q],
24
+ # file: body[:file].filename
25
+ # }
26
+ # end)
27
+ module HandlerWrapper
28
+ module_function
29
+
30
+ # Wrap a handler that receives only the request body
31
+ #
32
+ # Automatically converts file metadata in the body to UploadFile instances.
33
+ #
34
+ # @yield [body] Handler block that receives converted body
35
+ # @yieldparam body [Hash] Request body with file metadata converted to UploadFile
36
+ # @yieldreturn [Hash, Spikard::Response] Response data or Response object
37
+ # @return [Proc] Wrapped handler proc
38
+ #
39
+ # @example
40
+ # app.post('/upload', &wrap_body_handler do |body|
41
+ # { filename: body[:file].filename }
42
+ # end)
43
+ def wrap_body_handler(&handler)
44
+ raise ArgumentError, 'block required for wrap_body_handler' unless handler
45
+
46
+ # Return a proc that matches the signature expected by Spikard::App
47
+ # The actual handler receives path params, query params, and body from Rust
48
+ lambda do |_params, _query, body|
49
+ handler.call(body)
50
+ end
51
+ end
52
+
53
+ # Wrap a handler that receives path params, query params, and body
54
+ #
55
+ # Automatically converts file metadata in the body to UploadFile instances.
56
+ #
57
+ # @yield [params, query, body] Handler block that receives all request data
58
+ # @yieldparam params [Hash] Path parameters
59
+ # @yieldparam query [Hash] Query parameters
60
+ # @yieldparam body [Hash] Request body with file metadata converted to UploadFile
61
+ # @yieldreturn [Hash, Spikard::Response] Response data or Response object
62
+ # @return [Proc] Wrapped handler proc
63
+ #
64
+ # @example
65
+ # app.post('/users/{id}/upload', &wrap_handler do |params, query, body|
66
+ # {
67
+ # user_id: params[:id],
68
+ # description: query[:desc],
69
+ # file: body[:file].filename
70
+ # }
71
+ # end)
72
+ def wrap_handler(&handler)
73
+ raise ArgumentError, 'block required for wrap_handler' unless handler
74
+
75
+ lambda do |params, query, body|
76
+ handler.call(params, query, body)
77
+ end
78
+ end
79
+
80
+ # Wrap a handler that receives a context hash with all request data
81
+ #
82
+ # Automatically converts file metadata in the body to UploadFile instances.
83
+ # Useful when you want all request data in a single hash.
84
+ #
85
+ # @yield [context] Handler block that receives context hash
86
+ # @yieldparam context [Hash] Request context with:
87
+ # - :params [Hash] Path parameters
88
+ # - :query [Hash] Query parameters
89
+ # - :body [Hash] Request body with file metadata converted to UploadFile
90
+ # @yieldreturn [Hash, Spikard::Response] Response data or Response object
91
+ # @return [Proc] Wrapped handler proc
92
+ #
93
+ # @example
94
+ # app.post('/upload', &wrap_handler_with_context do |ctx|
95
+ # {
96
+ # file: ctx[:body][:file].filename,
97
+ # query_params: ctx[:query]
98
+ # }
99
+ # end)
100
+ def wrap_handler_with_context(&handler)
101
+ raise ArgumentError, 'block required for wrap_handler_with_context' unless handler
102
+
103
+ lambda do |params, query, body|
104
+ context = {
105
+ params: params,
106
+ query: query,
107
+ body: body
108
+ }
109
+ handler.call(context)
110
+ end
111
+ end
112
+ end
113
+ end