Introduction
============
This package provides primitives to help delegate ZCatalog indexing operations
to adapters. It doesn't do very much on its own, but can be used by catalog
implementations that want to allow individual index values to be provided
not by the object itself, but by separate adapters.
Changelog
=========
.. You should *NOT* be adding new change log entries to this file.
You should create a file in the news directory instead.
For helpful instructions, please see:
https://github.com/plone/plone.releaser/blob/master/ADD-A-NEWS-ITEM.rst
.. towncrier release notes start
2.0.1 (2024-01-22)
------------------
Internal:
- Update configuration files.
[plone devs] (6e36bcc4, 7723aeaf)
2.0.0 (2023-04-19)
------------------
Breaking changes:
- Drop python 2.7 support.
[gforcada] (#1)
Internal:
- Update configuration files.
[plone devs] (5cc689e5)
1.0.7 (2020-04-20)
------------------
Bug fixes:
- Minor packaging updates. (#1)
1.0.6 (2019-04-29)
------------------
Bug fixes:
- Fixed: doctests on Python 2 were not correctly checked. [maurits] (#7)
1.0.5 (2018-09-26)
------------------
Fixes:
- fix https://github.com/plone/Products.CMFPlone/issues/2469:
"Subobjects are indexing attributes of parent".
Allow only direct attributes and acquired PythonScripts,
but not acquired attributes.
Indexers and PythonScripts are able to handle this explicitly,
because they get the acquisition-wrapped object.
[jensens]
- Fix tests to work in Python 3
[pbauer]
1.0.4 (2016-02-25)
------------------
Fixes:
- Replace deprecated ``zope.testing.doctestunit`` import with ``doctest``
module from stdlib.
[thet]
- Reformat according to the Plone styleguide.
[thet]
1.0.3 (2015-05-05)
------------------
- Add missing dependency on Products.ZCatalog.
[gforcada]
1.0.2 (2013-01-13)
------------------
- Changed the @indexer decorator to maintain the information about the wrapped
function (__doc__, __module__, __name__, etc).
[dokai]
1.0.1 (2012-12-14)
------------------
- Relicense under modified BSD license; per Plone Foundation board
approval on 2012-05-31.
See: http://plone.org/foundation/materials/foundation-resolutions/plone-framework-components-relicensing-policy
[supton]
- Add MANIFEST.in.
[WouterVH]
1.0 - 2010-07-18
----------------
- Fixed reSt markup in the changelog.
[hannosch]
- Update license to GPL version 2 only.
[hannosch]
1.0rc2 - 2009-04-05
-------------------
- Added _getWrappedObject() method to get hold of the underlying object.
Note that this means you can't have an index/metadata column with this name.
[optilude]
- Corrected IZCatalog import location to point to the interfaces module.
[hannosch]
1.0rc1 - 2009-03-26
-------------------
- Updated the interface to match the developments of similar functionality
on CMF trunk. This means that indexers are now multi-adapters on
(object, catalog), and the keyword arguments (including the implicit
'portal' parameter) are gone.
[optilude]
1.0a1 - 2009-03-05
------------------
- Initial release
Writing indexers
================
An indexer is a named adapter that adapts the type of an object and provides a value to be indexed when the catalog attempts to index the attribute with that name.
For example, let's say we have two types, page and news item::
>>> from zope.interface import Interface
>>> from zope.interface import implementer
>>> from zope import schema
>>> class IPage(Interface):
... text = schema.Text(title=u"Body text")
>>> @implementer(IPage)
... class Page(object):
... def __init__(self, text):
... self.text = text
>>> class INewsItem(Interface):
... summary = schema.TextLine(title=u"Short summary")
... story = schema.Text(title=u"Body text")
... audience = schema.TextLine(title=u"Audience")
>>> @implementer(INewsItem)
... class NewsItem(object):
... def __init__(self, summary, story, audience):
... self.summary = summary
... self.story = story
... self.audience = audience
Now, pretend that our catalog had an index 'description', which for a page should contain the first 10 characters from the body text, and for a news item should contain the contents of the 'summary' field.
Furthermore, there is an index 'audience' that should contain the value of the corresponding field for news items, in all uppercase.
It should do nothing for pages.
We could write indexers for all of these like this::
>>> from plone.indexer import indexer
>>> @indexer(IPage)
... def page_description(object):
... return object.text[:10]
>>> @indexer(INewsItem)
... def newsitem_description(object):
... return object.summary
>>> @indexer(INewsItem)
... def newsitem_audience(object):
... return object.audience.upper()
These need to be registered as named adapters, where the name corresponds to the index name.
In ZCML, that may be::
<adapter name="description" factory=".indexers.page_description" />
<adapter name="description" factory=".indexers.newsitem_description" />
<adapter name="audience" factory=".indexers.newsitem_audience" />
We can omit the 'for' attribute because we passed this to the @indexer decorator, and we can omit the 'provides' attribute because the thing returned by the decorator is actually a class providing the required IIndexer interface.
For the purposes of the ensuing tests, we'll register these directly::
>>> from zope.component import provideAdapter
>>> provideAdapter(page_description, name='description')
>>> provideAdapter(newsitem_description, name='description')
>>> provideAdapter(newsitem_audience, name='audience')
Testing your indexers (or calling them directly)
------------------------------------------------
If you are writing tests for your indexers (as you should!), then you should be aware of the following:
When the @indexer decorator returns, it turns your function into an instance of type DelegatingIndexerFactory.
This is an adapter factory that can create a DelegatingIndexer, which in turn will call your function when asked to perform indexing operations.
This means that you can't just call your function to test the indexer.
Instead, you need to instantiate the adapter and then call the delegating indexer with the portal root as the first argument.
For example::
>>> test_page = Page(text=u"My page with some text")
>>> page_description(test_page)()
'My page wi'
This will suffice in most cases.
Note that there is actually a second parameter, catalog, which defaults to None.
If you need to write an indexer that acts on catalog, you'll need to register a conventional adapter, as described in the next section.
Other means of registering indexers
-----------------------------------
At the end of the day, an indexer is just a named multi-adapter from the indexable object (e.g.
INewsItem or IPage above) and the catalog (usually portal_catalog in a CMF application) to IIndexer, where the name is the name of the indexed attribute in the catalog.
Thus, you could register your indexers as more conventional adapters::
>>> from plone.indexer.interfaces import IIndexer
>>> from Products.ZCatalog.interfaces import IZCatalog
>>> from zope.component import adapter
>>> from zope.interface import implementer
>>> @implementer(IIndexer)
... @adapter(IPage, IZCatalog)
... class LengthIndexer(object):
... """Index the length of the body text
... """
... def __init__(self, context, catalog):
... self.context = context
... self.catalog = catalog
...
... def __call__(self):
... return len(self.context.text)
We normally just use IZCatalog for the catalog adaptation, to apply to any catalog.
However, if you want different indexers for different types of catalogs, there is an example later in this test.
You'd register this with ZCML like so::
<adapter factory=".indexers.LengthIndexer" name="length" />
Or in a test::
>>> provideAdapter(LengthIndexer, name="length")
If you're only curious about how to write indexers, you can probably stop here.
If you want to know more about how they work and how they are wired into a framework, read on.
Hooking up indexers to the framework
=====================================
Here is a mock implementation of a ZCatalog.catalog_object() override, based on the one in Plone.
We'll use this for testing.
We won't bother with the full ZCatalog interface, only catalog_object(), and we'll stub out a few things.
This really is for illustration purposes only, to show the intended usage pattern.
In CMF 2.2, there is an IIndexableObject marker interface defined in Products.CMFCore.interfaces.
We have a compatibility alias in this package for use with CMF 2.1.
::
>>> from OFS.interfaces import IItem
>>> from plone.indexer.interfaces import IIndexableObject
>>> from Products.ZCatalog.interfaces import IZCatalog
>>> from zope.component import queryMultiAdapter
>>> @implementer(IZCatalog, IItem)
... class FauxCatalog(object):
...
... def catalog_object(self, object, uid, idxs=[]):
... """Pretend to index 'object' under the key 'uid'. We'll
... print the results of the indexing operation to the screen .
... """
...
... if not IIndexableObject.providedBy(object):
... wrapper = queryMultiAdapter((object, self,), IIndexableObject)
... if wrapper is not None:
... object = wrapper
...
... # Perform the actual indexing of attributes in the idxs list
... for idx in idxs:
... try:
... indexed_value = getattr(object, idx)
... if callable(indexed_value):
... indexed_value = indexed_value()
... print("{0} = {1}".format(idx, indexed_value))
... except (AttributeError, TypeError,):
... pass
The important things here are:
- We attempt to obtain an IIndexableObject for the object to be indexed.
This is just a way to get hold of an implementation of this interface (we'll register one in a moment) and allow some coarse-grained overrides.
- Cataloging involves looking up attributes on the indexable object wrapper matching the names of indexes (in the real ZCatalog, this is actually decoupled, but let's not get carried away).
If they are callable, they should be called.
This is just mimicking what ZCatalog's implementation does.
This package comes with an implementation of an IIndexableObject adapter that knows how to delegate to an IIndexer.
Let's now register that as the default IIndexableObject wrapper adapter so that the code above will find it::
>>> from plone.indexer.interfaces import IIndexableObject
>>> from plone.indexer.wrapper import IndexableObjectWrapper
>>> provideAdapter(factory=IndexableObjectWrapper, adapts=(Interface, IZCatalog,), provides=IIndexableObject)
Seeing it in action
===================
Now for the testing. First, we need a faux catalog::
>>> catalog = FauxCatalog()
Finally, let's create some objects to index::
>>> page = Page(u"The page body text here")
>>> news = NewsItem(u"News summary", u"News body text", u"Audience")
First of all, let's demonstrate that our indexers work and apply only to the types for which they are registered::
>>> catalog.catalog_object(page, 'p1', idxs=['description', 'audience', 'length'])
description = The page b
length = 23
>>> catalog.catalog_object(news, 'n1', idxs=['description', 'audience', 'length'])
description = News summary
audience = AUDIENCE
Our custom indexable object wrapper is capable of looking up workflow variables if the portal_workflow tool is available.
For testing purposes, we'll create a fake minimal workflow tool and stash it onto the fake catalog so that it can be found by getToolByName.
In real life, it would of course be acquirable as normal::
>>> @implementer(IItem)
... class FauxWorkflowTool(object):
... def getCatalogVariablesFor(self, object):
... return dict(review_state='published', audience='Somebody')
>>> catalog.portal_workflow = FauxWorkflowTool()
If we now index 'review_state', it will be obtained from the workflow variables.
However, a custom indexer still overrides workflow variables::
>>> catalog.catalog_object(news, 'n1', idxs=['description', 'audience', 'review_state'])
description = News summary
audience = AUDIENCE
review_state = published
Finally, if not adapter can be found, we fall back on getattr() on the object::
>>> catalog.catalog_object(page, 'p3', idxs=['description', 'text'])
description = The page b
text = The page body text here
Customising indexers based on the catalog type
==============================================
It is possible to provide a custom indexer for a different type of catalog.
To test that, let's create a secondary catalog and mark it with a marker interface::
>>> from zope.interface import Interface
>>> class IAlternateCatalog(Interface):
... pass
>>> from zope.interface import alsoProvides
>>> catalog2 = FauxCatalog()
>>> alsoProvides(catalog2, IAlternateCatalog)
Let's say that we did not want the news item audience uppercased here.
We could provide a custom indexer for just this catalog::
>>> @indexer(INewsItem, IAlternateCatalog)
... def alternate_newsitem_audience(object):
... return object.audience.lower()
>>> provideAdapter(alternate_newsitem_audience, name='audience')
This does not affect the first catalog::
>>> catalog.catalog_object(news, 'n1', idxs=['description', 'audience', 'length'])
description = News summary
audience = AUDIENCE
However, the second catalog gets the audience in lowercase::
>>> catalog2.catalog_object(news, 'n1', idxs=['description', 'audience', 'length'])
description = News summary
audience = audience
Interfaces provided by the wrapper
==================================
The indexable object wrapper has one particular feature: instances of the wrapper will provide the same interfaces as instances of the wrapped object.
For example::
>>> from plone.indexer.interfaces import IIndexableObject
>>> from plone.indexer.interfaces import IIndexableObjectWrapper
>>> wrapper = IndexableObjectWrapper(page, catalog)
>>> IIndexableObjectWrapper.providedBy(wrapper)
True
>>> IIndexableObject.providedBy(wrapper)
True
>>> IPage.providedBy(wrapper)
True
>>> INewsItem.providedBy(wrapper)
False
>>> wrapper = IndexableObjectWrapper(news, catalog)
>>> IIndexableObjectWrapper.providedBy(wrapper)
True
>>> IPage.providedBy(wrapper)
False
>>> INewsItem.providedBy(wrapper)
True
Unboxing
========
It is possible to obtain the wrapped object from the wrapper::
>>> wrapper = IndexableObjectWrapper(page, catalog)
>>> wrapper._getWrappedObject() is page
True
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/plone.indexer",
"name": "plone.indexer",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "plone cmf zope catalog index",
"author": "Plone Foundation",
"author_email": "plone-developers@lists.sourceforge.net",
"download_url": "https://files.pythonhosted.org/packages/b0/99/513f61019848b637d15a5b782e2d2a65e490efee3992a5dcfcbde837a3d2/plone.indexer-2.0.1.tar.gz",
"platform": null,
"description": "Introduction\n============\n\nThis package provides primitives to help delegate ZCatalog indexing operations\nto adapters. It doesn't do very much on its own, but can be used by catalog\nimplementations that want to allow individual index values to be provided\nnot by the object itself, but by separate adapters.\n\n\nChangelog\n=========\n\n.. You should *NOT* be adding new change log entries to this file.\n You should create a file in the news directory instead.\n For helpful instructions, please see:\n https://github.com/plone/plone.releaser/blob/master/ADD-A-NEWS-ITEM.rst\n\n.. towncrier release notes start\n\n2.0.1 (2024-01-22)\n------------------\n\nInternal:\n\n\n- Update configuration files.\n [plone devs] (6e36bcc4, 7723aeaf)\n\n\n2.0.0 (2023-04-19)\n------------------\n\nBreaking changes:\n\n\n- Drop python 2.7 support.\n [gforcada] (#1)\n\n\nInternal:\n\n\n- Update configuration files.\n [plone devs] (5cc689e5)\n\n\n1.0.7 (2020-04-20)\n------------------\n\nBug fixes:\n\n\n- Minor packaging updates. (#1)\n\n\n1.0.6 (2019-04-29)\n------------------\n\nBug fixes:\n\n\n- Fixed: doctests on Python 2 were not correctly checked. [maurits] (#7)\n\n\n1.0.5 (2018-09-26)\n------------------\n\nFixes:\n\n- fix https://github.com/plone/Products.CMFPlone/issues/2469:\n \"Subobjects are indexing attributes of parent\".\n Allow only direct attributes and acquired PythonScripts,\n but not acquired attributes.\n Indexers and PythonScripts are able to handle this explicitly,\n because they get the acquisition-wrapped object.\n [jensens]\n\n- Fix tests to work in Python 3\n [pbauer]\n\n\n1.0.4 (2016-02-25)\n------------------\n\nFixes:\n\n- Replace deprecated ``zope.testing.doctestunit`` import with ``doctest``\n module from stdlib.\n [thet]\n\n- Reformat according to the Plone styleguide.\n [thet]\n\n\n1.0.3 (2015-05-05)\n------------------\n\n- Add missing dependency on Products.ZCatalog.\n [gforcada]\n\n\n1.0.2 (2013-01-13)\n------------------\n\n- Changed the @indexer decorator to maintain the information about the wrapped\n function (__doc__, __module__, __name__, etc).\n [dokai]\n\n\n1.0.1 (2012-12-14)\n------------------\n\n- Relicense under modified BSD license; per Plone Foundation board\n approval on 2012-05-31.\n See: http://plone.org/foundation/materials/foundation-resolutions/plone-framework-components-relicensing-policy\n [supton]\n\n- Add MANIFEST.in.\n [WouterVH]\n\n\n1.0 - 2010-07-18\n----------------\n\n- Fixed reSt markup in the changelog.\n [hannosch]\n\n- Update license to GPL version 2 only.\n [hannosch]\n\n\n1.0rc2 - 2009-04-05\n-------------------\n\n- Added _getWrappedObject() method to get hold of the underlying object.\n Note that this means you can't have an index/metadata column with this name.\n [optilude]\n\n- Corrected IZCatalog import location to point to the interfaces module.\n [hannosch]\n\n\n1.0rc1 - 2009-03-26\n-------------------\n\n- Updated the interface to match the developments of similar functionality\n on CMF trunk. This means that indexers are now multi-adapters on\n (object, catalog), and the keyword arguments (including the implicit\n 'portal' parameter) are gone.\n [optilude]\n\n\n1.0a1 - 2009-03-05\n------------------\n\n- Initial release\n\n\nWriting indexers\n================\n\nAn indexer is a named adapter that adapts the type of an object and provides a value to be indexed when the catalog attempts to index the attribute with that name.\n\nFor example, let's say we have two types, page and news item::\n\n >>> from zope.interface import Interface\n >>> from zope.interface import implementer\n >>> from zope import schema\n\n >>> class IPage(Interface):\n ... text = schema.Text(title=u\"Body text\")\n\n >>> @implementer(IPage)\n ... class Page(object):\n ... def __init__(self, text):\n ... self.text = text\n\n >>> class INewsItem(Interface):\n ... summary = schema.TextLine(title=u\"Short summary\")\n ... story = schema.Text(title=u\"Body text\")\n ... audience = schema.TextLine(title=u\"Audience\")\n\n >>> @implementer(INewsItem)\n ... class NewsItem(object):\n ... def __init__(self, summary, story, audience):\n ... self.summary = summary\n ... self.story = story\n ... self.audience = audience\n\nNow, pretend that our catalog had an index 'description', which for a page should contain the first 10 characters from the body text, and for a news item should contain the contents of the 'summary' field.\nFurthermore, there is an index 'audience' that should contain the value of the corresponding field for news items, in all uppercase.\nIt should do nothing for pages.\n\nWe could write indexers for all of these like this::\n\n >>> from plone.indexer import indexer\n\n >>> @indexer(IPage)\n ... def page_description(object):\n ... return object.text[:10]\n\n >>> @indexer(INewsItem)\n ... def newsitem_description(object):\n ... return object.summary\n\n >>> @indexer(INewsItem)\n ... def newsitem_audience(object):\n ... return object.audience.upper()\n\nThese need to be registered as named adapters, where the name corresponds to the index name.\nIn ZCML, that may be::\n\n <adapter name=\"description\" factory=\".indexers.page_description\" />\n <adapter name=\"description\" factory=\".indexers.newsitem_description\" />\n <adapter name=\"audience\" factory=\".indexers.newsitem_audience\" />\n\nWe can omit the 'for' attribute because we passed this to the @indexer decorator, and we can omit the 'provides' attribute because the thing returned by the decorator is actually a class providing the required IIndexer interface.\n\nFor the purposes of the ensuing tests, we'll register these directly::\n\n >>> from zope.component import provideAdapter\n >>> provideAdapter(page_description, name='description')\n >>> provideAdapter(newsitem_description, name='description')\n >>> provideAdapter(newsitem_audience, name='audience')\n\n\nTesting your indexers (or calling them directly)\n------------------------------------------------\n\nIf you are writing tests for your indexers (as you should!), then you should be aware of the following:\n\nWhen the @indexer decorator returns, it turns your function into an instance of type DelegatingIndexerFactory.\nThis is an adapter factory that can create a DelegatingIndexer, which in turn will call your function when asked to perform indexing operations.\n\nThis means that you can't just call your function to test the indexer.\nInstead, you need to instantiate the adapter and then call the delegating indexer with the portal root as the first argument.\nFor example::\n\n >>> test_page = Page(text=u\"My page with some text\")\n >>> page_description(test_page)()\n 'My page wi'\n\nThis will suffice in most cases.\nNote that there is actually a second parameter, catalog, which defaults to None.\nIf you need to write an indexer that acts on catalog, you'll need to register a conventional adapter, as described in the next section.\n\n\nOther means of registering indexers\n-----------------------------------\n\nAt the end of the day, an indexer is just a named multi-adapter from the indexable object (e.g.\nINewsItem or IPage above) and the catalog (usually portal_catalog in a CMF application) to IIndexer, where the name is the name of the indexed attribute in the catalog.\nThus, you could register your indexers as more conventional adapters::\n\n >>> from plone.indexer.interfaces import IIndexer\n >>> from Products.ZCatalog.interfaces import IZCatalog\n >>> from zope.component import adapter\n >>> from zope.interface import implementer\n\n >>> @implementer(IIndexer)\n ... @adapter(IPage, IZCatalog)\n ... class LengthIndexer(object):\n ... \"\"\"Index the length of the body text\n ... \"\"\"\n ... def __init__(self, context, catalog):\n ... self.context = context\n ... self.catalog = catalog\n ...\n ... def __call__(self):\n ... return len(self.context.text)\n\nWe normally just use IZCatalog for the catalog adaptation, to apply to any catalog.\nHowever, if you want different indexers for different types of catalogs, there is an example later in this test.\n\nYou'd register this with ZCML like so::\n\n <adapter factory=\".indexers.LengthIndexer\" name=\"length\" />\n\nOr in a test::\n\n >>> provideAdapter(LengthIndexer, name=\"length\")\n\nIf you're only curious about how to write indexers, you can probably stop here.\nIf you want to know more about how they work and how they are wired into a framework, read on.\n\n\nHooking up indexers to the framework\n=====================================\n\nHere is a mock implementation of a ZCatalog.catalog_object() override, based on the one in Plone.\nWe'll use this for testing.\nWe won't bother with the full ZCatalog interface, only catalog_object(), and we'll stub out a few things.\nThis really is for illustration purposes only, to show the intended usage pattern.\n\nIn CMF 2.2, there is an IIndexableObject marker interface defined in Products.CMFCore.interfaces.\nWe have a compatibility alias in this package for use with CMF 2.1.\n\n::\n\n >>> from OFS.interfaces import IItem\n >>> from plone.indexer.interfaces import IIndexableObject\n >>> from Products.ZCatalog.interfaces import IZCatalog\n >>> from zope.component import queryMultiAdapter\n\n >>> @implementer(IZCatalog, IItem)\n ... class FauxCatalog(object):\n ...\n ... def catalog_object(self, object, uid, idxs=[]):\n ... \"\"\"Pretend to index 'object' under the key 'uid'. We'll\n ... print the results of the indexing operation to the screen .\n ... \"\"\"\n ...\n ... if not IIndexableObject.providedBy(object):\n ... wrapper = queryMultiAdapter((object, self,), IIndexableObject)\n ... if wrapper is not None:\n ... object = wrapper\n ...\n ... # Perform the actual indexing of attributes in the idxs list\n ... for idx in idxs:\n ... try:\n ... indexed_value = getattr(object, idx)\n ... if callable(indexed_value):\n ... indexed_value = indexed_value()\n ... print(\"{0} = {1}\".format(idx, indexed_value))\n ... except (AttributeError, TypeError,):\n ... pass\n\nThe important things here are:\n\n - We attempt to obtain an IIndexableObject for the object to be indexed.\n This is just a way to get hold of an implementation of this interface (we'll register one in a moment) and allow some coarse-grained overrides.\n\n - Cataloging involves looking up attributes on the indexable object wrapper matching the names of indexes (in the real ZCatalog, this is actually decoupled, but let's not get carried away).\n If they are callable, they should be called.\n This is just mimicking what ZCatalog's implementation does.\n\nThis package comes with an implementation of an IIndexableObject adapter that knows how to delegate to an IIndexer.\nLet's now register that as the default IIndexableObject wrapper adapter so that the code above will find it::\n\n >>> from plone.indexer.interfaces import IIndexableObject\n >>> from plone.indexer.wrapper import IndexableObjectWrapper\n >>> provideAdapter(factory=IndexableObjectWrapper, adapts=(Interface, IZCatalog,), provides=IIndexableObject)\n\nSeeing it in action\n===================\n\nNow for the testing. First, we need a faux catalog::\n\n >>> catalog = FauxCatalog()\n\nFinally, let's create some objects to index::\n\n >>> page = Page(u\"The page body text here\")\n >>> news = NewsItem(u\"News summary\", u\"News body text\", u\"Audience\")\n\nFirst of all, let's demonstrate that our indexers work and apply only to the types for which they are registered::\n\n >>> catalog.catalog_object(page, 'p1', idxs=['description', 'audience', 'length'])\n description = The page b\n length = 23\n\n >>> catalog.catalog_object(news, 'n1', idxs=['description', 'audience', 'length'])\n description = News summary\n audience = AUDIENCE\n\nOur custom indexable object wrapper is capable of looking up workflow variables if the portal_workflow tool is available.\nFor testing purposes, we'll create a fake minimal workflow tool and stash it onto the fake catalog so that it can be found by getToolByName.\nIn real life, it would of course be acquirable as normal::\n\n >>> @implementer(IItem)\n ... class FauxWorkflowTool(object):\n ... def getCatalogVariablesFor(self, object):\n ... return dict(review_state='published', audience='Somebody')\n >>> catalog.portal_workflow = FauxWorkflowTool()\n\nIf we now index 'review_state', it will be obtained from the workflow variables.\nHowever, a custom indexer still overrides workflow variables::\n\n >>> catalog.catalog_object(news, 'n1', idxs=['description', 'audience', 'review_state'])\n description = News summary\n audience = AUDIENCE\n review_state = published\n\nFinally, if not adapter can be found, we fall back on getattr() on the object::\n\n >>> catalog.catalog_object(page, 'p3', idxs=['description', 'text'])\n description = The page b\n text = The page body text here\n\n\nCustomising indexers based on the catalog type\n==============================================\n\nIt is possible to provide a custom indexer for a different type of catalog.\nTo test that, let's create a secondary catalog and mark it with a marker interface::\n\n >>> from zope.interface import Interface\n >>> class IAlternateCatalog(Interface):\n ... pass\n >>> from zope.interface import alsoProvides\n >>> catalog2 = FauxCatalog()\n >>> alsoProvides(catalog2, IAlternateCatalog)\n\nLet's say that we did not want the news item audience uppercased here.\nWe could provide a custom indexer for just this catalog::\n\n >>> @indexer(INewsItem, IAlternateCatalog)\n ... def alternate_newsitem_audience(object):\n ... return object.audience.lower()\n >>> provideAdapter(alternate_newsitem_audience, name='audience')\n\nThis does not affect the first catalog::\n\n >>> catalog.catalog_object(news, 'n1', idxs=['description', 'audience', 'length'])\n description = News summary\n audience = AUDIENCE\n\nHowever, the second catalog gets the audience in lowercase::\n\n >>> catalog2.catalog_object(news, 'n1', idxs=['description', 'audience', 'length'])\n description = News summary\n audience = audience\n\n\nInterfaces provided by the wrapper\n==================================\n\nThe indexable object wrapper has one particular feature: instances of the wrapper will provide the same interfaces as instances of the wrapped object.\nFor example::\n\n >>> from plone.indexer.interfaces import IIndexableObject\n >>> from plone.indexer.interfaces import IIndexableObjectWrapper\n\n >>> wrapper = IndexableObjectWrapper(page, catalog)\n >>> IIndexableObjectWrapper.providedBy(wrapper)\n True\n >>> IIndexableObject.providedBy(wrapper)\n True\n >>> IPage.providedBy(wrapper)\n True\n >>> INewsItem.providedBy(wrapper)\n False\n\n >>> wrapper = IndexableObjectWrapper(news, catalog)\n >>> IIndexableObjectWrapper.providedBy(wrapper)\n True\n >>> IPage.providedBy(wrapper)\n False\n >>> INewsItem.providedBy(wrapper)\n True\n\n\nUnboxing\n========\n\nIt is possible to obtain the wrapped object from the wrapper::\n\n >>> wrapper = IndexableObjectWrapper(page, catalog)\n >>> wrapper._getWrappedObject() is page\n True\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Hooks to facilitate managing custom index values in Zope 2/CMF applications",
"version": "2.0.1",
"project_urls": {
"Homepage": "https://pypi.org/project/plone.indexer"
},
"split_keywords": [
"plone",
"cmf",
"zope",
"catalog",
"index"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d2b32f29c8cd7ea90dd751ac8bbe59734135f73955eb8f48fdcec49c6a9b3801",
"md5": "006d707a1dcab0ca046bb6d1d73017b2",
"sha256": "85e8c6f38fb06e48b46849d6ae1b85e9bda3ec6bb3572a70e473ab0e7ceb2d4e"
},
"downloads": -1,
"filename": "plone.indexer-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "006d707a1dcab0ca046bb6d1d73017b2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15197,
"upload_time": "2024-01-22T19:38:04",
"upload_time_iso_8601": "2024-01-22T19:38:04.290679Z",
"url": "https://files.pythonhosted.org/packages/d2/b3/2f29c8cd7ea90dd751ac8bbe59734135f73955eb8f48fdcec49c6a9b3801/plone.indexer-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b099513f61019848b637d15a5b782e2d2a65e490efee3992a5dcfcbde837a3d2",
"md5": "71cca19244e5cf205f386e11439ee349",
"sha256": "4c962c500f214cbcad6fa5a50604d5c70adbf11c981fae0fa8a2ea8a7f788701"
},
"downloads": -1,
"filename": "plone.indexer-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "71cca19244e5cf205f386e11439ee349",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 17021,
"upload_time": "2024-01-22T19:38:06",
"upload_time_iso_8601": "2024-01-22T19:38:06.408484Z",
"url": "https://files.pythonhosted.org/packages/b0/99/513f61019848b637d15a5b782e2d2a65e490efee3992a5dcfcbde837a3d2/plone.indexer-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-22 19:38:06",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "plone.indexer"
}
JSON