imagex 0.2.0__tar.gz → 0.2.2__tar.gz

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

@@ -1,16 +1,49 @@
 Metadata-Version: 2.4
 Name: imagex
-Version: 0.2.0
-Summary: Image processing CLI tool - right in your terminal
-Author: kushal1o1
-License: MIT
+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
+        
+        Copyright (c) 2026 Kushal Baral
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/kushal1o1/ImageX
+Project-URL: Repository, https://github.com/kushal1o1/ImageX
+Project-URL: Documentation, https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md
+Project-URL: Changelog, https://github.com/kushal1o1/ImageX/releases
+Project-URL: Issues, https://github.com/kushal1o1/ImageX/issues
+Keywords: image-processing,cli,pillow,resize,convert,watermark,compress,metadata,batch,rename
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -48,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 |
@@ -56,7 +90,7 @@ Navigate to any folder with images and run `imagex`.
 | Add Noise | Gaussian or salt & pepper (bypass AI detection) |
 | Watermark | Add text/image or remove existing |
 
-Full details in [OPERATIONS.md](OPERATIONS.md).
+Full details in [OPERATIONS.md](https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md).
 
 ## Install
 
@@ -72,7 +106,7 @@ Then run `imagex` from any folder.
 
 ## Adding Features
 
-See [CONTRIBUTION.md](CONTRIBUTION.md) for the contribution guide.
+See [CONTRIBUTION.md](https://github.com/kushal1o1/ImageX/blob/main/CONTRIBUTION.md) for the contribution guide.
 
 ## License
 

{imagex-0.2.0 → 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 |
@@ -29,7 +30,7 @@ Navigate to any folder with images and run `imagex`.
 | Add Noise | Gaussian or salt & pepper (bypass AI detection) |
 | Watermark | Add text/image or remove existing |
 
-Full details in [OPERATIONS.md](OPERATIONS.md).
+Full details in [OPERATIONS.md](https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md).
 
 ## Install
 
@@ -45,7 +46,7 @@ Then run `imagex` from any folder.
 
 ## Adding Features
 
-See [CONTRIBUTION.md](CONTRIBUTION.md) for the contribution guide.
+See [CONTRIBUTION.md](https://github.com/kushal1o1/ImageX/blob/main/CONTRIBUTION.md) for the contribution guide.
 
 ## License
 

imagex-0.2.2/imagex/__init__.py

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

{imagex-0.2.0 → 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.0 → imagex-0.2.2}/imagex/features/add_noise.py

@@ -44,7 +44,12 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
     else:
         _add_salt_pepper(img, intensity)
 
-    img.save(str(output_path), format=img.format or "JPEG")
+    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
+    img.save(str(output_path), **kw)
     return True
 
 

{imagex-0.2.0 → imagex-0.2.2}/imagex/features/compress.py

@@ -28,17 +28,22 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
 
     quality = args.get("quality", 80)
     img = Image.open(file)
+    meta = {}
+    if exif := img.info.get("exif"):
+        meta["exif"] = exif
+    if icc := img.info.get("icc_profile"):
+        meta["icc_profile"] = icc
     fmt = img.format
     original_size = file.stat().st_size
 
     if fmt == "JPEG":
-        _compress_jpeg(img, output_path, quality)
+        _compress_jpeg(img, output_path, quality, meta)
     elif fmt == "PNG":
-        _compress_png(img, output_path, quality)
+        _compress_png(img, output_path, quality, meta)
     elif fmt == "WEBP":
-        _compress_webp(img, output_path, quality)
+        _compress_webp(img, output_path, quality, meta)
     else:
-        _compress_other(img, output_path, fmt, quality)
+        _compress_other(img, output_path, fmt, quality, meta)
 
     new_size = output_path.stat().st_size
     saved = original_size - new_size
@@ -51,17 +56,17 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
     return True
 
 
-def _compress_jpeg(img: Image.Image, output_path: Path, quality: int):
+def _compress_jpeg(img: Image.Image, output_path: Path, quality: int, meta: dict):
     if img.mode == "RGBA":
         bg = Image.new("RGB", img.size, (255, 255, 255))
         bg.paste(img, mask=img.split()[3])
         img = bg
     elif img.mode != "RGB":
         img = img.convert("RGB")
-    img.save(str(output_path), format="JPEG", quality=quality, optimize=True)
+    img.save(str(output_path), format="JPEG", quality=quality, optimize=True, **meta)
 
 
-def _compress_png(img: Image.Image, output_path: Path, quality: int):
+def _compress_png(img: Image.Image, output_path: Path, quality: int, meta: dict):
     if quality < 50:
         if img.mode == "RGBA":
             bg = Image.new("RGB", img.size, (255, 255, 255))
@@ -71,17 +76,19 @@ def _compress_png(img: Image.Image, output_path: Path, quality: int):
             img = img.convert("RGB")
         colors = max(quality * 2, 16)
         img = img.quantize(colors=colors, method=Image.Quantize.MEDIANCUT)
-        img.save(str(output_path), format="PNG", optimize=True)
+        img.save(str(output_path), format="PNG", optimize=True, **meta)
     else:
-        img.save(str(output_path), format="PNG", optimize=True)
+        img.save(str(output_path), format="PNG", optimize=True, **meta)
 
 
-def _compress_webp(img: Image.Image, output_path: Path, quality: int):
-    img.save(str(output_path), format="WEBP", quality=quality)
+def _compress_webp(img: Image.Image, output_path: Path, quality: int, meta: dict):
+    img.save(str(output_path), format="WEBP", quality=quality, **meta)
 
 
-def _compress_other(img: Image.Image, output_path: Path, fmt: str, quality: int):
-    params = {"format": fmt}
+def _compress_other(
+    img: Image.Image, output_path: Path, fmt: str, quality: int, meta: dict,
+):
+    params = {"format": fmt, **meta}
     if fmt == "GIF":
         params["save_all"] = True
     img.save(str(output_path), **params)

{imagex-0.2.0 → imagex-0.2.2}/imagex/features/convert.py

@@ -48,16 +48,21 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
     target_fmt = args["target_format"]
 
     img = Image.open(file)
+    meta = {}
+    if exif := img.info.get("exif"):
+        meta["exif"] = exif
+    if icc := img.info.get("icc_profile"):
+        meta["icc_profile"] = icc
     actual_output = output_path.with_suffix(args["target_ext"])
 
     if target_fmt == "JPEG":
-        _save_as_jpeg(img, actual_output)
+        _save_as_jpeg(img, actual_output, meta)
     elif target_fmt == "PNG":
-        _save_as_png(img, actual_output)
+        _save_as_png(img, actual_output, meta)
     elif target_fmt == "WEBP":
-        _save_as_webp(img, actual_output)
+        _save_as_webp(img, actual_output, meta)
     elif target_fmt == "TIFF":
-        img.save(str(actual_output), format="TIFF")
+        img.save(str(actual_output), format="TIFF", **meta)
     elif target_fmt == "BMP":
         img.save(str(actual_output), format="BMP")
     elif target_fmt == "GIF":
@@ -68,22 +73,22 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
     return True
 
 
-def _save_as_jpeg(img: Image.Image, output_path: Path):
+def _save_as_jpeg(img: Image.Image, output_path: Path, meta: dict):
     if img.mode == "RGBA":
         bg = Image.new("RGB", img.size, (255, 255, 255))
         bg.paste(img, mask=img.split()[3])
         img = bg
     elif img.mode != "RGB":
         img = img.convert("RGB")
-    img.save(str(output_path), format="JPEG")
+    img.save(str(output_path), format="JPEG", **meta)
 
 
-def _save_as_png(img: Image.Image, output_path: Path):
-    img.save(str(output_path), format="PNG")
+def _save_as_png(img: Image.Image, output_path: Path, meta: dict):
+    img.save(str(output_path), format="PNG", **meta)
 
 
-def _save_as_webp(img: Image.Image, output_path: Path):
-    img.save(str(output_path), format="WEBP")
+def _save_as_webp(img: Image.Image, output_path: Path, meta: dict):
+    img.save(str(output_path), format="WEBP", **meta)
 
 
 def _save_as_heic(img: Image.Image, output_path: Path):

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.0 → imagex-0.2.2}/imagex/features/resize.py

@@ -78,7 +78,12 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
         raise ValueError(msg)
 
     resized = img.resize((new_w, new_h), Image.LANCZOS)
-    resized.save(str(output_path), format=img.format or "JPEG")
+    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
+    resized.save(str(output_path), **kw)
 
     return True
 

{imagex-0.2.0 → imagex-0.2.2}/imagex/features/rotate.py

@@ -30,5 +30,10 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
 
     img = Image.open(file)
     rotated = img.transpose(args["method"])
-    rotated.save(str(output_path), format=img.format or "JPEG")
+    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
+    rotated.save(str(output_path), **kw)
     return True

{imagex-0.2.0 → imagex-0.2.2}/imagex/features/watermark.py

@@ -123,7 +123,13 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
         msg = "args required for watermark"
         raise ValueError(msg)
 
-    img = Image.open(file).convert("RGBA")
+    src = Image.open(file)
+    meta = {}
+    if exif := src.info.get("exif"):
+        meta["exif"] = exif
+    if icc := src.info.get("icc_profile"):
+        meta["icc_profile"] = icc
+    img = src.convert("RGBA")
     action = args["action"]
 
     if action == "add":
@@ -135,7 +141,7 @@ def run(file: Path, output_path: Path, args: Optional[dict[str, Any]] = None) ->
         raise ValueError(msg)
 
     out = img.convert("RGB") if img.mode == "RGBA" else img
-    out.save(str(output_path))
+    out.save(str(output_path), **meta)
     return True
 
 

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

@@ -1,16 +1,49 @@
 Metadata-Version: 2.4
 Name: imagex
-Version: 0.2.0
-Summary: Image processing CLI tool - right in your terminal
-Author: kushal1o1
-License: MIT
+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
+        
+        Copyright (c) 2026 Kushal Baral
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/kushal1o1/ImageX
+Project-URL: Repository, https://github.com/kushal1o1/ImageX
+Project-URL: Documentation, https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md
+Project-URL: Changelog, https://github.com/kushal1o1/ImageX/releases
+Project-URL: Issues, https://github.com/kushal1o1/ImageX/issues
+Keywords: image-processing,cli,pillow,resize,convert,watermark,compress,metadata,batch,rename
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -48,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 |
@@ -56,7 +90,7 @@ Navigate to any folder with images and run `imagex`.
 | Add Noise | Gaussian or salt & pepper (bypass AI detection) |
 | Watermark | Add text/image or remove existing |
 
-Full details in [OPERATIONS.md](OPERATIONS.md).
+Full details in [OPERATIONS.md](https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md).
 
 ## Install
 
@@ -72,7 +106,7 @@ Then run `imagex` from any folder.
 
 ## Adding Features
 
-See [CONTRIBUTION.md](CONTRIBUTION.md) for the contribution guide.
+See [CONTRIBUTION.md](https://github.com/kushal1o1/ImageX/blob/main/CONTRIBUTION.md) for the contribution guide.
 
 ## License
 

{imagex-0.2.0 → 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.0 → imagex-0.2.2}/pyproject.toml

@@ -4,23 +4,40 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "imagex"
-version = "0.2.0"
-description = "Image processing CLI tool - right in your terminal"
+version = "0.2.2"
+description = "All-in-one image processing CLI — resize, convert, watermark, compress, and more"
 readme = "README.md"
 requires-python = ">=3.10"
-license = {text = "MIT"}
+license = {file = "LICENSE"}
 authors = [
-    {name = "kushal1o1"},
+    {name = "kushal1o1", email = "kushal1o1@users.noreply.github.com"},
+]
+keywords = [
+    "image-processing",
+    "cli",
+    "pillow",
+    "resize",
+    "convert",
+    "watermark",
+    "compress",
+    "metadata",
+    "batch",
+    "rename",
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Multimedia :: Graphics :: Graphics Conversion",
+    "Topic :: Utilities",
 ]
 dependencies = [
     "rich>=13.0",
@@ -28,6 +45,13 @@ dependencies = [
     "Pillow>=10.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/kushal1o1/ImageX"
+Repository = "https://github.com/kushal1o1/ImageX"
+Documentation = "https://github.com/kushal1o1/ImageX/blob/main/OPERATIONS.md"
+Changelog = "https://github.com/kushal1o1/ImageX/releases"
+Issues = "https://github.com/kushal1o1/ImageX/issues"
+
 [project.optional-dependencies]
 heif = [
     "pillow-heif>=0.16",

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.0/imagex/__init__.py

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