FM / docs

/usr/share/doc/python3-zope-interface/docs/

/usr/share/doc/python3-zope-interface/docs

Name	Size	Mode	Actions
api/	-	0755	rm
_static/	-	0755	rm
adapter.rst	16503	0644	edit dl rm
adapter.ru.rst	21169	0644	edit dl rm
changes.rst	28	0644	edit dl rm
conf.py	8611	0644	edit dl rm
foodforthought.rst	1742	0644	edit dl rm
hacking.rst	9509	0644	edit dl rm
human.rst	6543	0644	edit dl rm
human.ru.rst	10681	0644	edit dl rm
index.rst	639	0644	edit dl rm
make.bat	5110	0644	edit dl rm
Makefile	5592	0644	edit dl rm
README.rst	25139	0644	edit dl rm
README.ru.rst	33981	0644	edit dl rm
verify.rst	3612	0644	edit dl rm

Edit: /usr/share/doc/python3-zope-interface/docs/foodforthought.rst (1742B)

================================
Food-based subscription examples
================================

This file gives more subscription examples using a cooking-based example:

.. doctest::

>>> from zope.interface.adapter import AdapterRegistry
    >>> registry = AdapterRegistry()

>>> import zope.interface
    >>> class IAnimal(zope.interface.Interface):
    ...     pass
    >>> class IPoultry(IAnimal):
    ...     pass
    >>> class IChicken(IPoultry):
    ...     pass
    >>> class ISeafood(IAnimal):
    ...     pass

Adapting to some other interface for which there is no
subscription adapter returns an empty sequence:

.. doctest::

>>> class IRecipe(zope.interface.Interface):
    ...     pass
    >>> class ISausages(IRecipe):
    ...     pass
    >>> class INoodles(IRecipe):
    ...     pass
    >>> class IKFC(IRecipe):
    ...     pass

>>> list(registry.subscriptions([IPoultry], IRecipe))
    []

unless we define a subscription:

.. doctest::

>>> registry.subscribe([IAnimal], ISausages, 'sausages')
    >>> list(registry.subscriptions([IPoultry], ISausages))
    ['sausages']

And define another subscription adapter:

.. doctest::

>>> registry.subscribe([IPoultry], INoodles, 'noodles')
    >>> meals = list(registry.subscriptions([IPoultry], IRecipe))
    >>> meals.sort()
    >>> meals
    ['noodles', 'sausages']

>>> registry.subscribe([IChicken], IKFC, 'kfc')
    >>> meals = list(registry.subscriptions([IChicken], IRecipe))
    >>> meals.sort()
    >>> meals
    ['kfc', 'noodles', 'sausages']

And the answer for poultry hasn't changed:

.. doctest::

>>> meals = list(registry.subscriptions([IPoultry], IRecipe))
    >>> meals.sort()
    >>> meals
    ['noodles', 'sausages']

================================ Food-based subscription examples ================================ This file gives more subscription examples using a cooking-based example: .. doctest:: >>> from zope.interface.adapter import AdapterRegistry >>> registry = AdapterRegistry() >>> import zope.interface >>> class IAnimal(zope.interface.Interface): ... pass >>> class IPoultry(IAnimal): ... pass >>> class IChicken(IPoultry): ... pass >>> class ISeafood(IAnimal): ... pass Adapting to some other interface for which there is no subscription adapter returns an empty sequence: .. doctest:: >>> class IRecipe(zope.interface.Interface): ... pass >>> class ISausages(IRecipe): ... pass >>> class INoodles(IRecipe): ... pass >>> class IKFC(IRecipe): ... pass >>> list(registry.subscriptions([IPoultry], IRecipe)) [] unless we define a subscription: .. doctest:: >>> registry.subscribe([IAnimal], ISausages, 'sausages') >>> list(registry.subscriptions([IPoultry], ISausages)) ['sausages'] And define another subscription adapter: .. doctest:: >>> registry.subscribe([IPoultry], INoodles, 'noodles') >>> meals = list(registry.subscriptions([IPoultry], IRecipe)) >>> meals.sort() >>> meals ['noodles', 'sausages'] >>> registry.subscribe([IChicken], IKFC, 'kfc') >>> meals = list(registry.subscriptions([IChicken], IRecipe)) >>> meals.sort() >>> meals ['kfc', 'noodles', 'sausages'] And the answer for poultry hasn't changed: .. doctest:: >>> meals = list(registry.subscriptions([IPoultry], IRecipe)) >>> meals.sort() >>> meals ['noodles', 'sausages']