testzombie-windows 0.2.25__tar.gz

testzombie_windows-0.2.25/LICENSE.txt

@@ -0,0 +1,5 @@
+TestZombie AI — Proprietary Software
+Copyright (c) 2026 TestZombie AI. All rights reserved.
+
+No open-source license is granted by this notice. Use and redistribution
+are subject to the applicable agreement with TestZombie AI.

testzombie_windows-0.2.25/MANIFEST.in

@@ -0,0 +1,11 @@
+include README.md
+include LICENSE.txt
+include pyproject.toml
+recursive-include testzombie_windows *.py
+prune tests
+prune examples
+prune docs
+prune history
+prune dist
+prune build
+recursive-exclude * __pycache__ *.pyc *.pyo

testzombie_windows-0.2.25/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: testzombie-windows
+Version: 0.2.25
+Summary: TestZombie AI integration for Windows UI automation with self-healing, discovery and code updates
+Author: TestZombie AI
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://testzombie.ai
+Keywords: windows,ui-automation,self-healing,robot-framework,flaui,uiautomation,testzombie
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: uiautomation<3,>=2
+Provides-Extra: flaui
+Requires-Dist: robotframework-flaui>=6; extra == "flaui"
+Provides-Extra: rpa
+Requires-Dist: rpaframework-windows>=8; extra == "rpa"
+Dynamic: license-file
+
+# TestZombie AI – Windows Library
+
+TestZombie AI integriert Self-Healing, Discovery und optionales Code Update in bestehende Windows-UI-Tests. Die vorhandenen Testfälle und eigenen Robot-Framework-Keywords bleiben unverändert. Die Integration erfolgt über den TestZombie-Runner.
+
+**Unterstützt:** Robot Framework mit FlaUILibrary, Robot Framework mit RPA.Windows sowie Python mit `uiautomation`.
+
+## Voraussetzungen
+
+- Windows mit interaktiver Desktop-Sitzung und Python 3.10 oder neuer (64-Bit empfohlen).
+- Zugriff auf ein TestZombie-AI-Projekt mit API-Key.
+- Bei Robot Framework: das verwendete native Framework in **derselben Python-Umgebung** installieren wie `testzombie-windows`.
+- Die Anwendung muss über einen Fenstertitel und/oder eine AutomationId identifizierbar sein.
+
+## Installation mit pip
+
+Die Installation erfolgt in der Python-Umgebung, in der auch die Kundentests laufen.
+
+**Robot Framework + FlaUILibrary:**
+
+```powershell
+python -m pip install "testzombie-windows[flaui]"
+```
+
+**Robot Framework + RPA.Windows:**
+
+```powershell
+python -m pip install "testzombie-windows[rpa]"
+```
+
+**Python + uiautomation:**
+
+```powershell
+python -m pip install testzombie-windows
+```
+
+Für ein bereits vorhandenes virtuelles Environment dessen `python.exe` verwenden, zum Beispiel:
+
+```powershell
+& ".\.venv\Scripts\python.exe" -m pip install "testzombie-windows[flaui]"
+```
+
+### Alternative: Installation von einem lokalen Pfad
+
+Installation direkt aus einer Wheel-Datei:
+
+```powershell
+python -m pip install "C:\Pakete\testzombie_windows-0.2.25-py3-none-any.whl"
+```
+
+Oder aus einem entpackten Quellverzeichnis mit `pyproject.toml`:
+
+```powershell
+python -m pip install "C:\Pakete\TestZombie-Windows-PyPI-v0.2.25"
+```
+
+Bei lokaler Installation aus einer Wheel-Datei die benötigte Robot-Integration gegebenenfalls zusätzlich installieren, z. B. `python -m pip install "robotframework-flaui>=6"`.
+
+Installation prüfen:
+
+```powershell
+python -m pip show testzombie-windows
+python -c "import testzombie_windows; print(testzombie_windows.__version__)"
+```
+
+## Konfiguration
+
+Die Konfiguration erfolgt über Umgebungsvariablen, beispielsweise im CI-Job oder in PowerShell. Es sind **keine Änderungen am Testcode** erforderlich.
+
+```powershell
+$env:TZ_API_KEY = "<projekt-api-key>"
+$env:TZ_API_EMAIL = "<konto-email>"
+$env:TZ_APP_NAME = "MeineAnwendung"
+$env:TZ_WINDOW_NAME = "Hauptfenster"
+# Optional, falls vorhanden:
+$env:TZ_WINDOW_AUTOMATION_ID = "MainWindow"
+```
+
+Die Standard-API-Adresse lautet **`https://testzombie.ai/api`**. Für diese Adresse muss `TZ_API_URL` nicht gesetzt werden. Für eigene Umgebungen kann sie überschrieben werden:
+
+```powershell
+$env:TZ_API_URL = "http://localhost/api"
+# Alternativ: $env:TZ_API_URL = "https://staging.example.com/api"
+```
+
+Die Library erwartet eine vollständige `http(s)`-URL und verhindert doppelte `/api`-Pfadsegmente.
+
+### Verfügbare Optionen
+
+| Variable | Standard | Bedeutung |
+| --- | --- | --- |
+| `TZ_API_URL` | `https://testzombie.ai/api` | API-Adresse; optional überschreibbar. |
+| `TZ_API_KEY` | – | API-Key des TestZombie-Projekts. |
+| `TZ_API_EMAIL` | leer | Zugehörige API-Identität. |
+| `TZ_APP_NAME` | – | Technische Anwendungskennung, für Python-Integration erforderlich. |
+| `TZ_WINDOW_NAME` | – | Fenstertitel, für direkte Python-Integration erforderlich. |
+| `TZ_WINDOW_AUTOMATION_ID` | leer | Optionale AutomationId des Hauptfensters. |
+| `TZ_BACKEND` | `FLAUI` | Robot-Backend `FLAUI` oder `RPA_WINDOWS`. |
+| `TZ_NATIVE_LIBRARY_ALIAS` | automatisch | Optionaler Robot-Bibliotheksalias, falls `WITH NAME` verwendet wird. |
+| `TZ_ENABLED` | im Runner aktiviert | `0` deaktiviert die transparente Integration. |
+| `TZ_CODE_UPDATE` | `0` | `1` aktiviert automatische Quellcode-Korrekturen nach erfolgreichem Healing. |
+| `TZ_CODE_UPDATE_ROOT` | aktuelles Arbeitsverzeichnis | Verzeichnis, in dem Code Update Dateien bearbeiten darf. |
+| `TZ_DISCOVERY_ENABLED` | `0` | `1` aktiviert die Discovery-Aufzeichnung im TestRun. |
+| `TZ_DISCOVERY_MAX_STATES` | `12` (max. 40) | Obergrenze erfasster UI-Zustände. |
+| `TZ_DISCOVERY_MAX_EVENTS` | `200` (max. 500) | Obergrenze erfasster Aktionen. |
+| `TZ_DISCOVERY_MAX_CONTROLS` | `120` (max. 300) | Obergrenze UI-Controls pro Zustand. |
+| `TZ_DISCOVERY_CAPTURE_OPTION_LABELS` | `0` | Optionales Erfassen von Auswahlbezeichnungen, falls fachlich erlaubt. |
+| `TZ_DISCOVERY_INSPECT_PATTERNS` | `0` | Zusätzliche UIA-Pattern-Informationen erfassen. |
+| `TZ_DISCOVERY_CAPTURE_GRID_DIMENSIONS` | `0` | Zeilen-/Spaltenzahlen von Tabellen erfassen. |
+| `TZ_DISCOVERY_CAPTURE_COUNTER_DELTAS` | `0` | Unterschiede ausgewählter Zähler erfassen. |
+| `TZ_API_TIMEOUT` | `3` Sekunden | HTTP-Timeout (größer 0 bis 60 Sekunden). |
+| `TZ_API_HEAL_TIMEOUT` | `120` Sekunden | Timeout für Healing-Requests (größer 0 bis 300 Sekunden). |
+| `TZ_API_KEY_HEADER` | `X-API-KEY` | Optionaler API-Key-Header. |
+| `TZ_API_MAIL_HEADER` | `X-API-MAIL` | Optionaler Header der API-Identität. |
+| `TZ_FLAUI_SAFE_WAIT` | `1` | Sicherer nativer FlaUI-Wait, sofern verfügbar. |
+| `TZ_FLAUI_PROBE_TIMEOUT` | `0.8` Sekunden | Timeout des FlaUI-Locator-Probes. |
+| `TZ_HEALING_FAILURE_LOG` | `.testzombie/windows-healing-failures.jsonl` | Lokaler Dateipfad für Healing-Diagnosen. |
+| `TZ_ROBOT_DIAGNOSTICS` | `0` | `1` aktiviert erweiterte Robot-Diagnoseausgaben. |
+
+API-Credentials nicht in Testdateien, Repositorys oder Logs ablegen. Die Wirksamkeit der Healing-Optionen hängt außerdem von den Einstellungen und Berechtigungen des TestZombie-Projekts ab.
+
+## Bestehende Tests ausführen
+
+**Robot Framework + FlaUILibrary:**
+
+```powershell
+python -m testzombie_windows.run_robot --backend FLAUI -- tests\meine_suite.robot
+```
+
+**Robot Framework + RPA.Windows:**
+
+```powershell
+python -m testzombie_windows.run_robot --backend RPA_WINDOWS -- tests\meine_suite.robot
+```
+
+**Direktes Python + uiautomation:**
+
+```powershell
+python -m testzombie_windows.run_python tests\meine_tests.py
+```
+
+Für eine bestehende Python-Modul-Ausführung (z. B. pytest):
+
+```powershell
+python -m testzombie_windows.run_python -m pytest tests\
+```
+
+Die üblichen Robot-CLI-Optionen können nach `--` übergeben werden. Bereits vorhandene `.robot`- und importierte `.resource`-Dateien müssen nicht geändert werden. Native Aufrufe werden innerhalb der unterstützten Adapter transparent verarbeitet. Eigene, vollständig gekapselte Framework-Aufrufe können ein gezieltes Mapping erfordern.
+
+## Optional: Code Update
+
+Code Update ist standardmäßig ausgeschaltet. Nach erfolgreichem Healing kann TestZombie eindeutige Locator-Referenzen in unterstützten Testdateien aktualisieren:
+
+```powershell
+$env:TZ_CODE_UPDATE = "1"
+$env:TZ_CODE_UPDATE_ROOT = "C:\Projekte\MeineTests"
+python -m testzombie_windows.run_robot --backend FLAUI -- tests\meine_suite.robot
+```
+
+Es werden nur sicher zuordenbare Locator-Ausdrücke aktualisiert. Vor Änderungen werden Backups mit der Endung `.testzombie.bak` erstellt. Für den ersten Einsatz empfiehlt sich ein versionierter Arbeitsstand.
+
+## Optional: Discovery
+
+```powershell
+$env:TZ_DISCOVERY_ENABLED = "1"
+python -m testzombie_windows.run_robot --backend FLAUI -- tests\meine_suite.robot
+```
+
+Discovery zeichnet unterstützte UI-Zustände und Aktionen im TestRun auf. Nur explizit in erfolgreichen Testaktionen verwendete Controls werden als GUI Elements registriert. Das Erfassen potenziell personenbezogener Auswahlbezeichnungen bleibt standardmäßig deaktiviert.
+
+## Hinweise zur Ausführung
+
+- Tests benötigen eine interaktive Windows-Desktop-Sitzung. Eine gesperrte Sitzung oder eine CI-Umgebung ohne sichtbaren Desktop kann UIAutomation verhindern.
+- Alle Komponenten (TestZombie-Library, Robot Framework und nativer Adapter) müssen in derselben Python-Umgebung installiert sein.
+- Ohne gültige API-Anmeldedaten sind servergestütztes Healing, Discovery-Upload und Code Update nicht verfügbar. Die nativen Aufrufe laufen – soweit möglich – unverändert weiter.
+- Code Update wird nur bei ausdrücklich gesetztem `TZ_CODE_UPDATE=1` ausgeführt.
+- Bei fehlenden Fenstern oder mehrdeutigen Treffern `TZ_APP_NAME`, `TZ_WINDOW_NAME` und gegebenenfalls `TZ_WINDOW_AUTOMATION_ID` prüfen.

testzombie_windows-0.2.25/README.md

@@ -0,0 +1,176 @@
+# TestZombie AI – Windows Library
+
+TestZombie AI integriert Self-Healing, Discovery und optionales Code Update in bestehende Windows-UI-Tests. Die vorhandenen Testfälle und eigenen Robot-Framework-Keywords bleiben unverändert. Die Integration erfolgt über den TestZombie-Runner.
+
+**Unterstützt:** Robot Framework mit FlaUILibrary, Robot Framework mit RPA.Windows sowie Python mit `uiautomation`.
+
+## Voraussetzungen
+
+- Windows mit interaktiver Desktop-Sitzung und Python 3.10 oder neuer (64-Bit empfohlen).
+- Zugriff auf ein TestZombie-AI-Projekt mit API-Key.
+- Bei Robot Framework: das verwendete native Framework in **derselben Python-Umgebung** installieren wie `testzombie-windows`.
+- Die Anwendung muss über einen Fenstertitel und/oder eine AutomationId identifizierbar sein.
+
+## Installation mit pip
+
+Die Installation erfolgt in der Python-Umgebung, in der auch die Kundentests laufen.
+
+**Robot Framework + FlaUILibrary:**
+
+```powershell
+python -m pip install "testzombie-windows[flaui]"
+```
+
+**Robot Framework + RPA.Windows:**
+
+```powershell
+python -m pip install "testzombie-windows[rpa]"
+```
+
+**Python + uiautomation:**
+
+```powershell
+python -m pip install testzombie-windows
+```
+
+Für ein bereits vorhandenes virtuelles Environment dessen `python.exe` verwenden, zum Beispiel:
+
+```powershell
+& ".\.venv\Scripts\python.exe" -m pip install "testzombie-windows[flaui]"
+```
+
+### Alternative: Installation von einem lokalen Pfad
+
+Installation direkt aus einer Wheel-Datei:
+
+```powershell
+python -m pip install "C:\Pakete\testzombie_windows-0.2.25-py3-none-any.whl"
+```
+
+Oder aus einem entpackten Quellverzeichnis mit `pyproject.toml`:
+
+```powershell
+python -m pip install "C:\Pakete\TestZombie-Windows-PyPI-v0.2.25"
+```
+
+Bei lokaler Installation aus einer Wheel-Datei die benötigte Robot-Integration gegebenenfalls zusätzlich installieren, z. B. `python -m pip install "robotframework-flaui>=6"`.
+
+Installation prüfen:
+
+```powershell
+python -m pip show testzombie-windows
+python -c "import testzombie_windows; print(testzombie_windows.__version__)"
+```
+
+## Konfiguration
+
+Die Konfiguration erfolgt über Umgebungsvariablen, beispielsweise im CI-Job oder in PowerShell. Es sind **keine Änderungen am Testcode** erforderlich.
+
+```powershell
+$env:TZ_API_KEY = "<projekt-api-key>"
+$env:TZ_API_EMAIL = "<konto-email>"
+$env:TZ_APP_NAME = "MeineAnwendung"
+$env:TZ_WINDOW_NAME = "Hauptfenster"
+# Optional, falls vorhanden:
+$env:TZ_WINDOW_AUTOMATION_ID = "MainWindow"
+```
+
+Die Standard-API-Adresse lautet **`https://testzombie.ai/api`**. Für diese Adresse muss `TZ_API_URL` nicht gesetzt werden. Für eigene Umgebungen kann sie überschrieben werden:
+
+```powershell
+$env:TZ_API_URL = "http://localhost/api"
+# Alternativ: $env:TZ_API_URL = "https://staging.example.com/api"
+```
+
+Die Library erwartet eine vollständige `http(s)`-URL und verhindert doppelte `/api`-Pfadsegmente.
+
+### Verfügbare Optionen
+
+| Variable | Standard | Bedeutung |
+| --- | --- | --- |
+| `TZ_API_URL` | `https://testzombie.ai/api` | API-Adresse; optional überschreibbar. |
+| `TZ_API_KEY` | – | API-Key des TestZombie-Projekts. |
+| `TZ_API_EMAIL` | leer | Zugehörige API-Identität. |
+| `TZ_APP_NAME` | – | Technische Anwendungskennung, für Python-Integration erforderlich. |
+| `TZ_WINDOW_NAME` | – | Fenstertitel, für direkte Python-Integration erforderlich. |
+| `TZ_WINDOW_AUTOMATION_ID` | leer | Optionale AutomationId des Hauptfensters. |
+| `TZ_BACKEND` | `FLAUI` | Robot-Backend `FLAUI` oder `RPA_WINDOWS`. |
+| `TZ_NATIVE_LIBRARY_ALIAS` | automatisch | Optionaler Robot-Bibliotheksalias, falls `WITH NAME` verwendet wird. |
+| `TZ_ENABLED` | im Runner aktiviert | `0` deaktiviert die transparente Integration. |
+| `TZ_CODE_UPDATE` | `0` | `1` aktiviert automatische Quellcode-Korrekturen nach erfolgreichem Healing. |
+| `TZ_CODE_UPDATE_ROOT` | aktuelles Arbeitsverzeichnis | Verzeichnis, in dem Code Update Dateien bearbeiten darf. |
+| `TZ_DISCOVERY_ENABLED` | `0` | `1` aktiviert die Discovery-Aufzeichnung im TestRun. |
+| `TZ_DISCOVERY_MAX_STATES` | `12` (max. 40) | Obergrenze erfasster UI-Zustände. |
+| `TZ_DISCOVERY_MAX_EVENTS` | `200` (max. 500) | Obergrenze erfasster Aktionen. |
+| `TZ_DISCOVERY_MAX_CONTROLS` | `120` (max. 300) | Obergrenze UI-Controls pro Zustand. |
+| `TZ_DISCOVERY_CAPTURE_OPTION_LABELS` | `0` | Optionales Erfassen von Auswahlbezeichnungen, falls fachlich erlaubt. |
+| `TZ_DISCOVERY_INSPECT_PATTERNS` | `0` | Zusätzliche UIA-Pattern-Informationen erfassen. |
+| `TZ_DISCOVERY_CAPTURE_GRID_DIMENSIONS` | `0` | Zeilen-/Spaltenzahlen von Tabellen erfassen. |
+| `TZ_DISCOVERY_CAPTURE_COUNTER_DELTAS` | `0` | Unterschiede ausgewählter Zähler erfassen. |
+| `TZ_API_TIMEOUT` | `3` Sekunden | HTTP-Timeout (größer 0 bis 60 Sekunden). |
+| `TZ_API_HEAL_TIMEOUT` | `120` Sekunden | Timeout für Healing-Requests (größer 0 bis 300 Sekunden). |
+| `TZ_API_KEY_HEADER` | `X-API-KEY` | Optionaler API-Key-Header. |
+| `TZ_API_MAIL_HEADER` | `X-API-MAIL` | Optionaler Header der API-Identität. |
+| `TZ_FLAUI_SAFE_WAIT` | `1` | Sicherer nativer FlaUI-Wait, sofern verfügbar. |
+| `TZ_FLAUI_PROBE_TIMEOUT` | `0.8` Sekunden | Timeout des FlaUI-Locator-Probes. |
+| `TZ_HEALING_FAILURE_LOG` | `.testzombie/windows-healing-failures.jsonl` | Lokaler Dateipfad für Healing-Diagnosen. |
+| `TZ_ROBOT_DIAGNOSTICS` | `0` | `1` aktiviert erweiterte Robot-Diagnoseausgaben. |
+
+API-Credentials nicht in Testdateien, Repositorys oder Logs ablegen. Die Wirksamkeit der Healing-Optionen hängt außerdem von den Einstellungen und Berechtigungen des TestZombie-Projekts ab.
+
+## Bestehende Tests ausführen
+
+**Robot Framework + FlaUILibrary:**
+
+```powershell
+python -m testzombie_windows.run_robot --backend FLAUI -- tests\meine_suite.robot
+```
+
+**Robot Framework + RPA.Windows:**
+
+```powershell
+python -m testzombie_windows.run_robot --backend RPA_WINDOWS -- tests\meine_suite.robot
+```
+
+**Direktes Python + uiautomation:**
+
+```powershell
+python -m testzombie_windows.run_python tests\meine_tests.py
+```
+
+Für eine bestehende Python-Modul-Ausführung (z. B. pytest):
+
+```powershell
+python -m testzombie_windows.run_python -m pytest tests\
+```
+
+Die üblichen Robot-CLI-Optionen können nach `--` übergeben werden. Bereits vorhandene `.robot`- und importierte `.resource`-Dateien müssen nicht geändert werden. Native Aufrufe werden innerhalb der unterstützten Adapter transparent verarbeitet. Eigene, vollständig gekapselte Framework-Aufrufe können ein gezieltes Mapping erfordern.
+
+## Optional: Code Update
+
+Code Update ist standardmäßig ausgeschaltet. Nach erfolgreichem Healing kann TestZombie eindeutige Locator-Referenzen in unterstützten Testdateien aktualisieren:
+
+```powershell
+$env:TZ_CODE_UPDATE = "1"
+$env:TZ_CODE_UPDATE_ROOT = "C:\Projekte\MeineTests"
+python -m testzombie_windows.run_robot --backend FLAUI -- tests\meine_suite.robot
+```
+
+Es werden nur sicher zuordenbare Locator-Ausdrücke aktualisiert. Vor Änderungen werden Backups mit der Endung `.testzombie.bak` erstellt. Für den ersten Einsatz empfiehlt sich ein versionierter Arbeitsstand.
+
+## Optional: Discovery
+
+```powershell
+$env:TZ_DISCOVERY_ENABLED = "1"
+python -m testzombie_windows.run_robot --backend FLAUI -- tests\meine_suite.robot
+```
+
+Discovery zeichnet unterstützte UI-Zustände und Aktionen im TestRun auf. Nur explizit in erfolgreichen Testaktionen verwendete Controls werden als GUI Elements registriert. Das Erfassen potenziell personenbezogener Auswahlbezeichnungen bleibt standardmäßig deaktiviert.
+
+## Hinweise zur Ausführung
+
+- Tests benötigen eine interaktive Windows-Desktop-Sitzung. Eine gesperrte Sitzung oder eine CI-Umgebung ohne sichtbaren Desktop kann UIAutomation verhindern.
+- Alle Komponenten (TestZombie-Library, Robot Framework und nativer Adapter) müssen in derselben Python-Umgebung installiert sein.
+- Ohne gültige API-Anmeldedaten sind servergestütztes Healing, Discovery-Upload und Code Update nicht verfügbar. Die nativen Aufrufe laufen – soweit möglich – unverändert weiter.
+- Code Update wird nur bei ausdrücklich gesetztem `TZ_CODE_UPDATE=1` ausgeführt.
+- Bei fehlenden Fenstern oder mehrdeutigen Treffern `TZ_APP_NAME`, `TZ_WINDOW_NAME` und gegebenenfalls `TZ_WINDOW_AUTOMATION_ID` prüfen.

testzombie_windows-0.2.25/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "testzombie-windows"
+version = "0.2.25"
+description = "TestZombie AI integration for Windows UI automation with self-healing, discovery and code updates"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE.txt"]
+authors = [{ name = "TestZombie AI" }]
+keywords = ["windows", "ui-automation", "self-healing", "robot-framework", "flaui", "uiautomation", "testzombie"]
+classifiers = [
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Testing",
+]
+dependencies = ["uiautomation>=2,<3"]
+
+[project.optional-dependencies]
+flaui = ["robotframework-flaui>=6"]
+rpa = ["rpaframework-windows>=8"]
+
+[project.urls]
+Homepage = "https://testzombie.ai"
+
+[tool.setuptools]
+include-package-data = false
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["testzombie_windows*"]

testzombie_windows-0.2.25/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

testzombie_windows-0.2.25/testzombie_windows/__init__.py

@@ -0,0 +1,6 @@
+"""TestZombie Windows integration: FlaUI, RPA.Windows and Python uiautomation."""
+__version__ = '0.2.25'
+
+from .uiautomation_adapter import UiautomationHealingClient
+
+__all__ = ['UiautomationHealingClient']

testzombie_windows-0.2.25/testzombie_windows/api.py

@@ -0,0 +1,152 @@
+"""Network contract for the additive Windows API endpoints (Phase 2.2)."""
+from __future__ import annotations
+import json
+import os
+import socket
+from .config import api_base_url, api_header_names
+import urllib.error
+import urllib.request
+
+
+class TestZombieApiError(RuntimeError):
+    pass
+
+
+# The InitController supplies these project settings in InitZombieResult.
+# Keep the allowlist explicit: no tokens, credentials or project secrets in logs.
+_HEALING_FIELDS = (
+    ('healingLocatorFallbackEnabled', 'Locator-Fallback'),
+    ('healingVisualPositionEnabled', 'Visual-Position'),
+    ('healingWaitEnabled', 'Wait'),
+    ('healingClickEnabled', 'Click'),
+    ('healingAiEnabled', 'AI'),
+    ('healingStrictness', 'Strictness'),
+    ('healingAuditModeEnabled', 'Audit'),
+)
+
+
+def format_healing_configuration(config):
+    """Render only settings actually supplied by initZombie, never infer defaults."""
+    if not isinstance(config, dict):
+        return ''
+    rendered = []
+    for key, label in _HEALING_FIELDS:
+        if key not in config or config[key] is None:
+            continue
+        value = config[key]
+        if isinstance(value, bool):
+            value = 'AN' if value else 'AUS'
+        else:
+            value = str(value)
+        rendered.append(f'{label}={value}')
+    return ' | '.join(rendered)
+
+
+def report_healing_configuration(api, *, emitter=print):
+    """Print project-controlled healing flags after a successful Init."""
+    summary = format_healing_configuration(getattr(api, 'healing_config', None))
+    if summary:
+        emitter('[TestZombie Windows] Healing-Konfiguration: ' + summary)
+
+
+class WindowsApiClient:
+    def __init__(self, url=None, api_key=None, email=None, timeout=None):
+        try:
+            self.url = api_base_url(url)
+            self.key_header, self.mail_header = api_header_names()
+        except ValueError as exc:
+            raise TestZombieApiError(str(exc)) from exc
+        self.healing_config = {}
+        self.api_key = api_key or os.environ.get('TZ_API_KEY', '')
+        self.email = email or os.environ.get('TZ_API_EMAIL', '')
+        try:
+            self.timeout = float(timeout if timeout is not None else os.environ.get('TZ_API_TIMEOUT', '3'))
+            # findWindowsElement may execute a synchronous AI provider request.
+            # Its deadline must not inherit the short normal API timeout.
+            self.heal_timeout = float(os.environ.get('TZ_API_HEAL_TIMEOUT', '120'))
+        except (TypeError, ValueError) as exc:
+            raise TestZombieApiError('TZ_API_TIMEOUT / TZ_API_HEAL_TIMEOUT muss eine Sekundenzahl sein.') from exc
+        if not (0 < self.timeout <= 60):
+            raise TestZombieApiError('TZ_API_TIMEOUT muss groesser 0 und maximal 60 Sekunden sein.')
+        if not (0 < self.heal_timeout <= 300):
+            raise TestZombieApiError('TZ_API_HEAL_TIMEOUT muss groesser 0 und maximal 300 Sekunden sein.')
+        if not self.api_key:
+            raise TestZombieApiError('TZ_API_KEY fehlt (Projekt-API-Key konfigurieren).')
+
+    def request_timeout(self, endpoint):
+        return self.heal_timeout if endpoint.strip('/').lower() == 'findwindowselement' else self.timeout
+
+    def post(self, endpoint, payload):
+        timeout = self.request_timeout(endpoint)
+        url = self.url + '/api/' + endpoint.lstrip('/')
+        body = json.dumps(payload, ensure_ascii=False).encode('utf-8')
+        headers = {
+            'Content-Type': 'application/json',
+            self.key_header: self.api_key,
+            self.mail_header: self.email,
+        }
+        # This marks a single Windows demo request. The server additionally
+        # requires a local/test Spring profile, explicit property and exact
+        # demo identity; a client-controlled header can never force AI alone.
+        if endpoint.strip('/').lower() == 'findwindowselement' and os.environ.get(
+                'TZ_WINDOWS_TEST_FORCE_AI', '').strip().lower() in ('1', 'true', 'yes', 'on'):
+            from urllib.parse import urlsplit
+            if urlsplit(self.url).hostname not in ('localhost', '127.0.0.1', '::1'):
+                raise TestZombieApiError('Force-AI test mode requires a localhost API URL')
+            headers['X-TestZombie-Windows-Test-Force-AI'] = 'true'
+        req = urllib.request.Request(url, body, method='POST', headers=headers)
+        try:
+            with urllib.request.urlopen(req, timeout=timeout) as response:
+                result = json.load(response)
+        except urllib.error.HTTPError as exc:
+            # Avoid echoing response bodies potentially containing user data.
+            raise TestZombieApiError(f'{endpoint}: HTTP {exc.code} (API response rejected)') from exc
+        except (urllib.error.URLError, TimeoutError, OSError, ValueError) as exc:
+            # urllib can wrap a socket timeout in URLError.reason. Do not
+            # include raw response bodies, credentials or user input in logs.
+            reason = getattr(exc, 'reason', exc)
+            if isinstance(reason, (TimeoutError, socket.timeout)) or 'timed out' in str(reason).lower():
+                detail = f'timeout after {timeout:g}s'
+            elif isinstance(exc, ValueError):
+                detail = 'invalid JSON response'
+            else:
+                detail = 'network error: ' + type(exc).__name__
+            raise TestZombieApiError(f'{endpoint}: {detail}') from exc
+        if not isinstance(result, dict) or result.get('success') is False:
+            raise TestZombieApiError(f'{endpoint}: unsuccessful API response')
+        data = result.get('data')
+        if isinstance(data, dict) and data.get('error'):
+            raise TestZombieApiError(f'{endpoint}: {data["error"]}')
+        return data if isinstance(data, dict) else {}
+
+    def put_discovery(self, test_run_id, payload):
+        """PUT to the existing DiscoveryController; success is HTTP 204 (no JSON)."""
+        from urllib.parse import quote
+        if not isinstance(test_run_id, str) or not test_run_id.strip():
+            raise TestZombieApiError('Discovery requires a valid testRunId')
+        endpoint = 'test-runs/' + quote(test_run_id, safe='') + '/discovery'
+        url = self.url + '/api/' + endpoint
+        body = json.dumps(payload, ensure_ascii=False).encode('utf-8')
+        req = urllib.request.Request(url, body, method='PUT', headers={
+            'Content-Type': 'application/json',
+            self.key_header: self.api_key,
+            self.mail_header: self.email,
+        })
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as response:
+                if response.status not in (200, 201, 202, 204):
+                    raise TestZombieApiError('discovery: unexpected HTTP status')
+                return True
+        except urllib.error.HTTPError as exc:
+            raise TestZombieApiError(f'discovery: HTTP {exc.code}') from exc
+        except (urllib.error.URLError, TimeoutError, OSError, ValueError) as exc:
+            raise TestZombieApiError(f'discovery: network error: {type(exc).__name__}') from exc
+
+    def init_run(self, info='ROBOT_WINDOWS'):
+        self.healing_config = {}
+        data = self.post('initZombie', {'info': info})
+        run_id = data.get('testRunId')
+        if not run_id:
+            raise TestZombieApiError('initZombie did not return a testRunId')
+        self.healing_config = {key: data[key] for key, _ in _HEALING_FIELDS if key in data}
+        return run_id