Enum ArchToolkitError 

pub enum ArchToolkitError {
    Network(Error),
    SearchFailed {
        query: String,
        source: Error,
    },
    InfoFailed {
        packages: String,
        source: Error,
    },
    CommentsFailed {
        package: String,
        source: Error,
    },
    PkgbuildFailed {
        package: String,
        source: Error,
    },
    Json(Error),
    Parse(String),
    RateLimited {
        retry_after: Option<u64>,
    },
    PackageNotFound {
        package: String,
    },
    InvalidInput(String),
    EmptyInput {
        field: String,
        message: String,
    },
    InvalidPackageName {
        name: String,
        reason: String,
    },
    InvalidSearchQuery {
        reason: String,
    },
    InputTooLong {
        field: String,
        max_length: usize,
        actual_length: usize,
    },
}

Unified error type for all arch-toolkit operations.

This error type covers all possible failure modes across different modules, providing clear, actionable error messages.

Variants

Network(Error)

Network or HTTP request error.

Note: For AUR operations, prefer using operation-specific error variants (SearchFailed, InfoFailed, CommentsFailed, PkgbuildFailed) to preserve context. This variant is retained for client initialization and non-AUR operations.

SearchFailed

AUR search operation failed.

Fields

query: String

The search query that failed.

source: Error

The underlying network error.

InfoFailed

AUR info fetch operation failed.

Fields

packages: String

Comma-separated list of package names that failed.

source: Error

The underlying network error.

CommentsFailed

AUR comments fetch operation failed.

Fields

package: String

The package name that failed.

source: Error

The underlying network error.

PkgbuildFailed

PKGBUILD fetch operation failed.

Fields

package: String

The package name that failed.

source: Error

The underlying network error.

Json(Error)

JSON parsing error.

Parse(String)

Custom parsing error with message.

RateLimited

Rate limiting error with optional retry-after information.

Fields

retry_after: Option<u64>

Optional retry-after value in seconds from server.

PackageNotFound

Package not found (enhanced with package name).

Fields

package: String

The package name that was not found.

InvalidInput(String)

Invalid input parameter.

EmptyInput

Empty input provided where a value is required.

Fields

field: String

The field name that is empty.

message: String

Detailed message about why the field cannot be empty.

InvalidPackageName

Package name contains invalid characters or format.

Fields

name: String

The invalid package name.

reason: String

Reason why the package name is invalid.

InvalidSearchQuery

Search query validation failed.

Fields

reason: String

Reason why the search query is invalid.

InputTooLong

Input exceeds maximum length.

Fields

field: String

The field name that is too long.

max_length: usize

Maximum allowed length.

actual_length: usize

Actual length of the input.

Implementations

impl ArchToolkitError

pub fn search_failed(query: impl Into<String>, source: Error) -> Self

What: Create a SearchFailed error with query context.

Inputs:

• query: The search query that failed
• source: The underlying network error

Output:

• ArchToolkitError::SearchFailed variant

Details:

• Convenience constructor for search operation errors
• Preserves both the query and the underlying error

pub fn info_failed(packages: &[&str], source: Error) -> Self

What: Create an InfoFailed error with package names context.

Inputs:

• packages: Slice of package names that failed
• source: The underlying network error

Output:

• ArchToolkitError::InfoFailed variant

Details:

• Convenience constructor for info operation errors
• Formats package names as comma-separated string
• Preserves both the package names and the underlying error

pub fn comments_failed(package: impl Into<String>, source: Error) -> Self

What: Create a CommentsFailed error with package name context.

Inputs:

• package: The package name that failed
• source: The underlying network error

Output:

• ArchToolkitError::CommentsFailed variant

Details:

• Convenience constructor for comments operation errors
• Preserves both the package name and the underlying error

pub fn pkgbuild_failed(package: impl Into<String>, source: Error) -> Self

What: Create a PkgbuildFailed error with package name context.

Inputs:

• package: The package name that failed
• source: The underlying network error

Output:

• ArchToolkitError::PkgbuildFailed variant

Details:

• Convenience constructor for pkgbuild operation errors
• Preserves both the package name and the underlying error

Trait Implementations

impl Debug for ArchToolkitError

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

Formats the value using the given formatter.

impl Display for ArchToolkitError

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

Formats the value using the given formatter.

impl Error for ArchToolkitError

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 ArchToolkitError

fn from(source: Error) -> Self

Converts to this type from the input type.