Mercy is a public Rust crate created to assist with building cybersecurity frameworks, assessment tools, and numerous other projects

Overview


Mercy

📚 Documentation


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.

Usage

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:

mercy = "1.1.11"

Once the Cargo.toml file has been updated, you can import the crate and use the provided methods by running cargo run.

Cryptographic Processes

Here's a quick example for decoding and encoding using the base64 protocol:

use mercy::{
    mercy_decode,
    mercy_encode
};

fn main() {
    // Encode string "Umiko Security"
    mercy_encode("base64", "Umiko Security");
    
    // Decode string "VW1pa28gU2VjdXJpdHk="
    mercy_decode("base64", "VW1pa28gU2VjdXJpdHk=");
}

Hexadecimal Dumping

Here's how to dump hexadecimal values in a single line using Mercy:

use mercy::mercy_hex;

fn main() {
    mercy_hex("hex_dump", "/Location/of/file");
}

Miscellaneous Methods

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.

use mercy::mercy_extra;

fn main() {
    // Contains the internal ip address of the user's system
    mercy_extra("internal_ip", "");

    // 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:

  • hostname
  • cpu_cores
  • cpu_speed
  • os_release
  • proc

More Info

If ever in doubt, feel free to run this special function to display more information about the crate.

use mercy::source;

fn main() {
    mercy_source();
}
You might also like...
Little exercises for learning Rust and building awesome cli tools! ⭐️

rust-cli-exercises Little exercises for learning Rust and building awesome cli tools! ⭐️ What's Here This repo is a collection of many extremely small

⚙️ A curated list of static analysis (SAST) tools for all programming languages, config files, build tools, and more.
⚙️ A curated list of static analysis (SAST) tools for all programming languages, config files, build tools, and more.

This repository lists static analysis tools for all programming languages, build tools, config files and more. The official website, analysis-tools.de

CLI program for building generative projects

NFT image generator This is the project to help artists to generate NFT collection, which can be generated from layers of PNG images. Usage Get archiv

A toolkit for building your own interactive command-line tools in Rust

promkit A toolkit for building your own interactive command-line tools in Rust, utilizing crossterm. Getting Started Put the package in your Cargo.tom

A tiny crate to make it easy to share and apply Git hooks for Rust projects
A tiny crate to make it easy to share and apply Git hooks for Rust projects

Shareable git hooks for Rust project. Sloughi is a friend of Husky from North Africa! :algeria:

Show unused code from multi-crate Rust projects

Warnalyzer Remove unused code from multi-crate Rust projects. The dead_code lint family of rustc is limited to one crate only and thus can't tell whet

My own image file format created for fun! Install the "hif_opener.exe" to open hif files. clone the repo and compile to make your own hif file

Why am i creating this? I wanted to create my own image format since I was 12 years old using Windows 7, tryna modify GTA San Andreas. That day, when

A simple crate, that protects some variables from being modified by memory tampering tools.

Crate: protected_integer A simple crate, that protects some variables from being modified by memory tampering tools. Usage Add this crate to dependenc

A fast python geohash library created by wrapping rust.

Pygeohash-Fast A Fast geohasher for python. Created by wrapping the rust geohash crate with pyo3. Huge shout out to the georust community :) Currently

Comments
  • New Release: v1.2.x

    New Release: v1.2.x

    Changelog

    • Improved overall documentation
    • Updated with a new project icon

    Features

    • Now queries the InQuest API to validate if a domain is malicious or not
    • Added the ability to defang IP addresses and URLs
    • Can now query the WHOIS database for domain information
    documentation enhancement 
    opened by azazelm3dj3d 0
Releases(v1.2.16)
  • v1.2.16(Jan 6, 2023)

    Changelog | v1.2.16

    Available on crates.io: https://crates.io/crates/mercy

    Features

    • New project logo (https://github.com/CatherineFramework/mercy/commit/457c22eae26c24a00382b391d60918d44a5e83f7)
    • Now offers the ability to run a malicious domain query (https://github.com/CatherineFramework/mercy/commit/d2d5aa16001189320966afa3db380012f69c12bb)
    • Added the option to defang URLs and IP addresses (https://github.com/CatherineFramework/mercy/commit/457c22eae26c24a00382b391d60918d44a5e83f7)
    • Can now run a WHOIS lookup to collect domain information (https://github.com/CatherineFramework/mercy/commit/457c22eae26c24a00382b391d60918d44a5e83f7)
    • Improved documentation and cleared any lib warnings

    Hot Fix

    • v1.2.17 - Removed an irrelevant public function call (https://github.com/CatherineFramework/mercy/commit/ecb7fde73972171a64f023fceed2dac17011f4b7)
    Source code(tar.gz)
    Source code(zip)
  • v1.1.11(Nov 2, 2022)

    Changelog | v1.1.11 🚀

    Mercy currently accepts multiple callbacks:

    • Decoding encoded strings
      • Base64
      • Rot13
    • Encoding plaintext strings
      • Base64
    • Hashing plaintext strings
      • md5
      • sha256
    • Dumps hexadecimal values from a local file
    • Aggregates system information, including internal IP address, CPU diagnostics, hostname, etc.

    Documentation is available here: https://docs.rs/crate/mercy/latest

    Source code(tar.gz)
    Source code(zip)
Owner
Umiko Security
Open-source security tools for all security professionals
Umiko Security
List public items (public API) of library crates. Enables diffing public API between releases.

cargo-public-items List public items (the public API) of a Rust library crate by analyzing the rustdoc JSON of the crate. Automatically builds the rus

Martin Nordholts 203 Dec 31, 2022
A collection of tools for i3 that assist in window, workspace and output operations.

i3-valet A collection of tools for i3 that assist in window, workspace and output operations. i3-valet can be run directly from the command line or as

Erich Heine 15 Jan 8, 2023
Transform jsx/tsx files to reactive views in js/ts to use in Web Components, insert into DOM or integrate with other libraries/frameworks

viewmill Features | Installation | Getting Started | Notes | Examples viewmill is aimed to create complex UIs from a simple form of JSX. It statically

apleshkov 6 Sep 4, 2023
Little example projects for learning Rust and building awesome cli tools! ⭐️

rust-cli-examples Examples of clean and well-tested command line utilities, written in Rust. ?? ?? What is this repo? This repo is a collection of man

Jim Lynch 5 Mar 31, 2023
Guardian Self Assessment CLI tool

Guardian Self Assessment CLI tool What? self-assessment is a tool that generates a list of PRs authored and reviewed by you. Why? Assessing oneself is

The Guardian 5 Jul 6, 2022
Codemod - Codemod is a tool/library to assist you with large-scale codebase refactors that can be partially automated but still require human oversight and occasional intervention

Codemod - Codemod is a tool/library to assist you with large-scale codebase refactors that can be partially automated but still require human oversight and occasional intervention. Codemod was developed at Facebook and released as open source.

Meta Archive 4k Dec 29, 2022
Tooling and library for generation, validation and verification of supply chain metadata documents and frameworks

Spector Spector is both tooling and a library for the generation, validation and verification of supply chain metadata documents and frameworks. Many

Kusari 13 May 4, 2023
A simple cli to clone projects and fetch all projects in a GitHub org..

stupid-git A simple cli to clone projects and update all projects. get all repository from GitHub clone all pull all with git stash Usage create sgit.

Fengda Huang 5 Sep 15, 2022
tmplt is a command-line interface tool that allows you to quickly and easily set up project templates for various programming languages and frameworks

tmplt A User Friendly CLI Tool For Creating New Projects With Templates About tmplt is a command-line tool that lets users quickly create new projects

Humble Penguin 35 Apr 8, 2023