Struct DynamicNoClone 

pub struct DynamicNoClone<T: ?Sized>(/* private fields */);

Non-cloneable heap-allocated secret wrapper.

This is a thin newtype over Dynamic<T> that deliberately omits Clone. Use this for dynamic secrets where duplication must be prevented.

Converts from Dynamic<T> via .no_clone().

Examples

use secure_gate::{Dynamic, DynamicNoClone};
let secret = Dynamic::new("hunter2".to_string());
let no_clone: DynamicNoClone<String> = secret.no_clone();
// no_clone cannot be cloned
assert_eq!(no_clone.expose_secret(), "hunter2");

Implementations

impl<T: ?Sized> DynamicNoClone<T>

pub fn new(value: Box<T>) -> Self

Wrap a boxed value in a non-cloneable dynamic secret.

Example

use secure_gate::DynamicNoClone;
let boxed = Box::new("secret".to_string());
let no_clone = DynamicNoClone::new(boxed);

pub const fn expose_secret(&self) -> &T

Expose the inner value for read-only access.

This is the only way to read the secret — loud and auditable.

Example

use secure_gate::DynamicNoClone;
let secret = DynamicNoClone::new(Box::new("hunter2".to_string()));
assert_eq!(secret.expose_secret(), "hunter2");

pub fn expose_secret_mut(&mut self) -> &mut T

Expose the inner value for mutable access.

This is the only way to mutate the secret — loud and auditable.

Example

use secure_gate::DynamicNoClone;
let mut secret = DynamicNoClone::new(Box::new("hello".to_string()));
secret.expose_secret_mut().push_str(" world");
assert_eq!(secret.expose_secret(), "hello world");

impl<T: ?Sized + Zeroize> DynamicNoClone<T>

pub fn zeroize_now(&mut self)

Explicitly zeroize the secret immediately.

This is useful when you want to wipe memory before the value goes out of scope, or when you want to make the zeroization intent explicit in the code.

Example

use secure_gate::DynamicNoClone;
let mut password = DynamicNoClone::new(Box::new("secret".to_string()));
// ... use password ...
password.zeroize_now();  // Explicit wipe - makes intent clear

impl DynamicNoClone<String>

pub const fn len(&self) -> usize

Returns the length of the secret string in bytes (UTF-8).

pub const fn is_empty(&self) -> bool

Returns true if the secret string is empty.

impl<T> DynamicNoClone<Vec<T>>

pub const fn len(&self) -> usize

Returns the length of the secret vector in elements.

pub const fn is_empty(&self) -> bool

Returns true if the secret vector is empty.

Trait Implementations

impl<T: ?Sized> Debug for DynamicNoClone<T>

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

Formats the value using the given formatter.

impl<T: ?Sized + Zeroize> Zeroize for DynamicNoClone<T>

Available on crate feature zeroize only.

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl<T: ?Sized + Zeroize> ZeroizeOnDrop for DynamicNoClone<T>

Available on crate feature zeroize only.