Enum EmbedError 

pub enum EmbedError {
    InvalidSettings {
        field: String,
        reason: String,
    },
    ManifestVersionTooNew {
        found: u32,
        max_supported: u32,
    },
    ManifestCorrupted {
        path: PathBuf,
        expected: String,
        actual: String,
    },
    SettingsChanged {
        previous: String,
        current: String,
    },
    NoChunksGenerated {
        include_patterns: String,
        exclude_patterns: String,
    },
    SecretsDetected {
        count: usize,
        files: String,
    },
    InvalidPattern {
        pattern: String,
        reason: String,
    },
    HashCollision {
        id: String,
        hash1: String,
        hash2: String,
    },
    FileTooLarge {
        path: PathBuf,
        size: u64,
        max: u64,
    },
    LineTooLong {
        path: PathBuf,
        length: usize,
        max: usize,
    },
    TooManyChunks {
        count: usize,
        max: usize,
    },
    TooManyFiles {
        count: usize,
        max: usize,
    },
    RecursionLimitExceeded {
        depth: u32,
        max: u32,
        context: String,
    },
    PathTraversal {
        path: PathBuf,
        repo_root: PathBuf,
    },
    IoError {
        path: PathBuf,
        source: Error,
    },
    ParseError {
        file: String,
        line: u32,
        message: String,
    },
    SerializationError {
        reason: String,
    },
    DeserializationError {
        reason: String,
    },
    UnsupportedAlgorithmVersion {
        found: u32,
        max_supported: u32,
    },
    MultipleErrors {
        errors: String,
    },
    NotADirectory {
        path: PathBuf,
    },
    TooManyErrors {
        count: usize,
        max: usize,
    },
}

Actionable error types with helpful messages

Variants

InvalidSettings

Fields

field: String

reason: String

ManifestVersionTooNew

Fields

found: u32

max_supported: u32

ManifestCorrupted

Fields

path: PathBuf

expected: String

actual: String

SettingsChanged

Fields

previous: String

current: String

NoChunksGenerated

Fields

include_patterns: String

exclude_patterns: String

SecretsDetected

Fields

count: usize

files: String

InvalidPattern

Fields

pattern: String

reason: String

HashCollision

Fields

id: String

hash1: String

hash2: String

FileTooLarge

Fields

path: PathBuf

size: u64

max: u64

LineTooLong

Fields

path: PathBuf

length: usize

max: usize

TooManyChunks

Fields

count: usize

max: usize

TooManyFiles

Fields

count: usize

max: usize

RecursionLimitExceeded

Fields

depth: u32

max: u32

context: String

PathTraversal

Fields

path: PathBuf

repo_root: PathBuf

IoError

Fields

path: PathBuf

source: Error

ParseError

Fields

file: String

line: u32

message: String

SerializationError

Fields

reason: String

DeserializationError

Fields

reason: String

UnsupportedAlgorithmVersion

Fields

found: u32

max_supported: u32

MultipleErrors

Fields

errors: String

NotADirectory

Fields

path: PathBuf

TooManyErrors

Fields

count: usize

max: usize

Implementations

impl EmbedError

pub fn from_file_errors(errors: Vec<(PathBuf, EmbedError)>) -> Self

Format multiple file errors into a single error

pub fn is_critical(&self) -> bool

Check if this error is critical (should stop processing)

pub fn is_skippable(&self) -> bool

Check if this error can be recovered from by skipping the file

pub fn exit_code(&self) -> i32

Get the semantic exit code for this error

Exit codes follow POSIX conventions and are designed for shell scripting:

Code	Category	Description
0	Success	No error
1	User Error	Invalid settings, patterns, or arguments
2	Input Error	No chunks generated, no data to process
3	Security	Secrets detected (use –redact-secrets or –no-scan-secrets)
4	Security	Path traversal attempt blocked
10	Manifest	Version mismatch, corruption, or settings changed
11	Resource	Too many chunks/files, recursion limit
12	System	I/O errors, serialization failures
13	Internal	Hash collision (extremely rare, report as bug)
14	Parse	Source code parse errors (skippable)
15	Multiple	Multiple errors encountered

Shell Script Example

infiniloom embed /path/to/repo
case $? in
    0) echo "Success" ;;
    1) echo "Invalid settings - check arguments" ;;
    2) echo "No code found - check include/exclude patterns" ;;
    3) echo "Secrets detected - use --redact-secrets" ;;
    4) echo "Security violation - path traversal blocked" ;;
    10) echo "Manifest issue - delete .infiniloom-embed.bin and retry" ;;
    11) echo "Resource limit - use more restrictive patterns" ;;
    12) echo "System error - check disk space and permissions" ;;
    13) echo "Internal error - please report this bug" ;;
    14) echo "Parse errors - some files skipped" ;;
    15) echo "Multiple errors - see above for details" ;;
esac

pub fn error_code(&self) -> &'static str

Get a short error code string for programmatic use

Useful for JSON output or logging systems.

Trait Implementations

impl Clone for EmbedError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbedError

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

Formats the value using the given formatter.

impl Display for EmbedError

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

Formats the value using the given formatter.

impl Error for EmbedError

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.