error_status

A lightweight error handling library for Rust that combines HTTP-style error statuses with contextual information.

Features

HTTP-inspired Error Status: Wrap errors with semantic status codes similar to HTTP status codes
Context-Rich Errors: Add meaningful context strings to your errors for better debugging
Result Extension Trait: Convenient methods to construct error statuses from Result type

Installation

Add this to your Cargo.toml:

[dependencies]
error_status = "0.1.0";

Quick Start

use std::io::{self, ErrorKind};

use anyhow::Result;
use error_status::ResultExt;

fn find_file() -> Result<(), io::Error> {
    Err(ErrorKind::NotFound.into())
}

fn main() -> Result<()> {
    find_file()
        .not_found("Failed to read file")
        .internal_error("Config file is not available")?;
    Ok(())
}

Usage

The library provides a ResultExt trait that extends Result with methods corresponding to common error scenarios:

not_found(): For missing resource errors
internal_error(): For internal system errors
bad_request(): For validation failures
And more...

Each method accepts a context string that provides additional information about the error. There's also a corresponding _lazy() version for context builder.

Error Handling Best Practices

Use semantic status codes to categorize errors appropriately
Provide meaningful context messages for better error tracking
Implement comprehensive logging throughout your codebase
Use the error handling chain to provide multiple layers of context

License

MIT OR Apache-2.0

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

error_status 0.1.0