xxHash

xxHash is an extremely fast non-cryptographic hash algorithm, working at RAM speed limit. It comes in four flavors (XXH32, XXH64, XXH3_64bits and XXH3_128bits). For a more detailed comparison, see xxhash.com.

Current implementation status:

• XXH32
• XXH64
• XXH3_64
• XXH3_128

Installation

1. Add the dependency to your shard.yml:

   dependencies:
     xxhash:
       git: https://codeberg.org/Sylphrena/xxHash.cr.git
   

2. Run shards install

Usage

require "xxhash"

# Hashing a file
File.open "path_to_file", "r" do |io|
  # xxHash64 algorithm
  XXHash.digest64(io)

  # xxHash32 algorithm
  XXHash.digest32(io)

  # With hexstring return value
  XXHash.hexdigest64(io)

  # With hexstring return value
  XXHash.hexdigest32(io)
end

# Hashing a `String`
XXHash.digest64("魑魅魍魎")
XXHash.digest32("魑魅魍魎")

XXHash.hexdigest64("魑魅魍魎")
XXHash.hexdigest32("魑魅魍魎")

Performance

Using spec/speed_test.cr. Times include rewinding the IO, greatly influencing performance for small sizes.

Contributing

1. Fork it (https://codeberg.org/Sylphrena/xxHash.cr/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• Sylphrena - creator and maintainer