将 versionutils 模块迁移至 oslo.log

https://blueprints.launchpad.net/oslo?searchtext=graduate-oslo-versionutils

versionutils 模块包含用于在 OpenStack 发布周期边界报告功能弃用的工具。它将被添加到 oslo.log 中，因为它本身不足以作为独立的库进行管理，并且主要用作日志记录辅助函数。

库名称

新库的名称是什么？: oslo.log 和 oslo.utils

内容

  • openstack/common/versionutils.py

  • tests/unit/test_versionutils.py

早期采用者

无

公共 API

deprecated() 装饰器和 report_deprecated_feature() 将通过 oslo_log.versionutils 提供。

is_compatible() 将被添加到 oslo_utils.versionutils 中。

实现

负责人

主要负责人: Doug Hellmann

其他贡献者：无

主要维护者

主要维护者: 现有库维护者

其他贡献者: 无

安全联系人

安全联系人: 现有联系人

里程碑

完成目标里程碑：liberty-1

工作项

  1. 提取 versionutils 代码的历史记录到一个新的仓库。

  2. 将该历史记录导入到 oslo.log 仓库的一个分支中。该分支中的更改需要提交到 gerrit 进行审查，但我们可以快速批准它们，因为它们已经在孵化器中得到了审查。

  3. 将分支合并到 master 分支，并附带修复以使测试正常工作。

  4. 从 oslo.log 中移除 is_compatible()。

  5. 将该历史记录导入到 oslo.utils 仓库的一个分支中。该分支中的更改需要提交到 gerrit 进行审查，但我们可以快速批准它们，因为它们已经在孵化器中得到了审查。

  6. 将分支合并到 master 分支，并附带修复以使测试正常工作。

  7. 从 oslo.utils 中移除与 is_compatible() 不相关的 versionutils 的部分。

  8. 发布 oslo.log 和 oslo.utils。

  9. 从孵化器中移除 versionutils。

采用说明

大多数应用程序已经在使用 versionutils，并且 API 不会发生变化，因此采用应该相当简单。

依赖项

无

参考资料

注意

本作品采用知识共享署名 3.0 非移植许可协议授权。 http://creativecommons.org/licenses/by/3.0/legalcode