five.localsitemanager 2.0

Overview

five.localsitemanager attempts to provide a local site manager implementation that is as close to the zope.interface / zope.component implementation as possible. Some reservations that do not conflict with the original API have been made to ease the path with CMF.

Developer Resources

• Subversion browser:

  http://svn.zope.org/five.localsitemanager

Prerequisites

• Zope 2.12.x or newer

Installation

Add five.localsitemanager to either your buildout’s global eggs list or to the appropriate instance specific parts.

Configuration

Place a five.localsitemanager-configure.zcml file into your instance’s etc/package-includes directory with the following contents:

<include package="five.localsitemanager" />

Also setup a five.localsitemanager-overrides.zcml file into your instance’s etc/package-includes directory with the following contents:

<include package="five.localsitemanager" file="overrides.zcml" />

Running the Tests

Use the following command to run this package’s tests:

$ bin/test -s five.localsitemanager

2.0 - 2009-09-27

• Cleaned up package documentation and fixed spelling errors in the tests. [hannosch]

• Made sure that the __of__ method is only called on objects providing the IAcquirer interface. [hannosch]

• Updated forked registerUtility method to match the zope.component 3.7.1 code base. This fixes the two bugs with the implicit unregistration of utilities for existing interface / name pairs. [hannosch]

• Simplified some code, aq_parent now respects __parent__ pointers. [hannosch]

2.0a1 - 2009-05-27

• Updated to use IObjectMovedEvent from zope.lifecycleevent instead of zope.container. We require zope.lifecycleevent >= 3.5.2 now. [hannosch]

• Removed package dependencies that did collide with the KGS of Zope 2.12. [yuppie]

• Adjusted code to use the new zope.site and zope.container packages and use the ISite interface from zope.location. [hannosch]

• Specify all package dependencies including Acquisition and Zope2. You need to use either the eggified Zope 2.12 or create fake-eggs for these. [hannosch]

• ‘make_site’ no longer stores the path of the site manager in its name. This way the name can’t become out-dated. PersistentComponents’ __repr__ method now returns the current path instead of the name of the site manager. [yuppie]

• Requiring zope.component >= 3.5.0. [icemac]

1.0 - 2008-11-18

• Utilities registered with an absolute path were returned with the RequestContainer in the aq_chain. As the result of the first utility look-up is stored in the adapter look-up cache, subsequent utility look-ups return the utlitiy with the RequestContainer of the first look-up.

  Solution: For utilities registered with an absolute path the RequestContainer is now also removed at look-up. [icemac]

1.0c1 - 2008-08-27

• Added buildout for project, so testing can be done using bin/test. [icemac]

• Added ability to register utilities with an absolute path. These utilities are returned wrapped into their original context. This change is backward compatible to existing registries.

  But registering utilities having an acquisition context will behave different because these utilities will be returned in their original context. To restore the previous behavior, register utilities unwrapped (aq_base).

  For storing path information the component must implement getPhysicalPath and have an absolute path.

  When a component registered as utility is moved and registered again the path stored in registry gets updated. [icemac]

0.4 - 2008-07-23

• Rewrite PersistentComponents.registeredUtilities to not use internal methods. This makes it compatible with both zope.component <3.5.0dev and >3.5.0dev. [wichert]

0.3 - 2007-12-24

• Fixed potential aq problem when assigning various values to the utilities registry of the component registry. [hannosch]

0.2 - 2007-06-30

• Refactored and fixed aq wrapping: Nested site managers now return utilities wrapped in the right context. RequestContainers are removed and wrapped utilities are cached. This requires a special LookupClass called ‘FiveVerifyingAdapterLookup’ in all ‘utilities’ registries used below a five.localsitemanager site. [yuppie, hannosch]

0.1.2 - 2007-06-23

• Corrected the zip-safe flag to be False.

0.1.1 - 2007-03-05

• Fixed aq wrapping when looking up a utility that is actually the component registry’s parent (the ISite).

0.1 (2007-02-27)

• Initial version