工具包

moear_api_common.utils.mkdirp(path)

创建传入的路径

该方法为一个串联调用方法，仅对 os.makedirs() 做了简单封装。

推荐用法:

path_created = mkdirp(path)  # 赋值路径的同时确保其已被创建

用例:

>>> from moear_api_common.utils import mkdirp
>>> mkdirp('build/doctest/test_path')
'build/doctest/test_path'

参数:path (str) – 待创建路径 返回:创建完成的路径 返回类型:str 引发:OSError – 调用 os.makedirs() 时发生的异常，若路径已存在则不抛出异常

moear_api_common.utils.get_config_dict(config)

获取配置数据字典

对传入的配置包进行格式化处理，生成一个字典对象

参数:config (object) – 配置模块 返回:配置数据字典 返回类型:dict

moear_api_common.utils.img.rescale_image(data, maxsizeb=4000000, dimen=None, png2jpg=False, graying=True, reduceto=(600, 800))

若 png2jpg 为 True 则将图片转换为 JPEG 格式，所有透明像素被设置为 白色 。确保结果图片尺寸小于 maxsizeb 的约束限制。

如果 dimen 不为空，则生成一个相应约束的缩略图。依据 dimen 的类型，设置约束为 width=dimen, height=dimen 或者 width, height = dimen

参数:

• data (bytes or io.BytesIO) – 原始图片字节数据
• maxsizeb (int) – 文件大小约束，单位：字节
• dimen (int or (int, int)) – 缩略图尺寸约束，宽&高
• png2jpg (bool) – 是否将图片转换为 JPG 格式
• graying (bool) – 是否将图片进行灰度处理
• reduceto ((int, int)) – 若图片大于此约束则进行相应缩小处理，宽&高

返回:

处理后的图片字节数据，可直接以 wb 模式输出到文件中

返回类型:

bytes

moear_api_common.utils.img.gray_image(data)

灰度化图片

将传入的图片数据转换为灰度图后返回

参数:bytes (data) – 图片字节数据，可通过以 rb 模式读取图片文件获得 返回:处理后的图片字节数据，可直接以 wb 模式输出到文件中 返回类型:bytes

moear_api_common.utils.kindlegen.find_kindlegen_prog(path=None)

获取kindlegen程序路径

该方法会检索系统 PATH 路径，查找包含 kindlegen 文件的路径， 并返回该文件的绝对路径。若不存在则返回 None

注意

检索 PATH 路径前，会优先寻找指定路径，并在检索到第一个符合文件后立刻返回

参数:path (str) – 关键字参数，若传入，则优先检测该路径下是否存在 kindlegen 程序 返回:kindlegen的绝对路径 返回类型:str