Enum PlisskenError 

pub enum PlisskenError {
    ConfigNotFound {
        path: PathBuf,
    },
    ConfigParse {
        message: String,
        source: Option<Error>,
    },
    ConfigValidation {
        message: String,
    },
    Parse {
        language: String,
        path: PathBuf,
        line: Option<usize>,
        message: String,
    },
    FileRead {
        path: PathBuf,
        message: String,
        source: Error,
    },
    Template {
        message: String,
        source: Error,
    },
    OutputWrite {
        path: PathBuf,
        message: String,
        source: Error,
    },
    CrossRef {
        message: String,
    },
    Io {
        context: String,
        source: Error,
    },
    Discovery {
        path: PathBuf,
        message: String,
    },
    ManifestParse {
        path: PathBuf,
        message: String,
    },
}

The primary error type for plissken-core operations.

This enum covers all error categories that can occur during parsing, rendering, and configuration handling.

Variants

ConfigNotFound

Configuration file not found at the expected path.

Fields

path: PathBuf

Path where config was expected

ConfigParse

Failed to parse configuration file.

Fields

message: String

Description of the parse error

source: Option<Error>

The underlying TOML parse error, if available

ConfigValidation

Configuration validation failed.

Fields

message: String

Description of the validation error

Parse

Failed to parse a source file.

Fields

language: String

The language being parsed (e.g., “Rust”, “Python”)

path: PathBuf

Path to the file that failed to parse

line: Option<usize>

Line number where error occurred, if known

message: String

Description of the parse error

FileRead

Failed to read a source file.

Fields

path: PathBuf

Path to the file that couldn’t be read

message: String

Description of the error

source: Error

The underlying IO error

Template

Template rendering failed.

Fields

message: String

Description of the template error

source: Error

The underlying Tera error

OutputWrite

Failed to write output file.

Fields

path: PathBuf

Path to the output file

message: String

Description of the error

source: Error

The underlying IO error

CrossRef

Cross-reference resolution failed.

Fields

message: String

Description of the cross-reference error

Io

Generic IO error with context.

Fields

context: String

Context describing what operation failed

source: Error

The underlying IO error

Discovery

Module discovery failed.

Fields

path: PathBuf

Directory being scanned

message: String

Description of the error

ManifestParse

Failed to parse manifest file (Cargo.toml or pyproject.toml).

Fields

path: PathBuf

Path to the manifest file

message: String

Description of the error

Implementations

impl PlisskenError

pub fn rust_parse(path: impl Into<PathBuf>, message: impl Into<String>) -> Self

Create a parse error for a Rust file.

pub fn rust_parse_at( path: impl Into<PathBuf>, line: usize, message: impl Into<String>, ) -> Self

Create a parse error for a Rust file with line number.

pub fn python_parse( path: impl Into<PathBuf>, message: impl Into<String>, ) -> Self

Create a parse error for a Python file.

pub fn python_parse_at( path: impl Into<PathBuf>, line: usize, message: impl Into<String>, ) -> Self

Create a parse error for a Python file with line number.

pub fn file_read(path: impl Into<PathBuf>, source: Error) -> Self

Create a file read error.

pub fn io(context: impl Into<String>, source: Error) -> Self

Create an IO error with context.

pub fn config_not_found(path: impl Into<PathBuf>) -> Self

Create a config not found error.

pub fn discovery(path: impl Into<PathBuf>, message: impl Into<String>) -> Self

Create a discovery error.

Trait Implementations

impl Debug for PlisskenError

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

Formats the value using the given formatter.

impl Display for PlisskenError

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

Formats the value using the given formatter.

impl Error for PlisskenError

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<ConfigError> for PlisskenError

fn from(err: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for PlisskenError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PlisskenError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PlisskenError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ManifestError> for PlisskenError

fn from(err: ManifestError) -> Self

Converts to this type from the input type.