use serde::{Deserialize, Serialize};
#[derive(Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum RateLimitBackend {
#[default]
Memory,
Redis {
redis_url: String,
},
}
impl std::fmt::Debug for RateLimitBackend {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
match self {
Self::Memory => f.debug_struct("Memory").finish(),
Self::Redis { redis_url } => f
.debug_struct("Redis")
.field("redis_url", &redact_redis_url(redis_url))
.finish(),
}
}
}
fn redact_redis_url(url: &str) -> String {
if let Some(scheme_end) = url.find("://") {
let rest = &url[scheme_end + 3..];
if let Some(at) = rest.rfind('@') {
let host_part = &rest[at + 1..];
return match host_part.split_once('?') {
Some((host, _)) => format!("{}://***@{}?***", &url[..scheme_end], host),
None => format!("{}://***@{}", &url[..scheme_end], host_part),
};
}
}
match url.split_once('?') {
Some((base, _)) => format!("{}?***", base),
None => url.to_string(),
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn default_is_memory() {
assert_eq!(RateLimitBackend::default(), RateLimitBackend::Memory);
}
#[test]
fn redis_variant_with_url() {
let backend = RateLimitBackend::Redis {
redis_url: "redis://127.0.0.1:6379/0".to_string(),
};
match backend {
RateLimitBackend::Redis { redis_url } => {
assert_eq!(redis_url, "redis://127.0.0.1:6379/0");
},
_ => panic!("应为 Redis 变体"),
}
}
#[test]
fn memory_variant() {
let backend = RateLimitBackend::Memory;
assert!(matches!(backend, RateLimitBackend::Memory));
}
#[test]
fn serialization_round_trip() {
let backends = vec![
RateLimitBackend::Memory,
RateLimitBackend::Redis {
redis_url: "redis://localhost:6379".to_string(),
},
];
for original in backends {
let json = serde_json::to_string(&original).unwrap();
let deserialized: RateLimitBackend = serde_json::from_str(&json).unwrap();
assert_eq!(original, deserialized, "序列化 round-trip 应保持相等");
}
}
#[test]
fn enum_equality() {
assert_eq!(RateLimitBackend::Memory, RateLimitBackend::Memory);
assert_ne!(
RateLimitBackend::Memory,
RateLimitBackend::Redis {
redis_url: String::new()
}
);
}
#[test]
fn debug_redacts_credentials() {
let backend = RateLimitBackend::Redis {
redis_url: "redis://user:p@ssw0rd@host:6379/0".to_string(),
};
let dbg = format!("{:?}", backend);
assert!(
!dbg.contains("p@ssw0rd") && !dbg.contains("redis://user"),
"Debug 不得包含 userinfo 凭据,实际: {}",
dbg
);
assert!(
dbg.contains("***@host:6379/0"),
"应保留 host 便于排查,实际: {}",
dbg
);
let query_backend = RateLimitBackend::Redis {
redis_url: "redis://host:6379/0?password=secret".to_string(),
};
let dbg = format!("{:?}", query_backend);
assert!(
!dbg.contains("secret"),
"Debug 不得包含 query 凭据,实际: {}",
dbg
);
let plain = RateLimitBackend::Redis {
redis_url: "redis://127.0.0.1:6379/0".to_string(),
};
assert_eq!(
format!("{:?}", plain),
r#"Redis { redis_url: "redis://127.0.0.1:6379/0" }"#
);
}
}