spikard 0.3.5 → 0.5.0

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 (142) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +1 -1
  3. data/README.md +674 -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 +405 -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 +256 -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-bindings-shared/Cargo.toml +63 -0
  24. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -0
  25. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -0
  26. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
  27. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
  28. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -0
  29. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -0
  30. data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -0
  31. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -0
  32. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -0
  33. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -0
  34. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
  35. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -0
  36. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -0
  37. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -0
  38. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -0
  39. data/vendor/crates/spikard-core/Cargo.toml +40 -40
  40. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -3
  41. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -133
  42. data/vendor/crates/spikard-core/src/debug.rs +127 -63
  43. data/vendor/crates/spikard-core/src/di/container.rs +702 -726
  44. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -273
  45. data/vendor/crates/spikard-core/src/di/error.rs +118 -118
  46. data/vendor/crates/spikard-core/src/di/factory.rs +534 -538
  47. data/vendor/crates/spikard-core/src/di/graph.rs +506 -545
  48. data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
  49. data/vendor/crates/spikard-core/src/di/resolved.rs +405 -411
  50. data/vendor/crates/spikard-core/src/di/value.rs +281 -283
  51. data/vendor/crates/spikard-core/src/errors.rs +69 -39
  52. data/vendor/crates/spikard-core/src/http.rs +415 -153
  53. data/vendor/crates/spikard-core/src/lib.rs +29 -29
  54. data/vendor/crates/spikard-core/src/lifecycle.rs +1186 -422
  55. data/vendor/crates/spikard-core/src/metadata.rs +389 -0
  56. data/vendor/crates/spikard-core/src/parameters.rs +2525 -722
  57. data/vendor/crates/spikard-core/src/problem.rs +344 -310
  58. data/vendor/crates/spikard-core/src/request_data.rs +1154 -189
  59. data/vendor/crates/spikard-core/src/router.rs +510 -249
  60. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -183
  61. data/vendor/crates/spikard-core/src/type_hints.rs +304 -304
  62. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +688 -0
  63. data/vendor/crates/spikard-core/src/{validation.rs → validation/mod.rs} +457 -699
  64. data/vendor/crates/spikard-http/Cargo.toml +64 -68
  65. data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -0
  66. data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -0
  67. data/vendor/crates/spikard-http/src/auth.rs +296 -247
  68. data/vendor/crates/spikard-http/src/background.rs +1860 -249
  69. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -3
  70. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -1
  71. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -8
  72. data/vendor/crates/spikard-http/src/cors.rs +1005 -490
  73. data/vendor/crates/spikard-http/src/debug.rs +128 -63
  74. data/vendor/crates/spikard-http/src/di_handler.rs +1668 -423
  75. data/vendor/crates/spikard-http/src/handler_response.rs +901 -190
  76. data/vendor/crates/spikard-http/src/handler_trait.rs +830 -228
  77. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +290 -284
  78. data/vendor/crates/spikard-http/src/lib.rs +534 -529
  79. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +230 -149
  80. data/vendor/crates/spikard-http/src/lifecycle.rs +1193 -428
  81. data/vendor/crates/spikard-http/src/middleware/mod.rs +540 -285
  82. data/vendor/crates/spikard-http/src/middleware/multipart.rs +912 -86
  83. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +513 -147
  84. data/vendor/crates/spikard-http/src/middleware/validation.rs +735 -287
  85. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
  86. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -190
  87. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1363 -308
  88. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +665 -195
  89. data/vendor/crates/spikard-http/src/query_parser.rs +793 -369
  90. data/vendor/crates/spikard-http/src/response.rs +720 -399
  91. data/vendor/crates/spikard-http/src/server/handler.rs +1650 -87
  92. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +234 -98
  93. data/vendor/crates/spikard-http/src/server/mod.rs +1502 -805
  94. data/vendor/crates/spikard-http/src/server/request_extraction.rs +770 -119
  95. data/vendor/crates/spikard-http/src/server/routing_factory.rs +599 -0
  96. data/vendor/crates/spikard-http/src/sse.rs +1409 -447
  97. data/vendor/crates/spikard-http/src/testing/form.rs +52 -14
  98. data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -60
  99. data/vendor/crates/spikard-http/src/testing/test_client.rs +283 -285
  100. data/vendor/crates/spikard-http/src/testing.rs +377 -377
  101. data/vendor/crates/spikard-http/src/websocket.rs +1375 -324
  102. data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -0
  103. data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -0
  104. data/vendor/crates/spikard-http/tests/common/mod.rs +26 -0
  105. data/vendor/crates/spikard-http/tests/di_integration.rs +192 -0
  106. data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -0
  107. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -0
  108. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -0
  109. data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -0
  110. data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -0
  111. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -0
  112. data/vendor/crates/spikard-rb/Cargo.toml +48 -42
  113. data/vendor/crates/spikard-rb/build.rs +199 -8
  114. data/vendor/crates/spikard-rb/src/background.rs +63 -63
  115. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
  116. data/vendor/crates/spikard-rb/src/{config.rs → config/server_config.rs} +285 -294
  117. data/vendor/crates/spikard-rb/src/conversion.rs +554 -453
  118. data/vendor/crates/spikard-rb/src/di/builder.rs +100 -0
  119. data/vendor/crates/spikard-rb/src/{di.rs → di/mod.rs} +375 -409
  120. data/vendor/crates/spikard-rb/src/handler.rs +618 -625
  121. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
  122. data/vendor/crates/spikard-rb/src/lib.rs +1810 -2771
  123. data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -274
  124. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
  125. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +447 -0
  126. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
  127. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -0
  128. data/vendor/crates/spikard-rb/src/server.rs +308 -283
  129. data/vendor/crates/spikard-rb/src/sse.rs +231 -231
  130. data/vendor/crates/spikard-rb/src/{test_client.rs → testing/client.rs} +551 -404
  131. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
  132. data/vendor/crates/spikard-rb/src/{test_sse.rs → testing/sse.rs} +143 -143
  133. data/vendor/crates/spikard-rb/src/testing/websocket.rs +635 -0
  134. data/vendor/crates/spikard-rb/src/websocket.rs +374 -233
  135. metadata +46 -13
  136. data/vendor/crates/spikard-http/src/parameters.rs +0 -1
  137. data/vendor/crates/spikard-http/src/problem.rs +0 -1
  138. data/vendor/crates/spikard-http/src/router.rs +0 -1
  139. data/vendor/crates/spikard-http/src/schema_registry.rs +0 -1
  140. data/vendor/crates/spikard-http/src/type_hints.rs +0 -1
  141. data/vendor/crates/spikard-http/src/validation.rs +0 -1
  142. data/vendor/crates/spikard-rb/src/test_websocket.rs +0 -221
@@ -1,173 +1,173 @@
1
- # frozen_string_literal: true
2
-
3
- # ⚠️ GENERATED BY crates/spikard-rb/build.rs — DO NOT EDIT BY HAND
4
- module Spikard
5
- class Response # :nodoc: Native-backed HTTP response facade generated from Rust metadata.
6
- attr_reader :content, :status_code, :headers, :native_response
7
-
8
- def initialize(content: nil, body: nil, status_code: 200, headers: nil, content_type: nil)
9
- @content = content.nil? ? body : content
10
- @status_code = Integer(status_code || 200)
11
- @headers = normalize_headers(headers)
12
- set_header('content-type', content_type) if content_type
13
- rebuild_native!
14
- end
15
-
16
- def status
17
- @status_code
18
- end
19
-
20
- def status_code=(value)
21
- @status_code = Integer(value)
22
- rebuild_native!
23
- rescue ArgumentError, TypeError
24
- raise ArgumentError, 'status_code must be an integer'
25
- end
26
-
27
- def headers=(value)
28
- @headers = normalize_headers(value)
29
- rebuild_native!
30
- end
31
-
32
- def content=(value)
33
- @content = value
34
- rebuild_native!
35
- end
36
-
37
- def set_header(name, value)
38
- @headers[name.to_s] = value.to_s
39
- rebuild_native!
40
- end
41
-
42
- def set_cookie(name, value, **options)
43
- raise ArgumentError, 'cookie name required' if name.nil? || name.empty?
44
-
45
- header_value = ["#{name}=#{value}", *cookie_parts(options)].join('; ')
46
- set_header('set-cookie', header_value)
47
- end
48
-
49
- def to_native_response
50
- @native_response
51
- end
52
-
53
- private
54
-
55
- def rebuild_native!
56
- ensure_native!
57
- @native_response = Spikard::Native.build_response(@content, @status_code, @headers)
58
- return unless @native_response
59
-
60
- @status_code = @native_response.status_code
61
- @headers = @native_response.headers
62
- end
63
-
64
- def ensure_native!
65
- return if defined?(Spikard::Native) && Spikard::Native.respond_to?(:build_response)
66
-
67
- raise 'Spikard native extension is not loaded'
68
- end
69
-
70
- def cookie_parts(options)
71
- [
72
- options[:max_age] && "Max-Age=#{Integer(options[:max_age])}",
73
- options[:domain] && "Domain=#{options[:domain]}",
74
- "Path=#{options.fetch(:path, '/') || '/'}",
75
- options[:secure] ? 'Secure' : nil,
76
- options[:httponly] ? 'HttpOnly' : nil,
77
- options[:samesite] && "SameSite=#{options[:samesite]}"
78
- ].compact
79
- end
80
-
81
- def normalize_headers(value)
82
- case value
83
- when nil
84
- {}
85
- when Hash
86
- value.each_with_object({}) do |(key, val), acc|
87
- acc[key.to_s.downcase] = val.to_s
88
- end
89
- else
90
- raise ArgumentError, 'headers must be a Hash'
91
- end
92
- end
93
- end
94
-
95
- class StreamingResponse # :nodoc: Streaming response wrapper backed by the native Rust builder.
96
- attr_reader :stream, :status_code, :headers, :native_response
97
-
98
- def initialize(stream, status_code: 200, headers: nil)
99
- unless stream.respond_to?(:next) || stream.respond_to?(:each)
100
- raise ArgumentError, 'StreamingResponse requires an object responding to #next or #each'
101
- end
102
-
103
- @stream = stream.respond_to?(:to_enum) ? stream.to_enum : stream
104
- @status_code = Integer(status_code || 200)
105
- header_hash = headers || {}
106
- @headers = header_hash.each_with_object({}) do |(key, value), memo|
107
- memo[String(key)] = String(value)
108
- end
109
-
110
- rebuild_native!
111
- end
112
-
113
- def to_native_response
114
- @native_response
115
- end
116
-
117
- private
118
-
119
- def rebuild_native!
120
- ensure_native!
121
- @native_response = Spikard::Native.build_streaming_response(@stream, @status_code, @headers)
122
- return unless @native_response
123
-
124
- @status_code = @native_response.status_code
125
- @headers = @native_response.headers
126
- end
127
-
128
- def ensure_native!
129
- return if defined?(Spikard::Native) && Spikard::Native.respond_to?(:build_streaming_response)
130
-
131
- raise 'Spikard native extension is not loaded'
132
- end
133
- end
134
-
135
- module Testing
136
- class Response # :nodoc: Lightweight response wrapper used by the test client.
137
- attr_reader :status_code, :headers, :body
138
-
139
- def initialize(payload)
140
- @status_code = payload[:status_code]
141
- @headers = payload[:headers] || {}
142
- @body = payload[:body]
143
- @body_text = payload[:body_text]
144
- end
145
-
146
- def status
147
- @status_code
148
- end
149
-
150
- def body_bytes
151
- @body || ''.b
152
- end
153
-
154
- def body_text
155
- @body_text || @body&.dup&.force_encoding(Encoding::UTF_8)
156
- end
157
-
158
- def text
159
- body_text
160
- end
161
-
162
- def json
163
- return nil if @body.nil? || @body.empty?
164
-
165
- JSON.parse(@body)
166
- end
167
-
168
- def bytes
169
- body_bytes.bytes
170
- end
171
- end
172
- end
173
- end
1
+ # frozen_string_literal: true
2
+
3
+ # ⚠️ GENERATED BY crates/spikard-rb/build.rs — DO NOT EDIT BY HAND
4
+ module Spikard
5
+ class Response # :nodoc: Native-backed HTTP response facade generated from Rust metadata.
6
+ attr_reader :content, :status_code, :headers, :native_response
7
+
8
+ def initialize(content: nil, body: nil, status_code: 200, headers: nil, content_type: nil)
9
+ @content = content.nil? ? body : content
10
+ @status_code = Integer(status_code || 200)
11
+ @headers = normalize_headers(headers)
12
+ set_header('content-type', content_type) if content_type
13
+ rebuild_native!
14
+ end
15
+
16
+ def status
17
+ @status_code
18
+ end
19
+
20
+ def status_code=(value)
21
+ @status_code = Integer(value)
22
+ rebuild_native!
23
+ rescue ArgumentError, TypeError
24
+ raise ArgumentError, 'status_code must be an integer'
25
+ end
26
+
27
+ def headers=(value)
28
+ @headers = normalize_headers(value)
29
+ rebuild_native!
30
+ end
31
+
32
+ def content=(value)
33
+ @content = value
34
+ rebuild_native!
35
+ end
36
+
37
+ def set_header(name, value)
38
+ @headers[name.to_s] = value.to_s
39
+ rebuild_native!
40
+ end
41
+
42
+ def set_cookie(name, value, **options)
43
+ raise ArgumentError, 'cookie name required' if name.nil? || name.empty?
44
+
45
+ header_value = ["#{name}=#{value}", *cookie_parts(options)].join('; ')
46
+ set_header('set-cookie', header_value)
47
+ end
48
+
49
+ def to_native_response
50
+ @native_response
51
+ end
52
+
53
+ private
54
+
55
+ def rebuild_native!
56
+ ensure_native!
57
+ @native_response = Spikard::Native.build_response(@content, @status_code, @headers)
58
+ return unless @native_response
59
+
60
+ @status_code = @native_response.status_code
61
+ @headers = @native_response.headers
62
+ end
63
+
64
+ def ensure_native!
65
+ return if defined?(Spikard::Native) && Spikard::Native.respond_to?(:build_response)
66
+
67
+ raise 'Spikard native extension is not loaded'
68
+ end
69
+
70
+ def cookie_parts(options)
71
+ [
72
+ options[:max_age] && "Max-Age=#{Integer(options[:max_age])}",
73
+ options[:domain] && "Domain=#{options[:domain]}",
74
+ "Path=#{options.fetch(:path, '/') || '/'}",
75
+ options[:secure] ? 'Secure' : nil,
76
+ options[:httponly] ? 'HttpOnly' : nil,
77
+ options[:samesite] && "SameSite=#{options[:samesite]}"
78
+ ].compact
79
+ end
80
+
81
+ def normalize_headers(value)
82
+ case value
83
+ when nil
84
+ {}
85
+ when Hash
86
+ value.each_with_object({}) do |(key, val), acc|
87
+ acc[key.to_s.downcase] = val.to_s
88
+ end
89
+ else
90
+ raise ArgumentError, 'headers must be a Hash'
91
+ end
92
+ end
93
+ end
94
+
95
+ class StreamingResponse # :nodoc: Streaming response wrapper backed by the native Rust builder.
96
+ attr_reader :stream, :status_code, :headers, :native_response
97
+
98
+ def initialize(stream, status_code: 200, headers: nil)
99
+ unless stream.respond_to?(:next) || stream.respond_to?(:each)
100
+ raise ArgumentError, 'StreamingResponse requires an object responding to #next or #each'
101
+ end
102
+
103
+ @stream = stream.respond_to?(:to_enum) ? stream.to_enum : stream
104
+ @status_code = Integer(status_code || 200)
105
+ header_hash = headers || {}
106
+ @headers = header_hash.each_with_object({}) do |(key, value), memo|
107
+ memo[String(key)] = String(value)
108
+ end
109
+
110
+ rebuild_native!
111
+ end
112
+
113
+ def to_native_response
114
+ @native_response
115
+ end
116
+
117
+ private
118
+
119
+ def rebuild_native!
120
+ ensure_native!
121
+ @native_response = Spikard::Native.build_streaming_response(@stream, @status_code, @headers)
122
+ return unless @native_response
123
+
124
+ @status_code = @native_response.status_code
125
+ @headers = @native_response.headers
126
+ end
127
+
128
+ def ensure_native!
129
+ return if defined?(Spikard::Native) && Spikard::Native.respond_to?(:build_streaming_response)
130
+
131
+ raise 'Spikard native extension is not loaded'
132
+ end
133
+ end
134
+
135
+ module Testing
136
+ class Response # :nodoc: Lightweight response wrapper used by the test client.
137
+ attr_reader :status_code, :headers, :body
138
+
139
+ def initialize(payload)
140
+ @status_code = payload[:status_code]
141
+ @headers = payload[:headers] || {}
142
+ @body = payload[:body]
143
+ @body_text = payload[:body_text]
144
+ end
145
+
146
+ def status
147
+ @status_code
148
+ end
149
+
150
+ def body_bytes
151
+ @body || ''.b
152
+ end
153
+
154
+ def body_text
155
+ @body_text || @body&.dup&.force_encoding(Encoding::UTF_8)
156
+ end
157
+
158
+ def text
159
+ body_text
160
+ end
161
+
162
+ def json
163
+ return nil if @body.nil? || @body.empty?
164
+
165
+ JSON.parse(@body)
166
+ end
167
+
168
+ def bytes
169
+ body_bytes.bytes
170
+ end
171
+ end
172
+ end
173
+ end