clandestined

What it is and what it does

Clandestined is a rendezvous hashing library designed to solve the problem of locating objects across a cluster of machines while minimizing data movement when nodes join or leave. It uses murmur3 hashing as its underlying algorithm and provides two main interfaces: a low-level RendezvousHash class for simple node-to-key mapping, and a higher-level Cluster class that adds zone awareness to spread replicas across failure domains.

The library is lightweight with no runtime dependencies and supports a wide range of Python versions from 2.5 through 3.8, including PyPy variants. It allows customization through seed parameters for hashing and configurable replica counts, making it suitable for both simple and zone-aware distributed systems.

Use it for:

• Locate cached data across a cluster of cache nodes while minimizing cache invalidation on node failures
• Distribute object replicas across multiple zones to ensure fault tolerance in geographically distributed systems
• Map incoming requests to backend servers in a load-balanced cluster with consistent routing
• Implement shard assignment in a distributed database where data must survive node departures

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Implements rendezvous hashing to locate objects across a cluster of machines, minimizing data movement when cluster topology changes.

Yes, if you need rendezvous hashing for a stable distributed system and can accept an abandoned library. The code is simple, has no dependencies, and carries no known vulnerabilities. However, verify compatibility with your Python version (support beyond 3.8 is unspecified) and be aware that no active maintenance means no future bug fixes or security updates.

Install

clandestined on PyPI

pip install clandestined

uv add clandestined

poetry add clandestined

Installing clandestined

Before you install

High install friction with no runtime dependencies. Maintenance status is abandoned—last release was 2023-06-01, over 1170 days ago. The repository is not archived but shows no active development.

License in practice

Licensed under MIT (permissive), so you may use, modify, and distribute freely with minimal restrictions.

Quickstart

from clandestined import Cluster

nodes = {'1': {'name': 'node1.example.com', 'zone': 'us-east-1a'},
         '2': {'name': 'node2.example.com', 'zone': 'us-east-1a'}}
cluster = Cluster(nodes)
result = cluster.find_nodes('mykey')

Verify before relying

• Whether the package works reliably on Python versions beyond 3.8, given the description lists support through 3.8 but provides no requires_python constraint
• Current stability and whether murmur3 hash implementation remains secure for production use in untrusted-input scenarios

Package facts

Evidence: clandestined-1.1.0.tar.gz

Tags

More Distributed Computing packages