fix: apply medium/high severity code review findings

- Re-raise worker futures in as_completed to surface thread exceptions
- Replace hardcoded extension set with ALLOWED_EXT constant in compress_with_caesium
- Initialise work_dir/scratch_dir to None before try block to prevent NameError in finally
- Remove unused dead function get_slide_numbers_for_image
- Simplify redundant caesium_threads guard (threads and threads > 1 -> threads > 1)
- Write [Content_Types].xml first in ZIP to satisfy OOXML spec

Co-Authored-By: Abacus.AI CLI <agent@abacus.ai>

.gitignore

@@ -2,3 +2,4 @@ python-3.*-embed-amd64.zip
 python-embed/*
 .vscode/launch.json
 logs/*.log
+__pycache__/*

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+    "python.testing.unittestArgs": [
+        "-v",
+        "-s",
+        ".",
+        "-p",
+        "test_*.py"
+    ],
+    "python.testing.pytestEnabled": false,
+    "python.testing.unittestEnabled": true
+}

README.md

@@ -1,6 +1,6 @@
 
 # PPTX Image Compressor (CaesiumCLT only)
-**Version 1.1.3**
+**Version 1.1.6**
 
 Dieses Paket enthält:
 
@@ -11,8 +11,6 @@ PPTX-Image-Compressor/
 ├─ pptx_image_compress.py
 ├─ bin/
 │  └─ caesiumclt.exe
-└─ samples/
-   └─ README.txt
 ```
 
 ## Schnellstart (ohne Admin-Rechte)
@@ -32,16 +30,17 @@ Die Batch lädt bei Bedarf automatisch das **Windows Embeddable Python Package**
 
 ## Was das Tool macht
 - Entpackt die PPTX in einen Temp‑Ordner
-- Komprimiert **JPG/JPEG, PNG, WebP** mit **CaesiumCLT** (Default `-q 90`, `-O bigger`)
+- Komprimiert **JPG/JPEG, PNG, WebP, GIF** mit **CaesiumCLT** (Default `-q 90`, `-O bigger`)
 - Ersetzt Bilder nur, wenn die komprimierte Datei kleiner ist
+- Ersetzt Bilder nur, wenn sei mindestens 2% kleiner sind (verhindert *doppelte Komprimierung*)
 - Schreibt ein CSV‑Log (`.log` neben der Output‑PPTX)
 - Baut eine neue PPTX und zeigt eine Summary (Name, Größe vorher/nachher, Ersparnis %, Zeit)
 - Räumt alle temporären Dateien auf (keine Caesium‑Tempfiles in der finalen PPTX)
 
 ## Hinweise
-- **GIF** wird übersprungen (keine Rekodierung).
 - `-t` steuert die Parallelität der Python‑Threads; intern wird `caesiumclt --threads 1` gesetzt, sobald `-t > 1`, um Oversubscription zu vermeiden. Default ist 16
 -  `-q` steuert das Qualitätslevel; intern wird `caesiumclt -q` mit diesem Wert von `0..100` benutzt, Default ist 90
+-  `--min-savings` steuert das Mindestmass an Komprimierung zur Verhinderung von doppelter Komprimierunt, Default ist 2%
 - Die Batch **verwendet bevorzugt das Embeddable Python** neben der BAT; ansonsten sucht sie echte `python.exe`/`py.exe` im PATH, **ignoriert** aber die Microsoft‑Store‑Alias‑Pfade (`WindowsApps`).
 
 ## Manuelle Nutzung des .py (falls Python vorhanden)

check_new_version.bat

@@ -0,0 +1,61 @@
+@echo off
+setlocal EnableExtensions EnableDelayedExpansion
+
+set UPDATE_DIR=%~dp0updates
+if not exist "%UPDATE_DIR%" mkdir "%UPDATE_DIR%"
+
+set TMP_OUT=%TEMP%\update_check_%RANDOM%.txt
+set TMP_OUT_2=%TEMP%\update_check_%RANDOM%.txt
+
+python check_new_version.py > "%TMP_OUT%"
+set EXITCODE=%ERRORLEVEL%
+
+if %EXITCODE%==20 (
+    echo Fehler beim Update-Check
+    goto :END
+)
+
+if %EXITCODE%==0 (
+    echo Keine Updates verfuegbar.
+    goto :END
+)
+
+echo.
+type "%TMP_OUT%"
+
+choice /c jn /m "Wollen Sie die Updates-Packages herunterladen?"
+
+if errorlevel 2 goto :END
+
+
+if exist "%TMP_OUT%" (
+    
+    
+    findstr /b "PYTHON_DOWNLOAD=" "%TMP_OUT%" >nul
+    if not errorlevel 1 (
+        for /f "tokens=1,* delims==" %%a in (
+            'findstr /b "PYTHON_DOWNLOAD=" "%TMP_OUT%"'
+        ) do (
+            echo Downloading Python update from PYTHON_DOWNLOAD
+            powershell -NoProfile -Command ^
+              "Invoke-WebRequest '%%b' -OutFile '%UPDATE_DIR%\python-embed.zip'"
+        )
+    )
+
+    findstr /b "CAESIUM_DOWNLOAD=" "%TMP_OUT_2%" >nul
+    if not errorlevel 1 (
+        for /f "tokens=1,* delims==" %%a in (
+            'findstr /b "CAESIUM_DOWNLOAD=" "%TMP_OUT_2%"'
+        ) do (
+            echo Downloading caesiumclt update from CAESIUM_DOWNLOAD
+
+            powershell -NoProfile -Command ^
+              "Invoke-WebRequest '%%b' -OutFile '%UPDATE_DIR%\caesiumclt.zip'"
+        )
+    )
+)
+
+:END
+del "%TMP_OUT%" >nul 2>&1
+del "%TMP_OUT_2%" >nul 2>&1
+endlocal

check_new_version.py

@@ -0,0 +1,121 @@
+import argparse
+import configparser
+import json
+import sys
+import urllib.request
+from pathlib import Path
+
+INI_FILE = Path("latestversion.ini")
+PYTHON_API = "https://endoflife.date/api/v1/products/python"
+CAESIUM_API = "https://api.github.com/repos/Lymphatus/caesium-clt/tags"
+
+EXIT_NO_UPDATE = 0
+EXIT_UPDATE_AVAILABLE = 10
+EXIT_ERROR = 20
+
+
+def fetch_json(url):
+    with urllib.request.urlopen(url, timeout=15) as r:
+        return json.loads(r.read().decode("utf-8"))
+
+
+def load_ini():
+    cfg = configparser.ConfigParser()
+    cfg.read(INI_FILE, encoding="utf-8")
+    return cfg
+
+
+def save_ini(cfg):
+    with open(INI_FILE, "w", encoding="utf-8") as f:
+        cfg.write(f)
+
+
+def check_python(cfg, result):
+    used = cfg["DEFAULT"].get("python_used_version", "").strip()
+    major_minor = ".".join(used.split(".")[:2])
+
+    data = fetch_json(PYTHON_API)
+    releases = data.get("result", {}).get("releases", [])
+
+    for rel in releases:
+        if rel.get("name") != major_minor:
+            continue
+
+        latest = rel.get("latest", {}).get("name", "")
+        is_maintained = rel.get("isMaintained", True)
+
+        cfg["DEFAULT"]["python_latest_version"] = latest
+
+        if used != latest:
+            result["updates"].append({
+                "tool": "python",
+                "used": used,
+                "latest": latest,
+                "maintained": is_maintained,
+                "url": (
+                    f"https://www.python.org/ftp/python/{latest}/"
+                    f"python-{latest}-embed-amd64.zip"
+                )
+            })
+
+
+def check_caesium(cfg, result):
+    used = cfg["DEFAULT"].get("caesiumclt_used_version", "").strip()
+
+    tags = fetch_json(CAESIUM_API)
+    latest = tags[0]["name"]
+
+    cfg["DEFAULT"]["caesiumclt_latest_version"] = latest
+
+    if used != latest:
+        result["updates"].append({
+            "tool": "caesiumclt",
+            "used": used,
+            "latest": latest,
+            "maintained": True,
+            "url": (
+                f"https://github.com/Lymphatus/caesium-clt/releases/download/{latest}/"
+                f"caesiumclt-{latest}-x86_64-pc-windows-msvc.zip"
+            )
+        })
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--yes", action="store_true")
+    parser.add_argument("--json", action="store_true")
+    args = parser.parse_args()
+
+    cfg = load_ini()
+    result = {"updates": []}
+
+    try:
+        check_python(cfg, result)
+        check_caesium(cfg, result)
+    except Exception as e:
+        print(f"ERROR: {e}")
+        sys.exit(EXIT_ERROR)
+
+    save_ini(cfg)
+
+    if args.json:
+        print(json.dumps(result, indent=2))
+    else:
+        for u in result["updates"]:
+            print(
+                f"{u['tool'].capitalize()}: aktuell genutzt {u['used']}, "
+                f"neu {u['latest']}, download?"
+            )
+            print(f"{u['tool'].upper()}_DOWNLOAD={u['url']}")
+
+            if not u["maintained"]:
+                print(
+                    f"WARNING: Achtung Version {u['latest']} "
+                    "wird nicht mehr gewartet!"
+                )
+
+    sys.exit(EXIT_UPDATE_AVAILABLE if result["updates"] else EXIT_NO_UPDATE)
+
+
+if __name__ == "__main__":
+    main()

endoflifeapi.json

@@ -0,0 +1,655 @@
+{
+    "schema_version": "1.2.0",
+    "generated_at": "2026-04-08T07:17:19+00:00",
+    "last_modified": "2026-04-08T00:10:16+00:00",
+    "result": {
+        "name": "python",
+        "aliases": [],
+        "label": "Python",
+        "category": "lang",
+        "tags": [
+            "lang"
+        ],
+        "versionCommand": "python --version\n\n# or alternatively\npython3 --version",
+        "identifiers": [
+            {
+                "type": "purl",
+                "id": "pkg:generic/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.14"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.13"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.12"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.11"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.10"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.9"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.8"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.7"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.6"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.5"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.4"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.3"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.1"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python3.0"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.7"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.6"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.5"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.4"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.3"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/ubuntu/python2.1"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.14"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.13"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.11"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.9"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.7"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.5"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.4"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python3.1"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.7"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.6"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.5"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.4"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.3"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python2.1"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:deb/debian/python1.5"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.14"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.13"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.12"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.11"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.10"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.9"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.8"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.6"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/fedora/python3.5"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/amzn/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/amzn/python2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/amzn/python3"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/redhat/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/redhat/python2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/redhat/python3"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/centos/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/centos/python2"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:rpm/centos/python3"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:docker/library/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:docker/circleci/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:docker/bitnami/python"
+            },
+            {
+                "type": "purl",
+                "id": "pkg:github/python/cpython"
+            },
+            {
+                "type": "repology",
+                "id": "python"
+            },
+            {
+                "type": "cpe",
+                "id": "cpe:/a:python:python"
+            },
+            {
+                "type": "cpe",
+                "id": "cpe:2.3:a:python:python"
+            }
+        ],
+        "labels": {
+            "eoas": "Active Support",
+            "discontinued": null,
+            "eol": "Security Support",
+            "eoes": null
+        },
+        "links": {
+            "icon": "https://cdn.jsdelivr.net/npm/simple-icons/icons/python.svg",
+            "html": "https://endoflife.date/python",
+            "releasePolicy": "https://devguide.python.org/versions/"
+        },
+        "releases": [
+            {
+                "name": "3.14",
+                "codename": null,
+                "label": "3.14",
+                "releaseDate": "2025-10-07",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": false,
+                "eoasFrom": "2027-10-01",
+                "isEol": false,
+                "eolFrom": "2030-10-31",
+                "isMaintained": true,
+                "latest": {
+                    "name": "3.14.4",
+                    "date": "2026-04-07",
+                    "link": "https://www.python.org/downloads/release/python-3144/"
+                },
+                "custom": {
+                    "pep": "PEP-0745"
+                }
+            },
+            {
+                "name": "3.13",
+                "codename": null,
+                "label": "3.13",
+                "releaseDate": "2024-10-07",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": false,
+                "eoasFrom": "2026-10-01",
+                "isEol": false,
+                "eolFrom": "2029-10-31",
+                "isMaintained": true,
+                "latest": {
+                    "name": "3.13.13",
+                    "date": "2026-04-07",
+                    "link": "https://www.python.org/downloads/release/python-31313/"
+                },
+                "custom": {
+                    "pep": "PEP-0719"
+                }
+            },
+            {
+                "name": "3.12",
+                "codename": null,
+                "label": "3.12",
+                "releaseDate": "2023-10-02",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2025-04-02",
+                "isEol": false,
+                "eolFrom": "2028-10-31",
+                "isMaintained": true,
+                "latest": {
+                    "name": "3.12.13",
+                    "date": "2026-03-03",
+                    "link": "https://www.python.org/downloads/release/python-31213/"
+                },
+                "custom": {
+                    "pep": "PEP-0693"
+                }
+            },
+            {
+                "name": "3.11",
+                "codename": null,
+                "label": "3.11",
+                "releaseDate": "2022-10-24",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2024-04-01",
+                "isEol": false,
+                "eolFrom": "2027-10-31",
+                "isMaintained": true,
+                "latest": {
+                    "name": "3.11.15",
+                    "date": "2026-03-03",
+                    "link": "https://www.python.org/downloads/release/python-31115/"
+                },
+                "custom": {
+                    "pep": "PEP-0664"
+                }
+            },
+            {
+                "name": "3.10",
+                "codename": null,
+                "label": "3.10",
+                "releaseDate": "2021-10-04",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2023-04-05",
+                "isEol": false,
+                "eolFrom": "2026-10-31",
+                "isMaintained": true,
+                "latest": {
+                    "name": "3.10.20",
+                    "date": "2026-03-03",
+                    "link": "https://www.python.org/downloads/release/python-31020/"
+                },
+                "custom": {
+                    "pep": "PEP-0619"
+                }
+            },
+            {
+                "name": "3.9",
+                "codename": null,
+                "label": "3.9",
+                "releaseDate": "2020-10-05",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2022-05-17",
+                "isEol": true,
+                "eolFrom": "2025-10-31",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.9.25",
+                    "date": "2025-10-31",
+                    "link": "https://www.python.org/downloads/release/python-3925/"
+                },
+                "custom": {
+                    "pep": "PEP-0596"
+                }
+            },
+            {
+                "name": "3.8",
+                "codename": null,
+                "label": "3.8",
+                "releaseDate": "2019-10-14",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2021-05-03",
+                "isEol": true,
+                "eolFrom": "2024-10-07",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.8.20",
+                    "date": "2024-09-06",
+                    "link": "https://www.python.org/downloads/release/python-3820/"
+                },
+                "custom": {
+                    "pep": "PEP-0569"
+                }
+            },
+            {
+                "name": "3.7",
+                "codename": null,
+                "label": "3.7",
+                "releaseDate": "2018-06-27",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2020-06-27",
+                "isEol": true,
+                "eolFrom": "2023-06-27",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.7.17",
+                    "date": "2023-06-05",
+                    "link": "https://www.python.org/downloads/release/python-3717/"
+                },
+                "custom": {
+                    "pep": "PEP-0537"
+                }
+            },
+            {
+                "name": "3.6",
+                "codename": null,
+                "label": "3.6",
+                "releaseDate": "2016-12-23",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": "2018-12-24",
+                "isEol": true,
+                "eolFrom": "2021-12-23",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.6.15",
+                    "date": "2021-09-03",
+                    "link": "https://www.python.org/downloads/release/python-3615/"
+                },
+                "custom": {
+                    "pep": "PEP-0494"
+                }
+            },
+            {
+                "name": "3.5",
+                "codename": null,
+                "label": "3.5",
+                "releaseDate": "2015-09-13",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2020-09-30",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.5.10",
+                    "date": "2020-09-05",
+                    "link": "https://www.python.org/downloads/release/python-3510/"
+                },
+                "custom": {
+                    "pep": "PEP-0478"
+                }
+            },
+            {
+                "name": "3.4",
+                "codename": null,
+                "label": "3.4",
+                "releaseDate": "2014-03-16",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2019-03-18",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.4.10",
+                    "date": "2019-03-18",
+                    "link": "https://www.python.org/downloads/release/python-3410/"
+                },
+                "custom": {
+                    "pep": "PEP-0429"
+                }
+            },
+            {
+                "name": "3.3",
+                "codename": null,
+                "label": "3.3",
+                "releaseDate": "2012-09-29",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2017-09-29",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.3.7",
+                    "date": "2017-09-19",
+                    "link": "https://www.python.org/downloads/release/python-337/"
+                },
+                "custom": {
+                    "pep": "PEP-0398"
+                }
+            },
+            {
+                "name": "3.2",
+                "codename": null,
+                "label": "3.2",
+                "releaseDate": "2011-02-20",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2016-02-20",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.2.6",
+                    "date": "2014-10-12",
+                    "link": "https://www.python.org/downloads/release/python-326/"
+                },
+                "custom": {
+                    "pep": "PEP-0392"
+                }
+            },
+            {
+                "name": "2.7",
+                "codename": null,
+                "label": "2.7",
+                "releaseDate": "2010-07-03",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2020-01-01",
+                "isMaintained": false,
+                "latest": {
+                    "name": "2.7.18",
+                    "date": "2020-04-19",
+                    "link": "https://www.python.org/downloads/release/python-2718/"
+                },
+                "custom": {
+                    "pep": "PEP-0373"
+                }
+            },
+            {
+                "name": "3.1",
+                "codename": null,
+                "label": "3.1",
+                "releaseDate": "2009-06-27",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2012-04-09",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.1.5",
+                    "date": "2012-04-06",
+                    "link": "https://www.python.org/downloads/release/python-315/"
+                },
+                "custom": {
+                    "pep": "PEP-0375"
+                }
+            },
+            {
+                "name": "3.0",
+                "codename": null,
+                "label": "3.0",
+                "releaseDate": "2008-12-03",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2009-06-27",
+                "isMaintained": false,
+                "latest": {
+                    "name": "3.0.1",
+                    "date": "2009-02-12",
+                    "link": "https://www.python.org/downloads/release/python-301/"
+                },
+                "custom": {
+                    "pep": "PEP-0361"
+                }
+            },
+            {
+                "name": "2.6",
+                "codename": null,
+                "label": "2.6",
+                "releaseDate": "2008-10-01",
+                "isLts": false,
+                "ltsFrom": null,
+                "isEoas": true,
+                "eoasFrom": null,
+                "isEol": true,
+                "eolFrom": "2013-10-29",
+                "isMaintained": false,
+                "latest": {
+                    "name": "2.6.9",
+                    "date": "2013-10-29",
+                    "link": "https://www.python.org/downloads/release/python-269/"
+                },
+                "custom": {
+                    "pep": "PEP-0361"
+                }
+            }
+        ]
+    }
+}

install_and_run.bat

@@ -12,7 +12,7 @@ set "SELF_DIR=%~dp0"
 set "SCRIPT=%SELF_DIR%pptx_image_compress.py"
 
 rem ---- Python Embeddable config ----
-set "PY_EMBED_VERSION=3.13.7"
+set "PY_EMBED_VERSION=3.14.4"
 set "PY_EMBED_ZIP=python-%PY_EMBED_VERSION%-embed-amd64.zip"
 set "PY_EMBED_URL=https://www.python.org/ftp/python/%PY_EMBED_VERSION%/%PY_EMBED_ZIP%"
 set "PY_DIR=%SELF_DIR%python-embed"

latestversion.ini

@@ -0,0 +1,6 @@
+[DEFAULT]
+python_used_version = 3.14.4
+python_latest_version = 3.14.4
+caesiumclt_used_version = v1.3.0
+caesiumclt_latest_version = v1.3.0
+

pptx_image_compress.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 """
 PPTX Grafik-Komprimier-Tool (nur CaesiumCLT, Multi-Thread, Batch, sauberes Cleanup)
-Version: 1.1.3
+Version: 1.1.6
 
 
 Highlights:
@@ -12,12 +12,14 @@ Highlights:
 - Log: image_name,size_before,size_after,saving,saving_percent
 - Summary inkl. Zeit benötigt
 
-Änderungen in 1.1.3:
+Änderungen in 1.1.6:
-- Changed all UNICODE Chars to ASCII
+- Libcaesium 1.3.0 kann nun auch files ignorieren, wenn die Kompression kleiner als <MIN_SAVING> ist
 """
 
 import argparse
 import os
+import re
+import xml.etree.ElementTree as ET
 import sys
 import zipfile
 import tempfile
@@ -30,12 +32,51 @@ from pathlib import Path
 from datetime import timedelta
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from threading import Lock
+from dataclasses import dataclass
+from typing import Callable, List, Optional
 
-__version__ = "1.1.3"
 
-ALLOWED_EXT = {".jpg", ".jpeg", ".png", ".webp", ".gif"}  # GIF wird übersprungen
+__version__ = "1.1.6"
+
+ALLOWED_EXT = {".jpg", ".jpeg", ".png", ".webp", ".gif"}
 PROGRESS_BAR_LEN = 40
 TEMP_PREFIX = "pptx_compress_"
+DEFAULT_MIN_SAVINGS = "2%"
+
+
+@dataclass
+class DeckResult:
+    input: str
+    output: str
+    ok: bool = False
+    size_before: int = 0
+    size_after: int = 0
+    elapsed_sec: float = 0.0
+    error: Optional[str] = None
+    log_file: Optional[str] = None
+
+
+@dataclass
+class ImageProcessResult:
+    image_name: str
+    orig_size: int
+    chosen_size: int
+    slide_nr: str
+
+
+def discover_images(media_dir: Path) -> list[Path]:
+    images: list[Path] = []
+    if media_dir.exists():
+        for f in sorted(media_dir.iterdir()):
+            if f.is_file() and f.suffix.lower() in ALLOWED_EXT:
+                images.append(f)
+    return images
+
+
+def image_result_to_log_line(image_result: ImageProcessResult) -> str:
+    saving = image_result.orig_size - image_result.chosen_size
+    saving_percent = round((saving / image_result.orig_size) * 100, 2) if image_result.orig_size > 0 else 0.0
+    return f"{image_result.image_name};{human_kb(image_result.orig_size)};{human_kb(image_result.chosen_size)};{human_kb(saving)};{saving_percent};{image_result.slide_nr}\n"
 
 
 # -------------------- Utilities --------------------
@@ -75,25 +116,31 @@ def print_progress(i: int, total: int):
     print(f"\rBilder: |{bar}| {i}/{total} ({pct}%)", end="", flush=True)
 
 def zip_dir_to_pptx(src_dir: Path, out_pptx: Path):
+    all_files: list[Path] = []
+    for root, _, files in os.walk(src_dir):
+        for f in files:
+            all_files.append(Path(root) / f)
+
+    content_types = [f for f in all_files if f.name == "[Content_Types].xml"]
+    rest = [f for f in all_files if f.name != "[Content_Types].xml"]
+
     with zipfile.ZipFile(out_pptx, "w", compression=zipfile.ZIP_DEFLATED) as z:
-        for root, _, files in os.walk(src_dir):
+        for full in content_types + rest:
-            for f in files:
+            rel = full.relative_to(src_dir)
-                full = Path(root) / f
+            z.write(full, arcname=str(rel))
-                rel = full.relative_to(src_dir)
-                z.write(full, arcname=str(rel))
 
 def which(cmd: str):
     return shutil.which(cmd)
 
-def compress_with_caesium(original: Path, out_dir: Path, caesium_threads: int | None, quality: int) -> Path | None:
+def compress_with_caesium(original: Path, out_dir: Path, caesium_threads: int | None, quality: int, min_savings: str) -> Path | None:
     exe = which("caesiumclt")
     if not exe:
         raise RuntimeError("[ERROR] 'caesiumclt' wurde nicht gefunden. Bitte CaesiumCLT installieren und in PATH verfügbar machen.")
     out_dir.mkdir(parents=True, exist_ok=True)
     ext = original.suffix.lower()
-    if ext not in {".jpg", ".jpeg", ".png", ".webp"}:
+    if ext not in ALLOWED_EXT:
         return None
-    cmd = [exe, "-q", str(quality), "-O", "bigger", "-o", str(out_dir)]
+    cmd = [exe, "-q", str(quality), "-O", "bigger", "--min-savings", min_savings, "-o", str(out_dir)]
     if caesium_threads is not None:
         cmd += ["--threads", str(caesium_threads)]
     cmd += [str(original)]
@@ -117,19 +164,87 @@ def format_duration(seconds: float) -> str:
         return f"{hms}.{frac[:2]}"
     return base
 
+def build_image_slide_index(rels_dir: Path) -> dict[str, List[int]]:
+    if not rels_dir.exists() or not rels_dir.is_dir():
+        return {}
+
+    image_to_slides: dict[str, set[int]] = {}
+
+    for rels_path in rels_dir.iterdir():
+        rels_file = rels_path.name
+        if rels_file.startswith("slide") and rels_file.endswith(".xml.rels") and rels_path.is_file():
+            match = re.search(r"slide(\d+)\.xml\.rels$", rels_file)
+            if not match:
+                continue
+            slide_number = int(match.group(1))
+            try:
+                tree = ET.parse(rels_path)
+                root = tree.getroot()
+                for rel in root.findall(".//{http://schemas.openxmlformats.org/package/2006/relationships}Relationship"):
+                    target = rel.attrib.get("Target", "")
+                    image_name = Path(target).name
+                    if image_name:
+                        if image_name not in image_to_slides:
+                            image_to_slides[image_name] = set()
+                        image_to_slides[image_name].add(slide_number)
+            except (ET.ParseError, OSError):
+                print(f"Fehler beim Lesen von {rels_file}")
+
+    return {img: sorted(slides) for img, slides in image_to_slides.items()}
+
+
+def process_image_file(
+    idx: int,
+    img_path: Path,
+    scratch_dir: Path,
+    image_to_slides: dict[str, List[int]],
+    caesium_threads: int | None,
+    quality: int,
+    min_savings: str,
+    compressor: Callable[[Path, Path, int | None, int, str], Path | None],
+) -> ImageProcessResult:
+    orig_size = img_path.stat().st_size
+    chosen_size = orig_size
+    found_in_slide = image_to_slides.get(img_path.name)
+    slide_nr = "NOT_USED" if found_in_slide is None else str(found_in_slide)
+
+    try:
+        out_sub = scratch_dir / f"img_{idx:06d}"
+        caesium_out = compressor(img_path, out_sub, caesium_threads, quality, min_savings)
+        if caesium_out and caesium_out.exists():
+            s = caesium_out.stat().st_size
+            if s < orig_size:
+                tmp_target = img_path.with_suffix(img_path.suffix + ".tmp")
+                shutil.copy2(caesium_out, tmp_target)
+                tmp_target.replace(img_path)
+                chosen_size = s
+    except Exception:
+        chosen_size = orig_size
+
+    return ImageProcessResult(
+        image_name=img_path.name,
+        orig_size=orig_size,
+        chosen_size=chosen_size,
+        slide_nr=slide_nr,
+    )
+
+
 # -------------------- Core per-deck processing --------------------
-def process_single_deck(input_pptx: Path, output_pptx: Path, threads: int, quality: int) -> dict:
+def process_single_deck(
+    input_pptx: Path,
+    output_pptx: Path,
+    threads: int,
+    quality: int,
+    min_savings: str,
+    compressor: Callable[[Path, Path, int | None, int, str], Path | None] = compress_with_caesium,
+) -> DeckResult:
     start_time = time.perf_counter()
-    result = {
+    result = DeckResult(
-        "input": str(input_pptx),
+        input=str(input_pptx),
-        "output": str(output_pptx),
+        output=str(output_pptx),
-        "ok": False,
+    )
-        "size_before": 0,
+    work_dir: Optional[Path] = None
-        "size_after": 0,
+    scratch_dir: Optional[Path] = None
-        "elapsed_sec": 0.0,
-        "error": None,
-        "log_file": None,
-    }
 
     try:
         if not input_pptx.exists() or input_pptx.suffix.lower() != ".pptx":
@@ -140,71 +255,60 @@ def process_single_deck(input_pptx: Path, output_pptx: Path, threads: int, quali
 
         work_dir = Path(tempfile.mkdtemp(prefix=TEMP_PREFIX + "work_"))
         scratch_dir = Path(tempfile.mkdtemp(prefix=TEMP_PREFIX + "scratch_"))
-
         log_file = output_pptx.with_suffix(".log.csv")
         ensure_clean_file(log_file)
-        log_lines = ["image_name;size_before(kb);size_after(kb);saving(kb);saving_percent(%)\n"]
+        log_lines = ["image_name;size_before(kb);size_after(kb);saving(kb);saving_percent(%);in_slide_number\n"]
 
         size_before = input_pptx.stat().st_size
-        result["size_before"] = size_before
+        result.size_before = size_before
 
         with zipfile.ZipFile(input_pptx, "r") as z:
             z.extractall(work_dir)
 
+        slides_dir  = work_dir / "ppt" / "slides"
+        rels_dir = slides_dir / "_rels"
         media_dir = work_dir / "ppt" / "media"
-        images = []
+
-        if media_dir.exists():
+        images = discover_images(media_dir)
-            for f in sorted(media_dir.iterdir()):
-                if f.is_file() and f.suffix.lower() in ALLOWED_EXT:
-                    images.append(f)
 
         total = len(images)
         print(f"[Processing] {input_pptx.name}: {total} Bild(er) gefunden")
         print_progress(0, total)
 
-        if not which("caesiumclt"):
+        if not which("caesiumclt") and compressor is compress_with_caesium:
             raise RuntimeError("'caesiumclt' nicht gefunden. Bitte installieren und in PATH verfügbar machen.")
 
-        caesium_threads = 1 if threads and threads > 1 else None
+        caesium_threads = 1 if threads > 1 else None
         lock = Lock()
         done_count = 0
+        image_to_slides = build_image_slide_index(rels_dir)
 
         def worker(idx: int, img_path: Path):
             nonlocal done_count
-            ext = img_path.suffix.lower()
+            image_result = process_image_file(
-            orig_size = img_path.stat().st_size
+                idx=idx,
-            if ext == ".gif":
+                img_path=img_path,
-                with lock:
+                scratch_dir=scratch_dir,
-                    done_count += 1
+                image_to_slides=image_to_slides,
-                    log_lines.append(f"{img_path.name};{human_kb(orig_size)};{human_kb(orig_size)};0;0.0\n")
+                caesium_threads=caesium_threads,
-                    print_progress(done_count, total)
+                quality=quality,
-                return
+                min_savings=min_savings,
-            chosen_size = orig_size
+                compressor=compressor,
-            try:
+            )
-                out_sub = scratch_dir / f"img_{idx:06d}"
+
-                caesium_out = compress_with_caesium(img_path, out_sub, caesium_threads, quality)
+            with lock:
-                if caesium_out and caesium_out.exists():
+                log_lines.append(image_result_to_log_line(image_result))
-                    s = caesium_out.stat().st_size
+                done_count += 1
-                    if s < orig_size:
+                print_progress(done_count, total)
-                        tmp_target = img_path.with_suffix(img_path.suffix + ".tmp")
-                        shutil.copy2(caesium_out, tmp_target)
-                        tmp_target.replace(img_path)
-                        chosen_size = s
-            except Exception:
-                chosen_size = orig_size
-            finally:
-                saving = orig_size - chosen_size
-                saving_percent = round((saving / orig_size) * 100, 2) if orig_size > 0 else 0.0
-                with lock:
-                    log_lines.append(f"{img_path.name};{human_kb(orig_size)};{human_kb(chosen_size)};{human_kb(saving)};{saving_percent}\n")
-                    done_count += 1
-                    print_progress(done_count, total)
 
         if total > 0:
             with ThreadPoolExecutor(max_workers=max(1, threads)) as ex:
                 futures = [ex.submit(worker, i, p) for i, p in enumerate(images, start=1)]
-                for _ in as_completed(futures):
+                for fut in as_completed(futures):
-                    pass
+                    try:
+                        fut.result()
+                    except Exception as exc:
+                        sys.stderr.write(f"[worker] Unerwarteter Fehler: {exc}\n")
 
         print()  # newline
 
@@ -226,7 +330,7 @@ def process_single_deck(input_pptx: Path, output_pptx: Path, threads: int, quali
 
         zip_dir_to_pptx(work_dir, output_pptx)
         size_after = output_pptx.stat().st_size
-        result["size_after"] = size_after
+        result.size_after = size_after
 
         try:
             with open(log_file, "w", encoding="utf-8") as f:
@@ -235,9 +339,9 @@ def process_single_deck(input_pptx: Path, output_pptx: Path, threads: int, quali
             pass
 
         elapsed = time.perf_counter() - start_time
-        result["elapsed_sec"] = elapsed
+        result.elapsed_sec = elapsed
-        result["log_file"] = str(log_file)
+        result.log_file = str(log_file)
-        result["ok"] = True
+        result.ok = True
 
         savings_pct = 0.0 if size_before == 0 else round(100.0 * (size_before - size_after) / size_before, 2)
         print(f"[OK] Fertig!  ({input_pptx.name})")
@@ -249,16 +353,12 @@ def process_single_deck(input_pptx: Path, output_pptx: Path, threads: int, quali
         print("  Log:       ", log_file)
 
     except Exception as e:
-        result["error"] = str(e)
+        result.error = str(e)
     finally:
-        try:
+        if work_dir is not None:
-            shutil.rmtree(work_dir, ignore_errors=True)  # type: ignore[name-defined]
+            shutil.rmtree(work_dir, ignore_errors=True)
-        except Exception:
+        if scratch_dir is not None:
-            pass
+            shutil.rmtree(scratch_dir, ignore_errors=True)
-        try:
-            shutil.rmtree(scratch_dir, ignore_errors=True)  # type: ignore[name-defined]
-        except Exception:
-            pass
         cleanup_old_temps()
 
     return result
@@ -317,15 +417,16 @@ def main():
         formatter_class=argparse.ArgumentDefaultsHelpFormatter,
     )
     parser.add_argument('-i','--input', nargs='*', help='Input-PPTX (eine oder mehrere, Wildcards erlaubt). Bei mehreren: -O erforderlich.')
+    parser.add_argument('--input-dir', help='Eingabe-Verzeichnis (optional, für Batch)')
     parser.add_argument('-o','--output', help='Output-PPTX (nur Single-Mode)')
     parser.add_argument('-O','--output-dir', help='Output-Verzeichnis (erforderlich für Batch)')
-    parser.add_argument('--input-dir', help='Eingabe-Verzeichnis (optional, für Batch)')
     parser.add_argument('--pattern', default='*.pptx', help='Dateimuster für --input-dir')
     parser.add_argument('--recursive', action='store_true', help='Rekursiv in --input-dir suchen')
     #parser.add_argument('-t','--threads', type=int, default=min(32, os.cpu_count() or 4), help='Anzahl paralleler Threads pro Datei')
     parser.add_argument('-t','--threads', type=int, default=16, help='Anzahl paralleler Threads pro Datei')
     parser.add_argument('-q','--quality', type=int, default=90, help='Qualität für caesiumclt (0..100), höher = bessere Qualität / größere Datei')
-    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
+    parser.add_argument('--min-savings', default=DEFAULT_MIN_SAVINGS, help="Mindestersparnis für caesiumclt (z. B. 2%%, 100KB, 1MB oder Bytes als Zahl)")
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}',  help="Zeigt die Versionsnummer an" )
     
     args = parser.parse_args()
 
@@ -370,14 +471,14 @@ def main():
                 failures += 1
                 continue
             dst = out_dir / f"{src.stem}_compressed.pptx"
-            res = process_single_deck(src, dst, args.threads, args.quality)
+            res = process_single_deck(src, dst, args.threads, args.quality, args.min_savings)
-            if res['ok']:
+            if res.ok:
                 successes += 1
-                overall_before += res['size_before']
+                overall_before += res.size_before
-                overall_after += res['size_after']
+                overall_after += res.size_after
             else:
                 failures += 1
-                print(f"  Fehler: {src.name} -> {res['error']}")
+                print(f"  Fehler: {src.name} -> {res.error}")
     else:
         src = input_files[0]
         if args.output_dir:
@@ -385,14 +486,14 @@ def main():
             dst = Path(args.output_dir) / f"{src.stem}_compressed.pptx"
         else:
             dst = Path(args.output).resolve() if args.output else src.with_name(f"{src.stem}_compressed.pptx")
-        res = process_single_deck(src, dst, args.threads, args.quality)
+        res = process_single_deck(src, dst, args.threads, args.quality, args.min_savings)
-        if res['ok']:
+        if res.ok:
             successes += 1
-            overall_before += res['size_before']
+            overall_before += res.size_before
-            overall_after += res['size_after']
+            overall_after += res.size_after
         else:
             failures += 1
-            print(f"  Fehler: {src.name} -> {res['error']}")
+            print(f"  Fehler: {src.name} -> {res.error}")
 
     if batch_mode:
             

samples/README.txt

@@ -1 +0,0 @@
-Place your PPTX files here for testing, or use -i with a full path.

test_pptx_image_compress.py

@@ -0,0 +1,144 @@
+import tempfile
+import unittest
+import zipfile
+from pathlib import Path
+
+import pptx_image_compress as pic
+
+
+class TestPptxImageCompress(unittest.TestCase):
+    def test_discover_images_filters_extensions(self):
+        with tempfile.TemporaryDirectory() as td:
+            media_dir = Path(td)
+            (media_dir / "a.jpg").write_bytes(b"1")
+            (media_dir / "b.png").write_bytes(b"1")
+            (media_dir / "c.txt").write_bytes(b"1")
+            (media_dir / "d.GIF").write_bytes(b"1")
+            images = pic.discover_images(media_dir)
+            self.assertEqual([p.name for p in images], ["a.jpg", "b.png", "d.GIF"])
+
+    def test_image_result_to_log_line(self):
+        image_result = pic.ImageProcessResult(
+            image_name="image1.png",
+            orig_size=1000,
+            chosen_size=800,
+            slide_nr="[1, 2]",
+        )
+        line = pic.image_result_to_log_line(image_result)
+        self.assertIn("image1.png", line)
+        self.assertIn("[1, 2]", line)
+        self.assertIn("20.0", line)
+
+    def test_process_image_file_replaces_when_smaller(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            img = root / "image1.png"
+            img.write_bytes(b"A" * 100)
+            scratch = root / "scratch"
+
+            def fake_compressor(original: Path, out_dir: Path, caesium_threads: int | None, quality: int, min_savings: str):
+                out_dir.mkdir(parents=True, exist_ok=True)
+                out = out_dir / original.name
+                out.write_bytes(b"B" * 40)
+                return out
+
+            result = pic.process_image_file(
+                idx=1,
+                img_path=img,
+                scratch_dir=scratch,
+                image_to_slides={"image1.png": [1]},
+                caesium_threads=1,
+                quality=90,
+                min_savings="2%",
+                compressor=fake_compressor,
+            )
+
+            self.assertEqual(result.chosen_size, 40)
+            self.assertEqual(img.stat().st_size, 40)
+            self.assertEqual(result.slide_nr, "[1]")
+
+    def test_process_image_file_keeps_original_when_bigger(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            img = root / "image1.png"
+            img.write_bytes(b"A" * 100)
+            scratch = root / "scratch"
+
+            def fake_compressor(original: Path, out_dir: Path, caesium_threads: int | None, quality: int, min_savings: str):
+                out_dir.mkdir(parents=True, exist_ok=True)
+                out = out_dir / original.name
+                out.write_bytes(b"B" * 120)
+                return out
+
+            result = pic.process_image_file(
+                idx=1,
+                img_path=img,
+                scratch_dir=scratch,
+                image_to_slides={},
+                caesium_threads=1,
+                quality=90,
+                min_savings="2%",
+                compressor=fake_compressor,
+            )
+
+            self.assertEqual(result.chosen_size, 100)
+            self.assertEqual(img.stat().st_size, 100)
+            self.assertEqual(result.slide_nr, "NOT_USED")
+
+    def test_process_single_deck_with_injected_compressor(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            input_pptx = root / "input.pptx"
+            output_pptx = root / "output.pptx"
+            source_tree = root / "src"
+            rels_dir = source_tree / "ppt" / "slides" / "_rels"
+            media_dir = source_tree / "ppt" / "media"
+            rels_dir.mkdir(parents=True, exist_ok=True)
+            media_dir.mkdir(parents=True, exist_ok=True)
+
+            rels_xml = (
+                "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+                "<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">"
+                "<Relationship Id=\"rId2\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/image\" Target=\"../media/image1.png\"/>"
+                "</Relationships>"
+            )
+            (rels_dir / "slide1.xml.rels").write_text(rels_xml, encoding="utf-8")
+            (media_dir / "image1.png").write_bytes(b"A" * 100)
+
+            with zipfile.ZipFile(input_pptx, "w", compression=zipfile.ZIP_DEFLATED) as z:
+                for p in source_tree.rglob("*"):
+                    if p.is_file():
+                        z.write(p, arcname=str(p.relative_to(source_tree)))
+
+            def fake_compressor(original: Path, out_dir: Path, caesium_threads: int | None, quality: int, min_savings: str):
+                out_dir.mkdir(parents=True, exist_ok=True)
+                out = out_dir / original.name
+                out.write_bytes(b"B" * 50)
+                return out
+
+            result = pic.process_single_deck(
+                input_pptx=input_pptx,
+                output_pptx=output_pptx,
+                threads=2,
+                quality=90,
+                min_savings="2%",
+                compressor=fake_compressor,
+            )
+
+            self.assertTrue(result.ok)
+            self.assertEqual(result.error, None)
+            self.assertTrue(output_pptx.exists())
+            self.assertIsNotNone(result.log_file)
+            with zipfile.ZipFile(output_pptx, "r") as z:
+                out_image = z.read("ppt/media/image1.png")
+            self.assertEqual(len(out_image), 50)
+            log_file = result.log_file
+            if log_file is None:
+                self.fail("log_file should not be None")
+            log_text = Path(log_file).read_text(encoding="utf-8")
+            self.assertIn("image1.png", log_text)
+            self.assertIn("[1]", log_text)
+
+
+if __name__ == "__main__":
+    unittest.main()