Do you need a simple non-cryptograhic hash algorithm?
Do you not want to rely on the internals of GetHashCode()?
Do you want to run a hash in a tight loop with low allocation overhead?

If so, then this package might be right for you.

The Data and Analytics team is building it's own high-performance, low-allocation hash algorithms for processing data in various "big data" systems. We've managed to squeeze some pretty astonishing performance out of our implementation. Since it wasn't tightly coupled to anything either, we thought we'd share the goodness with everyone.

We're sharing our code as NuGet "recipe" packages. That means that instead of adding a DLL reference to your code, we're adding the source files themselves. Everything we add is internal and therefore scoped only to that assembly. So, you can freely add this to as many projects as you like without fear of conflicts. We do this for a few reasons:

1. In this day and age, the JIT compiler is usually smart enough to optimize away annything you don't use and codegen overhead isn't typically concerning on beefy server machines.
2. It helps avoid assembly versioning issues when several projects have a dependency on this and each other.
3. It also -- to a lesser degree -- insulates us from framework versioning issues. We try to keep the syntax simple and therefore, in many cases, we're natually compatible all the way back to .NET 3.5.
4. It gives the compiler a chance to inline our code in your project, thus giving us a boost in performance in some cases.
5. Most importantly, it gives you the freedom to tweak and tinker without even necessarily having to wait for a pull request to be approved. Although, you can still do that (and we encourage it). You just don't have to necessarily wait for all the paperwork to go through if you're in a hurry.

This source code and artifacts are released under the terms of the MIT License.

The package is available on nuget.org.

If you have Visual Studio installed, open a command prompt and run:

build.cmd

This will download the dependencies, compile the code, run unit tests, and package everything. You should end up with a file named something like Microsoft.Shared.Dna.Hash.{major}.{minor}.{patch}.nupkg under the Drop folder.

Please refer to CONTRIBUTING.md.

If you believe you have found a security vulnerability in this project, please follow these steps to report it. For more information on how vulnerabilities are disclosed, see Coordinated Vulnerability Disclosure.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.