EasyMutex

EasyMutex is a lightweight, thread-safe, and clonable wrapper around parking_lot::Mutex using Arc.

It simplifies shared mutable state management by providing an easy-to-use API for safely reading and writing data across threads, with handy convenience methods and error handling.

Features

• Thread-safe mutable access using Mutex wrapped in an Arc.
• Cloneable wrapper for shared ownership.
• All APIs drop the lock before returning, so it should be deadlock free.
• Simple API: read() and write().
• Implements From<T> for ergonomic construction.
• Poisoning free (derived from parking_lot::Mutex)

Installation

Add this to your Cargo.toml:

[dependencies]
easy_mutex = "0.2.0"

Usage

use easy_mutex::EasyMutex;

let shared = EasyMutex::new(5);
let clone = shared.clone();

assert_eq!(shared.read(), 5);
clone.write(10);
assert_eq!(shared.read(), 10);

let data: EasyMutex<String> = "hello".to_string().into();
assert_eq!(data.read(), "hello");

API Overview

• EasyMutex::new(value) — Create a new EasyMutex.
• read() — Acquire lock and clone the value.
• write(value) — Acquire lock and replace the value.
• From<T> implemented for convenient construction via .into().

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Licensing

All contributions to this project are licensed under the terms of the Apache License, Version 2.0.

By contributing, you agree that your code will be released under the same license.