imagex 0.2.1__tar.gz → 0.2.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imagex
-Version: 0.2.1
+Version: 0.2.2
 Summary: All-in-one image processing CLI — resize, convert, watermark, compress, and more
 Author-email: kushal1o1 <kushal1o1@users.noreply.github.com>
 License: MIT License
@@ -81,6 +81,7 @@ Navigate to any folder with images and run `imagex`.
 | Feature | Description |
 |---|---|
 | Rotate | Rotate 90° Left, 90° Right, or 180° |
+| Flip | Mirror horizontally or vertically |
 | Remove Metadata | Strip EXIF/XMP/IPTC (incl. AI generation markers) |
 | Convert Format | JPG ↔ PNG ↔ WEBP ↔ TIFF ↔ BMP ↔ GIF ↔ HEIC |
 | Compress / Optimize | Reduce file size with quality slider |

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

@@ -21,6 +21,7 @@ Navigate to any folder with images and run `imagex`.
 | Feature | Description |
 |---|---|
 | Rotate | Rotate 90° Left, 90° Right, or 180° |
+| Flip | Mirror horizontally or vertically |
 | Remove Metadata | Strip EXIF/XMP/IPTC (incl. AI generation markers) |
 | Convert Format | JPG ↔ PNG ↔ WEBP ↔ TIFF ↔ BMP ↔ GIF ↔ HEIC |
 | Compress / Optimize | Reduce file size with quality slider |

imagex-0.2.2/imagex/__init__.py

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

{imagex-0.2.1 → imagex-0.2.2}/imagex/cli.py

@@ -1,5 +1,7 @@
 import argparse
+import json
 import sys
+import urllib.request
 from pathlib import Path
 from typing import Optional
 
@@ -163,6 +165,23 @@ def select_files(all_files: list[Path]) -> Optional[list[Path]]:
     return [Path(f) for f in selected]
 
 
+PYPI_URL = "https://pypi.org/pypi/imagex/json"
+
+
+def _check_version():
+    try:
+        req = urllib.request.Request(PYPI_URL, headers={"Accept": "application/json"})
+        resp = urllib.request.urlopen(req, timeout=2)
+        latest = json.loads(resp.read())["info"]["version"]
+        if latest != __version__:
+            console.print(
+                f"  [dim] New version available :) : {latest} → "
+                f"pip install --upgrade imagex[/dim]"
+            )
+    except Exception:
+        pass
+
+
 def main():
     _parse_args()
 
@@ -214,6 +233,7 @@ def main():
             )
 
         console.print("\n[bold green]✓ All done![/bold green]")
+        _check_version()
 
     except KeyboardInterrupt:
         console.print("\n[yellow]Interrupted. Exiting.[/yellow]")

imagex-0.2.2/imagex/features/flip.py

@@ -0,0 +1,38 @@
+from pathlib import Path
+from typing import Any, Optional
+
+import questionary
+from PIL import Image
+
+NAME = "Flip"
+DESCRIPTION = "Mirror images horizontally or vertically"
+
+OPTIONS = {
+    "Horizontal (left ↔ right)": Image.FLIP_LEFT_RIGHT,
+    "Vertical (top ↔ bottom)": Image.FLIP_TOP_BOTTOM,
+}
+
+
+def ask_args(files: list[Path]) -> dict[str, Any]:
+    direction = questionary.select(
+        "Flip direction:",
+        choices=list(OPTIONS.keys()),
+    ).ask()
+
+    return {"method": OPTIONS[direction]}
+
+
+def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) -> bool:
+    if args is None:
+        msg = "args required for flip"
+        raise ValueError(msg)
+
+    img = Image.open(file)
+    flipped = img.transpose(args["method"])
+    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
+    flipped.save(str(output_path), **kw)
+    return True

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imagex
-Version: 0.2.1
+Version: 0.2.2
 Summary: All-in-one image processing CLI — resize, convert, watermark, compress, and more
 Author-email: kushal1o1 <kushal1o1@users.noreply.github.com>
 License: MIT License
@@ -81,6 +81,7 @@ Navigate to any folder with images and run `imagex`.
 | Feature | Description |
 |---|---|
 | Rotate | Rotate 90° Left, 90° Right, or 180° |
+| Flip | Mirror horizontally or vertically |
 | Remove Metadata | Strip EXIF/XMP/IPTC (incl. AI generation markers) |
 | Convert Format | JPG ↔ PNG ↔ WEBP ↔ TIFF ↔ BMP ↔ GIF ↔ HEIC |
 | Compress / Optimize | Reduce file size with quality slider |

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

@@ -15,6 +15,7 @@ imagex/features/__init__.py
 imagex/features/add_noise.py
 imagex/features/compress.py
 imagex/features/convert.py
+imagex/features/flip.py
 imagex/features/remove_metadata.py
 imagex/features/rename_batch.py
 imagex/features/resize.py
@@ -28,6 +29,7 @@ tests/test_cli.py
 tests/test_compress.py
 tests/test_convert.py
 tests/test_file_ops.py
+tests/test_flip.py
 tests/test_remove_metadata.py
 tests/test_rename_batch.py
 tests/test_resize.py

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

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

imagex-0.2.2/tests/test_flip.py

@@ -0,0 +1,72 @@
+from PIL import Image
+
+from imagex.features.flip import run
+
+
+def _marked_image(path, size=(4, 4)):
+    """An all-black image with a single white pixel in the top-left corner."""
+    img = Image.new("RGB", size, color="black")
+    img.putpixel((0, 0), (255, 255, 255))
+    img.save(str(path))
+    return img
+
+
+class TestFlipRun:
+    def test_flip_horizontal_moves_pixel_left_to_right(self, tmp_path):
+        src = tmp_path / "marked.png"
+        _marked_image(src)
+        out = tmp_path / "h.png"
+        assert run(src, out, {"method": Image.FLIP_LEFT_RIGHT})
+
+        flipped = Image.open(out)
+        # top-left white pixel mirrors to the top-right
+        assert flipped.getpixel((3, 0)) == (255, 255, 255)
+        assert flipped.getpixel((0, 0)) == (0, 0, 0)
+
+    def test_flip_vertical_moves_pixel_top_to_bottom(self, tmp_path):
+        src = tmp_path / "marked.png"
+        _marked_image(src)
+        out = tmp_path / "v.png"
+        assert run(src, out, {"method": Image.FLIP_TOP_BOTTOM})
+
+        flipped = Image.open(out)
+        # top-left white pixel mirrors to the bottom-left
+        assert flipped.getpixel((0, 3)) == (255, 255, 255)
+        assert flipped.getpixel((0, 0)) == (0, 0, 0)
+
+    def test_preserves_dimensions(self, tmp_images, tmp_path):
+        src = tmp_images / "test.jpg"
+        original = Image.open(src)
+        out = tmp_path / "out.jpg"
+        assert run(src, out, {"method": Image.FLIP_LEFT_RIGHT})
+
+        flipped = Image.open(out)
+        assert flipped.width == original.width
+        assert flipped.height == original.height
+
+    def test_double_flip_restores_original(self, tmp_path):
+        src = tmp_path / "marked.png"
+        _marked_image(src)
+        once = tmp_path / "once.png"
+        twice = tmp_path / "twice.png"
+        run(src, once, {"method": Image.FLIP_LEFT_RIGHT})
+        run(once, twice, {"method": Image.FLIP_LEFT_RIGHT})
+
+        assert Image.open(twice).getpixel((0, 0)) == (255, 255, 255)
+
+    def test_preserves_format(self, tmp_images, tmp_path):
+        src = tmp_images / "image.webp"
+        out = tmp_path / "out.webp"
+        assert run(src, out, {"method": Image.FLIP_TOP_BOTTOM})
+
+        flipped = Image.open(out)
+        assert flipped.format == "WEBP"
+
+    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.2.1/imagex/__init__.py

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