Struct Secret 

pub struct Secret(/* private fields */);

Wrapper for sensitive strings with redacted Debug/Display.

The inner value is wrapped in Zeroizing which overwrites the memory on drop. Clone is intentionally not derived — secrets must be explicitly duplicated via Secret::new(existing.expose().to_owned()).

Clone is not implemented

use zeph_common::secret::Secret;
let s = Secret::new("x");
let _ = s.clone(); // must not compile — Secret intentionally does not implement Clone

Implementations

impl Secret

pub fn new(s: impl Into<String>) -> Secret

Create a new secret from a string-like value.

The inner string is wrapped in Zeroizing, which overwrites the memory when the secret is dropped. This constructor is marked #[must_use] to encourage explicit handling of the returned secret value rather than accidental discarding.

Examples

use zeph_common::secret::Secret;

let secret = Secret::new("my_api_key");
assert_eq!(secret.expose(), "my_api_key");
// Memory is zeroized when secret is dropped

pub fn expose(&self) -> &str

Expose the inner secret string as a borrowed reference.

Use this method to access the secret for API calls or comparisons. The reference is bounded by the secret’s lifetime, so the underlying string cannot be dropped while the reference is in use. Note that the string itself is not zeroized on reference — zeroization occurs only when the containing Secret is dropped.

Examples

use zeph_common::secret::Secret;

let secret = Secret::new("password123");
let exposed = secret.expose();
println!("Length: {}", exposed.len());

Trait Implementations

impl Debug for Secret

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Secret

fn deserialize<__D>( __deserializer: __D, ) -> Result<Secret, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Secret

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.