Index of /ports/www/zope210/work/Zope-2.10.5-final/lib/python/zope/app/zapi

      Name                    Last modified       Size  Description


[DIR] Parent Directory        29-Oct-2007 06:39      -  
[   ] configure.zcml          29-Oct-2007 06:12     1k  
[   ] tests.py                29-Oct-2007 06:12     2k  
[   ] __init__.py             29-Oct-2007 06:12     2k  
[   ] interfaces.py           29-Oct-2007 06:12     2k  

Zope Application Programming Interface
======================================

This package provides a collection of commonly used APIs to make
imports simpler.

Mostly, the APIs provided here are imported from elsewhere. A few are
provided here.

principals()
------------

The principals method returns the authentication service. If no
service is defined, a ComponentLookupError is raised:

  >>> from zope.app import zapi
  >>> zapi.principals() #doctest: +NORMALIZE_WHITESPACE
  Traceback (most recent call last):
  ...
  ComponentLookupError:
  (<InterfaceClass zope.app.security.interfaces.IAuthentication>, '')


But if we provide an authentication service:

  >>> import zope.interface
  >>> from zope.app.security.interfaces import IAuthentication
  >>> class FakeAuthenticationUtility:
  ...     zope.interface.implements(IAuthentication)
  >>> fake = FakeAuthenticationUtility()

  >>> from zope.app.testing import ztapi
  >>> ztapi.provideUtility(IAuthentication, fake)

Then we should be able to get the service back when we ask for the
principals:

  >>> zapi.principals() is fake
  True