imagex 0.2.2__tar.gz → 0.3.0__tar.gz

{imagex-0.2.2 → imagex-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imagex
-Version: 0.2.2
+Version: 0.3.0
 Summary: All-in-one image processing CLI — resize, convert, watermark, compress, and more
 Author-email: kushal1o1 <kushal1o1@users.noreply.github.com>
 License: MIT License
@@ -89,6 +89,8 @@ Navigate to any folder with images and run `imagex`.
 | Rename Batch | Pattern-based renaming (%n, %o) |
 | Add Noise | Gaussian or salt & pepper (bypass AI detection) |
 | Watermark | Add text/image or remove existing |
+| Grayscale / B&W | Convert to grayscale or true black & white |
+| Invert Colors | Negative effect , invert all colors |
 
 Full details in [OPERATIONS.md](https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md).
 

{imagex-0.2.2 → imagex-0.3.0}/README.md

@@ -29,6 +29,8 @@ Navigate to any folder with images and run `imagex`.
 | Rename Batch | Pattern-based renaming (%n, %o) |
 | Add Noise | Gaussian or salt & pepper (bypass AI detection) |
 | Watermark | Add text/image or remove existing |
+| Grayscale / B&W | Convert to grayscale or true black & white |
+| Invert Colors | Negative effect , invert all colors |
 
 Full details in [OPERATIONS.md](https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md).
 

imagex-0.3.0/imagex/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.0"

imagex-0.3.0/imagex/features/grayscale.py

@@ -0,0 +1,57 @@
+from pathlib import Path
+from typing import Any, Optional
+
+import questionary
+from PIL import Image
+
+NAME = "Grayscale / B&W"
+DESCRIPTION = "Convert images to grayscale or true black & white"
+
+MODES = {
+    "Grayscale (luminosity)": "grayscale",
+    "True Black & White (threshold)": "bw",
+}
+
+
+def ask_args(files: list[Path]) -> dict[str, Any]:
+    mode_label = questionary.select(
+        "Mode:",
+        choices=list(MODES.keys()),
+    ).ask()
+
+    args = {"mode": MODES[mode_label]}
+
+    if MODES[mode_label] == "bw":
+        threshold = questionary.text(
+            "Threshold (0-255, lower = more black):",
+            default="128",
+            validate=lambda v: v.isdigit() and 0 <= int(v) <= 255 or "Enter 0-255",
+        ).ask()
+        args["threshold"] = int(threshold)
+
+    return args
+
+
+def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) -> bool:
+    if args is None:
+        msg = "args required for grayscale"
+        raise ValueError(msg)
+
+    img = Image.open(file)
+    kw = {"format": img.format or "JPEG"}
+    if exif := img.info.get("exif"):
+        kw["exif"] = exif
+    if icc := img.info.get("icc_profile"):
+        kw["icc_profile"] = icc
+
+    gray = img.convert("L")
+
+    if args["mode"] == "grayscale":
+        gray.save(str(output_path), **kw)
+    else:
+        threshold = args.get("threshold", 128)
+        bw = gray.point(lambda p: 255 if p > threshold else 0, mode="1")
+        bw = bw.convert("L")
+        bw.save(str(output_path), **kw)
+
+    return True

imagex-0.3.0/imagex/features/invert.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+from typing import Any, Optional
+
+from PIL import Image, ImageOps
+
+NAME = "Invert Colors"
+DESCRIPTION = "Invert image colors (negative effect)"
+
+
+def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) -> bool:
+    img = Image.open(file)
+    kw = {"format": img.format or "JPEG"}
+    if exif := img.info.get("exif"):
+        kw["exif"] = exif
+    if icc := img.info.get("icc_profile"):
+        kw["icc_profile"] = icc
+
+    if img.mode == "RGBA":
+        r, g, b, a = img.split()
+        rgb = Image.merge("RGB", (r, g, b))
+        inverted = ImageOps.invert(rgb)
+        r2, g2, b2 = inverted.split()
+        img = Image.merge("RGBA", (r2, g2, b2, a))
+    else:
+        if img.mode != "RGB":
+            img = img.convert("RGB")
+        img = ImageOps.invert(img)
+
+    img.save(str(output_path), **kw)
+    return True

{imagex-0.2.2 → imagex-0.3.0}/imagex.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imagex
-Version: 0.2.2
+Version: 0.3.0
 Summary: All-in-one image processing CLI — resize, convert, watermark, compress, and more
 Author-email: kushal1o1 <kushal1o1@users.noreply.github.com>
 License: MIT License
@@ -89,6 +89,8 @@ Navigate to any folder with images and run `imagex`.
 | Rename Batch | Pattern-based renaming (%n, %o) |
 | Add Noise | Gaussian or salt & pepper (bypass AI detection) |
 | Watermark | Add text/image or remove existing |
+| Grayscale / B&W | Convert to grayscale or true black & white |
+| Invert Colors | Negative effect , invert all colors |
 
 Full details in [OPERATIONS.md](https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md).
 

{imagex-0.2.2 → imagex-0.3.0}/imagex.egg-info/SOURCES.txt

@@ -16,6 +16,8 @@ imagex/features/add_noise.py
 imagex/features/compress.py
 imagex/features/convert.py
 imagex/features/flip.py
+imagex/features/grayscale.py
+imagex/features/invert.py
 imagex/features/remove_metadata.py
 imagex/features/rename_batch.py
 imagex/features/resize.py
@@ -30,6 +32,8 @@ tests/test_compress.py
 tests/test_convert.py
 tests/test_file_ops.py
 tests/test_flip.py
+tests/test_grayscale.py
+tests/test_invert.py
 tests/test_remove_metadata.py
 tests/test_rename_batch.py
 tests/test_resize.py

{imagex-0.2.2 → imagex-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "imagex"
-version = "0.2.2"
+version = "0.3.0"
 description = "All-in-one image processing CLI — resize, convert, watermark, compress, and more"
 readme = "README.md"
 requires-python = ">=3.10"

imagex-0.3.0/tests/test_grayscale.py

@@ -0,0 +1,53 @@
+from PIL import Image
+
+from imagex.features.grayscale import run
+
+
+class TestGrayscaleRun:
+    def test_grayscale_converts_mode(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        out = tmp_path / "gray.jpg"
+        assert run(src, out, {"mode": "grayscale"})
+
+        result = Image.open(out)
+        assert result.mode == "L"
+
+    def test_grayscale_preserves_size(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        img = Image.open(src)
+        out = tmp_path / "gray.png"
+        assert run(src, out, {"mode": "grayscale"})
+
+        result = Image.open(out)
+        assert result.width == img.width
+        assert result.height == img.height
+
+    def test_bw_threshold_high(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        out = tmp_path / "white.png"
+        assert run(src, out, {"mode": "bw", "threshold": 255})
+
+        result = Image.open(out)
+        assert result.mode == "L"
+        # threshold 255 means everything below 255 becomes black
+        # our red image (255,0,0) -> L ~ 76 -> 0 = black
+        assert result.getpixel((0, 0)) == 0
+
+    def test_bw_threshold_low(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        out = tmp_path / "black.png"
+        assert run(src, out, {"mode": "bw", "threshold": 0})
+
+        result = Image.open(out)
+        # threshold 0 means only pure black stays black
+        # our red image -> L ~ 76 -> 255 = white
+        assert result.getpixel((0, 0)) == 255
+
+    def test_run_without_args_raises(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        out = tmp_path / "out.jpg"
+        try:
+            run(src, out, None)
+            assert False, "should have raised"
+        except ValueError as e:
+            assert "args required" in str(e).lower()

imagex-0.3.0/tests/test_invert.py

@@ -0,0 +1,57 @@
+from PIL import Image
+
+from imagex.features.invert import run
+
+
+class TestInvertRun:
+    def test_invert_rgb_changes_pixels(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        img = Image.open(src)
+        original_pixel = img.getpixel((0, 0))
+        out = tmp_path / "inverted.png"
+        assert run(src, out, {})
+
+        result = Image.open(out)
+        inverted = result.getpixel((0, 0))
+        # red (255,0,0) -> cyan (0,255,255)
+        expected = tuple(255 - v for v in original_pixel)
+        assert inverted == expected
+
+    def test_invert_preserves_size(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        img = Image.open(src)
+        out = tmp_path / "inv.png"
+        assert run(src, out, {})
+
+        result = Image.open(out)
+        assert result.width == img.width
+        assert result.height == img.height
+
+    def test_invert_rgba_handles_alpha(self, tmp_images, tmp_path):
+        src = tmp_images / "with_alpha.png"
+        img = Image.open(src)
+        out = tmp_path / "inv_alpha.png"
+        assert run(src, out, {})
+
+        result = Image.open(out)
+        assert result.mode == "RGBA"
+        assert result.width == img.width
+        assert result.height == img.height
+
+    def test_invert_white_to_black(self, tmp_path):
+        src = tmp_path / "white.png"
+        Image.new("RGB", (10, 10), color="white").save(str(src))
+        out = tmp_path / "black.png"
+        assert run(src, out, {})
+
+        result = Image.open(out)
+        assert result.getpixel((0, 0)) == (0, 0, 0)
+
+    def test_invert_black_to_white(self, tmp_path):
+        src = tmp_path / "black.png"
+        Image.new("RGB", (10, 10), color="black").save(str(src))
+        out = tmp_path / "white.png"
+        assert run(src, out, {})
+
+        result = Image.open(out)
+        assert result.getpixel((0, 0)) == (255, 255, 255)

imagex-0.2.2/imagex/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.2"