Enum ConversionError 

pub enum ConversionError {
    InvalidDate(String),
    InvalidNumber(String),
    InvalidFlag(String),
    BookedCostInvariantViolated(BookedCostInvariantError),
    PerUnitFromTotalMissingUnits {
        per_unit: Decimal,
        total: Decimal,
    },
    SpanOverflow(String),
}

Error returned when converting a wrapper back to a directive fails.

Variants

InvalidDate(String)

Invalid date format.

InvalidNumber(String)

Invalid number format. Use for parse failures only — for a pair of valid numbers that fail a cross-field invariant, see Self::BookedCostInvariantViolated.

InvalidFlag(String)

Invalid flag format.

BookedCostInvariantViolated(BookedCostInvariantError)

A PerUnitFromTotal cost spec carries a (per_unit, total) pair that doesn’t agree with the posting’s units. Returned by the plugin egress and FFI input bridges when a plugin author or JSON client supplies the post-booking shape with inconsistent values — e.g. mutates per_unit without updating total. The inner rustledger_core::BookedCostInvariantError carries the supplied values, the derived total, and the tolerance for plugin-author diagnostics.

PerUnitFromTotalMissingUnits

A plugin emitted a PerUnitFromTotal cost spec without supplying the posting’s units. The post-booking shape is undefined without units (per_unit = total / |units| requires them) — a plugin emitting it untouched should keep the units the host gave it; a plugin emitting a fresh post-booking spec must include matching units. Distinct from Self::BookedCostInvariantViolated because “missing” is a different category from “inconsistent” — plugin authors fix each with different actions (forgot vs miscalculated).

Fields

per_unit: Decimal

The per-unit value the plugin supplied.

total: Decimal

The total value the plugin supplied.

SpanOverflow(String)

A SourceSpan byte offset from the plugin wire format does not fit in usize on the host. This is effectively impossible in practice — SourceSpan is u64 and the host is 64-bit on every platform rustledger supports today, so the only way to surface this variant is to run the host on a 32-bit target with source files larger than 4 GiB. If you see it: please file a bug report; the offset is almost certainly corrupt.

Trait Implementations

impl Clone for ConversionError

fn clone(&self) -> ConversionError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConversionError

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

Formats the value using the given formatter.

impl Display for ConversionError

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

Formats the value using the given formatter.

impl Error for ConversionError

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.

impl From<BookedCostInvariantError> for ConversionError

fn from(source: BookedCostInvariantError) -> Self

Converts to this type from the input type.