fotolab 0.31.16__py3-none-any.whl → 0.33.0__py3-none-any.whl

fotolab/__init__.py

@@ -31,30 +31,45 @@ log = logging.getLogger(__name__)
 
 def save_gif_image(
     args: argparse.Namespace,
-    image_filename: str,
+    image_filepath: Path,
     original_image: Image.Image,
     after_image: Image.Image,
     subcommand: str,
 ) -> None:
     """Save the original and after image."""
-    image_file = Path(image_filename)
-    new_filename = Path(
-        args.output_dir,
-        image_file.with_name(f"{subcommand}_gif_{image_file.stem}.gif"),
-    )
-    new_filename.parent.mkdir(parents=True, exist_ok=True)
-
-    log.info("%s gif image: %s", subcommand, new_filename)
-    original_image.save(
-        new_filename,
-        format="gif",
-        append_images=[after_image],
-        save_all=True,
-        duration=2500,
-        loop=0,
-        optimize=True,
+    gif_kwargs = {
+        "format": "gif",
+        "append_images": [after_image],
+        "save_all": True,
+        "duration": 2500,
+        "loop": 0,
+        "optimize": True,
+    }
+    _save_image_with_options(
+        args, original_image, image_filepath, subcommand, **gif_kwargs
     )
 
+
+def _save_image_with_options(
+    args: argparse.Namespace,
+    image: Image.Image,
+    output_filepath: Path,
+    subcommand: str,
+    **kwargs,
+) -> None:
+    """Save image with additional options and handle opening.
+
+    Args:
+        args (argparse.Namespace): Config from command line arguments.
+        image (Image.Image): The image to save.
+        output_filepath (Path): The path to save the image to.
+        subcommand (str): The name of the subcommand.
+        **kwargs: Additional keyword arguments for Image.save().
+    """
+    new_filename = _get_output_filename(args, output_filepath, subcommand)
+    log.info("%s image: %s", subcommand, new_filename.resolve())
+    image.save(new_filename, **kwargs)
+
     if args.open:
         _open_image(new_filename)
 
@@ -62,7 +77,7 @@ def save_gif_image(
 def save_image(
     args: argparse.Namespace,
     new_image: Image.Image,
-    output_filename: str,
+    output_filepath: Path,
     subcommand: str,
 ) -> None:
     """Save image after image operation.
@@ -70,13 +85,7 @@ def save_image(
     Returns:
         None
     """
-    image_file = Path(output_filename)
-    new_filename = _get_output_filename(args, image_file, subcommand)
-    log.info("%s image: %s", subcommand, new_filename.resolve())
-    new_image.save(new_filename)
-
-    if args.open:
-        _open_image(new_filename)
+    _save_image_with_options(args, new_image, output_filepath, subcommand)
 
 
 def _get_output_filename(
@@ -91,7 +100,7 @@ def _get_output_filename(
     return output_dir / image_file.with_name(f"{subcommand}_{image_file.name}")
 
 
-def _open_image(filename):
+def _open_image(filename: Path):
     """Open generated image using default program."""
     try:
         if sys.platform == "linux":

fotolab/subcommands/animate.py

@@ -125,7 +125,8 @@ def build_subparser(subparsers) -> None:
         default=4,
         choices=range(0, 7),
         help=(
-            "set WEBP encoding method (0=fast, 6=slow/best, default: '%(default)s')"
+            "set WEBP encoding method "
+            "(0=fast, 6=slow/best, default: '%(default)s')"
         ),
         metavar="METHOD",
     )
@@ -138,6 +139,14 @@ def build_subparser(subparsers) -> None:
         help="set default output folder (default: '%(default)s')",
     )
 
+    animate_parser.add_argument(
+        "-of",
+        "--output-filename",
+        dest="output_filename",
+        default=None,
+        help="set output filename (default: '%(default)s')",
+    )
+
 
 def run(args: argparse.Namespace) -> None:
     """Run animate subcommand.
@@ -150,21 +159,27 @@ def run(args: argparse.Namespace) -> None:
     """
     log.debug(args)
 
-    first_image_filepath = args.image_filenames[0]
+    image_filepaths = [Path(f) for f in args.image_filenames]
+    first_image_filepath = image_filepaths[0]
     other_frames = []
 
     with ExitStack() as stack:
         main_frame = stack.enter_context(Image.open(first_image_filepath))
 
-        for image_filename in args.image_filenames[1:]:
-            img = stack.enter_context(Image.open(image_filename))
+        for image_filepath in image_filepaths[1:]:
+            img = stack.enter_context(Image.open(image_filepath))
             other_frames.append(img)
 
-        image_file = Path(first_image_filepath)
-        new_filename = Path(
-            args.output_dir,
-            image_file.with_name(f"animate_{image_file.stem}.{args.format}"),
-        )
+        if args.output_filename:
+            new_filename = Path(args.output_dir, args.output_filename)
+        else:
+            image_file = Path(first_image_filepath)
+            new_filename = Path(
+                args.output_dir,
+                image_file.with_name(
+                    f"animate_{image_file.stem}.{args.format}"
+                ),
+            )
         new_filename.parent.mkdir(parents=True, exist_ok=True)
 
         log.info("animate image: %s", new_filename)
@@ -175,14 +190,14 @@ def run(args: argparse.Namespace) -> None:
             "save_all": True,
             "duration": args.duration,
             "loop": args.loop,
-            "optimize": True,
         }
 
         # Pillow's WEBP save doesn't use a general 'optimize' like GIF.
-        # Specific WEBP params like 'method' and 'quality' control this.  We
-        # can remove 'optimize' if it causes issues or is ignored for WEBP.
-        # For now, let's keep it, Pillow might handle it or ignore it.
-        if args.format == "webp":
+        # Specific WEBP params like 'method' and 'quality' control this.
+        # 'optimize' is removed for WEBP to avoid confusion.
+        if args.format == "gif":
+            save_kwargs["optimize"] = True
+        elif args.format == "webp":
             save_kwargs["quality"] = args.webp_quality
             save_kwargs["lossless"] = args.webp_lossless
             save_kwargs["method"] = args.webp_method

fotolab/subcommands/auto.py

@@ -18,6 +18,7 @@
 import argparse
 import logging
 
+import fotolab.subcommands.animate
 import fotolab.subcommands.contrast
 import fotolab.subcommands.resize
 import fotolab.subcommands.sharpen
@@ -43,6 +44,26 @@ def build_subparser(subparsers) -> None:
         metavar="IMAGE_FILENAMES",
     )
 
+    auto_parser.add_argument(
+        "-t",
+        "--title",
+        dest="title",
+        help="set the tile (default: '%(default)s')",
+        type=str,
+        default=None,
+        metavar="TITLE",
+    )
+
+    auto_parser.add_argument(
+        "-w",
+        "--watermark",
+        dest="watermark",
+        help="set the watermark (default: '%(default)s')",
+        type=str,
+        default="kianmeng.org",
+        metavar="WATERMARK_TEXT",
+    )
+
 
 def run(args: argparse.Namespace) -> None:
     """Run auto subcommand.
@@ -53,6 +74,10 @@ def run(args: argparse.Namespace) -> None:
     Returns:
         None
     """
+    text = args.watermark
+    if args.title and args.watermark:
+        text = f"{args.title}\n{args.watermark}"
+
     extra_args = {
         "width": 600,
         "height": 277,
@@ -60,7 +85,7 @@ def run(args: argparse.Namespace) -> None:
         "radius": 1,
         "percent": 100,
         "threshold": 2,
-        "text": "kianmeng.org",
+        "text": text,
         "position": "bottom-left",
         "font_size": 12,
         "font_color": "white",
@@ -69,13 +94,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)
 
@@ -83,3 +113,14 @@ def run(args: argparse.Namespace) -> None:
     fotolab.subcommands.contrast.run(combined_args)
     fotolab.subcommands.sharpen.run(combined_args)
     fotolab.subcommands.watermark.run(combined_args)
+
+    if len(args.image_filenames) > 1:
+        output_filename = (
+            args.title.lower().replace(",", "").replace(" ", "_") + ".gif"
+        )
+        combined_args.output_dir = "output"
+        combined_args.format = "gif"
+        combined_args.duration = 2500
+        combined_args.loop = 0
+        combined_args.output_filename = output_filename
+        fotolab.subcommands.animate.run(combined_args)

fotolab/subcommands/border.py

@@ -17,6 +17,7 @@
 
 import argparse
 import logging
+from pathlib import Path
 from typing import Tuple
 
 from PIL import Image, ImageColor, ImageOps
@@ -134,8 +135,8 @@ def run(args: argparse.Namespace) -> None:
     """
     log.debug(args)
 
-    for image_filename in args.image_filenames:
-        original_image = Image.open(image_filename)
+    for image_filepath in [Path(f) for f in args.image_filenames]:
+        original_image = Image.open(image_filepath)
         border = get_border(args)
         bordered_image = ImageOps.expand(
             original_image,
@@ -143,7 +144,7 @@ def run(args: argparse.Namespace) -> None:
             fill=ImageColor.getrgb(args.color),
         )
 
-        save_image(args, bordered_image, image_filename, "border")
+        save_image(args, bordered_image, image_filepath, "border")
 
 
 def get_border(

fotolab/subcommands/contrast.py

@@ -17,6 +17,7 @@
 
 import argparse
 import logging
+from pathlib import Path
 
 from PIL import Image, ImageOps
 
@@ -107,4 +108,4 @@ def run(args: argparse.Namespace) -> None:
             original_image, cutoff=args.cutoff
         )
 
-        save_image(args, contrast_image, image_filename, "contrast")
+        save_image(args, contrast_image, Path(image_filename), "contrast")

fotolab/subcommands/halftone.py

@@ -18,6 +18,7 @@
 import argparse
 import logging
 import math
+from pathlib import Path
 from typing import NamedTuple, Union
 
 from PIL import Image, ImageDraw
@@ -84,7 +85,9 @@ def build_subparser(subparsers) -> None:
         dest="cells",
         type=int,
         default=50,
-        help="set number of cells across the image width (default: %(default)s)",
+        help=(
+            "set number of cells across the image width (default: %(default)s)"
+        ),
     )
 
     halftone_parser.add_argument(
@@ -108,7 +111,8 @@ def run(args: argparse.Namespace) -> None:
     """
     log.debug(args)
 
-    for image_filename in args.image_filenames:
+    for image_filename_str in args.image_filenames:
+        image_filename = Path(image_filename_str)
         original_image = Image.open(image_filename)
         halftone_image = create_halftone_image(
             original_image, args.cells, args.grayscale

fotolab/subcommands/montage.py

@@ -17,6 +17,7 @@
 
 import argparse
 import logging
+from pathlib import Path
 
 from PIL import Image
 
@@ -37,7 +38,7 @@ def build_subparser(subparsers) -> None:
         dest="image_filenames",
         help="set the image filenames",
         nargs="+",
-        type=argparse.FileType("r"),
+        type=str,
         default=None,
         metavar="IMAGE_FILENAMES",
     )
@@ -71,8 +72,9 @@ def run(args: argparse.Namespace) -> None:
     """
     log.debug(args)
     images = []
-    for image_filename in args.image_filenames:
-        images.append(Image.open(image_filename.name))
+    for image_filename_str in args.image_filenames:
+        image_filename = Path(image_filename_str)
+        images.append(Image.open(image_filename))
 
     if len(images) < 2:
         raise ValueError("at least two images is required for montage")
@@ -87,5 +89,5 @@ def run(args: argparse.Namespace) -> None:
         montaged_image.paste(image, (x_offset, 0))
         x_offset += image.width
 
-    output_image_filename = args.image_filenames[0].name
+    output_image_filename = Path(args.image_filenames[0])
     save_image(args, montaged_image, output_image_filename, "montage")

fotolab/subcommands/resize.py

@@ -19,6 +19,7 @@ import argparse
 import logging
 import math
 import sys
+from pathlib import Path
 
 from PIL import Image, ImageColor
 
@@ -136,13 +137,13 @@ def run(args: argparse.Namespace) -> None:
     """
     log.debug(args)
 
-    for image_filename in args.image_filenames:
-        original_image = Image.open(image_filename)
+    for image_filepath in [Path(f) for f in args.image_filenames]:
+        original_image = Image.open(image_filepath)
         if args.canvas:
             resized_image = _resize_image_onto_canvas(original_image, args)
         else:
             resized_image = _resize_image(original_image, args)
-        save_image(args, resized_image, image_filename, "resize")
+        save_image(args, resized_image, image_filepath, "resize")
 
 
 def _resize_image_onto_canvas(original_image, args):

fotolab/subcommands/rotate.py

@@ -17,6 +17,7 @@
 
 import argparse
 import logging
+from pathlib import Path
 
 from PIL import Image
 
@@ -85,9 +86,16 @@ def run(args: argparse.Namespace) -> None:
     log.debug(args)
 
     rotation = -args.rotation if args.clockwise else args.rotation
-    for image_filename in args.image_filenames:
+    log.debug(f"Rotation angle: {rotation} degrees")
+
+    for image_filename_str in args.image_filenames:
+        image_filename = Path(image_filename_str)
+        log.debug(f"Processing image: {image_filename}")
         original_image = Image.open(image_filename)
+        log.debug(f"Original image size: {original_image.size}")
         rotated_image = original_image.rotate(
             rotation, expand=True, resample=Image.Resampling.BICUBIC
         )
+        log.debug(f"Rotated image size: {rotated_image.size}")
         save_image(args, rotated_image, image_filename, "rotate")
+        log.debug(f"Image saved: {image_filename}")

fotolab/subcommands/sharpen.py

@@ -17,6 +17,7 @@
 
 import argparse
 import logging
+from pathlib import Path
 
 from PIL import Image, ImageFilter
 
@@ -123,7 +124,11 @@ def run(args: argparse.Namespace) -> None:
         )
         if args.before_after:
             save_gif_image(
-                args, image_filename, original_image, sharpen_image, "sharpen"
+                args,
+                Path(image_filename),
+                original_image,
+                sharpen_image,
+                "sharpen",
             )
         else:
-            save_image(args, sharpen_image, image_filename, "sharpen")
+            save_image(args, sharpen_image, Path(image_filename), "sharpen")

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",
     )
@@ -204,7 +206,9 @@ def run(args: argparse.Namespace) -> None:
             watermarked_image: Image.Image = watermark_non_gif_image(
                 image, args
             )
-            save_image(args, watermarked_image, image_filename, "watermark")
+            save_image(
+                args, watermarked_image, Path(image_filename), "watermark"
+            )
 
 
 def watermark_gif_image(
@@ -325,7 +329,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.31.16.dist-info → fotolab-0.33.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fotolab
-Version: 0.31.16
+Version: 0.33.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
@@ -20,6 +20,20 @@ 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

fotolab-0.33.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+fotolab/__init__.py,sha256=Wb9aauJu-aXInocnVSuzUwpWoMSC6moNLQ1dLORbEgQ,3442
+fotolab/__main__.py,sha256=aboOURPs_snOXTEWYR0q8oq1UTY9e-NxCd1j33V0wHI,833
+fotolab/cli.py,sha256=oFiQXmsu3wIsM_DpZnL4B94sAoB62L16Am-cjxGmosY,4406
+fotolab/subcommands/__init__.py,sha256=l3DlIaJ3u3jGjnC1H1yV8LZ_nPqOLJ6gikD4BCaMAQ0,1129
+fotolab/subcommands/animate.py,sha256=iEor831HVQtQ04Y2-kHxnU4--BfS75mXggVIblxrO6g,5881
+fotolab/subcommands/auto.py,sha256=gkpZ15JwzSlQPYSqGSeeGu0SLKps3A2cEn1dYpyQEyk,3584
+fotolab/subcommands/border.py,sha256=TSr1rqAPWe1ZThkZan_WiMQdSTuua2YPXg6fYcvFitQ,4715
+fotolab/subcommands/contrast.py,sha256=1RD3B-7NTIReMvACmb_FQtLxx_RZdmpqKmvsEuYjy2Y,3058
+fotolab/subcommands/env.py,sha256=QoxRvzZKgmoHTUxDV4QYhdChCpMWs5TbXFY_qIpIQpE,1469
+fotolab/subcommands/halftone.py,sha256=56RRkyIhCyc6MPBujV2PIbuR9HobuFhqVQaq58A5ivQ,6781
+fotolab/subcommands/info.py,sha256=H3voMi67cKoHT2Mu4RUNQBPdb_MspetPjhOvy-YyNnE,3563
+fotolab/subcommands/montage.py,sha256=ax-TG5FixBRFHPGkVTq8kOtRL900K6nujeBYHZ0yBAE,2622
+fotolab/subcommands/resize.py,sha256=dMjgy52zrCIYpuvdOHyoP46X-jBolXNi0PLIQ-0x7eE,5473
+fotolab/subcommands/rotate.py,sha256=-yZ7pNW7PDOPBWbKPDut9z8bBe1NocfVBV_6V6tqq-4,2945
+fotolab/subcommands/sharpen.py,sha256=vGBJHHHUaQ2_SHS-E1mHfNVIfnnNYcCk5ritajWTik8,3594
+fotolab/subcommands/watermark.py,sha256=BkUa1tH86Ii_u03ypj9Tm0u9v7s9y9Jiz3aLpjmFDb8,11355
+fotolab-0.33.0.dist-info/licenses/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
+fotolab-0.33.0.dist-info/METADATA,sha256=T9V46riOT9o4ZsKI4gmTaxJ7VgdDVzvNo5YqTEnasfs,14765
+fotolab-0.33.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fotolab-0.33.0.dist-info/entry_points.txt,sha256=0e1go9plFpqj5FP-OpV2acxTAx3ViI59PMXuhejvgcQ,45
+fotolab-0.33.0.dist-info/top_level.txt,sha256=XUJ3gdpsbjohoZCLdVlbQrxAUDkbQg7WwGQG2DaN0t4,8
+fotolab-0.33.0.dist-info/RECORD,,

fotolab-0.31.16.dist-info/RECORD

@@ -1,22 +0,0 @@
-fotolab/__init__.py,sha256=F1sYdgd88MdxeT60olYsMzaMY7EipL8lJlL44BuFYj4,3088
-fotolab/__main__.py,sha256=aboOURPs_snOXTEWYR0q8oq1UTY9e-NxCd1j33V0wHI,833
-fotolab/cli.py,sha256=oFiQXmsu3wIsM_DpZnL4B94sAoB62L16Am-cjxGmosY,4406
-fotolab/subcommands/__init__.py,sha256=l3DlIaJ3u3jGjnC1H1yV8LZ_nPqOLJ6gikD4BCaMAQ0,1129
-fotolab/subcommands/animate.py,sha256=t1F0ekbYWVlQcCtnwsW_gsWjkFdGDqcr4R8VUztUuzI,5481
-fotolab/subcommands/auto.py,sha256=3Hl1cCdu65GcfwvwiMRAcex6c7zA-KqIY6AFnB6nI3w,2447
-fotolab/subcommands/border.py,sha256=VYs8SorNYMwk7bVhD7jyolvFly7XdV-s9tNVQQYZPtA,4671
-fotolab/subcommands/contrast.py,sha256=fcXmHnxDw74j5ZUDQ5cwWh0N4tpyqqvEjymnpITgrEk,3027
-fotolab/subcommands/env.py,sha256=QoxRvzZKgmoHTUxDV4QYhdChCpMWs5TbXFY_qIpIQpE,1469
-fotolab/subcommands/halftone.py,sha256=PgTGf9cChCYYbhB6vdNmzndobb4sK36ujGtZz4XAma0,6678
-fotolab/subcommands/info.py,sha256=H3voMi67cKoHT2Mu4RUNQBPdb_MspetPjhOvy-YyNnE,3563
-fotolab/subcommands/montage.py,sha256=ouwOnJQeXJTzsXi-4uby8c6k_VWg0Yo37FuvwAFx8ME,2566
-fotolab/subcommands/resize.py,sha256=eZGoHVMehpHrAX_y-M56s43lSvWmywMjHRVI_dYqpcA,5429
-fotolab/subcommands/rotate.py,sha256=uBFjHyjiBSQLtrtH1p9myODIHUDr1gkL4PpU-6Y1Ofo,2575
-fotolab/subcommands/sharpen.py,sha256=YNho2IPbc-lPvSy3Bsjehc2JOEy27LPqFSGRULs9MyY,3492
-fotolab/subcommands/watermark.py,sha256=cpdzmdzBXcaXWSrklYycnkPLjorLnTM-IXjPigPu0y0,11268
-fotolab-0.31.16.dist-info/licenses/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
-fotolab-0.31.16.dist-info/METADATA,sha256=8jKYLTQsusRg8jCG1Qrpm7_2APnnx-AZDT5YOboU-Io,14220
-fotolab-0.31.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fotolab-0.31.16.dist-info/entry_points.txt,sha256=0e1go9plFpqj5FP-OpV2acxTAx3ViI59PMXuhejvgcQ,45
-fotolab-0.31.16.dist-info/top_level.txt,sha256=XUJ3gdpsbjohoZCLdVlbQrxAUDkbQg7WwGQG2DaN0t4,8
-fotolab-0.31.16.dist-info/RECORD,,