Enum PropertyError 

pub enum PropertyError {
    ReadLockError {
        context: String,
    },
    WriteLockError {
        context: String,
    },
    ObserverNotFound {
        id: usize,
    },
    PoisonedLock,
    ObserverError {
        reason: String,
    },
    ThreadPoolExhausted,
    InvalidConfiguration {
        reason: String,
    },
    PersistenceError {
        reason: String,
    },
    NoHistory {
        reason: String,
    },
    ValidationError {
        reason: String,
    },
}

Errors that can occur when working with ObservableProperty

Note on Lock Poisoning

This implementation uses graceful degradation for poisoned locks. When a lock is poisoned (typically due to a panic in an observer or another thread), the library automatically recovers the inner value using PoisonError::into_inner().

This means:

• All operations continue to work even after a lock is poisoned
• No ReadLockError, WriteLockError, or PoisonedLock errors will occur in practice
• The system remains operational and observers continue to function

The error variants are kept for backward compatibility and potential future use cases, but with the current implementation, poisoned locks are transparent to users.

Production Benefit

This approach ensures maximum availability and resilience in production systems where a misbehaving observer shouldn’t bring down the entire property system.

Variants

ReadLockError

Failed to acquire a read lock on the property

Note: With graceful degradation, this error is unlikely to occur in practice as poisoned locks are automatically recovered.

Fields

context: String

Context describing what operation was being attempted

WriteLockError

Failed to acquire a write lock on the property

Note: With graceful degradation, this error is unlikely to occur in practice as poisoned locks are automatically recovered.

Fields

context: String

Context describing what operation was being attempted

ObserverNotFound

Attempted to unsubscribe an observer that doesn’t exist

Fields

id: usize

The ID of the observer that wasn’t found

PoisonedLock

The property’s lock has been poisoned due to a panic in another thread

Note: With graceful degradation, this error will not occur in practice as the implementation automatically recovers from poisoned locks.

ObserverError

An observer function encountered an error during execution

Fields

reason: String

Description of what went wrong

ThreadPoolExhausted

The thread pool for async notifications is exhausted

InvalidConfiguration

Invalid configuration was provided

Fields

reason: String

Description of the invalid configuration

PersistenceError

Failed to persist the property value

Fields

reason: String

Description of the persistence error

NoHistory

Attempted to undo when no history is available

Fields

reason: String

Description of the issue

ValidationError

Validation failed for the provided value

Fields

reason: String

Description of why validation failed

Trait Implementations

impl Clone for PropertyError

fn clone(&self) -> PropertyError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PropertyError

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

Formats the value using the given formatter.

impl Display for PropertyError

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

Formats the value using the given formatter.

impl Error for PropertyError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.