9 releases
Uses new Rust 2024
| 0.1.11 | May 26, 2025 |
|---|---|
| 0.1.10 | May 23, 2025 |
| 0.1.5 | Apr 21, 2025 |
#820 in Rust patterns
637 downloads per month
10KB
cdumay_error_json
A utility crate that converts serde_json::Error into structured, typed errors using the cdumay_core framework. This ensures consistent error handling, easier debugging, and informative error reporting across your Rust applications.
Features
- Categorizes
serde_json::Errorinto specific error types (Syntax,IO,Data,EOF) - Each error type is associated with a custom code, HTTP status, and descriptive message
- Structured output for APIs, logging systems, and observability platforms
- Includes context metadata via
BTreeMap - Provides a convenient
convert_result!macro for error conversion
Usage
Using the JsonErrorConverter directly:
use cdumay_core::{Error, ErrorConverter};
use serde_json::Value;
use std::collections::BTreeMap;
use cdumay_error_json::JsonErrorConverter;
fn parse_json(input: &str) -> cdumay_core::Result<Value> {
serde_json::from_str::<Value>(input).map_err(|e| {
let mut ctx = BTreeMap::new();
ctx.insert("input".to_string(), serde_value::Value::String(input.to_string()));
JsonErrorConverter::convert(&e, "Failed to parse JSON".to_string(), ctx)
})
}
Using the convert_result! macro:
use cdumay_error_json::convert_result;
use serde_json::Value;
use std::collections::BTreeMap;
use cdumay_core::{Error, ErrorConverter};
fn parse_json(input: &str) -> cdumay_core::Result<Value> {
// Basic usage with just the result
convert_result!(serde_json::from_str::<Value>(input));
// With custom context
let mut ctx = BTreeMap::new();
ctx.insert("input".to_string(), serde_value::Value::String(input.to_string()));
convert_result!(serde_json::from_str::<Value>(input), ctx.clone());
// With custom context and message
convert_result!(serde_json::from_str::<Value>(input), ctx, "Failed to parse JSON")
}
Dependencies
~0.8–1.8MB
~37K SLoC