Enum Error 

pub enum Error {
    InvalidData(String),
    InvalidOption(String),
    Unimplemented(&'static str),
    Backend(String),
}

Errors that can be returned by the encoder or renderer.

Error implements std::error::Error and std::fmt::Display, so it integrates with ?, anyhow, and thiserror like any other library error.

Example

use bwipp::{render_svg, Options, Symbology, Error};

let err = render_svg(Symbology::Ean13, "abc", &Options::default()).unwrap_err();
// The Display impl prepends a kind-specific prefix:
assert!(err.to_string().starts_with("invalid data:"));
// Pattern-match for programmatic recovery:
assert!(matches!(err, Error::InvalidData(_)));

Variants

InvalidData(String)

The input data is not valid for the requested symbology (e.g. wrong length, illegal character, bad check digit).

InvalidOption(String)

An option value is out of range or refers to an unknown setting.

Unimplemented(&'static str)

The symbology requested is recognized but the requested option / variant lies outside this Rust port’s scope (e.g. BWIPP feature that the port has consciously deferred).

Status note. As of the current release, no code path in the crate actually returns this variant — the catalog is 169 verified / 0 partial (see PORT_STATUS.md), and the BWIPP opt-in knobs that are deferred (e.g. POSICODE parsefnc, Code 16K sam, Code One eci/version, Ultracode rev=1/raw=true/link1) are surfaced via Error::InvalidData / Error::InvalidOption with a tagged message rather than via this variant. The variant is kept in the public API as a reserved slot for future semantic migration (callers who want to distinguish “input invalid” from “input valid but encoder lacks support”) and removing it would be a breaking change. Match on it defensively if you care, but don’t expect to see it fire today.

Backend(String)

A backing crate (e.g. qrcode, datamatrix) reported an error.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 PartialEq for Error

fn eq(&self, other: &Error) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error