devbits 1.0.0__tar.gz → 1.1.0__tar.gz

{devbits-1.0.0 → devbits-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devbits
-Version: 1.0.0
+Version: 1.1.0
 Summary: A lightweight CLI toolkit for daily development utilities.
 Author: Bruce Chuang
 License-Expression: MIT
@@ -64,6 +64,7 @@ clipvideo --help
 | Command | Description |
 |---------|-------------|
 | `resizeimage` | Resize a single image (preserves aspect ratio by default). |
+| `recolor` | Recolor a logo/icon foreground, leaving the background intact. |
 | `image2ico` | Convert an image to a multi-size ICO file. |
 | `batchimages` | Batch resize or convert all images in a folder. |
 | `checkimages` | Scan for broken / corrupt image files. |
@@ -94,6 +95,13 @@ video2gif movie.mp4 --start 3.5 --end 10.0 --fps 15
 # Extract every 5th frame as PNG
 video2images movie.mp4 --every 5 --format png
 
+# Recolor a logo's foreground to black (keeps the background)
+recolor logo.png
+
+# Recolor a logo's foreground to a custom color (hex or R,G,B)
+recolor logo.png --color '#1a73e8'
+recolor logo.png --color 0,178,179
+
 # Batch resize images to 800×600
 batchimages ./photos -o ./resized --size 800,600
 
@@ -109,6 +117,7 @@ When `-o` / `--output` is omitted, the output filename is derived from the input
 clipvideo movie.mp4          →  movie_clip.mp4
 video2gif movie.mp4          →  movie.gif
 resizeimage photo.jpg        →  photo_resized.jpg
+recolor logo.png             →  logo_revised.png
 contactsheet ./photos        →  photos_sheet.jpg
 ```
 

{devbits-1.0.0 → devbits-1.1.0}/README.md

@@ -47,6 +47,7 @@ clipvideo --help
 | Command | Description |
 |---------|-------------|
 | `resizeimage` | Resize a single image (preserves aspect ratio by default). |
+| `recolor` | Recolor a logo/icon foreground, leaving the background intact. |
 | `image2ico` | Convert an image to a multi-size ICO file. |
 | `batchimages` | Batch resize or convert all images in a folder. |
 | `checkimages` | Scan for broken / corrupt image files. |
@@ -77,6 +78,13 @@ video2gif movie.mp4 --start 3.5 --end 10.0 --fps 15
 # Extract every 5th frame as PNG
 video2images movie.mp4 --every 5 --format png
 
+# Recolor a logo's foreground to black (keeps the background)
+recolor logo.png
+
+# Recolor a logo's foreground to a custom color (hex or R,G,B)
+recolor logo.png --color '#1a73e8'
+recolor logo.png --color 0,178,179
+
 # Batch resize images to 800×600
 batchimages ./photos -o ./resized --size 800,600
 
@@ -92,6 +100,7 @@ When `-o` / `--output` is omitted, the output filename is derived from the input
 clipvideo movie.mp4          →  movie_clip.mp4
 video2gif movie.mp4          →  movie.gif
 resizeimage photo.jpg        →  photo_resized.jpg
+recolor logo.png             →  logo_revised.png
 contactsheet ./photos        →  photos_sheet.jpg
 ```
 

{devbits-1.0.0 → devbits-1.1.0}/devbits/__init__.py

@@ -1,3 +1,3 @@
 """devbits: A lightweight CLI toolkit for daily development utilities."""
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"

{devbits-1.0.0 → devbits-1.1.0}/devbits/cli.py

@@ -5,7 +5,7 @@ import sys
 from pathlib import Path
 
 from .cache import clear_cache
-from .image import batch_images, check_images, contact_sheet, image_to_ico, resize_image
+from .image import batch_images, check_images, contact_sheet, image_to_ico, recolor_image, resize_image
 from .media import clip_video, images_to_gif, images_to_video, resize_video, video_to_gif, video_to_images
 from .project import print_tree, rename_files, sample_files, top_sizes
 from .utils import ensure_exists
@@ -237,6 +237,32 @@ def build_parser() -> argparse.ArgumentParser:
                    help="Do not preserve aspect ratio; stretch to exact size.")
     p.set_defaults(func=cmd_resizeimage)
 
+    # ── recolor ────────────────────────────────────────────────
+    p = sub.add_parser(
+        "recolor",
+        help="Recolor the foreground of a logo / icon image.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        description=(
+            "Recolor a logo or icon. The background (transparent or a lighter\n"
+            "surrounding color) is detected automatically and left untouched,\n"
+            "while every foreground pixel is repainted with the target color.\n"
+            "The result is always saved as an RGBA PNG.\n\n"
+            "Examples:\n"
+            "  devbits recolor logo.png\n"
+            "  devbits recolor logo.png --color '#1a73e8'\n"
+            "  devbits recolor logo.png --color 0,178,179\n"
+            "  devbits recolor icon.jpg --color white --threshold 90"
+        ),
+    )
+    p.add_argument("image", type=Path, help="Input logo / icon image.")
+    p.add_argument("-o", "--output", type=Path, default=None,
+                   help="Output image path. Default: <image_stem>_revised.png")
+    p.add_argument("--color", default="black",
+                   help="Target foreground color: name, hex, or R,G,B (e.g. black, '#1a73e8', 0,178,179). Default: black")
+    p.add_argument("--threshold", type=int, default=60,
+                   help="Color distance from the background for opaque images. Default: 60")
+    p.set_defaults(func=cmd_recolor)
+
     # ── batchimages ────────────────────────────────────────────
     p = sub.add_parser(
         "batchimages",
@@ -452,6 +478,12 @@ def cmd_resizeimage(args: argparse.Namespace) -> None:
     print(resize_image(image, output, args.size, not args.no_keep_ratio))
 
 
+def cmd_recolor(args: argparse.Namespace) -> None:
+    image = ensure_exists(args.image)
+    output = args.output or _derive_output(image, ".png", "revised")
+    print(recolor_image(image, output, args.color, args.threshold))
+
+
 def cmd_batchimages(args: argparse.Namespace) -> None:
     outputs = batch_images(ensure_exists(args.folder), args.output, args.size, args.format)
     print(f"Saved {len(outputs)} image(s) to {args.output}")

{devbits-1.0.0 → devbits-1.1.0}/devbits/image.py

@@ -4,7 +4,7 @@ from pathlib import Path
 
 from PIL import Image, ImageDraw, ImageOps, UnidentifiedImageError
 
-from .utils import ensure_dir, list_images, parse_size
+from .utils import ensure_dir, list_images, parse_color, parse_size
 
 
 def image_to_ico(input_path: Path, output_path: Path, sizes: str = "16,32,48,64,128,256") -> Path:
@@ -81,6 +81,58 @@ def resize_image(input_path: Path, output_path: Path, size: str, keep_ratio: boo
     return output_path
 
 
+def recolor_image(
+    input_path: Path,
+    output_path: Path,
+    color: str = "black",
+    threshold: int = 60,
+) -> Path:
+    """Recolor the foreground of a logo / icon while keeping its background.
+
+    The background is detected either from transparency (transparent pixels are
+    treated as background) or, for fully opaque images, from the dominant border
+    color (the lighter surrounding area). Every foreground pixel is repainted
+    with ``color`` (a name like ``black``, a hex value like ``#1a73e8``, or an
+    ``R,G,B`` triple like ``0,178,179``). The result is always saved as an RGBA
+    PNG so soft, anti-aliased edges are kept.
+    """
+    import numpy as np
+
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    target_rgb = parse_color(color)
+
+    with Image.open(input_path) as image:
+        arr = np.array(image.convert("RGBA"))
+
+    rgb = arr[..., :3].astype(np.int16)
+    alpha = arr[..., 3]
+
+    # Step 1: distinguish background from foreground.
+    transparent = alpha < 16
+    if transparent.mean() > 0.02:
+        # Transparency marks the background; opaque pixels are the foreground.
+        foreground = alpha >= 16
+    else:
+        # Opaque image: estimate the (lighter) background from the border color.
+        border = np.concatenate(
+            [rgb[0, :, :], rgb[-1, :, :], rgb[:, 0, :], rgb[:, -1, :]], axis=0
+        )
+        bg_color = np.median(border, axis=0)
+        distance = np.sqrt(((rgb - bg_color) ** 2).sum(axis=2))
+        foreground = distance > threshold
+
+    # Step 2: paint the foreground with the target color (alpha is preserved,
+    # so anti-aliased edges keep their soft blend).
+    arr[..., 0][foreground] = target_rgb[0]
+    arr[..., 1][foreground] = target_rgb[1]
+    arr[..., 2][foreground] = target_rgb[2]
+
+    # Step 3: export as RGBA PNG.
+    Image.fromarray(arr, mode="RGBA").save(output_path, format="PNG")
+    return output_path
+
+
 def batch_images(folder: Path, output_folder: Path, size: str | None = None, fmt: str | None = None) -> list[Path]:
     ensure_dir(output_folder)
     outputs: list[Path] = []

{devbits-1.0.0 → devbits-1.1.0}/devbits/scripts.py

@@ -47,6 +47,10 @@ def resizeimage() -> int:
     return _run("resizeimage")
 
 
+def recolor() -> int:
+    return _run("recolor")
+
+
 def batchimages() -> int:
     return _run("batchimages")
 

{devbits-1.0.0 → devbits-1.1.0}/devbits/utils.py

@@ -46,6 +46,33 @@ def parse_size(size: str) -> tuple[int, int]:
     return width_i, height_i
 
 
+def parse_color(value: str) -> tuple[int, int, int]:
+    """Parse a color into an ``(R, G, B)`` tuple.
+
+    Accepts a CSS name (``black``), a hex value (``#1a73e8``), or a comma-/
+    space-separated ``R,G,B`` triple (``0,178,179``).
+    """
+    from PIL import ImageColor
+
+    text = value.strip()
+    if "," in text:
+        parts = [p.strip() for p in text.split(",") if p.strip()]
+        if len(parts) != 3:
+            raise ValueError(f"RGB color must have 3 components, got: {value!r}")
+        try:
+            channels = tuple(int(p) for p in parts)
+        except ValueError as exc:
+            raise ValueError(f"RGB components must be integers: {value!r}") from exc
+        if any(c < 0 or c > 255 for c in channels):
+            raise ValueError(f"RGB components must be in 0-255: {value!r}")
+        return channels  # type: ignore[return-value]
+
+    try:
+        return ImageColor.getrgb(text)[:3]
+    except ValueError as exc:
+        raise ValueError(f"Unrecognized color: {value!r}") from exc
+
+
 def parse_int_tuple(value: str, expected: int, name: str) -> tuple[int, ...]:
     try:
         items = tuple(int(x.strip()) for x in value.split(","))

{devbits-1.0.0 → devbits-1.1.0}/devbits.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devbits
-Version: 1.0.0
+Version: 1.1.0
 Summary: A lightweight CLI toolkit for daily development utilities.
 Author: Bruce Chuang
 License-Expression: MIT
@@ -64,6 +64,7 @@ clipvideo --help
 | Command | Description |
 |---------|-------------|
 | `resizeimage` | Resize a single image (preserves aspect ratio by default). |
+| `recolor` | Recolor a logo/icon foreground, leaving the background intact. |
 | `image2ico` | Convert an image to a multi-size ICO file. |
 | `batchimages` | Batch resize or convert all images in a folder. |
 | `checkimages` | Scan for broken / corrupt image files. |
@@ -94,6 +95,13 @@ video2gif movie.mp4 --start 3.5 --end 10.0 --fps 15
 # Extract every 5th frame as PNG
 video2images movie.mp4 --every 5 --format png
 
+# Recolor a logo's foreground to black (keeps the background)
+recolor logo.png
+
+# Recolor a logo's foreground to a custom color (hex or R,G,B)
+recolor logo.png --color '#1a73e8'
+recolor logo.png --color 0,178,179
+
 # Batch resize images to 800×600
 batchimages ./photos -o ./resized --size 800,600
 
@@ -109,6 +117,7 @@ When `-o` / `--output` is omitted, the output filename is derived from the input
 clipvideo movie.mp4          →  movie_clip.mp4
 video2gif movie.mp4          →  movie.gif
 resizeimage photo.jpg        →  photo_resized.jpg
+recolor logo.png             →  logo_revised.png
 contactsheet ./photos        →  photos_sheet.jpg
 ```
 

{devbits-1.0.0 → devbits-1.1.0}/devbits.egg-info/SOURCES.txt

@@ -17,4 +17,5 @@ devbits.egg-info/entry_points.txt
 devbits.egg-info/requires.txt
 devbits.egg-info/top_level.txt
 tests/test_cli.py
-tests/test_gui_cli.py
+tests/test_gui_cli.py
+tests/test_recolor.py

{devbits-1.0.0 → devbits-1.1.0}/devbits.egg-info/entry_points.txt

@@ -8,6 +8,7 @@ devbits = devbits.cli:main
 image2ico = devbits.scripts:image2ico
 images2gif = devbits.scripts:images2gif
 images2video = devbits.scripts:images2video
+recolor = devbits.scripts:recolor
 renamefiles = devbits.scripts:renamefiles
 resizeimage = devbits.scripts:resizeimage
 resizevideo = devbits.scripts:resizevideo

{devbits-1.0.0 → devbits-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devbits"
-version = "1.0.0"
+version = "1.1.0"
 description = "A lightweight CLI toolkit for daily development utilities."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -30,6 +30,7 @@ clipvideo = "devbits.scripts:clipvideo"
 resizevideo = "devbits.scripts:resizevideo"
 image2ico = "devbits.scripts:image2ico"
 resizeimage = "devbits.scripts:resizeimage"
+recolor = "devbits.scripts:recolor"
 batchimages = "devbits.scripts:batchimages"
 checkimages = "devbits.scripts:checkimages"
 contactsheet = "devbits.scripts:contactsheet"

devbits-1.1.0/tests/test_recolor.py

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+from PIL import Image
+
+from devbits.cli import main
+from devbits.image import recolor_image
+
+
+def _make_transparent_logo(path) -> None:
+    """A transparent background with an opaque red square in the middle."""
+    img = Image.new("RGBA", (20, 20), (0, 0, 0, 0))
+    for y in range(5, 15):
+        for x in range(5, 15):
+            img.putpixel((x, y), (200, 0, 0, 255))
+    img.save(path)
+
+
+def _make_opaque_logo(path) -> None:
+    """A light-gray background with a dark blue square in the middle."""
+    img = Image.new("RGB", (20, 20), (230, 230, 230))
+    for y in range(5, 15):
+        for x in range(5, 15):
+            img.putpixel((x, y), (10, 10, 120))
+    img.save(path)
+
+
+def test_recolor_transparent(tmp_path) -> None:
+    src = tmp_path / "logo.png"
+    _make_transparent_logo(src)
+    out = recolor_image(src, tmp_path / "logo_revised.png", "black")
+
+    result = Image.open(out)
+    assert result.mode == "RGBA"
+    # Foreground becomes black and stays opaque.
+    assert result.getpixel((10, 10)) == (0, 0, 0, 255)
+    # Background stays transparent.
+    assert result.getpixel((0, 0))[3] == 0
+
+
+def test_recolor_opaque_custom_color(tmp_path) -> None:
+    src = tmp_path / "icon.jpg"
+    _make_opaque_logo(src)
+    out = recolor_image(src, tmp_path / "icon_revised.png", "#00ff00")
+
+    result = Image.open(out)
+    assert result.mode == "RGBA"
+    # Foreground becomes the requested green.
+    assert result.getpixel((10, 10))[:3] == (0, 255, 0)
+    # Light background is left roughly unchanged.
+    assert result.getpixel((0, 0))[0] > 200
+
+
+def test_recolor_rgb_triple(tmp_path) -> None:
+    src = tmp_path / "logo.png"
+    _make_transparent_logo(src)
+    out = recolor_image(src, tmp_path / "logo_revised.png", "0,178,179")
+
+    result = Image.open(out)
+    assert result.mode == "RGBA"
+    assert result.getpixel((10, 10)) == (0, 178, 179, 255)
+
+
+def test_recolor_cli_default_output(tmp_path) -> None:
+    src = tmp_path / "brand.png"
+    _make_transparent_logo(src)
+    assert main(["recolor", str(src)]) == 0
+    assert (tmp_path / "brand_revised.png").exists()