fotolab 0.31.14__tar.gz → 0.31.16__tar.gz

{fotolab-0.31.14 → fotolab-0.31.16}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: fotolab
-Version: 0.31.14
-Summary: A console program that manipulate images.
-Keywords: photography,photo
+Version: 0.31.16
 Author-email: Kian-Meng Ang <kianmeng@cpan.org>
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
+License-Expression: AGPL-3.0-or-later
+Project-URL: Changelog, https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/kianmeng/fotolab/issues
+Project-URL: Source, https://github.com/kianmeng/fotolab
+Keywords: photography,photo
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -16,11 +16,11 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Requires-Dist: pillow
-Project-URL: Changelog, https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
-Project-URL: Issues, https://github.com/kianmeng/fotolab/issues
-Project-URL: Source, https://github.com/kianmeng/fotolab
+Dynamic: license-file
 
 # fotolab
 
@@ -471,4 +471,3 @@ The fish logo used in the documentation generated by Sphinx is a public domain
 drawing of male freshwater phase [Sockeye (red) salmon (Oncorhynchus nerka)]
 (https://en.wikipedia.org/w/index.php?oldid=1186575702) from
 <https://commons.wikimedia.org/entity/M2787002>.
-

{fotolab-0.31.14 → fotolab-0.31.16}/pyproject.toml

@@ -1,17 +1,21 @@
 [build-system]
-build-backend = "flit_core.buildapi"
-requires = ["flit_core"]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
 
 [project]
 name = "fotolab"
+version = "0.31.16"
 authors = [{name = "Kian-Meng Ang", email = "kianmeng@cpan.org"}]
 requires-python = ">=3.9"
 readme = "README.md"
-license = {file = "LICENSE.md"}
+license = "AGPL-3.0-or-later"
+license-files = ["LICENSE.md"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Environment :: Console",
-    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
@@ -20,8 +24,6 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python",
 ]
-version = "0.31.14"
-dynamic = ["description"]
 keywords = ["photography", "photo"]
 dependencies = [
     "pillow",
@@ -38,7 +40,6 @@ fotolab = "fotolab.cli:main"
 [dependency-groups]
 dev = [
     "exceptiongroup",
-    "flit",
     "importlib-metadata",
     "myst-parser",
     "nox",
@@ -54,3 +55,7 @@ dev = [
     "sphinx-copybutton",
     "tomli",
 ]
+
+# verify through: uv run ruff check --show-settings
+[tool.ruff]
+line-length = 79

fotolab-0.31.16/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

{fotolab-0.31.14 → fotolab-0.31.16/src}/fotolab/__init__.py

@@ -20,12 +20,11 @@ import logging
 import os
 import subprocess
 import sys
-from importlib import metadata
 from pathlib import Path
 
 from PIL import Image
 
-__version__ = metadata.version("fotolab")
+__version__ = "0.31.15"
 
 log = logging.getLogger(__name__)
 

{fotolab-0.31.14 → fotolab-0.31.16/src}/fotolab/subcommands/animate.py

@@ -18,6 +18,7 @@
 import argparse
 import logging
 from pathlib import Path
+from contextlib import ExitStack
 
 from PIL import Image
 
@@ -150,14 +151,13 @@ def run(args: argparse.Namespace) -> None:
     log.debug(args)
 
     first_image_filepath = args.image_filenames[0]
-    main_frame = None
     other_frames = []
 
-    try:
-        main_frame = Image.open(first_image_filepath)
+    with ExitStack() as stack:
+        main_frame = stack.enter_context(Image.open(first_image_filepath))
 
         for image_filename in args.image_filenames[1:]:
-            img = Image.open(image_filename)
+            img = stack.enter_context(Image.open(image_filename))
             other_frames.append(img)
 
         image_file = Path(first_image_filepath)
@@ -188,11 +188,6 @@ def run(args: argparse.Namespace) -> None:
             save_kwargs["method"] = args.webp_method
 
         main_frame.save(new_filename, **save_kwargs)
-    finally:
-        if main_frame:
-            main_frame.close()
-        for frame in other_frames:
-            frame.close()
 
     if args.open:
         _open_image(new_filename)

fotolab-0.31.16/src/fotolab.egg-info/PKG-INFO

@@ -0,0 +1,473 @@
+Metadata-Version: 2.4
+Name: fotolab
+Version: 0.31.16
+Author-email: Kian-Meng Ang <kianmeng@cpan.org>
+License-Expression: AGPL-3.0-or-later
+Project-URL: Changelog, https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/kianmeng/fotolab/issues
+Project-URL: Source, https://github.com/kianmeng/fotolab
+Keywords: photography,photo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+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 :: 3.13
+Classifier: Programming Language :: Python
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: pillow
+Dynamic: license-file
+
+# fotolab
+
+A console program to manipulate photos.
+
+## Installation
+
+Stable version From PyPI using `uv`:
+
+```console
+uv tool install fotolab
+```
+
+Upgrade to latest stable version:
+
+```console
+uv tool upgrade fotolab
+```
+
+## Usage
+
+```console
+fotolab -h
+```
+
+<!--help !-->
+
+```console
+usage: fotolab [-h] [-o] [-q] [-v] [-d] [-V]
+               {animate,auto,border,contrast,env,halftone,info,montage,resize,rotate,sharpen,watermark} ...
+
+A console program to manipulate photos.
+
+website: https://github.com/kianmeng/fotolab
+changelog: https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
+issues: https://github.com/kianmeng/fotolab/issues
+
+positional arguments:
+  {animate,auto,border,contrast,env,halftone,info,montage,resize,rotate,sharpen,watermark}
+                    sub-command help
+    animate         animate an image
+    auto            auto adjust (resize, contrast, and watermark) a photo
+    border          add border to image
+    contrast        contrast an image.
+    env             print environment information for bug reporting
+    halftone        halftone an image
+    info            info an image
+    montage         montage a list of image
+    resize          resize an image
+    rotate          rotate an image
+    sharpen         sharpen an image
+    watermark       watermark an image
+
+options:
+  -h, --help        show this help message and exit
+  -o, --overwrite   overwrite existing image
+  -q, --quiet       suppress all logging
+  -v, --verbose     show verbosity of debugging log, use -vv, -vvv for more details
+  -d, --debug       show debugging log and stacktrace
+  -V, --version     show program's version number and exit
+```
+
+<!--help !-->
+
+### fotolab animate
+
+```console
+fotolab animate -h
+```
+
+<!--help-animate !-->
+
+```console
+usage: fotolab animate [-h] [-f FORMAT] [-d DURATION] [-l LOOP] [-op]
+                       [--webp-quality QUALITY] [--webp-lossless]
+                       [--webp-method METHOD] [-od OUTPUT_DIR]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -f, --format FORMAT   set the image format (default: 'gif')
+  -d, --duration DURATION
+                        set the duration in milliseconds (must be a positive
+                        integer, default: '2500')
+  -l, --loop LOOP       set the loop cycle (default: '0')
+  -op, --open           open the image using default program (default:
+                        'False')
+  --webp-quality QUALITY
+                        set WEBP quality (0-100, default: '80')
+  --webp-lossless       enable WEBP lossless compression (default: 'False')
+  --webp-method METHOD  set WEBP encoding method (0=fast, 6=slow/best,
+                        default: '4')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-animate !-->
+
+### fotolab auto
+
+```console
+fotolab auto -h
+```
+
+<!--help-auto !-->
+
+```console
+usage: fotolab auto [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES  set the image filename
+
+options:
+  -h, --help       show this help message and exit
+```
+
+<!--help-auto !-->
+
+### fotolab border
+
+```console
+fotolab border -h
+```
+
+<!--help-border !-->
+
+```console
+usage: fotolab border [-h] [-c COLOR] [-w WIDTH] [-wt WIDTH] [-wr WIDTH]
+                      [-wb WIDTH] [-wl WIDTH] [-op] [-od OUTPUT_DIR]
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -c, --color COLOR     set the color of border (default: 'black')
+  -w, --width WIDTH     set the width of border in pixels (default: '10')
+  -wt, --width-top WIDTH
+                        set the width of top border in pixels (default: '0')
+  -wr, --width-right WIDTH
+                        set the width of right border in pixels (default: '0')
+  -wb, --width-bottom WIDTH
+                        set the width of bottom border in pixels (default:
+                        '0')
+  -wl, --width-left WIDTH
+                        set the width of left border in pixels (default: '0')
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-border !-->
+
+### fotolab contrast
+
+```console
+fotolab contrast -h
+```
+
+<!--help-contrast !-->
+
+```console
+usage: fotolab contrast [-h] [-c CUTOFF] [-op] [-od OUTPUT_DIR]
+                        IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filename
+
+options:
+  -h, --help            show this help message and exit
+  -c, --cutoff CUTOFF   set the percentage (0-50) of lightest or darkest
+                        pixels to discard from histogram (default: '1.0')
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-contrast !-->
+
+### fotolab halftone
+
+```console
+fotolab halftone -h
+```
+
+<!--help-halftone !-->
+
+```console
+usage: fotolab halftone [-h] [-ba] [-op] [-od OUTPUT_DIR] [-c CELLS] [-g]
+                        IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filename
+
+options:
+  -h, --help            show this help message and exit
+  -ba, --before-after   generate a GIF showing before and after changes
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+  -c, --cells CELLS     set number of cells across the image width (default:
+                        50)
+  -g, --grayscale       convert image to grayscale before applying halftone
+```
+
+<!--help-halftone !-->
+
+### fotolab info
+
+```console
+fotolab info -h
+```
+
+<!--help-info !-->
+
+```console
+usage: fotolab info [-h] [-s] [--camera] [--datetime] IMAGE_FILENAME
+
+positional arguments:
+  IMAGE_FILENAME  set the image filename
+
+options:
+  -h, --help      show this help message and exit
+  -s, --sort      show image info by sorted field name
+  --camera        show the camera maker details
+  --datetime      show the datetime
+```
+
+<!--help-info !-->
+
+### fotolab rotate
+
+```console
+fotolab rotate -h
+```
+
+<!--help-rotate !-->
+
+```console
+usage: fotolab rotate [-h] [-r ROTATION] [-cw] [-op] [-od OUTPUT_DIR]
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -r, --rotation ROTATION
+                        Rotation angle in degrees (default: '0')
+  -cw, --clockwise      Rotate clockwise (default: 'False)
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-rotate !-->
+
+### fotolab montage
+
+```console
+fotolab montage -h
+```
+
+<!--help-montage !-->
+
+```console
+usage: fotolab montage [-h] [-op] [-od OUTPUT_DIR]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-montage !-->
+
+### fotolab resize
+
+```console
+fotolab resize -h
+```
+
+<!--help-resize !-->
+
+```console
+usage: fotolab resize [-h] [-c] [-l CANVAS_COLOR] [-W WIDTH | -H HEIGHT] [-op]
+                      [-od OUTPUT_DIR]
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filename
+
+options:
+  -h, --help            show this help message and exit
+  -c, --canvas          paste image onto a larger canvas
+  -l, --canvas-color CANVAS_COLOR
+                        the color of the extended larger canvas(default:
+                        'black')
+  -W, --width WIDTH     set the width of the image (default: '600')
+  -H, --height HEIGHT   set the height of the image (default: '277')
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-resize !-->
+
+### fotolab sharpen
+
+```console
+fotolab sharpen -h
+```
+
+<!--help-sharpen !-->
+
+```console
+usage: fotolab sharpen [-h] [-r RADIUS] [-p PERCENT] [-t THRESHOLD] [-ba]
+                       [-op] [-od OUTPUT_DIR]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -r, --radius RADIUS   set the radius or size of edges (default: '1')
+  -p, --percent PERCENT
+                        set the amount of overall strength of sharpening
+                        effect (default: '100')
+  -t, --threshold THRESHOLD
+                        set the minimum brightness changed to be sharpened
+                        (default: '3')
+  -ba, --before-after   generate a GIF showing before and after changes
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-sharpen !-->
+
+### fotolab watermark
+
+```console
+fotolab watermark -h
+```
+
+<!--help-watermark !-->
+
+```console
+usage: fotolab watermark [-h] [-t WATERMARK_TEXT]
+                         [-p {top-left,top-right,bottom-left,bottom-right}]
+                         [-pd PADDING] [-fs FONT_SIZE] [-fc FONT_COLOR]
+                         [-ow OUTLINE_WIDTH] [-oc OUTLINE_COLOR]
+                         [-a ALPHA_VALUE] [--camera]
+                         [-l | --lowercase | --no-lowercase] [-op]
+                         [-od OUTPUT_DIR]
+                         IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -t, --text WATERMARK_TEXT
+                        set the watermark text (default: 'kianmeng.org')
+  -p, --position {top-left,top-right,bottom-left,bottom-right}
+                        set position of the watermark text (default: 'bottom-
+                        left')
+  -pd, --padding PADDING
+                        set the padding of the watermark text relative to the
+                        image (default: '15')
+  -fs, --font-size FONT_SIZE
+                        set the font size of watermark text (default: '12')
+  -fc, --font-color FONT_COLOR
+                        set the font color of watermark text (default:
+                        'white')
+  -ow, --outline-width OUTLINE_WIDTH
+                        set the outline width of the watermark text (default:
+                        '2')
+  -oc, --outline-color OUTLINE_COLOR
+                        set the outline color of the watermark text (default:
+                        'black')
+  -a, --alpha ALPHA_VALUE
+                        set the transparency of the watermark text (0-255,
+                        where 0 is fully transparent and 255 is fully opaque;
+                        default: '128')
+  --camera              use camera metadata as watermark
+  -l, --lowercase, --no-lowercase
+                        lowercase the watermark text
+  -op, --open           open the image using default program (default:
+                        'False')
+  -od, --output-dir OUTPUT_DIR
+                        set default output folder (default: 'output')
+```
+
+<!--help-watermark !-->
+
+### fotolab env
+
+```console
+fotolab env -h
+```
+
+<!--help-env !-->
+
+```console
+usage: fotolab env [-h]
+
+options:
+  -h, --help  show this help message and exit
+```
+
+<!--help-env !-->
+
+## Copyright and License
+
+Copyright (C) 2024,2025 Kian-Meng Ang
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU Affero General Public License as published by the Free
+Software Foundation, either version 3 of the License, or (at your option) any
+later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with this program. If not, see <https://www.gnu.org/licenses/>.
+
+The fish logo used in the documentation generated by Sphinx is a public domain
+drawing of male freshwater phase [Sockeye (red) salmon (Oncorhynchus nerka)]
+(https://en.wikipedia.org/w/index.php?oldid=1186575702) from
+<https://commons.wikimedia.org/entity/M2787002>.

fotolab-0.31.16/src/fotolab.egg-info/SOURCES.txt

@@ -0,0 +1,39 @@
+LICENSE.md
+README.md
+pyproject.toml
+src/fotolab/__init__.py
+src/fotolab/__main__.py
+src/fotolab/cli.py
+src/fotolab.egg-info/PKG-INFO
+src/fotolab.egg-info/SOURCES.txt
+src/fotolab.egg-info/dependency_links.txt
+src/fotolab.egg-info/entry_points.txt
+src/fotolab.egg-info/requires.txt
+src/fotolab.egg-info/top_level.txt
+src/fotolab/subcommands/__init__.py
+src/fotolab/subcommands/animate.py
+src/fotolab/subcommands/auto.py
+src/fotolab/subcommands/border.py
+src/fotolab/subcommands/contrast.py
+src/fotolab/subcommands/env.py
+src/fotolab/subcommands/halftone.py
+src/fotolab/subcommands/info.py
+src/fotolab/subcommands/montage.py
+src/fotolab/subcommands/resize.py
+src/fotolab/subcommands/rotate.py
+src/fotolab/subcommands/sharpen.py
+src/fotolab/subcommands/watermark.py
+tests/test_animate_subcommand.py
+tests/test_auto_subcommand.py
+tests/test_border_subcommand.py
+tests/test_contrast_subcommand.py
+tests/test_env_subcommand.py
+tests/test_halftone_subcommand.py
+tests/test_help_flag.py
+tests/test_info_subcommand.py
+tests/test_montage_subcommand.py
+tests/test_quiet_flag.py
+tests/test_resize_subcommand.py
+tests/test_rotate_subcommand.py
+tests/test_sharpen_subcommand.py
+tests/test_watermark_subcommand.py

fotolab-0.31.16/src/fotolab.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fotolab-0.31.16/src/fotolab.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fotolab = fotolab.cli:main

fotolab-0.31.16/src/fotolab.egg-info/requires.txt

@@ -0,0 +1 @@
+pillow

fotolab-0.31.16/src/fotolab.egg-info/top_level.txt

@@ -0,0 +1 @@
+fotolab

fotolab-0.31.16/tests/test_animate_subcommand.py

@@ -0,0 +1,21 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_animate_subcommand(cli_runner, image_file):
+    img_path1 = image_file("sample.png")
+    img_path2 = image_file("sample.png")
+    ret = cli_runner("animate", str(img_path1), str(img_path2))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_auto_subcommand.py

@@ -0,0 +1,21 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_auto_subcommand(cli_runner, image_file):
+    """Test auto subcommand."""
+    img_path = image_file("sample.png")
+    ret = cli_runner("auto", str(img_path))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_border_subcommand.py

@@ -0,0 +1,37 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_border_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("border", str(img_path), "--width", "10")
+    assert ret.returncode == 0
+
+
+def test_border_subcommand_with_individual_widths(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner(
+        "border",
+        str(img_path),
+        "--width-top",
+        "5",
+        "--width-right",
+        "10",
+        "--width-bottom",
+        "15",
+        "--width-left",
+        "20",
+    )
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_contrast_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_contrast_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("contrast", str(img_path))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_env_subcommand.py

@@ -0,0 +1,36 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import platform
+import sys
+
+from fotolab import __version__
+
+
+def test_env_output(cli_runner):
+    ret = cli_runner("env")
+
+    actual_sys_version = sys.version.replace("\n", "")
+    actual_platform = platform.platform()
+
+    expected_output = (
+        f"fotolab: {__version__}\n"
+        f"python: {actual_sys_version}\n"
+        f"platform: {actual_platform}\n"
+    )
+
+    assert ret.stdout == expected_output
+    assert ret.stderr == ""
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_halftone_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_halftone_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("halftone", str(img_path))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_help_flag.py

@@ -0,0 +1,22 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import pytest
+
+
+@pytest.mark.parametrize("option", ["-h", "--help"])
+def test_help_message(cli_runner, option):
+    ret = cli_runner(option)
+    assert "A console program to manipulate photos." in ret.stdout

fotolab-0.31.16/tests/test_info_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_info_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("info", str(img_path))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_montage_subcommand.py

@@ -0,0 +1,29 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_montage_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("montage", str(img_path), str(img_path))
+    assert ret.returncode == 0
+
+
+def test_montage_subcommand_with_single_image_raises_error(
+    cli_runner, image_file
+):
+    img_path = image_file("sample.png")
+    ret = cli_runner("montage", str(img_path))
+    assert ret.returncode != 0
+    assert "error: at least two images is required for montage" in ret.stdout

fotolab-0.31.16/tests/test_quiet_flag.py

@@ -0,0 +1,22 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import pytest
+
+
+@pytest.mark.parametrize("option", ["-q", "--quiet"])
+def test_no_debug_logs(cli_runner, option):
+    ret = cli_runner(option)
+    assert "debug=True" not in ret.stderr

fotolab-0.31.16/tests/test_resize_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_resize_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("resize", str(img_path), "--width", "200")
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_rotate_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_rotate_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("rotate", str(img_path))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_sharpen_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_sharpen_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("sharpen", str(img_path))
+    assert ret.returncode == 0

fotolab-0.31.16/tests/test_watermark_subcommand.py

@@ -0,0 +1,20 @@
+# Copyright (C) 2024,2025 Kian-Meng Ang
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+def test_watermark_subcommand(cli_runner, image_file):
+    img_path = image_file("sample.png")
+    ret = cli_runner("watermark", str(img_path), "--text", "Test")
+    assert ret.returncode == 0