repoze.bfg.traversalwrapper

An alternate implementation of the repoze.bfg.interfaces.ITraverserFactory (a “traverser”) which wraps each traversed object in a proxy. This allows a “location-ignorant” model (a model which does not possess intrinsic __name__ and __parent__ attributes) to be used as the root object and as any object returned from any other model’s __getitem__ method during traversal.

When this ITraverserFactory is registered as the traverser for a repoze.bfg application, during traversal, each object, including the root object is wrapped in a proxy. The proxy that provides the traversed object with a __name__ and __parent__ attribute. The __name__ and __parent__ attributes of the root proxy are both None. The __name__ of subsequently traversed object is the Unicode URL segment name which was used to look it up. The __parent__ of subsequently traversed objects is the previous object traversed.

In order to enable this package’s ITraverserFactory, register the repoze.bfg.traversalwrapper.ModelGraphTraverser as the traversal policy, rather than the default ModelGraphTraverser. To use this feature, your application will need to have a dependency on this package, as well as following stanza in its configure.zcml:

<adapter
    factory="repoze.bfg.traversalwrapper.ModelGraphTraverser"
    provides="repoze.bfg.interfaces.ITraverserFactory"
    for="*"
    />

repoze.bfg.traversalwrapper Changelog