Enum FormsError 

pub enum FormsError {
    UnsupportedYear(i32),
    MapFieldMissing(String),
    Overflow {
        part: &'static str,
        rows: usize,
        capacity: usize,
    },
    Geometry(String),
    UnmappedField(String),
    CellOverflow {
        fqn: String,
        max_len: usize,
        len: usize,
    },
    Structure(String),
    Pdf(Error),
    Map(Error),
    Io(Error),
}

Anything that can go wrong filling an official IRS PDF.

The geometric read-back failures (Geometry, UnmappedField) are the tax-safety net: a fill that lands a value in the wrong cell — or writes any field the map did not authorize — FAILS CLOSED (no PDF bytes are returned), so a mis-mapped form is never handed to a filer.

Variants

UnsupportedYear(i32)

The requested tax year has no bundled form set / map (this build ships TY2017, 2024 + 2025).

MapFieldMissing(String)

A field named by the map does not exist in the bundled PDF’s AcroForm.

Overflow

More data rows than the form’s page grid can hold on the paths that do not paginate.

Fields

part: &'static str

The part being filled (“Part I” / “Part II”).

rows: usize

The number of rows requested.

capacity: usize

The per-page row capacity from the map.

Geometry(String)

The geometric read-back found a written value in the WRONG column/row band — the map is mis-aligned. Fails closed.

UnmappedField(String)

A field carries a value but the map never authorized writing it (a stray write). Fails closed.

CellOverflow

A written value is longer than the cell’s /MaxLen — the form declares a fixed-width (usually comb) cell and the value does not fit. A PDF viewer would silently truncate it, or splay it across the wrong comb teeth, so the fill fails closed instead: a truncated SSN on a filed return is a wrong return.

Fields

fqn: String

The over-filled field.

max_len: usize

The cell’s declared capacity.

len: usize

The length actually written.

Structure(String)

The bundled PDF’s structure was not what the engine expects (missing AcroForm, bad Rect, …).

Pdf(Error)

Underlying lopdf parse/serialize error.

Map(Error)

A committed TOML map failed to parse.

Io(Error)

I/O error serializing the PDF.

Trait Implementations

impl Debug for FormsError

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

Formats the value using the given formatter.

impl Display for FormsError

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

Formats the value using the given formatter.

impl Error for FormsError

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FormsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FormsError

fn from(source: Error) -> Self

Converts to this type from the input type.