HAT-Trie structure for Python (2.x and 3.x).
Uses hat-trie C library.
pip install hat-trie
Create a new trie:
>>> from hat_trie import Trie >>> trie = Trie()
trie variable is a dict-like object that support unicode
keys and integer values and stores them efficiently.
Currently implemented methods are:
- __getitem__()
- __setitem__()
- __contains__()
- __len__()
- setdefault()
- keys()
- iterkeys()
- keys_with_prefix()
- iterkeys_with_prefix()
Other methods are not implemented.
Performance is measured for hat_trie.Trie against Python's dict with
100k unique unicode words (English and Russian) as keys and '1' numbers
as values.
Benchmark results for Python 3.3 (intel i5 1.8GHz, "1.000M ops/sec" == "1 000 000 operations per second"):
dict __getitem__ (hits) 6.874M ops/sec trie __getitem__ (hits) 3.754M ops/sec dict __contains__ (hits) 7.035M ops/sec trie __contains__ (hits) 3.772M ops/sec dict __contains__ (misses) 5.356M ops/sec trie __contains__ (misses) 3.364M ops/sec dict __len__ 785958.286 ops/sec trie __len__ 574164.704 ops/sec dict __setitem__ (updates) 6.830M ops/sec trie __setitem__ (updates) 3.472M ops/sec dict __setitem__ (inserts) 6.774M ops/sec trie __setitem__ (inserts) 2.460M ops/sec dict setdefault (updates) 3.522M ops/sec trie setdefault (updates) 2.680M ops/sec dict setdefault (inserts) 4.062M ops/sec trie setdefault (inserts) 1.866M ops/sec dict keys() 189.564 ops/sec trie keys() 16.067 ops/sec
HAT-Trie is about 1.5x faster that datrie on all supported operations; it also supports fast inserts unlike datrie. On the other hand, datrie has more features (e.g. better iteration support and richer API); datrie is also more memory efficient.
Development happens at github and bitbucket:
The main issue tracker is at github.
Feel free to submit ideas, bugs, pull requests (git or hg) or regular patches.
Make sure tox is installed and run
$ tox
from the source checkout. Tests should pass under python 2.6, 2.7, 3.2 and 3.3.
$ tox -c bench.ini
runs benchmarks.
- Mikhail Korobov <kmike84@gmail.com>
- Felix Liu <numeca.yfliu@gmail.com>
This module is based on hat-trie C library by Daniel Jones & contributors.
Licensed under MIT License.