https://github.com/mehcode/guerrilla

☢ Guerrilla (or Monkey) Patching in Rust for (unsafe) fun and profit.
https://github.com/mehcode/guerrilla

monkey-patching rust testing unsafe

Last synced: 4 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/mehcode/guerrilla
• Owner: mehcode
• License: apache-2.0
• Created: 2018-11-09T00:36:29.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-07-31T19:17:32.000Z (almost 2 years ago)
• Last Synced: 2024-06-17T00:43:11.478Z (25 days ago)
• Topics: monkey-patching, rust, testing, unsafe
• Language: Rust
• Homepage:
• Size: 25.4 KB
• Stars: 106
• Watchers: 3
• Forks: 6
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Lists

• awesome-rust-security - guerilla - monkey patching Rust functions (Vulnerability Assessment / Binary Analysis & Reversing)

README

        
# Guerrilla

[![Crates.io](https://img.shields.io/crates/v/guerrilla.svg?style=popout-square)](https://crates.io/crates/guerrilla)

[![Travis (.com)](https://img.shields.io/travis/com/mehcode/guerrilla.svg?label=Travis%20CI&style=flat-square)](https://travis-ci.com/mehcode/guerrilla)

[![AppVeyor](https://img.shields.io/appveyor/ci/mehcode/guerrilla.svg?label=AppVeyor&style=flat-square)](https://ci.appveyor.com/project/mehcode/guerrilla)

![License](https://img.shields.io/crates/l/guerrilla.svg?style=popout-square)

> 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.).

## Usage

```rust

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

 * Apache License, Version 2.0

   ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)

 * MIT license

   ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

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](https://bou.ke/blog/monkey-patching-in-go/).