plone.app.blob 1.8.2

概述

此软件包旨在成为Plone（>= 3.x）的插件，集成了ZODB（>=3.8）blob支持，允许大型二进制数据通过ZODB管理，但与您的常规FileStorage数据库分开，即Data.fs。这有几个优点，最重要的是大幅减小Data.fs的大小，以及在CPU和内存方面都提高了性能。

内容

状态

目前，“文件”内容的集成应该是稳定的，但仍需要进行更多的字段测试。它已经在几个生产部署中得到成功应用。提供的基于blob的内容类型可以作为ATFile的替换品安全使用。因此，它已经通过所有CMFPlone和ATContentTypes测试。请使用提供的test-compatibility.sh脚本来运行这些测试。

图像支持仍处于alpha阶段，默认情况下未启用。可以通过在门户设置工具中应用相应的配置文件来激活它。

有关集成和当前状态的更多详细信息，请参阅相应的Plone增强和Plone 4 PLIP票据。

需求

需要Plone 3.0或更高版本。该软件包已与3.0版本的所有版本以及4.0版本进行了测试。然而，由于3.0.4之前的所有版本都需要在下面的故障排除部分中描述的解决方案，建议使用Plone 3.0.4或更高版本。

安装

使用此软件包在Plone 3中获取ZODB blob支持的最简单方法是与基于zc.buildout的安装一起工作。其他类型的安装也应该是可能的，但可能会有些复杂——请参阅下面的常见问题解答部分。

要开始，您只需将软件包添加到您的“eggs”和“zcml”部分，运行buildout，重新启动您的Plone实例，并使用快速安装程序或通过“站点设置”中的“附加产品”部分安装“plone.app.blob”软件包。

一个示例buildout配置文件，例如buildout.cfg，可能看起来像这样

[buildout]
parts = zope2 instance
extends = http://dist.plone.org/release/3.3.1/versions.cfg
find-links =
    http://dist.plone.org/release/3.3.1
    http://dist.plone.org/thirdparty/
versions = versions

[versions]
ZODB3 = 3.8.3

[zope2]
recipe = plone.recipe.zope2install
url = ${versions:zope2-url}

[instance]
recipe = plone.recipe.zope2instance
zope2-location = ${zope2:location}
blob-storage = var/blobstorage
user = admin:admin
eggs =
    Plone
    plone.app.blob
zcml = plone.app.blob

您也可以使用此buildout配置来创建一个新的Plone安装。为此，您应将其保存为buildout.cfg——最好在一个空目录中，将bootstrap.py下载到同一目录中，然后执行以下命令

$ python bootstrap.py
$ ./bin/buildout
$ ./bin/instance fg

之后，您可以通过ZMI创建一个“Plone站点”，就像通常一样，在创建时选择“plone.app.blob”扩展配置文件，或者再次使用上述方法之一安装“plone.app.blob”软件包。

一个示例ZEO构建配置可能如下所示

[buildout]
parts = zope2 zeoserver instance1 instance2
extends = http://dist.plone.org/release/3.3.1/versions.cfg
find-links =
    http://dist.plone.org/release/3.3.1
    http://dist.plone.org/thirdparty/
versions = versions

[versions]
ZODB3 = 3.8.3

[zope2]
recipe = plone.recipe.zope2install
url = ${versions:zope2-url}

[zeoserver]
recipe = plone.recipe.zope2zeoserver
zope2-location = ${zope2:location}
zeo-address = 127.0.0.1:8100
zeo-var = ${buildout:directory}/var
blob-storage = ${zeoserver:zeo-var}/blobstorage
eggs = plone.app.blob

[instance1]
recipe = plone.recipe.zope2instance
zope2-location = ${zope2:location}
zeo-address = ${zeoserver:zeo-address}
blob-storage = ${zeoserver:blob-storage}
zeo-client = on
shared-blob = on
user = admin:admin
eggs =
    Plone
    plone.app.blob
zcml = plone.app.blob

[instance2]
recipe = plone.recipe.zope2instance
http-address = 8081
zope2-location = ${instance1:zope2-location}
zeo-client = ${instance1:zeo-client}
zeo-address = ${instance1:zeo-address}
blob-storage = ${instance1:blob-storage}
shared-blob = ${instance1:shared-blob}
user = ${instance1:user}
eggs = ${instance1:eggs}
zcml = ${instance1:zcml}

请注意在[client1]和[client2]中指定的配置选项 blob-storage 和 shared-blob。为了在ZEO客户端（或独立实例）上启用blob支持，您必须始终在 blob-storage 配置选项中指定一个路径。如果 shared-blob 设置为“开启”，ZEO客户端将假设可以从 blob-storage 选项中指定的路径直接读取blob文件。此路径也可能指的是网络共享，如果ZEO客户端和服务器安装在单独的机器上。但是，为了通过ZEO连接流式传输blob文件，您必须将 shared-blob 选项设置为“关闭”。在这种情况下， blob-storage 选项中指定的路径将被忽略，但仍然需要设置。

有关如何设置以及有关blob的背景信息的更详细说明，请参阅Ken Manheimer的维基。这是一个非常有用的资源，也是尝试使用blob的人的推荐读物。请注意，然而，这些说明中描述的大多数配方更改现在已经被纳入特定的配方中。

此外，有关如何使用buildout的更多信息可在附带的README.txt中找到，以及Martin在plone.org上的优秀buildout教程中。

迁移现有内容

为现有的“文件”和“图像”内容提供了就地内容迁移。需要Products.contentmigration软件包才能正常工作。要安装此软件包，您需要再次将其名称添加到 buildout.cfg 的“eggs”和“zcml”部分，使其看起来像这样：

[instance]
...
eggs +=
    plone.app.blob
    Products.contentmigration
zcml +=
    plone.app.blob
    Products.contentmigration

您也可以参考上述提到的示例buildout.cfg以获取详细信息。

然后，为了将现有文件内容迁移到blob，您可以使用在 http://<site>/@@blob-file-migration 提供的迁移界面来迁移“文件”内容，以及 http://<site>/@@blob-image-migration 来迁移“图像”内容。当然，这里需要将 <site> 替换为您“Plone网站”对象的URL。这些页面将显示可用的 ATFile 或 ATImage 实例的数量，然后通过点击按钮将这些实例转换为提供的blob内容类型。

有关使用FileField(s)的自定义AT内容类型，请参阅example.blobattype以获取有关启用和将其迁移到使用blob的详细说明。

如果在迁移过程中遇到任何错误，请参阅下一节。

故障排除

以下是一些已知问题，希望它们将很快得到解决。同时，以下是推荐的解决方案

“AttributeError: ‘module’ object has no attribute ‘VersionBase’”异常

症状

在升级您的buildout后，您会看到以下错误

Traceback (innermost last):
  ...
  Module App.PersistentExtra, line 57, in locked_in_version
AttributeError: 'module' object has no attribute 'VersionBase'

问题

版本 1.0b5 的 plone.app.blob 增加了 对 Plone 4 的支持 以及 Dexterity，因此不得不解除 ZODB 的版本限制。然而，虽然 Plone 4 将使用 Zope 2.12 和 ZODB 3.9，但 Plone 3.x 与这两个版本都不兼容。

解决方案

将 ZODB3 降级到 3.8 系列的某个版本。您可以通过在 buildout.cfg 中添加版本锁定来实现这一点：

[versions]
ZODB3 = 3.8.3

。

“FileFieldException: 值不是文件或字符串（……）” 异常

症状

在升级 buildout 后，在 blob 迁移过程中可能会遇到以下错误：

Traceback (innermost last):
  File ".../basemigrator/walker.py", line 174, in migrate
  ...
  File ".../Archetypes/Field.py", line 931, in _process_input
FileFieldException: Value is not File or String (...)

问题

在运行 buildout 的过程中，您的 archetypes.schemaextender 版本已升级到 1.1。您要么没有在非最新模式（-N）下运行它，要么没有锁定 archetypes.schemaextender 的版本。

解决方案

暂时将 archetypes.schemaextender 降级到版本 1.0。您可以通过在 buildout.cfg 中添加版本锁定来实现这一点：

[versions]
archetypes.schemaextender = 1.0

。正在努力添加兼容最新版本的适当修复。

“AttributeError: ‘NoneType’ 对象没有属性 ‘getAccessor’” 异常

症状

从版本 1.0b2 或更早版本升级后，在尝试查看基于 blob 的内容时可能会遇到以下错误：

Traceback (innermost last):
  Module ZPublisher.Publish, line 119, in publish
  ...
  Module Products.ATContentTypes.content.base, line 300, in get_content_type
AttributeError: 'NoneType' object has no attribute 'getAccessor'

问题

最新版本已添加对基于标记接口的子类型支持，而您的现有基于 blob 的内容尚未标记。

解决方案

升级到至少 1.0b4，通过快速安装程序重新安装“plone.app.blob”，并通过访问 @@blob-maintenance/resetSubtypes 视图重置所有子类型。

“无效的插件 ID” 异常

症状

在尝试创建“Plone 网站”时，您可能会遇到以下错误：

Error Type: KeyError
Error Value: 'Invalid plugin id: credentials_basic_auth'

问题

您的 Products.PluggableAuthService 版本过旧——您需要 1.5.2 或更高版本（有关此信息的更多信息，请参阅 http://www.zope.org/Collectors/PAS/59）。

解决方案

请使用提供的 buildout，将 1.5 分支 作为 svn:external 添加到您的 buildout 的 products/ 目录中，或者通过重新运行 buildout 升级到 Plone 3.0.4。

“未知类型名称：‘blobstorage’”

症状

在运行 buildout 时，您可能会遇到以下错误：

Error: unknown type name: 'blobstorage'
(line 36 in file:///.../parts/instance/etc/zope.conf)

问题

您的 plone.recipe.zope2instance 脚本版本过旧——您需要至少版本 1.0。

解决方案

请确保您在运行 buildout 时既没有使用“-N”，也没有使用“-o”，并且您也没有在 ~/.buildout/default.cfg 中添加它。或者，使用选项“-n”运行 buildout 应该将脚本更新到最新版本。

newest = false

缺少必需的“zdaemon”和“ZConfig”egg的发行版

在运行 buildout 时，您可能会遇到以下错误：

症状

或

Getting distribution for 'zdaemon>=1.4a2,<1.4.999'.
While:
  Installing instance.
  Getting distribution for 'zdaemon>=1.4a2,<1.4.999'.
Error: Couldn't find a distribution for 'zdaemon>=1.4a2,<1.4.999'.

zdaemon 和 ZConfig egg 自从更近的版本（即 2.0 和 2.5）开始才发布到 Cheeseshop。以 egg 格式提供的旧版本发行版只能从 http://download.zope.org/distribution 获取。

Getting distribution for 'ZConfig>=2.4a2,<2.4.999'.
While:
  Installing instance.
  Getting distribution for 'ZConfig>=2.4a2,<2.4.999'.
Error: Couldn't find a distribution for 'ZConfig>=2.4a2,<2.4.999'.

问题

将上述链接添加到您的 buildout.cfg 中的 [buildout] 部分的 find-links 设置中，例如：

解决方案

。

find-links =
    http://download.zope.org/distribution/
    ...

“ZRPCError: bad handshake ‘Z303’”

症状

在使用ZEO配置时，您可能会遇到如下错误：

ZRPCError: bad handshake 'Z303'

问题

您可能没有在zeo部分的eggs设置中添加plone.app.blob。如果没有它，ZEO服务器将不会使用所需的ZODB 3.8版本，因此不支持blob。

解决方案

将字符串plone.app.blob添加到buildout.cfg中的[zeo]部分（即使用plone.recipe.zope2zeoserver配方的那部分），如下所示：

[zeo]
...
eggs = plone.app.blob
...

在迁移过程中出现“AttributeError: ‘NoneType’对象没有名为‘product’的属性”错误。

症状

通过快速安装器安装“plone.app.blob”或应用“plone.app.blob: ATFile replacement”配置文件后，您可能会看到迁移错误：

Traceback (innermost last):
  Module ZPublisher.Publish, line 119, in publish
  Module ZPublisher.mapply, line 88, in mapply
  Module ZPublisher.Publish, line 42, in call_object
  Module plone.app.blob.browser.migration, line 24, in __call__
  Module plone.app.blob.migrations, line 42, in migrateATFiles
  Module Products.contentmigration.basemigrator.walker, line 126, in go
  Module Products.contentmigration.basemigrator.walker, line 205, in migrate
MigrationError: MigrationError for obj at /... (File -> Blob):
Traceback (most recent call last):
  File ".../Products/contentmigration/basemigrator/walker.py", line 174, in migrate
    migrator.migrate()
  File ".../Products/contentmigration/basemigrator/migrator.py", line 185, in migrate
    method()
  File ".../Products/contentmigration/archetypes.py", line 111, in beforeChange_schema
    archetype = getType(self.dst_meta_type, fti.product)
AttributeError: 'NoneType' object has no attribute 'product'

问题

当前的迁移代码被编写为将现有的“文件”内容转换为由基本“plone.app.blob”配置文件提供的“Blob”内容类型。然而，当仅安装“ATFile replacement”配置文件时，该类型是未知的。尽管如此，后者可能是您想要安装的，因为以前的“文件”内容在迁移后将继续保持相同的门户类型，即“文件”。这样就不会有明显的更改，这可能会帮助避免混淆。

解决方案

目前，您可以通过在/portal_setup的ZMI中应用“plone.app.blob”配置文件来解决这个问题。这将安装上述提到的“Blob”内容类型。之后迁移将工作，但您以前的“文件”内容将具有“Blob”内容类型。

如果这不是您想要的，只需简单地修改plone/app/blob/migrations.py文件中的第17行（该文件可能位于相对于您的buildout/安装的某个位置，例如eggs/plone.app.blob-1.0b2-py2.4.egg/）从

dst_portal_type = 'Blob'

到

dst_portal_type = 'File'

之后迁移将使用基于ZODB的新的“文件”类型。一旦迁移完成，您可以从/portal_types中再次删除或禁用“Blob”类型。未来版本的“plone.app.blob”将尝试自动检测迁移的正确目标类型，或者至少允许指定它，以便使其更方便。

如果您已经迁移到“Blob”内容，但更希望拥有“文件”项，可以将前面的两行更改为

src_portal_type = 'Blob'
src_meta_type = 'ATBlob'

并重新运行blob迁移。这将再次将您的“Blob”转换为显示为“文件”。您可能之后需要打包ZODB，以避免其blob存储占用实际所需的磁盘空间的两倍（额外的迁移将创建新的blobs）。

迁移到blob后，“图像”和/或“文件”内容没有按预期显示

症状

在将“图像”和/或“文件”内容迁移到基于blob后，其中一些内容没有按预期显示。一个典型的例子是ATCT的照片专辑视图。

问题

所有版本在1.0b11之前的版本在迁移期间都没有正确更新“类型”目录索引。这当然可能导致使用此索引的所有查询的结果错误。

解决方案

请使用ZMI手动更新“类型”索引，或升级到至少1.0b11，并使用@@blob-maintenance/updateTypeIndex视图将重新索引限制为仅基于blob的内容。后者通常更快，特别是对于更大的站点。

使用附加挂载的数据库时出现错误

症状

使用配置的ZODB挂载点时，您可能会遇到如下错误：

Traceback (innermost last):
  ...
  Module ZEO.ClientStorage, line 1061, in temporaryDirectory
AttributeError: 'NoneType' object has no attribute 'temp_dir

zdaemon 和 ZConfig egg 自从更近的版本（即 2.0 和 2.5）开始才发布到 Cheeseshop。以 egg 格式提供的旧版本发行版只能从 http://download.zope.org/distribution 获取。

Traceback (innermost last):
  ...
  Module ZODB.blob, line 495, in temp_dir
TypeError: Blobs are not supported

问题

您没有为您的额外数据库配置blob存储。

解决方案

请参阅David Glick在问题#10130的评论中的详细信息，了解有关为附加挂载点配置blob存储的各种方式。对于ZEO和非ZEO配置，推荐的方法是使用collective.recipe.filestorage，并使用以下方式调整您的buildout：

[buildout]
...
parts =
    ...
    filestorage
    instance

[filestorage]
recipe = collective.recipe.filestorage
blob-storage = var/blobstorage-%(fs_part_name)s
parts =
    foo

请注意，在“构建”部分的“部分”设置中，在安装 Zope 或 ZEO 之前，必须列出“filestorage”。然而，“filestorage”部分的“部分”设置代表要生成的文件存储子部分的列表，每行一个。更多详细信息可以在配方文档中找到。

常见问题解答

是否可以在不是基于zc.buildout的安装中使用“plone.app.blob”？

是的，但需要一些额外的步骤，因为它依赖于 ZODB 3.8，但 Plone 目前附带 Zope 2.10，它仍然包含 ZODB 3.7。因此，为了使一切正常工作，您可以要么将所有额外所需软件包的必需版本安装到您的 lib/python/ 目录中，要么使用相应的 eggs，并确保它们在 import 时优先于旧版本，例如通过设置 PYTHONPATH。

或者，也可以使用 easy_install 安装该软件包，这将自动安装其依赖项，包括 ZODB 3.8。同样，您需要设置您的 PYTHONPATH 以确保使用所需的版本。但是，以这种方式安装软件包可能会对系统上其他 Zope/Plone 实例产生副作用，因此您可能至少要使用 virtualenv。

总的来说，为了尽量减少痛苦，建议使用基于 buildout 的安装——例如提供的buildout。

这将在 Plone 2.5.x 中可用吗？

是的，计划支持 2.5 系列，这是下一步计划。

关于图像支持，即 ATImage 内容的替代品怎么办？

虽然仅仅替换 ATImage 的架构中的主要字段可能已经非常有效，但计划在未来的版本中提供正确的图像支持。“正确”在这里意味着使用像 Rocky Burt 在那不勒斯展示的 子类型方法，这将为代码提供更干净和更好的结构，但实现起来可能需要更长的时间。

像 Exception exceptions.OSError: (2, 'No such file or directory', '.../tmpZvxjZB') in <bound method _TemporaryFileWrapper.__del__ of <closed file '<fdopen>', mode 'w+b' at 0x7317650>> ignored 这样的奇怪消息会在每次上传文件时写入日志。这是错误还是需要担心的事情？

不是，这没问题，这只是一个小烦恼，最终应该会得到解决。如果您关心的话，问题在于 zope 发布者为接收到的每个上传创建一个临时文件。一旦上传完成，该临时文件就会传递给 blob 机制，它将其移动到 blob 存储中。然而，在请求结束时，临时文件的包装类尝试删除文件，因为，嗯，它应该是临时的。然而，那时文件已经不存在了，因此发布了上述警告。

我有一个 ZEO 设置，服务器和客户端在不同的机器上运行。为什么我会在我的 ZEO 客户端的 blobstorage 目录中存储 blob，而不仅仅是服务器上？

当ZEO客户端首次获取blob时，会将其缓存。不幸的是，当实例停止时，缓存不会自动清理，并且会继续增长。此外，如果您在重启之前手动删除文件，ZEO客户端仍然会期望找到它们。Plone 4使用的ZODB 3.9引入了缓存大小控制，可以缓解这个问题。虽然Plone 3.x和更早版本只能与ZODB 3.8.x一起使用。然而，Sasha Vincic为Plone 2.5.x编写了一个解决方案，该方案使现有的引用无效，如果blob数据缺失，则从ZEO服务器重新获取。该补丁已合并，并从版本1.0b11开始可用。

反馈

任何类型的反馈，如错误报告、建议、功能请求以及最理想的成功故事都受到欢迎并非常感激。特别是，了解关于现有内容和其他平台（而非OSX）上的迁移的成功或问题将很有趣。

因此，请随时在问题跟踪器中提交问题，在#plone、#plone-framework、plone开发者邮件列表或直接通过电子邮件与我联系。

详细文档

此包将ZODB 3.8的blob支持集成到Plone 3.0中。为此，提供了一个新的内容类型Blob，它可以替代现有的文件和图像类型。它们的行为通过子类型化来模拟，在这种情况下意味着动态更改底层Blob类型的视图和模式，以及对其进行功能扩展。

首先需要安装plone.app.blob包，这目前需要一个特殊的分支的Zope 2.10以及一些用于扩展模式和迁移目的的附加包。获取工作设置的最简单方法可能是使用提供的buildout配置之一，要么是基于ploneout的配置，因此主要针对开发者，要么是基于plone.recipe.plone的配置。后者使用当前的plone发布tarball而不是subversion checkout，这意味着它主要针对集成者和用户（并且设置起来更快：)))

无论如何，设置应使新的内容类型可用并可实例化

>>> from Products.CMFCore.utils import getToolByName
>>> portal = layer['portal']
>>> portal_types = getToolByName(portal, 'portal_types')
>>> portal_types.getTypeInfo('Blob')
<DynamicViewTypeInformation at /plone/portal_types/Blob>

>>> from plone.app.testing import TEST_USER_ID
>>> folder = portal.portal_membership.getHomeFolder(TEST_USER_ID)
>>> folder.invokeFactory('Blob', id='blob', title='a Blob')
'blob'
>>> blob = folder.blob
>>> blob
<ATBlob at /plone/Members/test_user_1_/blob>

新实例应已标记为默认子类型，因此还应包含扩展的模式

>>> from plone.app.blob.interfaces import IATBlobBlob
>>> IATBlobBlob.providedBy(blob)
True
>>> blob.getField('file')
<Field file(blob:rw)>

模仿现有的“文件”内容类型，即ATFile，它不应有关联的工作流

>>> workflow_tool = getToolByName(portal, 'portal_workflow')
>>> workflow_tool.getWorkflowsFor(blob)
[]

由于尚未向其中写入数据，blob文件仍然为空

>>> blob.getFile().getBlob()
<ZODB.blob.Blob object at ...>
>>> blob.getFile().getBlob().open().read()
''

向其中添加一些图像数据应导致正确设置MIME类型，并且现在非空的blob文件

>>> from StringIO import StringIO
>>> from base64 import decodestring
>>> gif = 'R0lGODlhAQABAPAAAPj8+AAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=='
>>> gif = StringIO(decodestring(gif))
>>> blob.setFile(gif)
>>> print blob.getFilename()
None
>>> blob.getContentType()
'image/gif'
>>> len(blob.getFile().getBlob().open().read())
43
>>> str(blob) == gif.getvalue()
True

从现有文件内容（即ATFile实例）迁移也提供。有效载荷数据以及所有其他字段都应正确迁移

>>> initial_file_product = portal.portal_types.File.product
>>> initial_file_factory = portal.portal_types.File.factory
>>> portal.portal_types.File.product = 'ATContentTypes'
>>> portal.portal_types.File.factory = 'addATFile'
>>> gif.filename = 'foo.gif'
>>> folder.invokeFactory('File', id='foo', title='a file', file=gif,
...     subject=('foo', 'bar'), contributors=('me'))
'foo'
>>> portal.portal_types.File.product = initial_file_product
>>> portal.portal_types.File.factory = initial_file_factory
>>> folder.foo
<ATFile at /plone/Members/test_user_1_/foo>
>>> folder.foo.Title()
'a file'
>>> folder.foo.getFilename()
'foo.gif'
>>> folder.foo.getContentType()
'image/gif'
>>> folder.foo.Subject()
('foo', 'bar')
>>> folder.foo.Contributors()
('me',)

>>> from plone.app.blob.migrations import migrateATFiles
>>> migrateATFiles(portal)
'Migrating /plone/Members/test_user_1_/foo (File -> Blob)\n'

>>> folder.foo
<ATBlob at /plone/Members/test_user_1_/foo>
>>> folder.foo.Title()
'a file'
>>> folder.foo.getFilename()
'foo.gif'
>>> folder.foo.getContentType()
'image/gif'
>>> folder.foo.Subject()
('foo', 'bar')
>>> folder.foo.Contributors()
('me',)
>>> folder.foo.getFile().getBlob()
<ZODB.blob.Blob object at ...>
>>> str(folder.foo) == gif.getvalue()
True
>>> folder.foo.getFile().getBlob().open().read()
'GIF89a...'

此外，迁移还应正确索引新内容，以防止陈旧或错误的数据在某些视图中显示，例如文件夹列表

>>> catalog = getToolByName(portal, 'portal_catalog')
>>> brain = catalog(id = 'foo')[0]
>>> folder.foo.UID() == brain.UID
True

>>> folder.foo.getObjSize() == brain.getObjSize
True

最后，使用testbrowser测试基于blob的内容的“通过Web”的正确创建

>>> from plone.app.testing import setRoles
>>> setRoles(portal, TEST_USER_ID, ['Editor'])

>>> from plone.testing.z2 import Browser

>>> from plone.app.testing import TEST_USER_NAME, TEST_USER_PASSWORD
>>> browser = Browser(layer['app'])
>>> browser.addHeader('Authorization', 'Basic %s:%s' % (
...     TEST_USER_NAME, TEST_USER_PASSWORD))

>>> browser.open(folder.absolute_url())
>>> browser.getLink(url='createObject?type_name=Blob').click()
>>> browser.url
'http://nohost/plone/.../portal_factory/Blob/blob.../edit...'
>>> browser.getControl(name='title').value = 'Foo bar'
>>> control = browser.getControl(name='file_file')
>>> testfile = StringIO('%PDF-1.4 fake pdf...' + 'foo' * 1000)
>>> control.add_file(testfile, None, 'foo.pdf')
>>> browser.getControl('Save').click()
>>> browser.url
'http://nohost/plone/.../foo-bar/view'
>>> browser.contents
'...Info...Changes saved...
 ...Foo bar...foo.pdf...PDF document...'

变更日志