CityHash for Ruby

This is an implementation of Google's CityHash for Ruby. It supports both 64-bit and 128-bit hashes. The newer CityHashCrc routines have not yet been implemented. Please note that the code has not been optimized for speed.

Installing CityHash is as simple as

gem install city_hash

require 'city_hash'

# Calculate a 64-bit hash
CityHash.hash64('New York City')

# Calculate a 64-bit hash with seed
CityHash.hash64('East Village', 0xef23)

# Calculate a 64-bit hash with two seeds
CityHash.hash64('Meatpacking', 0xba3c, 0x5acd)

# Calculate a 128-bit hash
CityHash.hash128('SoHo')

# Calculate a 128-bit hash with seed
CityHash.hash128('Upper West Side', 0x8ad1)

The test functions generate random strings and compare the outputs of both the C and Ruby implementations. The source for these strings is Dostoevsky's 'Crime and Punishment', obtained from Project Gutenberg and compressed within test.zip.

Google's implementation of Cityhash must be installed on the test system, since the test routines link against libcityhash.

This 'city_hash' gem must already be installed on the test system.

cd test/
./run.sh

Ashwin Ramaswamy

Copyright (c) 2011 ashwinr. Please see license.txt for further details.