Enum Error 

pub enum Error {
    Config {
        message: String,
        key: Option<String>,
    },
    Database(DatabaseError),
    Sqlx(Error),
    Nntp(String),
    Download(DownloadError),
    PostProcess(PostProcessError),
    InvalidNzb(String),
    Io(Error),
    NotFound(String),
    ShuttingDown,
    Network(Error),
    Serialization(Error),
    ApiServerError(String),
    FolderWatch(String),
    Duplicate(String),
    InsufficientSpace {
        required: u64,
        available: u64,
    },
    DiskSpaceCheckFailed(String),
    ExternalTool(String),
    NotSupported(String),
    Other(String),
}

Main error type for usenet-dl

This is the primary error type used throughout the library. Each variant includes contextual information to help diagnose issues.

Variants

Config

Configuration error with context about which setting is invalid

Fields

message: String

Human-readable error message describing the configuration issue

key: Option<String>

The configuration key that caused the error (e.g., “download_dir”)

Database(DatabaseError)

Database operation failed

Sqlx(Error)

SQLx database error

Nntp(String)

NNTP protocol or connection error

Download(DownloadError)

Download-related error

PostProcess(PostProcessError)

Post-processing error (verify, repair, extract, etc.)

InvalidNzb(String)

Invalid NZB file

Io(Error)

I/O error

NotFound(String)

Download not found

ShuttingDown

Shutdown in progress - not accepting new downloads

Network(Error)

Network error

Serialization(Error)

Serialization error

ApiServerError(String)

API server error

FolderWatch(String)

Folder watching error

Duplicate(String)

Duplicate download detected

InsufficientSpace

Insufficient disk space

Fields

required: u64

Number of bytes required for the operation

available: u64

Number of bytes currently available on disk

DiskSpaceCheckFailed(String)

Failed to check disk space

ExternalTool(String)

External tool execution failed (par2, unrar, etc.)

NotSupported(String)

Operation not supported (missing binary, not implemented, etc.)

Other(String)

Other error

Trait Implementations

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, __formatter: &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 From<DatabaseError> for Error

fn from(source: DatabaseError) -> Self

Converts to this type from the input type.

impl From<DownloadError> for Error

fn from(source: DownloadError) -> Self

Converts to this type from the input type.

impl From<Error> for ApiError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PostProcessError> for Error

fn from(source: PostProcessError) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

Implement IntoResponse for Error to automatically convert errors to HTTP responses

fn into_response(self) -> Response

Create a response.

impl IsRetryable for Error

Implementation of IsRetryable for our Error type

fn is_retryable(&self) -> bool

Returns true if the error is transient and the operation should be retried

impl ToHttpStatus for Error

fn status_code(&self) -> u16

Get the HTTP status code for this error

fn error_code(&self) -> &str

Get the machine-readable error code