guerrilla

Guerrilla (or Monkey) Patching in Rust for (unsafe) fun and profit

1 unstable release

0.0.0 Nov 8, 2018

#18 in #unsafe

Download history 4/week @ 2018-11-08 148/week @ 2018-11-15 15/week @ 2018-11-22 56/week @ 2018-11-29 19/week @ 2018-12-06

1 downloads per month

MIT/Apache

13KB
303 lines

Guerrilla

Crates.io Travis (.com) AppVeyor License

Guerrilla (or Monkey) Patching in Rust for (unsafe) fun and profit.

Provides aribtrary monkey patching in Rust. Please do not use this crate for anything outside of testing. It will not end well.

Can patch (almost) any function in Rust (free, associated, instance, generic, etc.). Can not patch anything from std.

Usage

extern crate guerrilla;

#[inline(never)]
fn say_hi(name: &str) {
    println!("hello, {}", name);
}

fn main() {
    // Variadic generics would be wondeful so we could have a [guerrilla::patch]
    let _guard = guerrilla::patch1(say_hi, |name| {
        // So sneaky... like a sneaky sneaky snek
        println!("bye, {}", name);
    });

    // [...]
    // Thousands of lines codes further in the project
    // [...]

    say_hi("Steve");

    // Once the guard is dropped the patch reverts the function to its original
    // behavior.
    drop(_guard);

    say_hi("Bob");
}

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.

Credits

Inspired (and derived) from monkey-patching-in-go.

Dependencies

~585KB

  • unix macos libc 0.2.43
  • windows winapi 0.3.6+memoryapi