6 releases

Uses old Rust 2015

0.1.6 Sep 25, 2021
0.1.5 Jul 31, 2020
0.1.4 Aug 1, 2018

#474 in Rust patterns

Download history 33336/week @ 2024-11-15 31863/week @ 2024-11-22 35403/week @ 2024-11-29 36500/week @ 2024-12-06 31870/week @ 2024-12-13 22945/week @ 2024-12-20 22985/week @ 2024-12-27 31845/week @ 2025-01-03 32477/week @ 2025-01-10 32035/week @ 2025-01-17 27569/week @ 2025-01-24 34584/week @ 2025-01-31 35247/week @ 2025-02-07 36462/week @ 2025-02-14 40022/week @ 2025-02-21 33421/week @ 2025-02-28

151,342 downloads per month
Used in 187 crates (16 directly)

MIT/Apache

7KB
142 lines

drop_bomb

Build Status Crates.io API reference

A runtime guard for (protecting your precious bodily fluids) implementing linear types. See the docs for more.


lib.rs:

drop_bomb

drop_bomb provides two types, DropBomb and DebugDropBomb, which panic in drop with a specified message unless defused. This is useful as a building-block for runtime-checked linear types.

For example, one can build a variant of BufWriter which enforces handling of errors during flush.

extern crate drop_bomb;

use std::io::{Write, BufWriter, Result};
use drop_bomb::DropBomb;

struct CheckedBufWriter<W: Write> {
    inner: BufWriter<W>,
    bomb: DropBomb,
}

impl<W: Write> CheckedBufWriter<W> {
    fn new(inner: BufWriter<W>) -> CheckedBufWriter<W> {
        let bomb = DropBomb::new(
            "CheckedBufWriter must be explicitly closed \
             to handle potential errors on flush"
        );
        CheckedBufWriter { inner, bomb }
    }

    fn close(mut self) -> Result<()> {
        self.bomb.defuse();
        self.inner.flush()?;
        Ok(())
    }
}

Notes:

  • Bombs do nothing if a thread is already panicking.
  • When #[cfg(debug_assertions)] is disabled, DebugDropBomb is always defused and has a zero size.

No runtime deps