cdumay_context

Crates.iocdumay_context
lib.rscdumay_context
version2.0.6
created_at2025-02-05 23:06:11.593939+00
updated_at2025-06-19 10:13:59.681815+00
descriptionA Rust Library for Context Manipulation and Export
homepagehttps://github.com/cdumay/cdumay_context
repositoryhttps://github.com/cdumay/cdumay_context
max_upload_size
id1544843
size41,387
Cédric Dumay (cdumay)

documentation

https://docs.rs/cdumay_context

README

cdumay_context

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

A flexible context management library that provides a trait-based approach for handling key-value data with support for multiple serialization formats.

Features

  • Generic context management through the Contextualize trait and a Context struct
  • Support for multiple serialization formats (with feature flags):
    • JSON (feature: "json")
    • TOML (feature: "toml")
    • YAML (feature: "yaml")
  • Type-safe error handling with the cdumay_core::Error struct

Example Usage

use std::collections::BTreeMap;
use serde::{Serialize, Deserialize};
use cdumay_context::{Contextualize, Context};

// Basic usage
let mut ctx = Context::new();
ctx.insert("name".to_string(), serde_value::Value::String("Alice".to_string()));

Error Handling

The library provides a comprehensive error handling system through the Error enum:

use cdumay_context::{Context, ContextDump, Contextualize, UnExpectedError};
use rand::Rng;
use serde::{Serialize, Deserialize};
use std::collections::BTreeMap;

fn example_error_handling() -> cdumay_core::Result<()> {
    let mut rng = rand::rng();
    let dice_roll: u8 = rng.random_range(1..=6);
    let mut ctx = Context::new();
    ctx.insert("env".to_string(), serde_value::Value::String("prod".to_string()));

    // Generic error
    if dice_roll == 7 {
        return Err(UnExpectedError::new().with_message("Something went wrong".to_string()).with_details(ctx.dump()).into());
    }

    Ok(())
}
Commit count: 23

cargo fmt