odex 0.0.1

Python object index for fast, declarative retrieval

odex

Python object index for fast, declarative retrieval.

Install

pip install odex

Usage

Odex provides a set-like collection called IndexedSet:

from odex import IndexedSet, HashIndex, attr, and_

class X:
    def __init__(self, a, b):
        self.a = a
        self.b = b

objs = [
    X(a=1, b=4),
    X(a=2, b=5),
    X(a=2, b=6),
    X(a=3, b=7),
]
        
iset = IndexedSet(objs, indexes=[HashIndex("a")])

# Filter objects with SQL-like expressions:
assert iset.filter("a = 2 AND b = 5") == {objs[1]}

# Or, using the fluent interface:
assert iset.filter(
    and_(
        attr("a").eq(2),
        attr("b").eq(5)
    )
) == {objs[1]}

Related projects

• sqlglot - odex uses sqlglot for expression parsing
• ducks - similar project with different tradeoffs

Benchmarks

See comparisons.ipynb for more.