9 releases

Uses old Rust 2015

0.2.0 Dec 14, 2020
0.1.7 Jan 21, 2018
0.0.6 Oct 3, 2017
0.0.5 Jan 20, 2016
0.0.1 Jan 15, 2015

#1785 in Data structures

Download history 38/week @ 2024-11-13 48/week @ 2024-11-20 39/week @ 2024-11-27 40/week @ 2024-12-04 63/week @ 2024-12-11 13/week @ 2024-12-18 4/week @ 2024-12-25 19/week @ 2025-01-01 8/week @ 2025-01-08 32/week @ 2025-01-15 15/week @ 2025-01-22 98/week @ 2025-01-29 186/week @ 2025-02-05 44/week @ 2025-02-12 14/week @ 2025-02-19 26/week @ 2025-02-26

338 downloads per month

MIT license

14KB
261 lines

rust-hash-ring

Consistent Hashing library for Rust

Crates.io crates.io Crates.io CI Coverage Status

Documentation

Usage

extern crate hash_ring;

use hash_ring::HashRing;
use hash_ring::NodeInfo;

fn main() {
    let mut nodes: Vec<NodeInfo> = Vec::new();
    nodes.push(NodeInfo {
        host: "localhost",
        port: 15324,
    });
    nodes.push(NodeInfo {
        host: "localhost",
        port: 15325,
    });
    nodes.push(NodeInfo {
        host: "localhost",
        port: 15326,
    });
    nodes.push(NodeInfo {
        host: "localhost",
        port: 15327,
    });
    nodes.push(NodeInfo {
        host: "localhost",
        port: 15328,
    });
    nodes.push(NodeInfo {
        host: "localhost",
        port: 15329,
    });

    let mut hash_ring: HashRing<NodeInfo> = HashRing::new(nodes, 10);

    println!(
        "Key: '{}', Node: {}",
        "hello",
        hash_ring.get_node(("hello").to_string()).unwrap()
    );

    println!(
        "Key: '{}', Node: {}",
        "dude",
        hash_ring.get_node(("dude").to_string()).unwrap()
    );

    println!(
        "Key: '{}', Node: {}",
        "martian",
        hash_ring.get_node(("martian").to_string()).unwrap()
    );

    println!(
        "Key: '{}', Node: {}",
        "tardis",
        hash_ring.get_node(("tardis").to_string()).unwrap()
    );

    hash_ring.remove_node(&NodeInfo {
        host: "localhost",
        port: 15329,
    });

    println!(
        "Key: '{}', Node: {}",
        "hello",
        hash_ring.get_node(("hello").to_string()).unwrap()
    );

    hash_ring.add_node(&NodeInfo {
        host: "localhost",
        port: 15329,
    });

    println!(
        "Key: '{}', Node: {}",
        "hello",
        hash_ring.get_node(("hello").to_string()).unwrap()
    );
}

For an example of how to use a custom hash function you can look at examples/custom_hasher.rs

Contributing

Just fork it, implement your changes and submit a pull request.

License

MIT

Dependencies

~185KB