#macro #codebase

veilid-bugsalot

Fork of bugsalot to meet the needs of the Veilid project. Debugging macros and APIs for shipping stable codebases.

2 unstable releases

0.2.0 Mar 3, 2024
0.1.0 Sep 3, 2023

#379 in Debugging

Download history 100/week @ 2024-07-10 236/week @ 2024-07-17 175/week @ 2024-07-24 319/week @ 2024-07-31 175/week @ 2024-08-07 110/week @ 2024-08-14 94/week @ 2024-08-21 103/week @ 2024-08-28 151/week @ 2024-09-04 161/week @ 2024-09-11 131/week @ 2024-09-18 168/week @ 2024-09-25 314/week @ 2024-10-02 184/week @ 2024-10-09 271/week @ 2024-10-16 162/week @ 2024-10-23

967 downloads per month
Used in 8 crates (via veilid-core)

MIT/Apache

43KB
557 lines

bugsalot

GitHub unsafe: yes rust: 1.36.0+ License dependency status

This crate provides macros and methods for bug wrangling. Specifically, I want all the advantages of crashing (bug reports, ease of debugging, etc.) with none of the drawbacks (lost progress, pissed off gamers, etc). Rust's error handling mechanisms (Try, ?, Results, etc.) are great, but leave something to be desired when it comes to actual bugs. Similarly, Rust's panic!, .unwrap(), .expect(), etc. are decent when it comes to giving context for bugs, but less great for writing stable software. This crate will attempt to bridge the gap.

Branch Badges Notes
publish Crates.io Docs Stable/published version
master Build Status Open issues "Completed" stuff that hasn't been published.
wip/* "Work In Progress" - incomplete, use at your own risk.
dead/* Abandoned threads of work

Platforms

Platform Breakpoints Debugger CI Stable Beta Nightly
Windows Supported Supported Tests Status
Android Supported Supported Build Status
Linux Supported Supported Tests Status Status Status
(Release) Status
FreeBSD Untested Untested No
NetBSD Untested Untested No
OS X Untested Untested Tests Status
iOS Untested Untested Build Status
WASM Supported N/A Build Status

Quick Start

Add one of the following bugsalot dependencies to your Cargo.toml:

[dependencies]
bugsalot = "0.2"                                            # Or...
bugsalot = { version = "0.2", features = ["wasm-bindgen"] } # If using: wasm-pack
bugsalot = { version = "0.2", features = ["stdweb"]       } # If using: cargo web build

Write your code (see examples and documentation for more code):

use bugsalot::*;

fn main() {
    let _ = debugger::wait_until_attached(None); // Wait for a debugger to be attached

    loop {
        let a : Option<i32> = Some(42);
        let b : Result<i32, &'static str> = Err("Unavailable");
        let a = expect!(a, "Unable to do something or other", return);
        let b = expect!(b, "Unable to do something or other", break);
        // Debugger will pause on the above line, continuing will break out of the loop
    }

    expect!(true, "Booleans work too");
}

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0–660KB
~12K SLoC