denselinkage.core.ports.BlockingIndex¶

class denselinkage.core.ports.BlockingIndex(*args, **kwargs)[source]¶

Bases: Protocol

Immutable fitted artifact produced by Blocker.build().

Holds the indexed (left/reference) records and generates CandidatePair``s for a query record set. ``top_k and similarity_threshold are query-time parameters: they default to the values fixed on the originating Blocker spec but may be overridden per call, so a top_k / threshold sweep reuses one built index instead of rebuilding it. An override top_k <= 0 raises InvalidTopK (parity with the index-time validation documented on index()).