pixlib 1.0.4

AI image processing toolkit - plain color detection, image validation, URL image download, hash rename, MD5 and random string utilities

pixlib 图像处理工具包

一个轻量级的 Python 图像处理库，专为 AI 图像生成工作流设计。提供纯色图检测、图片有效性校验、透明区域检测、URL 图片下载、MD5 计算、通用 HTTP 请求客户端等实用功能。

主要特性

• 纯色图检测 (ImageTool.is_plain_gray) - 通过 7 个维度综合判定图片是否为纯色图，支持 bytes / 文件路径 / URL 输入
• 图片有效性校验 (ImageTool.is_valid_image) - 检测图片是否损坏或不完整，支持 bytes / 文件路径 / URL 输入
• 透明区域检测 (ImageTool.has_multiple_transparency) - 检测图片是否包含多个透明区域，支持 bytes / 文件路径 / BytesIO / URL 输入
• URL 图片下载 (ImageTool.get_img_url_io) - 从 URL 获取图片，支持指数退避重试
• MD5 计算 (utils.str_to_md5) - 支持字符串、bytes、文件路径
• 随机字符串 (utils.generate_random_lowercase) - 生成指定长度的随机小写字母
• HTTP 请求客户端 (HttpRequestClient) - 通用HTTP客户端，支持指数退避重试、GET/POST快捷方法，内置断开ConnectionError重链。

安装

pip install pixlib

使用示例

import pixlib

# 纯色图检测（支持 bytes / 文件路径 / URL）
is_gray, metrics, msg = pixlib.ImageTool.is_plain_gray(image_bytes)
is_gray, metrics, msg = pixlib.ImageTool.is_plain_gray("/path/to/image.png")
is_gray, metrics, msg = pixlib.ImageTool.is_plain_gray("https://example.com/img.png")

# 图片有效性校验（支持 bytes / 文件路径 / URL）
try:
    pixlib.ImageTool.is_valid_image(image_bytes, task_id="abc123")
except Exception as e:
    print(e.extra_data)

# 透明区域检测（支持 bytes / 文件路径 / BytesIO / URL）
has_transparent = pixlib.ImageTool.has_multiple_transparency(image_bytes)

# URL 下载图片
im_io = pixlib.ImageTool.get_img_url_io("https://example.com/img.png")

# MD5 计算
pixlib.utils.str_to_md5("hello")
pixlib.utils.str_to_md5("/path/to/image.png")

# 随机字符串
pixlib.utils.generate_random_lowercase(10)

# HTTP 请求客户端
client = pixlib.HttpRequestClient(max_retries=3, base_timeout=300)
resp = client.get("https://example.com/api/data")
resp = client.post("https://example.com/api/submit", json={"key": "value"})