hashdeque 0.0.2

A string/bytes deque with an O(1) rolling hash and O(1) equality between instances.

hashdeque

A deque of characters (any Unicode symbol) that maintains a rolling hash of its contents. Powers of the base are precomputed, so the hash of the current sequence is available in O(1) after each push/pop instead of rehashing everything.

• push_front / push_back — O(1)
• pop_front / pop_back — O(1)
• hash() of the current contents — O(1)
• equality between two HashDeque instances — O(1) (compares rolling hashes)

Useful for substring/window matching (Rabin–Karp style), deduplication over a sliding window, and content-defined chunking.

Install

pip install hashdeque

Development setup:

uv venv
uv pip install -e ".[dev]"

Usage

from hashdeque import HashDeque

d = HashDeque()
for ch in "hello":
    d.push_back(ch)
print(d.hash())     # rolling-hash fingerprint of "hello"
d.pop_front()       # drop 'h'
print(d.hash())     # fingerprint of "ello", computed in O(1)

other = HashDeque("ello")
print(d == other)   # True, O(1) comparison

d.verify = True     # opt in to exact verification on a hash match

Test

pytest

Layout

hashdeque/
├── pyproject.toml
├── repo_structure.yaml         # enforced by the repo-structure pre-commit hook
├── .pre-commit-config.yaml
├── .github/workflows/publish.yml
├── src/hashdeque/
│   ├── __init__.py             # public API
│   ├── base.py                 # BaseHashDeque (ABC) — the contract
│   ├── params.py               # HashParams — bases/moduli/inverses
│   ├── deque.py                # HashDeque — polynomial double-hash implementation
│   └── py.typed
└── tests/
    ├── test_base.py
    ├── test_params.py
    └── test_hashdeque.py