Indices for using with catalog like text, field, etc.
The zope.index package provides several indices for the Zope catalog. These include:
- a field index (for indexing orderable values),
- a keyword index,
- a topic index,
- a text index (with support for lexicon, splitter, normalizer, etc.)
- Insure proper unindex behavior if index_doc is called with a empty sequence.
- Use the standard Python doctest module instead of zope.testing.doctest
- KeywordIndex: Minor optimization; use __nonzero__ instead of __len__ to avoid loading the full TreeSet.
- KeywordIndex: Store docids in TreeSet rather than a Set when the number of documents matching a word reaches a configurable threshold (default 64). The rule is applied to individual words at indexing time, but you can call the new optimize method to optimize all the words in an index at once. Designed to fix LP #881950.
- TextIndex: reuse the lexicon from the underlying Okapi / Cosine index, if passed. (LP #232516)
- Lexicon: avoid raising an exception when indexing None. (LP #598776)
- Improved test readability and reached 100% test coverage.
- Fixed a broken optimization in okascore.c: it was passing a Python float to the PyInt_AS_LONG() macro. This resulted in wrong scores, especially on 64 bit platforms, where all scores typically ended up being zero.
- Changed okascore.c to produce the same results as its Python equivalent, reducing the brittleness of the text index tests.
- Port okascore.c optimization used in okapiiindex from Zope2 catalog implementation. This module is compiled conditionally, based on whether your environment has a working C compiler.
- Don’t use len(self._docweight) in okapiindex _search_wids method (obtaining the length of a BTree is very expensive at scale). Instead use self.documentCount(). Also a Zope2 port.
- The baseindex, okapiindex, and lexicon used plain counters for various lengths, which is unsuitable for production applications. Backport code from Zope2 indexes which opportunistically replaces the counters with BTree.Length objects.
- Backport non-insane version of baseindex._del_wordinfo from Zope2 text index. This improves deletion performance by several orders of magnitude.
- Don’t modify given query dictionary in the KeywordIndex.apply method.
- Move FieldIndex’s sorting functionality to a mixin class so it can be reused by zc.catalog’s ValueIndex.
Remove zope.testing from dependencies, as it’s not really needed.
Define IIndexSort interface for indexes that support sorting.
Implement sorting for FieldIndex (adapted from repoze.catalog/ZCatalog).
Add an apply method for KeywordIndex/TopicIndex, making them implement IIndexSearch that can be useful in catalog.
Optimize the search method of KeywordIndex/TopicIndex by using multiunion for the or operator and sorting before intersection for and.
IMPORTANT: KeywordIndex/TopicIndex now use IFSets instead of IISets. This makes it more compatible with other indexes (for example, when using in catalog). This change can lead to problems, if your code somehow depends on the II nature of sets, as it was before.
Also, FilteredSets used to use IFSets as well, if you have any FilteredSets pickled in the database, you need to migrate them to IFSets yourself. You can do it like that:
filter._ids = filter.family.IF.Set(filter._ids)
Where filter is an instance of FilteredSet.
IMPORTANT: KeywordIndex are now non-normalizing. Because it can be useful for non-string keywords, where case-normalizing doesn’t make any sense. Instead, it provides the normalize method that can be overriden by subclasses to provide some normalization.
The CaseInsensitiveKeywordIndex class is now provided that do case-normalization for string-based keywords. The old CaseSensitiveKeywordIndex is gone, applications should use KeywordIndex for that.
Looks like the KeywordIndex/TopicIndex was sort of abadonware and wasn’t used by application developers, so after some discussion we decided to refactor them to make them more usable, optimal and compatible with other indexes and catalog.
Porting application from old KeywordIndex/TopicIndex to new ones are rather easy and explained above, so we believe that it isn’t a problem. Please, use firstname.lastname@example.org or email@example.com mailing lists, if you have any problems with migration.
Thanks Chris McDonough of repoze for supporting and useful code.
- Fixed bug in package metadata (wrong homepage URL).
No further changes since 3.4.0a1.
Initial release as a separate project, corresponds to zope.index from Zope 3.4.0a1
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.