proc-lock-macro

Crates.ioproc-lock-macro
lib.rsproc-lock-macro
version0.4.0
sourcesrc
created_at2022-03-17 21:42:19.019367
updated_at2022-03-23 11:12:07.623668
descriptionMacro API for the proc-lock crate
homepage
repositoryhttps://github.com/tabnine/proc-lock
max_upload_size
id552076
size3,664
(yonip23)

documentation

https://docs.rs/proc-lock

README

Developed with ❤️ by Tabnine

Proc-lock

A simple cross-process locking API.

Quick Start

Installation

In your Cargo.toml file, add:

[dependencies]
proc-lock = "*"

Using the API directly

use proc_lock::{lock, LockPath};

fn main() {
    let lock_path = LockPath::Tmp("my_lock.lock");
    let guard = lock(&lock_path).unwrap();
    // Until `guard` is dropped, this code section is atomic across multiple processes.
    // ...
    drop(guard);
}

Using macros

use proc_lock::proclock;

fn main() {
 // A lock will be acquired at the beginning of this function, and will be released at the end.
 a_sensitive_function();
}

#[proc_lock(name = "my_lock.lock")]
fn a_sensitive_function() {}

Current status

⚠️This crate is in its early stages, breaking changes are expected in upcoming releases.

Changelog

  • 0.4.0 - Change interdependencies to local for better development process
  • 0.3.3 - Minor docs changes
  • 0.3.2 - Fix macro compilation
  • 0.3.1 - Change docs
  • 0.3.0 - [breaking changes] Rename crate to proc-lock, and the macro to proc_lock
  • 0.2.1 - Add a notice about renaming the crate
  • 0.2.0 - [breaking changes] Stop supporting non-blocking macro api

Contribution

Please refer to our project, as well as open issues.

Also feel free to discuss and open PRs regardless :)

Commit count: 55

cargo fmt