Home

Awesome

HashLibPlus License

HashLibPlus is a recommended C++11 hashing library that provides a fluent interface for computing hashes and checksums of strings, files, streams, bytearrays and untyped data to mention but a few.

It also supports Incremental Hashing, Cloning, NullDigest.

Available Algorithms

Hashes

Cyclic Redundancy Checks
Checksums
Non-Cryptographic Hash Functions
32 bit hashes
64 bit hashes
128 bit hashes
Cryptographic Hash Functions

Key Derivation Functions

Password Hashing Schemes (Password Based Key Derivation Functions)

MAC

XOF (Extendable Output Function)

Usage Examples

#include "Base/HashFactory.h"

int main() 
{
    IHash hash = HashFactory::Crypto::CreateMD5();
		
    IHash clone = hash->Clone();

    IHMAC hmac = HashFactory::HMAC::CreateHMAC(hash);
    hmac->SetKey(Converters::ConvertStringToBytes("password"));

    IHashResult Result1 = hash->ComputeString("Hash");
    IHashResult Result2 = hmac->ComputeString("Hash");
	
    bool check = Result1->CompareTo(Result2);
    
    return 0;
}

Full Visual Studio project without CMake

Please consider using this version HashLibPlus-Reload instead.

How to build library

CMake

To build this library you should have CMake installed and configured on your local machine to work with any C++ compiler such as gcc, g++ and clang. If you already have visual studio installed on your local machine, cmake kind of automatically links with the compiler and therefore builds a visual studio project of the library for you. Visual Studio 2019 was used to build and compile this project. Goodluck! ;)

CMake version 2.30.3, was specifically used to compile this library.

Note: catch2 library was used as the test framework in the HashLibPlus.Tests project.

Follow the steps below to build for x86 (32-bit) Release mode.

> cmake -G "Visual Studio 16 2019" -A Win32 -S {src_dir} -B {build_dir}

Example: cmake -G "Visual Studio 16 2019" -A Win32 -S . -B x86

Note: The . used as the source directory indicates the current directory where the cmd interface is pointed to.

> cmake --build {src_dir} --config Release

Follow the steps below to build for x64 (64-bit) Release mode.

> cmake -G "Visual Studio 16 2019" -A x64 -S {src_dir} -B {build_dir}

Example: cmake -G "Visual Studio 16 2019" -A x64 -S . -B x64

Note: The . used as the source directory indicates the current directory where the cmd interface is pointed to.

> cmake --build {src_dir} --config Release

This command is to build a Visual Studio project files of the library, where {src_dir} is the parent directory. And {build_src} is the build directory depending on "x86" or "x64".

Download the project full release here

How to run test

catch2 is the test framework used in this project because of its flexible nature.

To run the unitests in HashLibPlus.Tests project, locate HashLibPlus.Test.exe in the Release folder of the built project.

The built project outputs two executables and a hashplus.lib for linking with the Base/HashFactory.h main header file.

This executable displays a benchmark test analysis of the compiled code speed with regards to your C.P.U capability.

This executable hooks into catch2 process to allow for detailed test results, and other command line options that catch2 supports for those that wish to pass values to catch2 interface.

More on this library

Depending on how experienced you are with CMake or catch2, you are always free to make pull requests and most especially plug in your favourite hash into the library which might not be available now. Bye!

Other Implementations

If you want implementations in other languages, you can check out these

Tip Jar