Mercy is a public Rust crate created to assist with building cybersecurity frameworks, assessment tools, and numerous other projects. We hope to create a sustainable crate to make creating security tools in Rust a little easier and not require so much bloat in your project.
Since Mercy is a standard crate, it can easily be utilized in any project already initialized with the Cargo configuration.
Add the following line to your Cargo.toml
file:
toml
mercy = "1.1.12"
Once the Cargo.toml
file has been updated, you can import the crate and use the provided methods by running cargo run
.
Here's a quick example for decoding and encoding using the base64 protocol: ```rust use mercy::{ mercydecode, mercyencode };
fn main() { // Encode string "Umiko Labs" mercy_encode("base64", "Umiko Labs");
// Decode string "VW1pa28gU2VjdXJpdHk="
mercy_decode("base64", "VW1pa28gU2VjdXJpdHk=");
} ```
Here's how to dump hexadecimal values in a single line using Mercy: ```rust use mercy::mercy_hex;
fn main() { mercyhex("hexdump", "/Location/of/file"); } ```
Some extra methods have been included to assist with local data collection. We currently allow you to collect the internal ip address of your device or dump certain information, specified by the user. ```rust use mercy::mercy_extra;
fn main() { // Contains the internal ip address of the user's system mercyextra("internalip", "");
// This method is extensive, but the "all" parameter allows the user to dump everything we have set in Mercy
mercy_extra("system_info", "all");
} ``` We can also use the following paremeters, replacing the "all" keyword:
If ever in doubt, feel free to run this special function to display more information about the crate. ```rust use mercy::source;
fn main() { mercy_source(); } ```