mr.migrator 1.2

简介

Transmogrifier是一个强大的工具，用于创建名为“管道”的转换过程。Transmogrifier为你提供了创建和共享这些管道的工具，但不提供运行管道的简单方法。Mr.migrator旨在弥合这一差距。

Mr.Migrator提供了以下功能

• 一个buildout配方，你可以用它来重写指定的管道。

• 一个带有帮助的命令行脚本，允许你运行管道并查看其进度。当你与transmogrify.ploneremote或其他蓝图一起使用时非常有用，这些蓝图不应该在Plone进程中运行。

• 一个Plone插件，一旦安装，就可以选择要运行的管道，提供重写管道选项的表单，然后提供运行中的管道的进度。当你想要使用应该在Plone进程中运行的plone.app.transmogrifier蓝图时，这非常有用。

获取管道

管道是来自collective.transmogrifier的一个概念，其中字典项通过一系列步骤传递，每个步骤都会向外部源添加、删除或上传信息。管道使用INI风格语法在配置文件中进行配置。Mr.Migrator允许你运行你自己构建的管道，或者

migrate --pipeline=mypipeline.cfg

[migrate]
recipe = mr.migrator
pipeline = mypipeline.cfg

[buildout]
parts += mr.migrator

[migrator]
recipe = mr.migrator
pipeline = mypipeline.cfg
eggs = transmogrify.sqlalchemy
zcml = transmogrify.sqlalchemy

migrate --zcml=transmogrify.sqlalchemy,transmogrify.other

entry-points = {"z3c.autoinclude.plugin":['target = transmogrify']}

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:transmogrifier="http://namespaces.plone.org/transmogrifier"
    i18n_domain="collective.transmogrifier">

<transmogrifier:registerConfig
    name="exampleconfig"
    title="Example pipeline configuration"
    description="This is an example pipeline configuration"
    configuration="example.cfg"
    />

</configure>

entry_points = {"z3c.autoinclude.plugin":['target = transmogrify']}

migrate --pipeline=exampleconfig

[migrate]
recipe = mr.migrator
pipeline = exampleconfig

重写管道值

管道被组织成一系列步骤，爬取项目通过这些步骤最终被上传。每个步骤有一个或多个配置选项，因此你可以根据需要自定义导入过程。几乎所有导入都需要一定级别的配置。

每个配置键的第一个部分是步骤，例如 crawler。第二部分是该特定步骤的特定配置选项。例如，url。然后是 = 和值或值。

配置选项可以是buildout部分的一部分，例如。

[buildout]
parts += mr.migrator

[mr.migrator]
recipe = mr.migrator
crawler-url=http://www.whitehouse.gov

或者可以通过命令行覆盖相同的选项

$> bin/migrate --crawler:url=http://www.whitehouse.gov

某些选项需要在构建部分中多行。这些可以通过命令行重复相同的参数来覆盖，例如：

$> bin/migrate --crawler:ignore=\.mp3 --crawler:ignore=\.pdf

您可以使用命令行帮助查看可用选项的列表。

$> bin/migrate --help

$> bin/mr.migrator --template1:debug

$> bin/mr.migrator --show-pipeline

$> bin/mr.migrator --show-pipeline > pipeline.cfg
$> {edit} pipeline.cfg
$> bin/mr.migrator --pipeline=pipeline.cfg

[mr.migrator]
recipe = mr.migrator
eggs = myblueprintpackage
pipeline = mypipeline.cfg

entry_points="""
      [z3c.autoinclude.plugin]
      target = transmogrify
      """,
      )

管道配置的帮助语法

待办事项

Plone中的Mr.Migrator

*开发中*

Mr.Migrator需要与提供注册管道的包结合使用。

1. 将mr.migrator安装到您的构建中。

2. 安装提供您管道的包，如funnelweb或collective.jsonmigrator。

3. 转到您想要导入内容的网站位置，并选择操作 > 在此处进行Mr.Migrate（或者，打开URL @@mr.migrator）。

4. 从下拉列表中选择您想要的管道。

5. 将显示一个用于填写管道额外配置的表单（该表单可能是从.cfg自动生成的，或者是由管道作者设计的表单）。

6. 点击运行。

7. 弹出进度反馈对话框，显示活动日志。

待办事项

• 完成自动表单，使其适用于所有情况。

• 结合argparse和autoform代码。

• 执行进度对话框。

• 为包提供注册表单以及管道的钩点。

• 当找不到管道时：显示有关如何找到它们以及如何安装它们的帮助信息。

贡献

• 代码仓库: http://github.com/collective/mr.migrator

• 有关问题和评论，请访问 http://github.com/collective/mr.migrator/issues

• 在 http://github.com/collective/mr.migrator/issues 报告错误

感谢

• Alex Clark - 为名称提供。

• Rok Garbas - z3cform的原始代码。

• Dylan Jay - 命令行运行器的原始代码。

1.2 (2017-05-15)

• 添加西班牙翻译。[macagua]

• 添加更多关于i18n支持的改进。[macagua]

• 添加Plone 4.3.x版本的构建配置文件。[macagua]

• 修复 IOError: [Errno 2] No such file or directory: mr/migrator/autoinclude.zcml 文件缺失。[macagua]

• 更新Plone 3.3.x版本的构建配置文件。[macagua]

• 修复与安全热补丁20160830相关的表单问题。[agitator]

1.1 (2015-10-22)

• 删除browserlayer注册，因此不需要安装mr.migrator即可使用。调用/@@mr.migrator就足够了。

• 添加卸载配置文件。[thet]

• 允许通过网页在 @@mr.migrator 视图中导入任何管道配置。以前，只有包含 plone.app.transmogrifier.atschemaupdater 蓝图的管道才会显示。现在可以使用任何管道，例如仅处理 Dexterity 对象的管道。[thet]

• Pep8。[thet]

1.0.1 (2012-09-18)

• 恢复手动 zcml 加载。[djay]

1.0 (2012-04-28)

• 修复 setup.py 的问题，破坏了 buildout。[djay]

• 修复了名称错误：全局名称 'cparser' 未定义，问题 #6。[gborelli]

• 修复默认配置文件。[toutpt]

• 修复导入错误。[toutpt]

1.0b11 (2012-04-25)

• 支持管道包含。[djay]

1.0b10 (2012-01-23)

• 撤销 ec799dcd3d 的一部分，导致 ConfigurationErrors。[aclark]

1.0b9 (2012-01-23)

• 修复棕色袋子发布（坏的 MANIFEST）。[aclark]

1.0b8 (2012-01-23)

• 修复棕色袋子发布（缺少 zcml）。[aclark]

1.0b7 (2012-01-23)

• 在当前工作目录中查找 pipeline.cfg。[aclark]

1.0b6 (2012-01-23)

• 修复棕色袋子发布。[aclark]

1.0b5 (2012-01-22)

• 错误修复：支持 –zcml 参数。[aclark]

1.0b4 (2011-08-14)

• 错误修复：ZCML 配置。[aclark]

1.0b3 (2011-08-14)

• 错误修复：ZCML 配置。[aclark]

1.0b2 (2011-08-14)

• 错误修复：Python 2.4 兼容。[aclark]

1.0b1 (2011-06-29)

• 允许在命令行中运行蓝图包的 zcml 的方式。[djay]

• 将命令行运行器从 funnelweb 中拆分出来。[djay]

• 添加在 Plone 内运行 transmogrifier 的表单的开始。[djay]