fotolab 0.31.15__tar.gz → 0.32.0__tar.gz

{fotolab-0.31.15 → fotolab-0.32.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: fotolab
-Version: 0.31.15
-Summary: A console program that manipulate images.
-Keywords: photography,photo
+Version: 0.32.0
 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,25 @@ 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
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-randomly; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: scripttest; extra == "test"
+Provides-Extra: doc
+Requires-Dist: myst-parser; extra == "doc"
+Requires-Dist: sphinx; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints; extra == "doc"
+Requires-Dist: sphinx-copybutton; extra == "doc"
+Provides-Extra: lint
+Requires-Dist: pre-commit; extra == "lint"
+Requires-Dist: ruff; extra == "lint"
+Dynamic: license-file
 
 # fotolab
 
@@ -471,4 +485,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.15 → fotolab-0.32.0}/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.32.0"
 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.15"
-dynamic = ["description"]
 keywords = ["photography", "photo"]
 dependencies = [
     "pillow",
@@ -35,26 +37,41 @@ Source = "https://github.com/kianmeng/fotolab"
 [project.scripts]
 fotolab = "fotolab.cli:main"
 
-[dependency-groups]
-dev = [
-    "exceptiongroup",
-    "flit",
-    "importlib-metadata",
-    "myst-parser",
-    "nox",
-    "pre-commit",
+[project.optional-dependencies]
+test = [
     "pytest",
     "pytest-cov",
     "pytest-randomly",
     "pytest-xdist",
-    "ruff",
     "scripttest",
+]
+
+doc = [
+    "myst-parser",
     "sphinx",
     "sphinx-autodoc-typehints",
     "sphinx-copybutton",
-    "tomli",
+]
+
+lint = [
+    "pre-commit",
+    "ruff",
 ]
 
 # verify through: uv run ruff check --show-settings
 [tool.ruff]
 line-length = 79
+target-version = "py310"
+exclude = [
+    "docs/",
+    "docs/source/conf.py",
+]
+
+[tool.ruff.lint]
+extend-select = [
+    "E",
+    "W",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"

fotolab-0.32.0/setup.cfg

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

{fotolab-0.31.15 → fotolab-0.32.0/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.15 → fotolab-0.32.0/src}/fotolab/subcommands/auto.py

@@ -43,6 +43,16 @@ def build_subparser(subparsers) -> None:
         metavar="IMAGE_FILENAMES",
     )
 
+    auto_parser.add_argument(
+        "-t",
+        "--text",
+        dest="text",
+        help="set the watermark text (default: '%(default)s')",
+        type=str,
+        default="kianmeng.org",
+        metavar="WATERMARK_TEXT",
+    )
+
 
 def run(args: argparse.Namespace) -> None:
     """Run auto subcommand.
@@ -60,7 +70,7 @@ def run(args: argparse.Namespace) -> None:
         "radius": 1,
         "percent": 100,
         "threshold": 2,
-        "text": "kianmeng.org",
+        "text": f"{args.text if args.text else 'kianmeng.org'}",
         "position": "bottom-left",
         "font_size": 12,
         "font_color": "white",
@@ -69,13 +79,18 @@ def run(args: argparse.Namespace) -> None:
         "padding": 15,
         "camera": False,
         "canvas": False,
-        "lowercase": False,
+        "lowercase": True,
         "before_after": False,
         "alpha": 128,
     }
-    combined_args = argparse.Namespace(**vars(args), **extra_args)
+
+    # resolve error: argparse.Namespace() got multiple values for keyword
+    # argument 'text'
+    merged_args = {**vars(args), **extra_args}
+    combined_args = argparse.Namespace(**merged_args)
     combined_args.overwrite = True
     combined_args.open = False
+
     log.debug(args)
     log.debug(combined_args)
 

{fotolab-0.31.15 → fotolab-0.32.0/src}/fotolab/subcommands/watermark.py

@@ -110,7 +110,8 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         type=int,
         default=2,
         help=(
-            "set the outline width of the watermark text (default: '%(default)s')"
+            "set the outline width of the watermark text "
+            "(default: '%(default)s')"
         ),
         metavar="OUTLINE_WIDTH",
     )
@@ -122,7 +123,8 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         type=str,
         default="black",
         help=(
-            "set the outline color of the watermark text (default: '%(default)s')"
+            "set the outline color of the watermark text "
+            "(default: '%(default)s')"
         ),
         metavar="OUTLINE_COLOR",
     )
@@ -325,7 +327,7 @@ def prepare_text(args: argparse.Namespace, image: Image.Image) -> str:
     if args.lowercase:
         text = text.lower()
 
-    return text
+    return text.replace("\\n", "\n")
 
 
 def calc_font_size(image: Image.Image, args: argparse.Namespace) -> int:

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

@@ -0,0 +1,487 @@
+Metadata-Version: 2.4
+Name: fotolab
+Version: 0.32.0
+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
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-randomly; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: scripttest; extra == "test"
+Provides-Extra: doc
+Requires-Dist: myst-parser; extra == "doc"
+Requires-Dist: sphinx; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints; extra == "doc"
+Requires-Dist: sphinx-copybutton; extra == "doc"
+Provides-Extra: lint
+Requires-Dist: pre-commit; extra == "lint"
+Requires-Dist: ruff; extra == "lint"
+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.32.0/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.32.0/src/fotolab.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1,18 @@
+pillow
+
+[doc]
+myst-parser
+sphinx
+sphinx-autodoc-typehints
+sphinx-copybutton
+
+[lint]
+pre-commit
+ruff
+
+[test]
+pytest
+pytest-cov
+pytest-randomly
+pytest-xdist
+scripttest

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

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

fotolab-0.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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.32.0/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