fotolab 0.31.5__py3-none-any.whl → 0.31.7__py3-none-any.whl

fotolab/subcommands/__init__.py

@@ -24,7 +24,8 @@ def build_subparser(subparsers):
     iter_namespace = pkgutil.iter_modules(__path__, __name__ + ".")
 
     subcommands = {
-        name: importlib.import_module(name) for finder, name, ispkg in iter_namespace
+        name: importlib.import_module(name)
+        for finder, name, ispkg in iter_namespace
     }
 
     for subcommand in subcommands.values():

fotolab/subcommands/animate.py

@@ -123,7 +123,9 @@ 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",
     )
 

fotolab/subcommands/border.py

@@ -77,7 +77,9 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         dest="width_right",
         type=int,
         default=0,
-        help=("set the width of right border in pixels (default: '%(default)s')"),
+        help=(
+            "set the width of right border in pixels (default: '%(default)s')"
+        ),
         metavar="WIDTH",
     )
 
@@ -87,7 +89,9 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         dest="width_bottom",
         type=int,
         default=0,
-        help=("set the width of bottom border in pixels (default: '%(default)s')"),
+        help=(
+            "set the width of bottom border in pixels (default: '%(default)s')"
+        ),
         metavar="WIDTH",
     )
 

fotolab/subcommands/contrast.py

@@ -31,7 +31,9 @@ def _validate_cutoff(value: str) -> float:
     try:
         f_value = float(value)
     except ValueError as e:
-        raise argparse.ArgumentTypeError(f"invalid float value: '{value}'") from e
+        raise argparse.ArgumentTypeError(
+            f"invalid float value: '{value}'"
+        ) from e
     if not 0 <= f_value <= 50:
         raise argparse.ArgumentTypeError(
             f"cutoff value {f_value} must be between 0 and 50"
@@ -41,7 +43,9 @@ def _validate_cutoff(value: str) -> float:
 
 def build_subparser(subparsers: argparse._SubParsersAction) -> None:
     """Build the subparser."""
-    contrast_parser = subparsers.add_parser("contrast", help="contrast an image.")
+    contrast_parser = subparsers.add_parser(
+        "contrast", help="contrast an image."
+    )
 
     contrast_parser.set_defaults(func=run)
 
@@ -99,6 +103,8 @@ def run(args: argparse.Namespace) -> None:
 
     for image_filename in args.image_filenames:
         original_image = Image.open(image_filename)
-        contrast_image = ImageOps.autocontrast(original_image, cutoff=args.cutoff)
+        contrast_image = ImageOps.autocontrast(
+            original_image, cutoff=args.cutoff
+        )
 
         save_image(args, contrast_image, image_filename, "contrast")

fotolab/subcommands/halftone.py

@@ -18,7 +18,7 @@
 import argparse
 import logging
 import math
-from typing import NamedTuple
+from typing import NamedTuple, Union
 
 from PIL import Image, ImageDraw
 
@@ -37,7 +37,9 @@ class HalftoneCell(NamedTuple):
 
 def build_subparser(subparsers) -> None:
     """Build the subparser."""
-    halftone_parser = subparsers.add_parser("halftone", help="halftone an image")
+    halftone_parser = subparsers.add_parser(
+        "halftone", help="halftone an image"
+    )
 
     halftone_parser.set_defaults(func=run)
 
@@ -129,22 +131,22 @@ def _draw_halftone_dot(
     source_image: Image.Image,
     cell: HalftoneCell,
     grayscale: bool,
-    fill_color_dot,
+    fill_color_dot: int,
 ) -> None:
     """Calculate properties and draw a single halftone dot."""
-    # Calculate center point of current cell
+    # calculate center point of current cell
     img_width, img_height = source_image.size
 
-    # Calculate center point of current cell and clamp to image bounds
+    # calculate center point of current cell and clamp to image bounds
     x = min(int(cell.col * cell.cellsize + cell.cellsize / 2), img_width - 1)
     y = min(int(cell.row * cell.cellsize + cell.cellsize / 2), img_height - 1)
 
-    # Ensure coordinates are non-negative (shouldn't happen with current logic,
+    # ensure coordinates are non-negative (shouldn't happen with current logic,
     # but safe)
     x = max(0, x)
     y = max(0, y)
 
-    # Get pixel value (brightness or color) from the source image using clamped
+    # get pixel value (brightness or color) from the source image using clamped
     # coordinates
     pixel_value = source_image.getpixel((x, y))
 
@@ -152,17 +154,20 @@ def _draw_halftone_dot(
         brightness = pixel_value
         dot_fill = fill_color_dot  # Use white for grayscale dots
     else:
-        # Calculate brightness (luminance) from the RGB color
+        # calculate brightness (luminance) from the RGB color
         brightness = int(
-            0.299 * pixel_value[0] + 0.587 * pixel_value[1] + 0.114 * pixel_value[2]
+            0.299 * pixel_value[0]
+            + 0.587 * pixel_value[1]
+            + 0.114 * pixel_value[2]
         )
         dot_fill = pixel_value  # Use original color for color dots
 
-    # Calculate dot radius relative to cell size based on brightness Max radius
-    # is half the cell size. Scale by brightness (0-255).
+    # calculate dot radius relative to cell size based on brightness max radius
+    # is half the cell size
+    # scale by brightness (0-255).
     dot_radius = (brightness / 255.0) * (cell.cellsize / 2)
 
-    # Draw the dot
+    # draw the dot
     draw.ellipse(
         [
             x - dot_radius,
@@ -190,29 +195,30 @@ def create_halftone_image(
     Returns:
         Image.Image: The halftone converted image
     """
+    output_mode: str
+    fill_color_black: Union[int, tuple[int, int, int]]
+    fill_color_dot_for_grayscale: int
+
     if grayscale:
         source_image = original_image.convert("L")
         output_mode = "L"
         fill_color_black = 0
-        fill_color_dot = 255
+        fill_color_dot_for_grayscale = 255
     else:
         source_image = original_image.convert("RGB")
         output_mode = "RGB"
         fill_color_black = (0, 0, 0)
-        fill_color_dot = None  # Will be set inside the loop for color images
+        fill_color_dot_for_grayscale = 0
 
     width, height = original_image.size
 
-    # Create a new image for the output, initialized to black
+    # create a new image for the output, initialized to black
     halftone_image = Image.new(output_mode, (width, height), fill_color_black)
     draw = ImageDraw.Draw(halftone_image)
 
     cellsize = width / cell_count
     rowtotal = math.ceil(height / cellsize)
 
-    # Determine the fill color for dots once if grayscale
-    grayscale_fill_color_dot = fill_color_dot if grayscale else None
-
     for row in range(rowtotal):
         for col in range(cell_count):
             cell = HalftoneCell(col=col, row=row, cellsize=cellsize)
@@ -221,7 +227,7 @@ def create_halftone_image(
                 source_image,
                 cell,
                 grayscale,
-                grayscale_fill_color_dot,
+                fill_color_dot_for_grayscale,
             )
 
     return halftone_image

fotolab/subcommands/info.py

@@ -107,7 +107,9 @@ def extract_exif_tags(image: Image.Image, sort: bool = False) -> dict:
     if exif:
         info = {ExifTags.TAGS.get(tag_id): exif.get(tag_id) for tag_id in exif}
 
-    filtered_info = {key: value for key, value in info.items() if key is not None}
+    filtered_info = {
+        key: value for key, value in info.items() if key is not None
+    }
     if sort:
         filtered_info = dict(sorted(filtered_info.items()))
 

fotolab/subcommands/montage.py

@@ -27,7 +27,9 @@ log = logging.getLogger(__name__)
 
 def build_subparser(subparsers) -> None:
     """Build the subparser."""
-    montage_parser = subparsers.add_parser("montage", help="montage a list of image")
+    montage_parser = subparsers.add_parser(
+        "montage", help="montage a list of image"
+    )
 
     montage_parser.set_defaults(func=run)
 

fotolab/subcommands/resize.py

@@ -59,7 +59,9 @@ def build_subparser(subparsers) -> None:
         "--canvas-color",
         default="black",
         dest="canvas_color",
-        help=("the color of the extended larger canvas(default: '%(default)s')"),
+        help=(
+            "the color of the extended larger canvas(default: '%(default)s')"
+        ),
     )
 
     if "-c" in sys.argv or "--canvas" in sys.argv:

fotolab/subcommands/watermark.py

@@ -109,7 +109,9 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         dest="outline_width",
         type=int,
         default=2,
-        help=("set the outline width of the watermark text (default: '%(default)s')"),
+        help=(
+            "set the outline width of the watermark text (default: '%(default)s')"
+        ),
         metavar="OUTLINE_WIDTH",
     )
 
@@ -119,7 +121,9 @@ def build_subparser(subparsers: argparse._SubParsersAction) -> None:
         dest="outline_color",
         type=str,
         default="black",
-        help=("set the outline color of the watermark text (default: '%(default)s')"),
+        help=(
+            "set the outline color of the watermark text (default: '%(default)s')"
+        ),
         metavar="OUTLINE_COLOR",
     )
 
@@ -197,7 +201,9 @@ def run(args: argparse.Namespace) -> None:
         if image.format == "GIF":
             watermark_gif_image(image, image_filename, args)
         else:
-            watermarked_image: Image.Image = watermark_non_gif_image(image, args)
+            watermarked_image: Image.Image = watermark_non_gif_image(
+                image, args
+            )
             save_image(args, watermarked_image, image_filename, "watermark")
 
 
@@ -333,12 +339,16 @@ def calc_font_size(image: Image.Image, args: argparse.Namespace) -> int:
     return new_font_size
 
 
-def calc_font_outline_width(image: Image.Image, args: argparse.Namespace) -> int:
+def calc_font_outline_width(
+    image: Image.Image, args: argparse.Namespace
+) -> int:
     """Calculate the font padding based on the width of the image."""
     width, _height = image.size
     new_font_outline_width: int = args.outline_width
     if width > 600:
-        new_font_outline_width = math.floor(FONT_OUTLINE_WIDTH_ASPECT_RATIO * width)
+        new_font_outline_width = math.floor(
+            FONT_OUTLINE_WIDTH_ASPECT_RATIO * width
+        )
 
     log.debug("new font outline width: %d", new_font_outline_width)
     return new_font_outline_width

{fotolab-0.31.5.dist-info → fotolab-0.31.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fotolab
-Version: 0.31.5
+Version: 0.31.7
 Summary: A console program that manipulate images.
 Keywords: photography,photo
 Author-email: Kian-Meng Ang <kianmeng@cpan.org>
@@ -31,19 +31,13 @@ A console program to manipulate photos.
 Stable version From PyPI using `uv`:
 
 ```console
-uv pip install fotolab
+uv tool install fotolab
 ```
 
 Upgrade to latest stable version:
 
 ```console
-uv pip install fotolab --upgrade
-```
-
-Latest development version from GitHub:
-
-```console
-uv pip install -e git+https://github.com/kianmeng/fotolab.git
+uv tool upgrade fotolab
 ```
 
 ## Usage

fotolab-0.31.7.dist-info/RECORD

@@ -0,0 +1,21 @@
+fotolab/__init__.py,sha256=7XrkZPbYLVCnsak061vye7L9hFC7zj7cP7XWdjunAk8,3137
+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=2bNaFyUbA5yNgBgd9WhVnJ1R28nfHu0agAJBBww1Z4w,5534
+fotolab/subcommands/auto.py,sha256=3Hl1cCdu65GcfwvwiMRAcex6c7zA-KqIY6AFnB6nI3w,2447
+fotolab/subcommands/border.py,sha256=096EPvuxCB1qnF5VPG8mLtQLXTM5cpkv0ExZXFSh5k8,4665
+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=d_3EcyRSFS8fKkczlHO8IRP-mrKhQUtkQndjfd0MKsc,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.7.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
+fotolab-0.31.7.dist-info/licenses/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
+fotolab-0.31.7.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+fotolab-0.31.7.dist-info/METADATA,sha256=k4aCD04oH6loRPR-eognUOxnqiirM9A2WA5U5fFg3f0,13454
+fotolab-0.31.7.dist-info/RECORD,,

fotolab-0.31.5.dist-info/RECORD

@@ -1,21 +0,0 @@
-fotolab/__init__.py,sha256=7XrkZPbYLVCnsak061vye7L9hFC7zj7cP7XWdjunAk8,3137
-fotolab/__main__.py,sha256=aboOURPs_snOXTEWYR0q8oq1UTY9e-NxCd1j33V0wHI,833
-fotolab/cli.py,sha256=oFiQXmsu3wIsM_DpZnL4B94sAoB62L16Am-cjxGmosY,4406
-fotolab/subcommands/__init__.py,sha256=zPNE3lTK3yNjBq2zP1GiL13R4ywO_zh5MRFp5aOFp_g,1121
-fotolab/subcommands/animate.py,sha256=Bzp1Y708UZogcLFwZSoJBfLAxLNZ5c0PESp1xl03sQg,5512
-fotolab/subcommands/auto.py,sha256=3Hl1cCdu65GcfwvwiMRAcex6c7zA-KqIY6AFnB6nI3w,2447
-fotolab/subcommands/border.py,sha256=3mD6ebdPjGk39ldUq9766jEXCbszPlbyV48k13dmrSA,4621
-fotolab/subcommands/contrast.py,sha256=k-NGncYgm7x821CP-NhDbyZGzW1FPxaDgJi00xd97kw,2969
-fotolab/subcommands/env.py,sha256=QoxRvzZKgmoHTUxDV4QYhdChCpMWs5TbXFY_qIpIQpE,1469
-fotolab/subcommands/halftone.py,sha256=4YpHkp3zSYp36qJVPinWBOAUhTJjc-aGxiaNd1IkhXA,6655
-fotolab/subcommands/info.py,sha256=pT2NBZ-KBjBCJJRpC9HC04iZj3s6RhbLWTRG6vjsarg,3549
-fotolab/subcommands/montage.py,sha256=6-3VFMOQm3KOhcGaDfzStTKvBB5GHrotFkHU9kxZe5E,2552
-fotolab/subcommands/resize.py,sha256=h4t425Xf95lkh6Trp-qw_cu0bBgMgBSBvJvUIR4dqiE,5407
-fotolab/subcommands/rotate.py,sha256=uBFjHyjiBSQLtrtH1p9myODIHUDr1gkL4PpU-6Y1Ofo,2575
-fotolab/subcommands/sharpen.py,sha256=YNho2IPbc-lPvSy3Bsjehc2JOEy27LPqFSGRULs9MyY,3492
-fotolab/subcommands/watermark.py,sha256=uVcFynGt2hkTNF5RnfdHhBxSoLmlA7o8-_I65pe_di0,11166
-fotolab-0.31.5.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
-fotolab-0.31.5.dist-info/licenses/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
-fotolab-0.31.5.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-fotolab-0.31.5.dist-info/METADATA,sha256=FRLzLmunavCF1LE273b1CeSIF7Ypxo4n7MMBvueyRCA,13581
-fotolab-0.31.5.dist-info/RECORD,,