glanceclient.common.utils 模块¶
- class glanceclient.common.utils.GeneratorProxy(wrapped)¶
基类:
ObjectProxy- next()¶
- property request_ids¶
- property wrapped¶
- class glanceclient.common.utils.RequestIdProxy(wrapped)¶
基类:
ObjectProxy- next()¶
- property request_ids¶
- property wrapped¶
- glanceclient.common.utils.add_req_id_to_generator()¶
- glanceclient.common.utils.add_req_id_to_object()¶
- glanceclient.common.utils.arg(*args, **kwargs)¶
- glanceclient.common.utils.debug_enabled(argv)¶
- glanceclient.common.utils.endpoint_version_from_url(endpoint, default_version=None)¶
- glanceclient.common.utils.env(*vars, **kwargs)¶
搜索可能存在的多个环境变量中的第一个已定义的环境变量。
如果变量在 vars 中定义,则返回第一个环境变量,否则返回 kwargs 中定义的默认值。
- glanceclient.common.utils.exit(msg='', exit_code=1)¶
- glanceclient.common.utils.find_resource(manager, name_or_id)¶
用于 _find_* 方法的辅助函数。
- glanceclient.common.utils.get_data_file(args)¶
- glanceclient.common.utils.get_file_size(file_obj)¶
分析类文件对象并尝试确定其大小。
- 参数:
file_obj – 类文件对象。
- 返回值:
文件的大小,如果无法确定则返回 None。
- glanceclient.common.utils.has_version(client, version)¶
- glanceclient.common.utils.integrity_iter(iter, checksum)¶
检查镜像数据完整性。
- 引发:
IOError
- glanceclient.common.utils.make_size_human_readable(size)¶
- glanceclient.common.utils.memoized_property(fn)¶
- glanceclient.common.utils.on_data_require_fields(data_fields, required=('disk_format', 'container_format'))¶
装饰器,用于检查命令的有效性
此装饰器检查是否在通过命令行参数或通过 stdin 提供镜像数据时,是否存在必需的字段
出错时,会抛出带有有意义消息的 CommandError 异常。
- 参数:
data_fields (iter) – 哪些字段的存在意味着镜像数据
required (iter) – 必需的字段
- 返回值:
函数装饰器
- glanceclient.common.utils.pretty_choice_list(choices)¶
- glanceclient.common.utils.print_cached_images(cached_images)¶
- glanceclient.common.utils.print_dict(d, max_column_width=80)¶
- glanceclient.common.utils.print_dict_list(objects, fields)¶
- glanceclient.common.utils.print_err(msg)¶
- glanceclient.common.utils.print_image(image_obj, human_readable=False, max_col_width=None)¶
- glanceclient.common.utils.print_list(objs, fields, formatters=None, field_settings=None)¶
打印对象列表。
@param objs: 要打印的对象 @param fields: 每个对象上要打印的字段 @param formatters: 自定义字段格式化程序
- glanceclient.common.utils.safe_header(name, value)¶
- glanceclient.common.utils.save_image(data, path)¶
将镜像保存到指定的路径。
- 参数:
data – 镜像的二进制数据
path – 保存镜像的路径
- glanceclient.common.utils.schema_args(schema_getter, omit=None)¶
- glanceclient.common.utils.serious_integrity_iter(iter, hasher, hash_value)¶
使用 Glance “multihash” 检查镜像数据完整性。
- 参数:
iter – 包含镜像数据的可迭代对象
hasher – 一个 hashlib 对象
hash_value – 镜像数据的十六进制摘要
- 引发:
如果数据的哈希摘要不是 hash_value,则引发 IOError
- glanceclient.common.utils.strip_version(endpoint)¶
如果存在,则从端点的最后一个组件中删除版本。