use core::fmt::{self, Write};
pub fn write_escaped_label_value(out: &mut dyn Write, s: &str) -> fmt::Result {
for c in s.chars() {
match c {
'\\' => out.write_str("\\\\")?,
'"' => out.write_str("\\\"")?,
'\n' => out.write_str("\\n")?,
c => out.write_char(c)?,
}
}
Ok(())
}
pub fn write_escaped_help(out: &mut dyn Write, s: &str) -> fmt::Result {
for c in s.chars() {
match c {
'\\' => out.write_str("\\\\")?,
'\n' => out.write_str("\\n")?,
c => out.write_char(c)?,
}
}
Ok(())
}
pub const fn valid_metric_name(s: &str) -> bool {
let Some((first, mut rest)) = s.as_bytes().split_first() else {
return true;
};
if !is_name_start(*first) {
return false;
}
while let Some((next, tail)) = rest.split_first() {
if !is_name_continue(*next) {
return false;
}
rest = tail;
}
true
}
pub const fn valid_label_name(s: &str) -> bool {
let bytes = s.as_bytes();
let Some((first, mut rest)) = bytes.split_first() else {
return false;
};
if !is_label_start(*first) {
return false;
}
while let Some((next, tail)) = rest.split_first() {
if !is_label_continue(*next) {
return false;
}
rest = tail;
}
!matches!(bytes, [b'_', b'_', ..])
}
const fn is_name_start(c: u8) -> bool {
c.is_ascii_alphabetic() || c == b'_' || c == b':'
}
const fn is_name_continue(c: u8) -> bool {
c.is_ascii_alphanumeric() || c == b'_' || c == b':'
}
const fn is_label_start(c: u8) -> bool {
c.is_ascii_alphabetic() || c == b'_'
}
const fn is_label_continue(c: u8) -> bool {
c.is_ascii_alphanumeric() || c == b'_'
}
#[cfg(test)]
mod tests {
use super::*;
fn escaped_value(s: &str) -> heapless::String<64> {
let mut out = heapless::String::<64>::new();
write_escaped_label_value(&mut out, s).unwrap();
out
}
fn escaped_help(s: &str) -> heapless::String<64> {
let mut out = heapless::String::<64>::new();
write_escaped_help(&mut out, s).unwrap();
out
}
#[test]
fn escapes_label_values() {
assert_eq!(escaped_value("plain"), "plain");
assert_eq!(escaped_value("back\\slash"), "back\\\\slash");
assert_eq!(escaped_value("has\"quote"), "has\\\"quote");
assert_eq!(escaped_value("multi\nline"), "multi\\nline");
assert_eq!(escaped_value("\\\"\n"), "\\\\\\\"\\n");
}
#[test]
fn escapes_help_text_but_not_quotes() {
assert_eq!(escaped_help("plain"), "plain");
assert_eq!(escaped_help("back\\slash"), "back\\\\slash");
assert_eq!(escaped_help("has\"quote"), "has\"quote");
assert_eq!(escaped_help("multi\nline"), "multi\\nline");
}
#[test]
fn metric_names() {
assert!(valid_metric_name(""));
assert!(valid_metric_name("wifi"));
assert!(valid_metric_name("wifi_packets_sent"));
assert!(valid_metric_name("_leading_underscore"));
assert!(valid_metric_name("with:colon"));
assert!(valid_metric_name("Name123"));
assert!(!valid_metric_name("1starts_with_digit"));
assert!(!valid_metric_name("has-dash"));
assert!(!valid_metric_name("has space"));
}
#[test]
fn label_names() {
assert!(valid_label_name("reason"));
assert!(valid_label_name("_ok"));
assert!(!valid_label_name(""));
assert!(!valid_label_name("1starts_with_digit"));
assert!(!valid_label_name("has-dash"));
assert!(!valid_label_name("has:colon"));
assert!(!valid_label_name("__reserved"));
}
}