py-img-processor 1.0.0__tar.gz

py_img_processor-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Skyler Hu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py_img_processor-1.0.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+
+recursive-include imgprocessor/ *
+recursive-include *.md Makefile *.jpg *.png *.gif
+
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude tests *
+recursive-exclude docs *

py_img_processor-1.0.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.1
+Name: py-img-processor
+Version: 1.0.0
+Summary: Image editor using Python and Pillow.
+Home-page: https://github.com/SkylerHu/py-img-processor.git
+Author: SkylerHu
+Author-email: skylerhu@qq.com
+License: MIT Licence
+Keywords: image,img-processor,image-processor,imgprocessor,img-editor,image-editor
+Platform: any
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: py-enum>=1.1.1
+Requires-Dist: Pillow>=8
+
+# py-img-processor
+
+[![PyPI - Version](https://img.shields.io/pypi/v/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![GitHub Actions Workflow Status](https://github.com/SkylerHu/py-img-processor/actions/workflows/pre-commit.yml/badge.svg?branch=master)](https://github.com/SkylerHu/py-img-processor)
+[![GitHub Actions Workflow Status](https://github.com/SkylerHu/py-img-processor/actions/workflows/test-py3.yml/badge.svg?branch=master)](https://github.com/SkylerHu/py-img-processor)
+[![Coveralls](https://img.shields.io/coverallsCoverage/github/SkylerHu/py-img-processor?branch=master)](https://github.com/SkylerHu/py-img-processor)
+[![PyPI - Wheel](https://img.shields.io/pypi/wheel/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![PyPI - Implementation](https://img.shields.io/pypi/implementation/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![GitHub License](https://img.shields.io/github/license/SkylerHu/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+
+
+Image editor using Python and Pillow.
+
+依赖Pillow开发的Python库，用于图像编辑处理。
+
+
+## 1. 安装
+
+	pip install py-img-processor
+
+依赖：
+
+- `Python >= 3.9`
+- `Pillow >= 8.0.0`
+
+可查看版本变更记录 [ChangeLog](https://github.com/SkylerHu/py-img-processor/blob/master/docs/CHANGELOG-1.x.md)
+
+## 2. 使用(Usage)
+
+具体使用说明查看 [readthedocs](https://py-img-processor.readthedocs.io) 。
+
+## 2.1 运行配置
+可以通过指定环境变量`PY_SETTINGS_MODULE`加载配置文件：
+
+    export PY_SETTINGS_MODULE=${your_project.settings_file.py}
+
+支持的配置项有：
+
+| 配置项 | 类型 | 说明 | 默认值 |
+| - | - | - | - |
+| DEBUG | bool | 是否debug开发模式 | False |
+| PROCESSOR_MAX_FILE_SIZE | int | 处理原图的大小限制， 单位 MB | 20 |
+| PROCESSOR_MAX_W_H | int | 处理图像，原图宽高像素限制 | 30000 |
+| PROCESSOR_MAX_PIXEL | int | width x height总像素3亿，处理前后的值都被此配置限制 | 300000000 |
+| PROCESSOR_DEFAULT_QUALITY | int | 图像处理后的默认质量 | 75 |
+| PROCESSOR_TEXT_FONT | str | 默认字体文件，默认从系统中寻找；也可以直接传递字体文件路径 | Arial Unicode.ttf |
+
+> `注意`：`PROCESSOR_TEXT_FONT` 字体的设置是文字水印必要参数，需保证系统已安装该字体。默认值 `Arial Unicode.ttf` 是MacOS系统存在的字体，建议设置字体文件路径。
+
+## 2.2 图像处理
+### 处理函数
+`process_image_by_path(input_path, out_path, params)`
+
+参数说明：
+
+- `input_path` str，输入图像文件路径
+- `out_path` str, 输出图像保存路径
+- `params` str or json，图像处理参数，参数说明详见 [Reference.md](https://github.com/SkylerHu/py-img-processor/blob/master/docs/Reference.md)
+
+
+### 图像处理参数为字符串
+
+- 斜线 `/` 隔开，区分不同的操作；
+- 逗号 `,` 隔开，区分操作中不同的参数；
+- 下划线 `_` 隔开，`key_value` 的形式，区分参数的Key和Value；
+- `value`是复杂参数时，需要进行`base64url_encode`，是否需要encode查看文档参数详细说明；
+
+```python
+from imgprocessor.utils import base64url_encode
+from imgprocessor.processor import process_image_by_path
+
+process_image_by_path(
+    "tests/imgs/lenna-400x225.jpg",
+    "/tmp/output.png",
+    # 对图片缩放、裁剪、生成圆角、并转成png存储
+    "resize,s_1080/crop,w_700,h_700//watermark,text_{base64url_encode('Hello 世界')}/circle,r_10/format,png",
+)
+```
+
+### 图像处理参数为JSON
+- 只是形式不同，参数和字符串形式无本质区别；
+- `format`、`quality`、`interlace`三个值在JSON第一层，直接按照`key: value`的形式设置；
+- 其他参数都放在 `actions` 数组中；
+
+```python
+process_image_by_path(
+    "tests/imgs/lenna-400x225.jpg",
+    "/tmp/output.png",
+    {
+        "actions": [
+            {"key": "resize", "s": 1080},
+            {"key": "crop", "w": 700, "h": 700},
+            # JSON形式参数, text无需encode
+            {"key": "watermark", "text": "Hello 世界"},
+            {"key": "circle", "r": 10},
+        ],
+        "format": "png",
+    },
+)
+```
+该操作与上述字符串示例参数等效。
+
+## 命令行
+安装库后 有可执行命令 `img-processor` 可以使用，通过 `img-processor -h` 查看参数说明。
+
+```shell
+usage: img-processor [-h] [-V] -P PATH [--action ACTION [ACTION ...]] -O OUTPUT [--overwrite]
+
+图像处理
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -V, --version         show program's version number and exit
+  -P PATH, --path PATH  输入图像的文件路径/目录，若是目录则批量处理目录下所有图像
+  --action ACTION [ACTION ...]
+                        操作参数，可对同一个文件多组操作
+  -O OUTPUT, --output OUTPUT
+                        输出图像路径，多个图像或多个操作时请设置已存在的目录
+  --overwrite           是否覆盖输出路径中已有文件
+```
+
+示例：
+```shell
+# 对单个图像进行多个操作，actions有2个参数，会输出2个图像文件
+img-processor -P tests/imgs/lenna-400x225.jpg -O /tmp/ --action resize,s_300 circle,r_100 --overwrite
+```
+
+> 注意：action参数仅支持字符串表达形式。
+
+
+## 提取图像主色调
+```python
+from imgprocessor.processor import extract_main_color
+
+extract_main_color("tests/imgs/lenna-400x225.jpg")
+# 输出： "905C4C"
+```

py_img_processor-1.0.0/README.md

@@ -0,0 +1,138 @@
+# py-img-processor
+
+[![PyPI - Version](https://img.shields.io/pypi/v/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![GitHub Actions Workflow Status](https://github.com/SkylerHu/py-img-processor/actions/workflows/pre-commit.yml/badge.svg?branch=master)](https://github.com/SkylerHu/py-img-processor)
+[![GitHub Actions Workflow Status](https://github.com/SkylerHu/py-img-processor/actions/workflows/test-py3.yml/badge.svg?branch=master)](https://github.com/SkylerHu/py-img-processor)
+[![Coveralls](https://img.shields.io/coverallsCoverage/github/SkylerHu/py-img-processor?branch=master)](https://github.com/SkylerHu/py-img-processor)
+[![PyPI - Wheel](https://img.shields.io/pypi/wheel/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![PyPI - Implementation](https://img.shields.io/pypi/implementation/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+[![GitHub License](https://img.shields.io/github/license/SkylerHu/py-img-processor)](https://github.com/SkylerHu/py-img-processor)
+
+
+Image editor using Python and Pillow.
+
+依赖Pillow开发的Python库，用于图像编辑处理。
+
+
+## 1. 安装
+
+	pip install py-img-processor
+
+依赖：
+
+- `Python >= 3.9`
+- `Pillow >= 8.0.0`
+
+可查看版本变更记录 [ChangeLog](./docs/CHANGELOG-1.x.md)
+
+## 2. 使用(Usage)
+
+具体使用说明查看 [readthedocs](https://py-img-processor.readthedocs.io) 。
+
+## 2.1 运行配置
+可以通过指定环境变量`PY_SETTINGS_MODULE`加载配置文件：
+
+    export PY_SETTINGS_MODULE=${your_project.settings_file.py}
+
+支持的配置项有：
+
+| 配置项 | 类型 | 说明 | 默认值 |
+| - | - | - | - |
+| DEBUG | bool | 是否debug开发模式 | False |
+| PROCESSOR_MAX_FILE_SIZE | int | 处理原图的大小限制， 单位 MB | 20 |
+| PROCESSOR_MAX_W_H | int | 处理图像，原图宽高像素限制 | 30000 |
+| PROCESSOR_MAX_PIXEL | int | width x height总像素3亿，处理前后的值都被此配置限制 | 300000000 |
+| PROCESSOR_DEFAULT_QUALITY | int | 图像处理后的默认质量 | 75 |
+| PROCESSOR_TEXT_FONT | str | 默认字体文件，默认从系统中寻找；也可以直接传递字体文件路径 | Arial Unicode.ttf |
+
+> `注意`：`PROCESSOR_TEXT_FONT` 字体的设置是文字水印必要参数，需保证系统已安装该字体。默认值 `Arial Unicode.ttf` 是MacOS系统存在的字体，建议设置字体文件路径。
+
+## 2.2 图像处理
+### 处理函数
+`process_image_by_path(input_path, out_path, params)`
+
+参数说明：
+
+- `input_path` str，输入图像文件路径
+- `out_path` str, 输出图像保存路径
+- `params` str or json，图像处理参数，参数说明详见 [Reference.md](./docs/Reference.md)
+
+
+### 图像处理参数为字符串
+
+- 斜线 `/` 隔开，区分不同的操作；
+- 逗号 `,` 隔开，区分操作中不同的参数；
+- 下划线 `_` 隔开，`key_value` 的形式，区分参数的Key和Value；
+- `value`是复杂参数时，需要进行`base64url_encode`，是否需要encode查看文档参数详细说明；
+
+```python
+from imgprocessor.utils import base64url_encode
+from imgprocessor.processor import process_image_by_path
+
+process_image_by_path(
+    "tests/imgs/lenna-400x225.jpg",
+    "/tmp/output.png",
+    # 对图片缩放、裁剪、生成圆角、并转成png存储
+    "resize,s_1080/crop,w_700,h_700//watermark,text_{base64url_encode('Hello 世界')}/circle,r_10/format,png",
+)
+```
+
+### 图像处理参数为JSON
+- 只是形式不同，参数和字符串形式无本质区别；
+- `format`、`quality`、`interlace`三个值在JSON第一层，直接按照`key: value`的形式设置；
+- 其他参数都放在 `actions` 数组中；
+
+```python
+process_image_by_path(
+    "tests/imgs/lenna-400x225.jpg",
+    "/tmp/output.png",
+    {
+        "actions": [
+            {"key": "resize", "s": 1080},
+            {"key": "crop", "w": 700, "h": 700},
+            # JSON形式参数, text无需encode
+            {"key": "watermark", "text": "Hello 世界"},
+            {"key": "circle", "r": 10},
+        ],
+        "format": "png",
+    },
+)
+```
+该操作与上述字符串示例参数等效。
+
+## 命令行
+安装库后 有可执行命令 `img-processor` 可以使用，通过 `img-processor -h` 查看参数说明。
+
+```shell
+usage: img-processor [-h] [-V] -P PATH [--action ACTION [ACTION ...]] -O OUTPUT [--overwrite]
+
+图像处理
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -V, --version         show program's version number and exit
+  -P PATH, --path PATH  输入图像的文件路径/目录，若是目录则批量处理目录下所有图像
+  --action ACTION [ACTION ...]
+                        操作参数，可对同一个文件多组操作
+  -O OUTPUT, --output OUTPUT
+                        输出图像路径，多个图像或多个操作时请设置已存在的目录
+  --overwrite           是否覆盖输出路径中已有文件
+```
+
+示例：
+```shell
+# 对单个图像进行多个操作，actions有2个参数，会输出2个图像文件
+img-processor -P tests/imgs/lenna-400x225.jpg -O /tmp/ --action resize,s_300 circle,r_100 --overwrite
+```
+
+> 注意：action参数仅支持字符串表达形式。
+
+
+## 提取图像主色调
+```python
+from imgprocessor.processor import extract_main_color
+
+extract_main_color("tests/imgs/lenna-400x225.jpg")
+# 输出： "905C4C"
+```

py_img_processor-1.0.0/imgprocessor/__init__.py

@@ -0,0 +1,68 @@
+import typing
+import os
+import traceback
+import importlib
+
+
+__all__ = ["settings", "VERSION"]
+__version__ = "1.0.0"
+
+
+VERSION = __version__
+
+_BLACK_ATTRS = ["_settings", "__dict__"]
+
+
+class SettingsProxy(object):
+
+    def __init__(self) -> None:
+        _settings = None
+        # 兼容在Django项目中的使用
+        _settings_module = os.environ.get("PY_SETTINGS_MODULE") or os.environ.get("DJANGO_SETTINGS_MODULE")
+        try:
+            if _settings_module:
+                _settings = importlib.import_module(_settings_module)
+        except Exception:
+            traceback.print_exc()
+            print('Please set the correct "PY_SETTINGS_MODULE".')
+
+        self._settings = _settings
+
+    # 是否调试模式
+    DEBUG = False
+
+    # 处理原图的大小限制， 单位 MB
+    PROCESSOR_MAX_FILE_SIZE = 20
+    # 处理图像，原图宽高像素限制
+    PROCESSOR_MAX_W_H = 30000
+    # width x height总像素3亿，处理前后的值都被此配置限制
+    PROCESSOR_MAX_PIXEL = 300000000
+    # 图像处理后的默认质量
+    PROCESSOR_DEFAULT_QUALITY = 75
+    # 默认字体文件; 默认配置了MacOS系统中的字体
+    PROCESSOR_TEXT_FONT = "Arial Unicode.ttf"
+
+    def __getattribute__(self, attr: str) -> typing.Any:
+        try:
+            if attr in _BLACK_ATTRS:
+                # 白名单，内置属性直接返回
+                return super(SettingsProxy, self).__getattribute__(attr)
+
+            if self._settings is not None and hasattr(self._settings, attr):
+                value = getattr(self._settings, attr)
+            else:
+                value = super(SettingsProxy, self).__getattribute__(attr)
+        except AttributeError:
+            raise AttributeError('settings has no attribute "{}"'.format(attr))
+        return value
+
+    def __setattr__(self, name: str, value: typing.Any) -> None:
+        if name in _BLACK_ATTRS and not hasattr(self, name):
+            return super(SettingsProxy, self).__setattr__(name, value)
+        raise AttributeError("All properties of settings are not allowed to be changed.")
+
+    def __delattr__(self, name: str) -> None:
+        raise AttributeError("All properties of settings are not allowed to be changed.")
+
+
+settings = SettingsProxy()

py_img_processor-1.0.0/imgprocessor/enums.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python
+# coding=utf-8
+from py_enum import ChoiceEnum
+
+
+class ImageFormat(ChoiceEnum):
+    """图像转换的格式"""
+
+    JPEG = ("JPEG", "JPEG")
+    PNG = ("PNG", "PNG")
+    WEBP = ("WebP", "WebP")
+
+
+class ImageOrientation(ChoiceEnum):
+    """
+    图片EXIF中的方向枚举，第0行0列的位置(即图像正常显示右上角的位置)
+
+    see http://sylvana.net/jpegcrop/exif_orientation.html
+    """
+
+    TOP_LEFT = (1, "0度：正确方向，无需调整")
+    TOP_RIGHT = (2, "水平翻转")
+    BOTTOM_RIGHT = (3, "180度旋转")
+    BOTTOM_LEFT = (4, "水平翻转+180度旋转")  # 垂直翻转
+    LEFT_TOP = (5, "水平翻转+顺时针270度")
+    RIGHT_TOP = (6, "顺时针270度")
+    RIGHT_BOTTOM = (7, "水平翻转+顺时针90度")
+    LEFT_BOTTOM = (8, "顺时针90°")
+
+
+class OpAction(ChoiceEnum):
+    """支持的操作类型"""
+
+    # 以下几个比较特殊，在保存文件时使用
+    FORMAT = ("format", "格式")
+    QUALITY = ("quality", "质量")
+    INTERLACE = ("interlace", "渐进显示")
+    # 其他
+    RESIZE = ("resize", "缩放")
+    CROP = ("crop", "裁剪")
+    CIRCLE = ("circle", "圆角")
+    BLUR = ("blur", "模糊效果")
+    ROTATE = ("rotate", "旋转")
+    ALPHA = ("alpha", "透明度")
+    GRAY = ("gray", "灰度图")
+    WATERMARK = ("watermark", "水印")
+    # 特殊操作
+    MERGE = ("merge", "合并图像")
+
+
+class ResizeMode(ChoiceEnum):
+    """图像缩放的模式"""
+
+    LFIT = ("lfit", "等比缩放，缩放图限制为指定w与h的矩形内的最大图片")  # 类似ImageOps.contain
+    MFIT = ("mfit", "等比缩放，缩放图为延伸出指定w与h的矩形框外的最小图片")  # 类似ImageOps.cover
+    FIT = ("fit", "将原图等比缩放为延伸出指定w与h的矩形框外的最小图片，然后将超出的部分进行居中裁剪")  # ImageOps.fit
+    PAD = ("pad", "将原图缩放为指定w与h的矩形内的最大图片，然后使用指定颜色居中填充空白部分")  # ImageOps.pad
+    FIXED = ("fixed", "固定宽高，强制缩放")
+
+
+class ArgType(ChoiceEnum):
+    STRING = ("str", "字符串")
+    INTEGER = ("int", "整数")
+    FLOAT = ("float", "浮点数")
+
+
+class Geography(ChoiceEnum):
+    """图像中的九宫格位置"""
+
+    NW = ("nw", "左上")
+    NORTH = ("north", "中上")
+    NE = ("ne", "右上")
+    WEST = ("west", "左中")
+    CENTER = ("center", "中部")
+    EAST = ("east", "右中")
+    SW = ("sw", "左下")
+    SOUTH = ("south", "中下")
+    SE = ("se", "右下")
+
+
+class PositionOrder(ChoiceEnum):
+    """两个元素的前后顺序"""
+
+    BEFORE = (0, "第一输入元素在前/在上")  # 图片在前
+    AFTER = (1, "第一个输入元素在后/在下")  # 文字在前
+
+
+class PositionAlign(ChoiceEnum):
+    """两个元素的对齐方式"""
+
+    TOP = (0, "水平上对齐")
+    HORIZONTAL_CENTER = (1, "水平居中对齐")
+    BOTTOM = (2, "水平下对齐")
+    LEFT = (3, "垂直左对齐")
+    VERTIAL_CENTER = (4, "垂直居中对齐")
+    RIGHT = (5, "垂直右对齐")

py_img_processor-1.0.0/imgprocessor/exceptions.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python
+# coding=utf-8
+
+
+class ProcessException(Exception):
+    """图像处理异常基类"""
+
+    pass
+
+
+class ProcessLimitException(Exception):
+    """图像处理限制"""
+
+    pass
+
+
+class ParamParseException(ProcessException):
+    """解析参数出现错误"""
+
+    pass
+
+
+class ParamValidateException(ProcessException):
+    """对参数进行校验"""
+
+    pass

py_img_processor-1.0.0/imgprocessor/main.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python
+# coding=utf-8
+import typing
+import os
+import sys
+import argparse
+import traceback
+
+from imgprocessor import VERSION
+from imgprocessor.processor import process_image_by_path
+
+
+def main(argv: typing.Optional[list[str]] = None) -> int:
+    argv = argv if argv is not None else sys.argv[1:]
+    parser = argparse.ArgumentParser(
+        prog="img-processor",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        description="图像处理",
+    )
+
+    parser.add_argument("-V", "--version", action="version", version=f"%(prog)s {VERSION}")
+    parser.add_argument(
+        "-P", "--path", type=str, required=True, help="输入图像的文件路径/目录，若是目录则批量处理目录下所有图像"
+    )
+    parser.add_argument("--action", type=str, nargs="+", help="操作参数，可对同一个文件多组操作")
+    parser.add_argument(
+        "-O", "--output", type=str, required=True, help="输出图像路径，多个图像或多个操作时请设置已存在的目录"
+    )
+    parser.add_argument("--overwrite", action="store_true", help="是否覆盖输出路径中已有文件")
+
+    args = parser.parse_args(argv)
+
+    # 输入
+    path = args.path
+    base_dir = path
+    # 初始化输入图像文件列表
+    file_paths = []
+    if os.path.isdir(path):
+        for path, dir_list, file_list in os.walk(path):
+            for file_name in file_list:
+                p = os.path.join(path, file_name)
+                file_paths.append(p)
+    else:
+        file_paths = [path]
+        base_dir = os.path.dirname(path)
+
+    total = len(file_paths)
+    ac_num = len(args.action)
+
+    # 输出目录
+    output = args.output
+    if (total > 1 or ac_num > 1) and not os.path.isdir(output):
+        print("\033[31m参数output目录不存在,请先创建\033[0m", file=sys.stderr, flush=True)
+        return 1
+    count = 0
+    for file_path in file_paths:
+        count += 1
+        f_tag = f"{count}/{total}\t处理 {file_path}"
+        print(f_tag, flush=True, end="\r")
+        # 相对path的相对路径
+        if not base_dir or base_dir in [".", "./"]:
+            relative_path = file_path
+        else:
+            relative_path = file_path.split(base_dir, 1)[-1]
+        relative_path = relative_path.strip("/")
+
+        prefix, ext = os.path.splitext(relative_path)
+        for idx, param_str in enumerate(args.action):
+            # 初始化目标文件路径
+            if total == 1 and ac_num == 1 and os.path.splitext(output)[-1]:
+                out_path = output
+            else:
+                if ac_num == 1:
+                    target_name = relative_path
+                else:
+                    target_name = f"{prefix}-{idx}.{ext}"
+                out_path = os.path.join(output, target_name)
+
+            tag = f"{f_tag}\t action={idx + 1}\t 保存于 {out_path}"
+            print(f"{tag}\t ...", flush=True, end="\r")
+
+            # 判断目标文件是否存在
+            if os.path.exists(out_path):
+                if not args.overwrite:
+                    print(f"\033[31m{tag} 目标文件已存在\033[0m", file=sys.stderr, flush=True)
+                    print("处理中断，可以添加参数 \033[33m--overwrite\033[0m 覆盖现有文件", file=sys.stderr, flush=True)
+                    return 1
+
+                tag = f"{tag}\t \033[33moverwrite\033[0m"
+
+            cur_out_dir = os.path.dirname(out_path)
+            if not os.path.exists(cur_out_dir):
+                os.makedirs(cur_out_dir)
+            try:
+                process_image_by_path(file_path, out_path, param_str)
+                print(f"{tag}\t 成功", flush=True)
+            except Exception as e:
+                print(f"{tag}\t \033[31m失败：{e}\033[0m", file=sys.stderr, flush=True)
+                print(traceback.format_exc(), file=sys.stderr, flush=True)
+                return 1
+
+    return 0
+
+
+# if __name__ == "__main__":
+#     raise SystemExit(main())