z3c.proxy 0.6.1

ObjectMover

要使用对象移动器，将包含的 对象 传递给类。包含的 对象 应实现 IContained。它应包含在一个具有 INameChooser 适配器的容器中。

设置测试容器和代理

>>> from zope.interface import implements
>>> from zope.container.interfaces import INameChooser
>>> from zope.copypastemove import ExampleContainer
>>> from z3c.proxy.container import ProxyAwareObjectMover

>>> class ContainerLocationProxyStub(ContainerLocationProxy):
...
...     implements(INameChooser)
...
...     def chooseName(self, name, ob):
...        while name in self:
...            name += '_'
...        return name

>>> container = ExampleContainer()
>>> container2 = ExampleContainer()

>>> ob = Contained()
>>> proxy = ContainerLocationProxyStub(container)
>>> proxy[u'foo'] = ob
>>> ob = proxy[u'foo']
>>> mover = ProxyAwareObjectMover(ob)

除了移动对象之外，对象移动器还可以告诉您对象是否可移动

>>> mover.moveable()
1

至少到目前为止，它们总是是这样的。一个更好的问题是，我们是否可以移动到特定的容器。目前，我们总是可以移动到同一类的容器

>>> proxy2 = ContainerLocationProxyStub(container2)
>>> mover.moveableTo(proxy2)
1

>>> mover.moveableTo({})
Traceback (most recent call last):
...
TypeError: Container is not a valid Zope container.

当然，一旦我们决定可以移动一个对象，我们就可以使用移动器来这样做

>>> mover.moveTo(proxy2)
u'foo'

>>> list(proxy)
[]

>>> list(proxy2)
[u'foo']

>>> ob = proxy2[u'foo']
>>> ob.__parent__ is proxy2
True

我们还可以指定一个名称

>>> mover.moveTo(proxy2, u'bar')
u'bar'

>>> list(proxy2)
[u'bar']

>>> ob = proxy2[u'bar']
>>> ob.__parent__ is proxy2
True

>>> ob.__name__
u'bar'

但如果该名称已被使用，我们可能不能使用给定的相同名称

>>> proxy2[u'splat'] = 1
>>> mover.moveTo(proxy2, u'splat')
u'splat_'

>>> l = list(proxy2)
>>> l.sort()
>>> l
[u'splat', u'splat_']

>>> ob = proxy2[u'splat_']
>>> ob.__name__
u'splat_'

如果我们尝试移动到无效的容器，我们将得到一个错误

>>> mover.moveTo({})
Traceback (most recent call last):
...
TypeError: Container is not a valid Zope container.

ObjectCopier

要使用对象复制器，将包含的 对象 传递给类。包含的 对象 应该实现 IContained。它应该包含在一个具有适配器到 INameChooser 的容器中。

设置测试容器和代理

>>> from z3c.proxy.container import ProxyAwareObjectCopier
>>> class ContainerLocationProxyStub(ContainerLocationProxy):
...
...     implements(INameChooser)
...
...     def chooseName(self, name, ob):
...        while name in self:
...            name += '_'
...        return name

>>> container = ExampleContainer()
>>> container2 = ExampleContainer()

>>> proxy = ContainerLocationProxyStub(container)
>>> proxy[u'foo'] = ob = Contained()
>>> ob = proxy[u'foo']
>>> copier = ProxyAwareObjectCopier(ob)

除了移动对象，对象复制器还可以告诉你对象是否可以移动

>>> copier.copyable()
1

至少到目前为止，它们总是是这样的。一个更好的问题是，我们是否可以将对象复制到特定的容器。目前，我们总是可以将对象复制到同一类的容器

>>> proxy2 = ContainerLocationProxyStub(container2)
>>> copier.copyableTo(proxy2)
1

>>> copier.copyableTo({})
Traceback (most recent call last):
...
TypeError: Container is not a valid Zope container.

当然，一旦我们决定可以复制一个对象，我们就可以使用复制器来这样做

>>> copier.copyTo(proxy2)
u'foo'

>>> list(proxy)
[u'foo']

>>> list(proxy2)
[u'foo']

>>> ob.__parent__ is proxy
1

>>> proxy2[u'foo'] is ob
0

>>> proxy2[u'foo'].__parent__ is proxy2
1

>>> proxy2[u'foo'].__name__
u'foo'

我们还可以指定一个名称

>>> copier.copyTo(proxy2, u'bar')
u'bar'

>>> l = list(proxy2)
>>> l.sort()
>>> l
[u'bar', u'foo']

>>> ob.__parent__ is proxy
1

>>> proxy2[u'bar'] is ob
0

>>> proxy2[u'bar'].__parent__ is proxy2
1

>>> proxy2[u'bar'].__name__
u'bar'

但如果该名称已被使用，我们可能不能使用给定的相同名称

>>> copier.copyTo(proxy2, u'bar')
u'bar_'

>>> l = list(proxy2)
>>> l.sort()
>>> l
[u'bar', u'bar_', u'foo']

>>> proxy2[u'bar_'].__name__
u'bar_'

如果我们尝试复制到无效的容器，我们将得到一个错误

>>> copier.copyTo({})
Traceback (most recent call last):
...
TypeError: Container is not a valid Zope container.

ProxyAwareContainerItemRenamer

此适配器使用 IObjectMover 将同一容器内的项目移动到不同的名称。我们需要首先设置一个 IObjectMover 的适配器

设置测试容器和代理

>>> from zope.container.sample import SampleContainer
>>> from zope.copypastemove import ContainerItemRenamer
>>> from zope.copypastemove import IObjectMover
>>> from z3c.proxy.container import ProxyAwareContainerItemRenamer

>>> import zope.component
>>> from zope.container.interfaces import IContained
>>> zope.component.provideAdapter(ProxyAwareObjectMover, [IContained],
...     IObjectMover)

>>> class ContainerLocationProxyStub(ContainerLocationProxy):
...
...     implements(INameChooser)
...
...     def chooseName(self, name, ob):
...        while name in self:
...            name += '_'
...        return name

要重命名容器中的项目，实例化一个带有容器的 ContainerItemRenamer

>>> container = SampleContainer()
>>> proxy = ContainerLocationProxyStub(container)
>>> renamer = ProxyAwareContainerItemRenamer(container)

在这个例子中，我们将项目“foo”重命名为“bar”

>>> from z3c.proxy.container import _unproxy
>>> foo = Contained()
>>> proxy['foo'] = foo
>>> proxy['foo'] == _unproxy(foo)
True

到“bar”

>>> renamer.renameItem('foo', 'bar')
>>> proxy['foo'] is foo
Traceback (most recent call last):
KeyError: 'foo'

>>> proxy['bar'] == _unproxy(foo)
True

如果被重命名的项目不在容器中，将引发 NotFoundError

>>> renamer.renameItem('foo', 'bar') # doctest:+ELLIPSIS
Traceback (most recent call last):
ItemNotFoundError: (<...SampleContainer...>, 'foo')

如果新的项目名称已存在，将引发 DuplicationError

>>> renamer.renameItem('bar', 'bar')
Traceback (most recent call last):
DuplicationError: bar is already in use

0.6.1 (2010-08-23)

• 在 long_description 中添加了 doctest 以在 PyPI 上渲染。

0.6.0 (2010-08-23)

• 用 zope.container 替换了 zope.app.container。

• 使用 Python 的 doctest 模块代替已弃用的 zope.testing.doctestunit。

0.5.0 (2008-04-12)

• 初始发布