fotolab 0.30.0__py3-none-any.whl → 0.31.1__py3-none-any.whl

fotolab/__init__.py

@@ -24,7 +24,7 @@ from pathlib import Path
 
 from PIL import Image
 
-__version__ = "0.30.0"
+__version__ = "0.31.1"
 
 log = logging.getLogger(__name__)
 
@@ -59,15 +59,14 @@ def save_gif_image(
         _open_image(new_filename)
 
 
-def save_image(args, new_image, output_filename, subcommand):
+def save_image(
+    args: argparse.Namespace,
+    new_image: Image.Image,
+    output_filename: str,
+    subcommand: str,
+) -> None:
     """Save image after image operation.
 
-    Args:
-        args (argparse.Namespace): Config from command line arguments
-        new_image(PIL.Image.Image): Modified image
-        output_filename(str): Save filename image
-        subcommand(str): Subcommand used to call this function
-
     Returns:
         None
     """

fotolab/subcommands/animate.py

@@ -73,7 +73,10 @@ def build_subparser(subparsers) -> None:
         dest="duration",
         type=_validate_duration,
         default=2500,
-        help="set the duration in milliseconds (must be a positive integer, default: '%(default)s')",
+        help=(
+            "set the duration in milliseconds "
+            "(must be a positive integer, default: '%(default)s')"
+        ),
         metavar="DURATION",
     )
 
@@ -120,7 +123,10 @@ def build_subparser(subparsers) -> None:
         type=int,
         default=4,
         choices=range(0, 7),
-        help="set WEBP encoding method (0=fast, 6=slow/best, default: '%(default)s')",
+        help=(
+            "set WEBP encoding method "
+            "(0=fast, 6=slow/best, default: '%(default)s')"
+        ),
         metavar="METHOD",
     )
 
@@ -170,17 +176,17 @@ def run(args: argparse.Namespace) -> None:
             "save_all": True,
             "duration": args.duration,
             "loop": args.loop,
-            "optimize": True,  # General optimization, good for GIF
+            "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":
             save_kwargs["quality"] = args.webp_quality
             save_kwargs["lossless"] = args.webp_lossless
             save_kwargs["method"] = args.webp_method
-            # 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.
 
         main_frame.save(new_filename, **save_kwargs)
     finally:

fotolab/subcommands/auto.py

@@ -71,6 +71,7 @@ def run(args: argparse.Namespace) -> None:
         "canvas": False,
         "lowercase": False,
         "before_after": False,
+        "alpha": 128,
     }
     combined_args = argparse.Namespace(**vars(args), **extra_args)
     combined_args.overwrite = True

fotolab/subcommands/border.py

@@ -17,7 +17,7 @@
 
 import argparse
 import logging
-from typing import Tuple, Union
+from typing import Tuple
 
 from PIL import Image, ImageColor, ImageOps
 
@@ -26,7 +26,7 @@ from fotolab import save_image
 log = logging.getLogger(__name__)
 
 
-def build_subparser(subparsers) -> None:
+def build_subparser(subparsers: argparse._SubParsersAction) -> None:
     """Build the subparser."""
     border_parser = subparsers.add_parser("border", help="add border to image")
 
@@ -150,17 +150,16 @@ def run(args: argparse.Namespace) -> None:
 
 def get_border(
     args: argparse.Namespace,
-) -> Union[Tuple[int, int, int, int], int]:
+) -> Tuple[int, int, int, int]:
     """Calculate the border dimensions.
 
     Args:
         args (argparse.Namespace): Command line arguments
 
     Returns:
-        Union[Tuple[int, int, int, int], int]: Border dimensions in pixels.
-        If individual widths are specified, returns a tuple of (left, top,
-        right, bottom) widths.  Otherwise, returns a uniform width for all
-        sides.
+        Tuple[int, int, int, int]: Border dimensions in pixels as (left, top,
+        right, bottom) widths. If individual widths are not specified,
+        a uniform width is returned for all sides.
     """
     if any(
         [
@@ -176,4 +175,5 @@ def get_border(
             args.width_right,
             args.width_bottom,
         )
-    return args.width
+    # If no individual widths are specified, use the general width for all sides
+    return (args.width, args.width, args.width, args.width)

fotolab/subcommands/info.py

@@ -81,31 +81,25 @@ def run(args: argparse.Namespace) -> None:
             return
 
         output_info = []
-    specific_info_requested = False
 
-    if args.camera:
-        specific_info_requested = True
-        output_info.append(camera_metadata(exif_tags))
+        if args.camera:
+            output_info.append(get_formatted_camera_info(exif_tags))
 
-    if args.datetime:
-        specific_info_requested = True
-        output_info.append(datetime(exif_tags))
+        if args.datetime:
+            output_info.append(get_formatted_datetime_info(exif_tags))
 
-    if specific_info_requested:
-        print("\n".join(output_info))
-    else:
-        # Print all tags if no specific info was requested
-        tag_name_width = max(map(len, exif_tags))
-        for tag_name, tag_value in exif_tags.items():
-            print(f"{tag_name:<{tag_name_width}}: {tag_value}")
+        if output_info:  # Check if any specific info was added
+            print("\n".join(output_info))
+        else:
+            # Print all tags if no specific info was requested
+            tag_name_width = max(map(len, exif_tags))
+            for tag_name, tag_value in exif_tags.items():
+                print(f"{tag_name:<{tag_name_width}}: {tag_value}")
 
 
 def extract_exif_tags(image: Image.Image, sort: bool = False) -> dict:
     """Extract Exif metadata from image."""
-    try:
-        exif = image._getexif()
-    except AttributeError:
-        exif = None
+    exif = image.getexif()
 
     log.debug(exif)
 
@@ -122,13 +116,13 @@ def extract_exif_tags(image: Image.Image, sort: bool = False) -> dict:
     return filtered_info
 
 
-def datetime(exif_tags: dict):
-    """Extract datetime metadata."""
+def get_formatted_datetime_info(exif_tags: dict):
+    """Extract and format datetime metadata."""
     return exif_tags.get("DateTime", "Not available")
 
 
-def camera_metadata(exif_tags: dict):
-    """Extract camera and model metadata."""
+def get_formatted_camera_info(exif_tags: dict):
+    """Extract and format camera make and model metadata."""
     make = exif_tags.get("Make", "")
     model = exif_tags.get("Model", "")
     metadata = f"{make} {model}"

fotolab/subcommands/watermark.py

@@ -24,7 +24,7 @@ from typing import Tuple
 from PIL import Image, ImageColor, ImageDraw, ImageFont, ImageSequence
 
 from fotolab import save_image
-from fotolab.subcommands.info import camera_metadata
+from fotolab.subcommands.info import get_formatted_camera_info
 
 log: logging.Logger = logging.getLogger(__name__)
 
@@ -129,6 +129,21 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         metavar="OUTLINE_COLOR",
     )
 
+    watermark_parser.add_argument(
+        "-a",
+        "--alpha",
+        dest="alpha",
+        type=int,
+        default=128,
+        choices=range(0, 256),
+        metavar="ALPHA_VALUE",
+        help=(
+            "set the transparency of the watermark text (0-255, "
+            "where 0 is fully transparent and 255 is fully opaque; "
+            "default: '%(default)s')"
+        ),
+    )
+
     watermark_parser.add_argument(
         "--camera",
         default=False,
@@ -176,7 +191,15 @@ def run(args: argparse.Namespace) -> None:
     log.debug(args)
 
     for image_filename in args.image_filenames:
-        image: Image.Image = Image.open(image_filename)
+        try:
+            image: Image.Image = Image.open(image_filename)
+        except FileNotFoundError:
+            log.error("Image file not found: %s", image_filename)
+            continue
+        except Exception as e:
+            log.error("Could not open image %s: %s", image_filename, e)
+            continue
+
         if image.format == "GIF":
             watermark_gif_image(image, image_filename, args)
         else:
@@ -202,7 +225,7 @@ def watermark_gif_image(
     frames: list[Image.Image] = []
     for frame in ImageSequence.Iterator(original_image):
         watermarked_frame: Image.Image = watermark_image(
-            args, frame.convert("RGBA")
+            args, frame.convert("RGBA"), args.alpha
         )
         frames.append(watermarked_frame)
 
@@ -241,11 +264,11 @@ def watermark_non_gif_image(
     Returns:
         Image.Image: The watermarked image
     """
-    return watermark_image(args, original_image)
+    return watermark_image(args, original_image, args.alpha)
 
 
 def watermark_image(
-    args: argparse.Namespace, original_image: Image.Image
+    args: argparse.Namespace, original_image: Image.Image, alpha: int
 ) -> Image.Image:
     """Watermark an image."""
     watermarked_image: Image.Image = original_image.copy()
@@ -268,23 +291,31 @@ def watermark_image(
         calc_padding(original_image, args),
     )
 
+    try:
+        font_fill_color = ImageColor.getrgb(args.font_color)
+        stroke_fill_color = ImageColor.getrgb(args.outline_color)
+    except ValueError:
+        log.error("Invalid font or outline color specified. Using defaults.")
+        font_fill_color = ImageColor.getrgb("white")
+        stroke_fill_color = ImageColor.getrgb("black")
+
     draw.text(
         (position_x, position_y),
         text,
         font=font,
-        fill=(*ImageColor.getrgb(args.font_color), 128),
+        fill=(*font_fill_color, alpha),
         stroke_width=calc_font_outline_width(original_image, args),
-        stroke_fill=(*ImageColor.getrgb(args.outline_color), 128),
+        stroke_fill=(*stroke_fill_color, alpha),
     )
     return watermarked_image
 
 
 def prepare_text(args: argparse.Namespace, image: Image.Image) -> str:
     """Prepare the watermark text."""
-    text: str = args.text  # Default text
+    text = args.text
     if args.camera:
-        metadata_text: str | None = camera_metadata(image)
-        if metadata_text:  # Use metadata only if it's not None or empty
+        metadata_text = get_formatted_camera_info(image)
+        if metadata_text:
             text = metadata_text
         else:
             log.warning(

{fotolab-0.30.0.dist-info → fotolab-0.31.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fotolab
-Version: 0.30.0
+Version: 0.31.1
 Summary: A console program that manipulate images.
 Keywords: photography,photo
 Author-email: Kian-Meng Ang <kianmeng@cpan.org>
@@ -371,7 +371,8 @@ fotolab watermark -h
 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] [--camera]
+                         [-ow OUTLINE_WIDTH] [-oc OUTLINE_COLOR]
+                         [-a ALPHA_VALUE] [--camera]
                          [-l | --lowercase | --no-lowercase] [-op]
                          [-od OUTPUT_DIR]
                          IMAGE_FILENAMES [IMAGE_FILENAMES ...]
@@ -400,6 +401,10 @@ options:
   -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

{fotolab-0.30.0.dist-info → fotolab-0.31.1.dist-info}/RECORD

@@ -1,21 +1,21 @@
-fotolab/__init__.py,sha256=RNGEVnKSQe-y5yy2fi65zOV5cJGZk9tw9o7id0xBMX4,3262
+fotolab/__init__.py,sha256=KWNA2ZPAuWOJFMr7zE2Lqnp2yOIi8e7vNdeo9uanRsQ,3087
 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=vmviz3cLnHfVENxFKiTimhx8nmbGbzumOP6dUd_UiUI,5524
-fotolab/subcommands/auto.py,sha256=ia-xegV1Z4HvYsbKgmTzf1NfNFdTDPWfZe7vQ1_90Ik,2425
-fotolab/subcommands/border.py,sha256=BS3BHytdWiNumxdKulKYK-WigbsKtPxECdvInUhUjSQ,4608
+fotolab/subcommands/animate.py,sha256=_tfIJOcwft-OP1PluPThWMsO6RAunj5RbhxeRi8Gf9w,5549
+fotolab/subcommands/auto.py,sha256=3Hl1cCdu65GcfwvwiMRAcex6c7zA-KqIY6AFnB6nI3w,2447
+fotolab/subcommands/border.py,sha256=-RNAYVcVTVrySzkmu3bIf__FTzog1BFC1jXqozF7PVM,4695
 fotolab/subcommands/contrast.py,sha256=fcXmHnxDw74j5ZUDQ5cwWh0N4tpyqqvEjymnpITgrEk,3027
 fotolab/subcommands/env.py,sha256=QoxRvzZKgmoHTUxDV4QYhdChCpMWs5TbXFY_qIpIQpE,1469
 fotolab/subcommands/halftone.py,sha256=lt6RV0OuZkGs1LigTC1EcCCY42CocPFHWaJTDjJ5LFM,6693
-fotolab/subcommands/info.py,sha256=vie578cEOesAyHohm0xCWwZBqXpblYJtdHGSyBgxsoU,3581
+fotolab/subcommands/info.py,sha256=H3voMi67cKoHT2Mu4RUNQBPdb_MspetPjhOvy-YyNnE,3563
 fotolab/subcommands/montage.py,sha256=d_3EcyRSFS8fKkczlHO8IRP-mrKhQUtkQndjfd0MKsc,2566
 fotolab/subcommands/resize.py,sha256=UOb2rg_5ArRj0gxPTDOww_ix3tqJRC0W5b_S-Lt1G4w,5444
 fotolab/subcommands/rotate.py,sha256=uBFjHyjiBSQLtrtH1p9myODIHUDr1gkL4PpU-6Y1Ofo,2575
 fotolab/subcommands/sharpen.py,sha256=YNho2IPbc-lPvSy3Bsjehc2JOEy27LPqFSGRULs9MyY,3492
-fotolab/subcommands/watermark.py,sha256=qRGUp1Lc22fZSJDFRqQGPiz8RSB293ebvOVTdsDLUE4,10351
-fotolab-0.30.0.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
-fotolab-0.30.0.dist-info/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
-fotolab-0.30.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-fotolab-0.30.0.dist-info/METADATA,sha256=tPOkSTJz_hy0seegQ60vrMKDyAcbwZWcIBwPl0ZU5Ac,13395
-fotolab-0.30.0.dist-info/RECORD,,
+fotolab/subcommands/watermark.py,sha256=wKv_8eREUZ20hNF2xKs1XZlcSNbB2kdG_kbBlaXhJ1I,11298
+fotolab-0.31.1.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
+fotolab-0.31.1.dist-info/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
+fotolab-0.31.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+fotolab-0.31.1.dist-info/METADATA,sha256=UjjTDVhNEU_PHEGJE-Cc_Z2zNugHVnxycHU3lzpBLIM,13656
+fotolab-0.31.1.dist-info/RECORD,,