Source code for zope.site.site

##############################################################################
#
# Copyright (c) 2001, 2002 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
"""Site and Local Site Manager implementation

A local site manager has a number of roles:

  - A local site manager, that provides a local adapter and utility registry.

  - A place to do TTW development and/or to manage database-based code.

  - A registry for persistent modules.  The Zope 3 import hook uses the
    SiteManager to search for modules.
"""

import zope.component
import zope.component.hooks
import zope.component.interfaces
import zope.event
import zope.interface
import zope.lifecycleevent.interfaces
import zope.location
import zope.location.interfaces
from zope.component.hooks import setSite
from zope.component.interfaces import ISite
from zope.component.persistentregistry import PersistentAdapterRegistry
from zope.component.persistentregistry import PersistentComponents
from zope.container.btree import BTreeContainer
from zope.container.contained import Contained
from zope.deprecation import deprecated
from zope.filerepresentation.interfaces import IDirectoryFactory
from zope.interface.interfaces import ComponentLookupError
from zope.interface.interfaces import IComponentLookup
from zope.lifecycleevent import ObjectCreatedEvent
from zope.location.interfaces import ILocationInfo
from zope.location.interfaces import IRoot

from zope.site import interfaces


# BBB. Remove in Version 5.0 including imports
setSite = deprecated(
    setSite,
    '``zope.site.site.setSite`` is deprecated '
    'and will be removed in zope.site Version 5.0. '
    'Use it from ``zope.component.hooks`` instead.')  # noqa


[docs]@zope.interface.implementer(interfaces.ISiteManagementFolder) class SiteManagementFolder(BTreeContainer): """Implementation of a :class:`~.ISiteManagementFolder`"""
[docs]@zope.interface.implementer(IDirectoryFactory) class SMFolderFactory: """ Implementation of a :class:`~.IDirectoryFactory` that creates :class:`SiteManagementFolder` """ def __init__(self, context): self.context = context def __call__(self, name): return SiteManagementFolder()
[docs]@zope.interface.implementer(zope.component.interfaces.IPossibleSite) class SiteManagerContainer(Contained): """Implement access to the site manager (++etc++site). This is a mix-in that implements the :class:`~.IPossibleSite` interface; for example, it is used by the Folder implementation. """ _sm = None def getSiteManager(self): if self._sm is not None: return self._sm raise ComponentLookupError('no site manager defined') def setSiteManager(self, sm): # pylint:disable=no-value-for-parameter if ISite.providedBy(self): raise TypeError("Already a site") if IComponentLookup.providedBy(sm): self._sm = sm else: raise ValueError('setSiteManager requires an IComponentLookup') zope.interface.directlyProvides( self, zope.component.interfaces.ISite, zope.interface.directlyProvidedBy(self)) zope.event.notify(interfaces.NewLocalSite(sm))
def _findNextSiteManager(site): while True: if IRoot.providedBy(site): # pylint:disable=no-value-for-parameter # we're the root site, return None return None try: # pylint:disable=no-value-for-parameter, too-many-function-args # pylint:disable=assignment-from-no-return site = ILocationInfo(site).getParent() except TypeError: # there was not enough context; probably run from a test return None if ISite.providedBy(site): # pylint:disable=no-value-for-parameter return site.getSiteManager() class _LocalAdapterRegistry( PersistentAdapterRegistry, zope.location.Location, ): pass
[docs]@zope.interface.implementer(interfaces.ILocalSiteManager) class LocalSiteManager(BTreeContainer, PersistentComponents): """Local Site Manager (:class:`~.ILocalSiteManager`) implementation""" subs = () def _setBases(self, bases): # Update base subs for base in self.__bases__: if ((base not in bases) # pragma: no cover # pylint:disable=no-value-for-parameter and interfaces.ILocalSiteManager.providedBy(base)): base.removeSub(self) for base in bases: if ((base not in self.__bases__) # pylint:disable=no-value-for-parameter and interfaces.ILocalSiteManager.providedBy(base)): base.addSub(self) super()._setBases(bases) def __init__(self, site, default_folder=True): BTreeContainer.__init__(self) PersistentComponents.__init__(self) # Locate the site manager self.__parent__ = site self.__name__ = '++etc++site' # Set base site manager next_sm = _findNextSiteManager(site) if next_sm is None: next_sm = zope.component.getGlobalSiteManager() self.__bases__ = (next_sm, ) # Setup default site management folder if requested if default_folder: folder = SiteManagementFolder() zope.event.notify(ObjectCreatedEvent(folder)) self['default'] = folder def _init_registries(self): self.adapters = _LocalAdapterRegistry() self.utilities = _LocalAdapterRegistry() self.adapters.__parent__ = self.utilities.__parent__ = self self.adapters.__name__ = 'adapters' self.utilities.__name__ = 'utilities' def _p_repr(self): return PersistentComponents.__repr__(self)
[docs] def addSub(self, sub): """See :meth:`zope.site.interfaces.ILocalSiteManager.addSub`""" self.subs += (sub, )
[docs] def removeSub(self, sub): """See :meth:`zope.site.interfaces.ILocalSiteManager.removeSub`""" self.subs = tuple( [s for s in self.subs if s is not sub])
[docs]def threadSiteSubscriber(ob, event): """A multi-subscriber to `zope.component.interfaces.ISite` and `zope.traversing.interfaces.BeforeTraverseEvent`. Sets the 'site' thread global if the object traversed is a site. .. note:: The ``configure.zcml`` included in this package does *not* install this subscriber. That must be configured separately. ``zope.app.publication`` includes such configuration. """ zope.component.hooks.setSite(ob)
[docs]def clearThreadSiteSubscriber(event): """A subscriber to `zope.publisher.interfaces.EndRequestEvent` Cleans up the site thread global after the request is processed. .. note:: The ``configure.zcml`` included in this package does *not* install this subscriber. That must be configured separately. ``zope.app.publication`` includes such configuration. """ clearSite()
# Clear the site thread global clearSite = zope.component.hooks.setSite try: from zope.testing.cleanup import addCleanUp except ImportError: # pragma: no cover pass else: addCleanUp(clearSite)
[docs]@zope.component.adapter(zope.interface.Interface) @zope.interface.implementer(IComponentLookup) def SiteManagerAdapter(ob): """An adapter from :class:`~.ILocation` to :class:`~.IComponentLookup`. The ILocation is interpreted flexibly, we just check for ``__parent__``. """ current = ob while True: if ISite.providedBy(current): # pylint:disable=no-value-for-parameter return current.getSiteManager() current = getattr(current, '__parent__', None) if current is None: # It is not a location or has no parent, so we return the global # site manager return zope.component.getGlobalSiteManager()
[docs]def changeSiteConfigurationAfterMove(site, event): """ After a site is (re-)moved, its site manager links have to be updated. Subscriber to :class:`~.ISite` objects in a :class:`~.IObjectMovedEvent`. """ local_sm = site.getSiteManager() if event.newParent is not None: next_sm = _findNextSiteManager(site) if next_sm is None: next_sm = zope.component.getGlobalSiteManager() local_sm.__bases__ = (next_sm, ) else: local_sm.__bases__ = ()
@zope.component.adapter( SiteManagerContainer, zope.lifecycleevent.interfaces.IObjectMovedEvent) def siteManagerContainerRemoved(container, event): # The relation between SiteManagerContainer and LocalSiteManager is a # kind of containment hierarchy, but it is not expressed via containment, # but rather via an attribute (_sm). # # When the parent is deleted, this needs to be propagated to the children, # and since we don't have "real" containment, we need to do that manually. try: sm = container.getSiteManager() except ComponentLookupError: pass else: zope.component.handle(sm, event)