毕业 fileutils

蓝图: https://blueprints.launchpad.net/oslo-incubator/+spec/graduate-oslo-io

概要: 将 fileutils 代码（以及相关的测试）移动到 oslo.utils

库名称

oslo.utils 和 oslo.policy

内容

• openstack/common/fileutils.py

• tests/unit/test_fileutils.py

早期采用者

• keystone

公共 API

fileutils.py 只有 7 个函数和 1 个全局变量。它们的使用情况和毕业计划如下。

1. ensure_tree()

• 被 nova/cinder/ironic 使用

• 将被添加到 oslo.utils

2. delete_if_exists()

• 在 nova 和 cinder 中被广泛使用，neutron 中也有少量使用

• 将被添加到 oslo.utils

3. remove_path_on_error()

• 被 nova/cinder/ironic 使用

• 将被添加到 oslo.utils

4. write_to_tempfile()

• 在 keystone 和 ceilometer 中使用较少（仅在测试中）

• 考虑弃用

5. file_open

• 在 cinder 中被广泛使用

• 可以用一个 open() 调用来代替

• 考虑弃用

6. read_cached_file()

• 仅被 nova 的策略引擎和 oslo.policy 使用

• 可以将这两个都推送到 oslo.policy 中，并且当/如果 nova 切换到 oslo.policy 时，它们将不再需要这些函数。

7. delete_cached_file()

• 与上述相同。

8. DEFAULT_MODE

• 未被引用，可以标记为私有。

实现

负责人

主要负责人

Steve Martinelli (stevemar)

主要维护者

主要维护者

Steve Martinelli (stevemar)

安全联系人

安全联系人

Doug Hellmann (doug-hellmann)

里程碑

Liberty-1

工作项

• https://wiki.openstack.org/wiki/Oslo/CreatingANewLibrary#Checklist

采用说明

当前导入的项目

from openstack.common import fileutils

需要切换到导入

from oslo_utils import fileutils

如果使用

fileutils.file_open()

切换到

open()

如果使用

fileutils.read_cached_file()

切换到

oslo_policy

依赖项

无

参考资料

• https://etherpad.openstack.org/p/kilo-oslo-library-proposals

• WIP 补丁 https://review.openstack.org/#/c/154975/

注意

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