cdumay_error_json

Crates.iocdumay_error_json
lib.rscdumay_error_json
version0.1.11
created_at2025-04-20 21:03:20.040718+00
updated_at2025-05-26 13:07:00.223478+00
descriptionA Rust Library for JSON error
homepagehttps://github.com/cdumay/cdumay_error_json
repositoryhttps://github.com/cdumay/cdumay_error_json
max_upload_size
id1642011
size19,830
Cédric Dumay (cdumay)

documentation

https://docs.rs/cdumay_error_json

README

cdumay_error_json

License: BSD-3-Clause cdumay_error_json on crates.io cdumay_error_json on docs.rs Source Code Repository

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::Error into 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")
}
Commit count: 26

cargo fmt