spikard 0.5.0 → 0.6.1
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.
- checksums.yaml +4 -4
- data/LICENSE +1 -1
- data/README.md +674 -674
- data/ext/spikard_rb/Cargo.toml +17 -17
- data/ext/spikard_rb/extconf.rb +13 -10
- data/ext/spikard_rb/src/lib.rs +6 -6
- data/lib/spikard/app.rb +405 -405
- data/lib/spikard/background.rb +27 -27
- data/lib/spikard/config.rb +396 -396
- data/lib/spikard/converters.rb +13 -13
- data/lib/spikard/handler_wrapper.rb +113 -113
- data/lib/spikard/provide.rb +214 -214
- data/lib/spikard/response.rb +173 -173
- data/lib/spikard/schema.rb +243 -243
- data/lib/spikard/sse.rb +111 -111
- data/lib/spikard/streaming_response.rb +44 -44
- data/lib/spikard/testing.rb +256 -256
- data/lib/spikard/upload_file.rb +131 -131
- data/lib/spikard/version.rb +5 -5
- data/lib/spikard/websocket.rb +59 -59
- data/lib/spikard.rb +43 -43
- data/sig/spikard.rbs +366 -366
- data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -63
- data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -132
- data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -752
- data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -194
- data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -246
- data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -401
- data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -238
- data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -24
- data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -292
- data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -616
- data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -305
- data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -248
- data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -351
- data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -454
- data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -383
- data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -280
- data/vendor/crates/spikard-core/Cargo.toml +40 -40
- data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -3
- data/vendor/crates/spikard-core/src/bindings/response.rs +133 -133
- data/vendor/crates/spikard-core/src/debug.rs +127 -127
- data/vendor/crates/spikard-core/src/di/container.rs +702 -702
- data/vendor/crates/spikard-core/src/di/dependency.rs +273 -273
- data/vendor/crates/spikard-core/src/di/error.rs +118 -118
- data/vendor/crates/spikard-core/src/di/factory.rs +534 -534
- data/vendor/crates/spikard-core/src/di/graph.rs +506 -506
- data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
- data/vendor/crates/spikard-core/src/di/resolved.rs +405 -405
- data/vendor/crates/spikard-core/src/di/value.rs +281 -281
- data/vendor/crates/spikard-core/src/errors.rs +69 -69
- data/vendor/crates/spikard-core/src/http.rs +415 -415
- data/vendor/crates/spikard-core/src/lib.rs +29 -29
- data/vendor/crates/spikard-core/src/lifecycle.rs +1186 -1186
- data/vendor/crates/spikard-core/src/metadata.rs +389 -389
- data/vendor/crates/spikard-core/src/parameters.rs +2525 -2525
- data/vendor/crates/spikard-core/src/problem.rs +344 -344
- data/vendor/crates/spikard-core/src/request_data.rs +1154 -1154
- data/vendor/crates/spikard-core/src/router.rs +510 -510
- data/vendor/crates/spikard-core/src/schema_registry.rs +183 -183
- data/vendor/crates/spikard-core/src/type_hints.rs +304 -304
- data/vendor/crates/spikard-core/src/validation/error_mapper.rs +696 -688
- data/vendor/crates/spikard-core/src/validation/mod.rs +457 -457
- data/vendor/crates/spikard-http/Cargo.toml +62 -64
- data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -148
- data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -92
- data/vendor/crates/spikard-http/src/auth.rs +296 -296
- data/vendor/crates/spikard-http/src/background.rs +1860 -1860
- data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -3
- data/vendor/crates/spikard-http/src/bindings/response.rs +1 -1
- data/vendor/crates/spikard-http/src/body_metadata.rs +8 -8
- data/vendor/crates/spikard-http/src/cors.rs +1005 -1005
- data/vendor/crates/spikard-http/src/debug.rs +128 -128
- data/vendor/crates/spikard-http/src/di_handler.rs +1668 -1668
- data/vendor/crates/spikard-http/src/handler_response.rs +901 -901
- data/vendor/crates/spikard-http/src/handler_trait.rs +838 -830
- data/vendor/crates/spikard-http/src/handler_trait_tests.rs +290 -290
- data/vendor/crates/spikard-http/src/lib.rs +534 -534
- data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +230 -230
- data/vendor/crates/spikard-http/src/lifecycle.rs +1193 -1193
- data/vendor/crates/spikard-http/src/middleware/mod.rs +560 -540
- data/vendor/crates/spikard-http/src/middleware/multipart.rs +912 -912
- data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +513 -513
- data/vendor/crates/spikard-http/src/middleware/validation.rs +768 -735
- data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
- data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -535
- data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1363 -1363
- data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +665 -665
- data/vendor/crates/spikard-http/src/query_parser.rs +793 -793
- data/vendor/crates/spikard-http/src/response.rs +720 -720
- data/vendor/crates/spikard-http/src/server/handler.rs +1650 -1650
- data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +234 -234
- data/vendor/crates/spikard-http/src/server/mod.rs +1593 -1502
- data/vendor/crates/spikard-http/src/server/request_extraction.rs +789 -770
- data/vendor/crates/spikard-http/src/server/routing_factory.rs +629 -599
- data/vendor/crates/spikard-http/src/sse.rs +1409 -1409
- data/vendor/crates/spikard-http/src/testing/form.rs +52 -52
- data/vendor/crates/spikard-http/src/testing/multipart.rs +64 -60
- data/vendor/crates/spikard-http/src/testing/test_client.rs +311 -283
- data/vendor/crates/spikard-http/src/testing.rs +406 -377
- data/vendor/crates/spikard-http/src/websocket.rs +1404 -1375
- data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -832
- data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -309
- data/vendor/crates/spikard-http/tests/common/mod.rs +26 -26
- data/vendor/crates/spikard-http/tests/di_integration.rs +192 -192
- data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -5
- data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -1093
- data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -656
- data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -314
- data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -620
- data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -663
- data/vendor/crates/spikard-rb/Cargo.toml +48 -48
- data/vendor/crates/spikard-rb/build.rs +199 -199
- data/vendor/crates/spikard-rb/src/background.rs +63 -63
- data/vendor/crates/spikard-rb/src/config/mod.rs +5 -5
- data/vendor/crates/spikard-rb/src/config/server_config.rs +285 -285
- data/vendor/crates/spikard-rb/src/conversion.rs +554 -554
- data/vendor/crates/spikard-rb/src/di/builder.rs +100 -100
- data/vendor/crates/spikard-rb/src/di/mod.rs +375 -375
- data/vendor/crates/spikard-rb/src/handler.rs +618 -618
- data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -3
- data/vendor/crates/spikard-rb/src/lib.rs +1806 -1810
- data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -275
- data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -5
- data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +442 -447
- data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -5
- data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -324
- data/vendor/crates/spikard-rb/src/server.rs +305 -308
- data/vendor/crates/spikard-rb/src/sse.rs +231 -231
- data/vendor/crates/spikard-rb/src/testing/client.rs +538 -551
- data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -7
- data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -143
- data/vendor/crates/spikard-rb/src/testing/websocket.rs +608 -635
- data/vendor/crates/spikard-rb/src/websocket.rs +377 -374
- metadata +15 -1
|
@@ -1,128 +1,128 @@
|
|
|
1
|
-
//! Debug logging utilities for spikard-http
|
|
2
|
-
//!
|
|
3
|
-
//! This module provides debug logging that can be enabled via:
|
|
4
|
-
//! - Building in debug mode (cfg(debug_assertions))
|
|
5
|
-
//! - Setting SPIKARD_DEBUG=1 environment variable
|
|
6
|
-
|
|
7
|
-
use std::sync::atomic::{AtomicBool, Ordering};
|
|
8
|
-
|
|
9
|
-
static DEBUG_ENABLED: AtomicBool = AtomicBool::new(false);
|
|
10
|
-
|
|
11
|
-
/// Initialize debug logging based on environment and build mode
|
|
12
|
-
pub fn init() {
|
|
13
|
-
let enabled = cfg!(debug_assertions) || std::env::var("SPIKARD_DEBUG").is_ok() || std::env::var("DEBUG").is_ok();
|
|
14
|
-
|
|
15
|
-
eprintln!(
|
|
16
|
-
"[spikard-http::debug] init() called, cfg!(debug_assertions)={}, DEBUG={}, enabled={}",
|
|
17
|
-
cfg!(debug_assertions),
|
|
18
|
-
std::env::var("DEBUG").is_ok(),
|
|
19
|
-
enabled
|
|
20
|
-
);
|
|
21
|
-
|
|
22
|
-
DEBUG_ENABLED.store(enabled, Ordering::Relaxed);
|
|
23
|
-
|
|
24
|
-
if enabled {
|
|
25
|
-
eprintln!("[spikard-http] Debug logging enabled");
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
/// Check if debug logging is enabled
|
|
30
|
-
#[inline]
|
|
31
|
-
pub fn is_enabled() -> bool {
|
|
32
|
-
DEBUG_ENABLED.load(Ordering::Relaxed)
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
/// Log a debug message if debugging is enabled
|
|
36
|
-
#[macro_export]
|
|
37
|
-
macro_rules! debug_log {
|
|
38
|
-
($($arg:tt)*) => {
|
|
39
|
-
if $crate::debug::is_enabled() {
|
|
40
|
-
eprintln!("[spikard-http] {}", format!($($arg)*));
|
|
41
|
-
}
|
|
42
|
-
};
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
/// Log a debug message with a specific module/component name
|
|
46
|
-
#[macro_export]
|
|
47
|
-
macro_rules! debug_log_module {
|
|
48
|
-
($module:expr, $($arg:tt)*) => {
|
|
49
|
-
if $crate::debug::is_enabled() {
|
|
50
|
-
eprintln!("[spikard-http::{}] {}", $module, format!($($arg)*));
|
|
51
|
-
}
|
|
52
|
-
};
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/// Log a debug value with pretty-printing
|
|
56
|
-
#[macro_export]
|
|
57
|
-
macro_rules! debug_log_value {
|
|
58
|
-
($name:expr, $value:expr) => {
|
|
59
|
-
if $crate::debug::is_enabled() {
|
|
60
|
-
eprintln!("[spikard-http] {} = {:?}", $name, $value);
|
|
61
|
-
}
|
|
62
|
-
};
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
#[cfg(test)]
|
|
66
|
-
mod tests {
|
|
67
|
-
use super::*;
|
|
68
|
-
use std::sync::Mutex;
|
|
69
|
-
use std::sync::atomic::Ordering;
|
|
70
|
-
|
|
71
|
-
static FLAG_LOCK: Mutex<()> = Mutex::new(());
|
|
72
|
-
|
|
73
|
-
struct DebugFlagGuard {
|
|
74
|
-
previous_flag: bool,
|
|
75
|
-
previous_env: Option<String>,
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
impl Drop for DebugFlagGuard {
|
|
79
|
-
fn drop(&mut self) {
|
|
80
|
-
DEBUG_ENABLED.store(self.previous_flag, Ordering::Relaxed);
|
|
81
|
-
if let Some(prev) = &self.previous_env {
|
|
82
|
-
unsafe { std::env::set_var("SPIKARD_DEBUG", prev) };
|
|
83
|
-
} else {
|
|
84
|
-
unsafe { std::env::remove_var("SPIKARD_DEBUG") };
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
#[test]
|
|
90
|
-
fn init_enables_debug_when_requested() {
|
|
91
|
-
let _lock = FLAG_LOCK.lock().unwrap();
|
|
92
|
-
let previous = DEBUG_ENABLED.load(Ordering::Relaxed);
|
|
93
|
-
let previous_env = std::env::var("SPIKARD_DEBUG").ok();
|
|
94
|
-
let _guard = DebugFlagGuard {
|
|
95
|
-
previous_flag: previous,
|
|
96
|
-
previous_env,
|
|
97
|
-
};
|
|
98
|
-
|
|
99
|
-
unsafe { std::env::set_var("SPIKARD_DEBUG", "1") };
|
|
100
|
-
|
|
101
|
-
init();
|
|
102
|
-
|
|
103
|
-
assert!(is_enabled(), "init should enable debug in test builds");
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
#[test]
|
|
107
|
-
fn macros_respect_debug_flag() {
|
|
108
|
-
let _lock = FLAG_LOCK.lock().unwrap();
|
|
109
|
-
let previous = DEBUG_ENABLED.load(Ordering::Relaxed);
|
|
110
|
-
let previous_env = std::env::var("SPIKARD_DEBUG").ok();
|
|
111
|
-
let _guard = DebugFlagGuard {
|
|
112
|
-
previous_flag: previous,
|
|
113
|
-
previous_env,
|
|
114
|
-
};
|
|
115
|
-
|
|
116
|
-
DEBUG_ENABLED.store(false, Ordering::Relaxed);
|
|
117
|
-
debug_log!("should not print while disabled");
|
|
118
|
-
debug_log_module!("middleware", "disabled branch");
|
|
119
|
-
debug_log_value!("key", 1_u8);
|
|
120
|
-
assert!(!is_enabled());
|
|
121
|
-
|
|
122
|
-
DEBUG_ENABLED.store(true, Ordering::Relaxed);
|
|
123
|
-
debug_log!("now printing {}", 2);
|
|
124
|
-
debug_log_module!("router", "enabled branch");
|
|
125
|
-
debug_log_value!("value", 3_i32);
|
|
126
|
-
assert!(is_enabled());
|
|
127
|
-
}
|
|
128
|
-
}
|
|
1
|
+
//! Debug logging utilities for spikard-http
|
|
2
|
+
//!
|
|
3
|
+
//! This module provides debug logging that can be enabled via:
|
|
4
|
+
//! - Building in debug mode (cfg(debug_assertions))
|
|
5
|
+
//! - Setting SPIKARD_DEBUG=1 environment variable
|
|
6
|
+
|
|
7
|
+
use std::sync::atomic::{AtomicBool, Ordering};
|
|
8
|
+
|
|
9
|
+
static DEBUG_ENABLED: AtomicBool = AtomicBool::new(false);
|
|
10
|
+
|
|
11
|
+
/// Initialize debug logging based on environment and build mode
|
|
12
|
+
pub fn init() {
|
|
13
|
+
let enabled = cfg!(debug_assertions) || std::env::var("SPIKARD_DEBUG").is_ok() || std::env::var("DEBUG").is_ok();
|
|
14
|
+
|
|
15
|
+
eprintln!(
|
|
16
|
+
"[spikard-http::debug] init() called, cfg!(debug_assertions)={}, DEBUG={}, enabled={}",
|
|
17
|
+
cfg!(debug_assertions),
|
|
18
|
+
std::env::var("DEBUG").is_ok(),
|
|
19
|
+
enabled
|
|
20
|
+
);
|
|
21
|
+
|
|
22
|
+
DEBUG_ENABLED.store(enabled, Ordering::Relaxed);
|
|
23
|
+
|
|
24
|
+
if enabled {
|
|
25
|
+
eprintln!("[spikard-http] Debug logging enabled");
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/// Check if debug logging is enabled
|
|
30
|
+
#[inline]
|
|
31
|
+
pub fn is_enabled() -> bool {
|
|
32
|
+
DEBUG_ENABLED.load(Ordering::Relaxed)
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/// Log a debug message if debugging is enabled
|
|
36
|
+
#[macro_export]
|
|
37
|
+
macro_rules! debug_log {
|
|
38
|
+
($($arg:tt)*) => {
|
|
39
|
+
if $crate::debug::is_enabled() {
|
|
40
|
+
eprintln!("[spikard-http] {}", format!($($arg)*));
|
|
41
|
+
}
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/// Log a debug message with a specific module/component name
|
|
46
|
+
#[macro_export]
|
|
47
|
+
macro_rules! debug_log_module {
|
|
48
|
+
($module:expr, $($arg:tt)*) => {
|
|
49
|
+
if $crate::debug::is_enabled() {
|
|
50
|
+
eprintln!("[spikard-http::{}] {}", $module, format!($($arg)*));
|
|
51
|
+
}
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/// Log a debug value with pretty-printing
|
|
56
|
+
#[macro_export]
|
|
57
|
+
macro_rules! debug_log_value {
|
|
58
|
+
($name:expr, $value:expr) => {
|
|
59
|
+
if $crate::debug::is_enabled() {
|
|
60
|
+
eprintln!("[spikard-http] {} = {:?}", $name, $value);
|
|
61
|
+
}
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
#[cfg(test)]
|
|
66
|
+
mod tests {
|
|
67
|
+
use super::*;
|
|
68
|
+
use std::sync::Mutex;
|
|
69
|
+
use std::sync::atomic::Ordering;
|
|
70
|
+
|
|
71
|
+
static FLAG_LOCK: Mutex<()> = Mutex::new(());
|
|
72
|
+
|
|
73
|
+
struct DebugFlagGuard {
|
|
74
|
+
previous_flag: bool,
|
|
75
|
+
previous_env: Option<String>,
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
impl Drop for DebugFlagGuard {
|
|
79
|
+
fn drop(&mut self) {
|
|
80
|
+
DEBUG_ENABLED.store(self.previous_flag, Ordering::Relaxed);
|
|
81
|
+
if let Some(prev) = &self.previous_env {
|
|
82
|
+
unsafe { std::env::set_var("SPIKARD_DEBUG", prev) };
|
|
83
|
+
} else {
|
|
84
|
+
unsafe { std::env::remove_var("SPIKARD_DEBUG") };
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
#[test]
|
|
90
|
+
fn init_enables_debug_when_requested() {
|
|
91
|
+
let _lock = FLAG_LOCK.lock().unwrap();
|
|
92
|
+
let previous = DEBUG_ENABLED.load(Ordering::Relaxed);
|
|
93
|
+
let previous_env = std::env::var("SPIKARD_DEBUG").ok();
|
|
94
|
+
let _guard = DebugFlagGuard {
|
|
95
|
+
previous_flag: previous,
|
|
96
|
+
previous_env,
|
|
97
|
+
};
|
|
98
|
+
|
|
99
|
+
unsafe { std::env::set_var("SPIKARD_DEBUG", "1") };
|
|
100
|
+
|
|
101
|
+
init();
|
|
102
|
+
|
|
103
|
+
assert!(is_enabled(), "init should enable debug in test builds");
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
#[test]
|
|
107
|
+
fn macros_respect_debug_flag() {
|
|
108
|
+
let _lock = FLAG_LOCK.lock().unwrap();
|
|
109
|
+
let previous = DEBUG_ENABLED.load(Ordering::Relaxed);
|
|
110
|
+
let previous_env = std::env::var("SPIKARD_DEBUG").ok();
|
|
111
|
+
let _guard = DebugFlagGuard {
|
|
112
|
+
previous_flag: previous,
|
|
113
|
+
previous_env,
|
|
114
|
+
};
|
|
115
|
+
|
|
116
|
+
DEBUG_ENABLED.store(false, Ordering::Relaxed);
|
|
117
|
+
debug_log!("should not print while disabled");
|
|
118
|
+
debug_log_module!("middleware", "disabled branch");
|
|
119
|
+
debug_log_value!("key", 1_u8);
|
|
120
|
+
assert!(!is_enabled());
|
|
121
|
+
|
|
122
|
+
DEBUG_ENABLED.store(true, Ordering::Relaxed);
|
|
123
|
+
debug_log!("now printing {}", 2);
|
|
124
|
+
debug_log_module!("router", "enabled branch");
|
|
125
|
+
debug_log_value!("value", 3_i32);
|
|
126
|
+
assert!(is_enabled());
|
|
127
|
+
}
|
|
128
|
+
}
|