Struct TrackedVariable 

pub struct TrackedVariable<T: Trackable> { /* private fields */ }

A wrapper that provides automatic lifecycle tracking for variables.

This struct wraps any Trackable type and automatically handles:

• Creation tracking when constructed
• Destruction tracking when dropped with duplicate protection
• Transparent access to the wrapped value via Deref/DerefMut
• Smart pointer detection and specialized handling for Rc, Arc, and Box
• Thread-safe drop protection using atomic flags
• Panic-safe error handling in drop logic

Key Features:

• Drop Protection: Prevents duplicate destruction tracking
• Smart Pointer Support: Automatic detection and handling of reference-counted types
• Error Resilience: Robust error handling that won’t crash on tracking failures
• Thread Safety: Uses atomic operations for safe concurrent access
• Zero-Cost Abstraction: Transparent access to wrapped value with minimal overhead

Implementations

impl<T: Trackable> TrackedVariable<T>

pub fn new(value: T, var_name: String) -> Self

Create a new tracked variable wrapper.

pub fn get(&self) -> &T

Get a reference to the inner value.

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

Get a mutable reference to the inner value.

pub fn into_inner(self) -> T

Consume the wrapper and return the inner value.

This method safely extracts the wrapped value while ensuring that destruction tracking occurs exactly once. It uses atomic protection to prevent duplicate tracking even if the Drop trait would normally execute afterwards.

Safety Features:

• Uses ManuallyDrop to prevent automatic Drop execution
• Atomic flag prevents duplicate destruction tracking
• Proper error handling for tracking failures
• Smart pointer detection for specialized handling

Trait Implementations

impl<T: Trackable + Clone> Clone for TrackedVariable<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Trackable + Debug> Debug for TrackedVariable<T>

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

Formats the value using the given formatter.

impl<T: Trackable> Deref for TrackedVariable<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: Trackable> DerefMut for TrackedVariable<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Trackable + Display> Display for TrackedVariable<T>

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

Formats the value using the given formatter.

impl<T: Trackable> Drop for TrackedVariable<T>

fn drop(&mut self)

Executes the destructor for this type.