#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) enum TransportRoute {
#[cfg(feature = "advanced-routing")]
Uds,
#[cfg(feature = "advanced-routing")]
Custom,
#[cfg(feature = "advanced-routing")]
Direct,
Proxy,
#[cfg(feature = "advanced-routing")]
SniDirect,
H3,
Standard,
}
#[allow(
clippy::fn_params_excessive_bools,
reason = "route selection is a pure precedence predicate over six availability flags; bundling into a struct adds indirection for tests"
)]
pub(super) fn select_route(
has_uds: bool,
has_custom: bool,
has_direct_no_proxy: bool,
has_proxy: bool,
has_sni: bool,
use_h3: bool,
) -> TransportRoute {
#[cfg(feature = "advanced-routing")]
if has_uds {
return TransportRoute::Uds;
}
#[cfg(feature = "advanced-routing")]
if has_custom {
return TransportRoute::Custom;
}
#[cfg(feature = "advanced-routing")]
if has_direct_no_proxy {
return TransportRoute::Direct;
}
if has_proxy {
return TransportRoute::Proxy;
}
#[cfg(feature = "advanced-routing")]
if has_sni {
return TransportRoute::SniDirect;
}
#[cfg(not(feature = "advanced-routing"))]
{
debug_assert!(
!(has_uds || has_custom || has_direct_no_proxy || has_sni),
"advanced transport hint reached lean select_route"
);
let _ = (has_uds, has_custom, has_direct_no_proxy, has_sni);
}
if use_h3 {
return TransportRoute::H3;
}
TransportRoute::Standard
}
#[cfg(test)]
mod tests {
use super::*;
#[cfg(feature = "advanced-routing")]
#[test]
fn select_route_precedence_matches_pipeline_order() {
assert_eq!(
select_route(true, false, true, true, true, true),
TransportRoute::Uds
);
assert_eq!(
select_route(true, true, true, true, true, true),
TransportRoute::Uds
);
assert_eq!(
select_route(false, true, true, true, true, true),
TransportRoute::Custom
);
assert_eq!(
select_route(false, true, false, false, false, false),
TransportRoute::Custom
);
assert_eq!(
select_route(false, false, true, false, true, true),
TransportRoute::Direct
);
assert_eq!(
select_route(false, false, false, true, true, true),
TransportRoute::Proxy
);
assert_eq!(
select_route(false, false, false, true, false, true),
TransportRoute::Proxy
);
assert_eq!(
select_route(false, false, false, false, true, true),
TransportRoute::SniDirect
);
assert_eq!(
select_route(false, false, false, false, false, true),
TransportRoute::H3
);
assert_eq!(
select_route(false, false, false, false, false, false),
TransportRoute::Standard
);
}
#[cfg(not(feature = "advanced-routing"))]
#[test]
fn select_route_lean_standard_only() {
assert_eq!(
select_route(true, true, true, true, true, true),
TransportRoute::Proxy
);
assert_eq!(
select_route(false, false, false, true, false, true),
TransportRoute::Proxy
);
assert_eq!(
select_route(false, false, false, false, false, true),
TransportRoute::H3
);
assert_eq!(
select_route(false, false, false, false, false, false),
TransportRoute::Standard
);
}
}