robotframework-okw4robot 0.4.0__tar.gz

robotframework_okw4robot-0.4.0/LICENSE

@@ -0,0 +1,36 @@
+OKW4Robot Community License (Nicht‑kommerzielle Nutzung)
+
+Copyright (c) 2025 Zoltán Hrabovszki
+
+1. Begriffe
+- "Software": die Bibliothek "OKW4Robot" samt zugehöriger Quell‑ und Binärdateien.
+- "Nicht‑kommerzielle Nutzung": jede Nutzung zu privaten, akademischen oder Open‑Source‑Zwecken ohne direkten oder indirekten Umsatzbezug, sowie reine Evaluierung/PoC.
+- "Kommerzielle Nutzung": jede Nutzung in oder für ein Produkt, einen Service oder Prozess, der direkt oder indirekt Einnahmen generiert (z. B. bezahlte Projekte, Firmen‑CI/Tests für kommerzielle Produkte, SaaS, Resale). Für kommerzielle Nutzung ist eine gesonderte kommerzielle Lizenz erforderlich.
+
+2. Lizenzgewährung (nicht‑kommerziell)
+Der Rechteinhaber gewährt eine weltweite, nicht‑exklusive, nicht übertragbare, unentgeltliche Lizenz zur Nutzung, Vervielfältigung, Änderung und Weitergabe der Software ausschließlich für nicht‑kommerzielle Zwecke, vorausgesetzt, dass (a) dieser Lizenztext in Kopien und abgeleiteten Werken enthalten bleibt und (b) Urheber‑ und Hinweistexte nicht entfernt werden.
+
+3. Einschränkungen
+- Kommerzielle Nutzung ist ohne kommerzielle Lizenz untersagt.
+- Marken‑ und Namensrechte werden nicht gewährt.
+- Sublicensing ist nur unter Beibehaltung dieser Bedingungen zulässig.
+
+4. Support
+Es besteht kein Anspruch auf Wartung, Support oder Updates.
+
+5. Gewährleistungsausschluss
+Die Software wird "wie besehen" ("AS IS") bereitgestellt, ohne ausdrückliche oder stillschweigende Gewährleistung. Insbesondere wird keine Gewähr für Marktgängigkeit, Eignung für einen bestimmten Zweck, Nichtverletzung von Rechten Dritter, Fehlerfreiheit, Richtigkeit oder Verfügbarkeit übernommen.
+
+6. Haftungsbeschränkung
+Soweit gesetzlich zulässig, haften der Rechteinhaber und Mitwirkende in keinem Fall für Schäden jedweder Art (einschließlich, aber nicht beschränkt auf direkte, indirekte, zufällige, besondere, exemplarische oder Folgeschäden, entgangenen Gewinn, Produktions‑/Betriebsunterbrechung, Datenverlust oder Rechtsverfolgungskosten), die aus der Nutzung, Unmöglichkeit der Nutzung oder Leistung der Software entstehen, selbst wenn auf die Möglichkeit solcher Schäden hingewiesen wurde.
+
+Unberührt bleiben zwingende Haftungstatbestände (z. B. nach dem Produkthaftungsgesetz) sowie die Haftung für Vorsatz, grobe Fahrlässigkeit oder für Verletzungen von Leben, Körper oder Gesundheit nach geltendem Recht.
+
+7. Laufzeit und Beendigung
+Diese Lizenz gilt bis zu ihrer Beendigung. Bei Verstoß erlischt das Nutzungsrecht automatisch; die Nutzung ist einzustellen. Rechte an bereits rechtmäßig weitergegebenen Kopien bleiben unberührt.
+
+8. Sonstiges
+Es gilt materielles Recht des Sitzstaats des Rechteinhabers unter Ausschluss des Kollisionsrechts. Sollte eine Bestimmung unwirksam sein, bleibt der Rest wirksam (Salvatorische Klausel).
+
+Kommerzielle Lizenz
+Für eine kommerzielle Nutzung (siehe Abschnitt 1) wenden Sie sich bitte an den Rechteinhaber, um Konditionen und Gebühren zu vereinbaren.

robotframework_okw4robot-0.4.0/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: robotframework-okw4robot
+Version: 0.4.0
+Summary: Driver-agnostic Robot Framework keyword library core for GUI test automation (OKW4Robot).
+Author: Zoltán Hrabovszki
+License: OKW4Robot Community License (Nicht‑kommerzielle Nutzung)
+        
+        Copyright (c) 2025 Zoltán Hrabovszki
+        
+        1. Begriffe
+        - "Software": die Bibliothek "OKW4Robot" samt zugehöriger Quell‑ und Binärdateien.
+        - "Nicht‑kommerzielle Nutzung": jede Nutzung zu privaten, akademischen oder Open‑Source‑Zwecken ohne direkten oder indirekten Umsatzbezug, sowie reine Evaluierung/PoC.
+        - "Kommerzielle Nutzung": jede Nutzung in oder für ein Produkt, einen Service oder Prozess, der direkt oder indirekt Einnahmen generiert (z. B. bezahlte Projekte, Firmen‑CI/Tests für kommerzielle Produkte, SaaS, Resale). Für kommerzielle Nutzung ist eine gesonderte kommerzielle Lizenz erforderlich.
+        
+        2. Lizenzgewährung (nicht‑kommerziell)
+        Der Rechteinhaber gewährt eine weltweite, nicht‑exklusive, nicht übertragbare, unentgeltliche Lizenz zur Nutzung, Vervielfältigung, Änderung und Weitergabe der Software ausschließlich für nicht‑kommerzielle Zwecke, vorausgesetzt, dass (a) dieser Lizenztext in Kopien und abgeleiteten Werken enthalten bleibt und (b) Urheber‑ und Hinweistexte nicht entfernt werden.
+        
+        3. Einschränkungen
+        - Kommerzielle Nutzung ist ohne kommerzielle Lizenz untersagt.
+        - Marken‑ und Namensrechte werden nicht gewährt.
+        - Sublicensing ist nur unter Beibehaltung dieser Bedingungen zulässig.
+        
+        4. Support
+        Es besteht kein Anspruch auf Wartung, Support oder Updates.
+        
+        5. Gewährleistungsausschluss
+        Die Software wird "wie besehen" ("AS IS") bereitgestellt, ohne ausdrückliche oder stillschweigende Gewährleistung. Insbesondere wird keine Gewähr für Marktgängigkeit, Eignung für einen bestimmten Zweck, Nichtverletzung von Rechten Dritter, Fehlerfreiheit, Richtigkeit oder Verfügbarkeit übernommen.
+        
+        6. Haftungsbeschränkung
+        Soweit gesetzlich zulässig, haften der Rechteinhaber und Mitwirkende in keinem Fall für Schäden jedweder Art (einschließlich, aber nicht beschränkt auf direkte, indirekte, zufällige, besondere, exemplarische oder Folgeschäden, entgangenen Gewinn, Produktions‑/Betriebsunterbrechung, Datenverlust oder Rechtsverfolgungskosten), die aus der Nutzung, Unmöglichkeit der Nutzung oder Leistung der Software entstehen, selbst wenn auf die Möglichkeit solcher Schäden hingewiesen wurde.
+        
+        Unberührt bleiben zwingende Haftungstatbestände (z. B. nach dem Produkthaftungsgesetz) sowie die Haftung für Vorsatz, grobe Fahrlässigkeit oder für Verletzungen von Leben, Körper oder Gesundheit nach geltendem Recht.
+        
+        7. Laufzeit und Beendigung
+        Diese Lizenz gilt bis zu ihrer Beendigung. Bei Verstoß erlischt das Nutzungsrecht automatisch; die Nutzung ist einzustellen. Rechte an bereits rechtmäßig weitergegebenen Kopien bleiben unberührt.
+        
+        8. Sonstiges
+        Es gilt materielles Recht des Sitzstaats des Rechteinhabers unter Ausschluss des Kollisionsrechts. Sollte eine Bestimmung unwirksam sein, bleibt der Rest wirksam (Salvatorische Klausel).
+        
+        Kommerzielle Lizenz
+        Für eine kommerzielle Nutzung (siehe Abschnitt 1) wenden Sie sich bitte an den Rechteinhaber, um Konditionen und Gebühren zu vereinbaren.
+        
+Project-URL: Repository, https://github.com/Hrabovszki1023/robotframework-okw4robot
+Project-URL: Homepage, https://github.com/Hrabovszki1023/robotframework-okw4robot
+Project-URL: Documentation, https://hrabovszki1023.github.io/robotframework-okw4robot/
+Keywords: robotframework,testing,testautomation,gui,okw,okw4robot
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Framework :: Robot Framework
+Classifier: Framework :: Robot Framework :: Library
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: robotframework>=6.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: okw-contract-utils>=0.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# OKW4Robot
+
+Driver-agnostic keyword architecture for [Robot Framework](https://robotframework.org/).
+
+One unified set of keywords for different GUI technologies
+(Web/Selenium, Web/Playwright, Java Swing, ...) — the actual implementation
+lives in the respective driver package.
+
+> **Deutsche Version:** [README_de.md](README_de.md)
+
+---
+
+## OKW Ecosystem
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    Robot Tests (.robot)                   │
+│     StartHost Chrome / SetValue Name "Smith"             │
+└──────────────────────────┬──────────────────────────────┘
+                           │
+               ┌───────────▼───────────┐
+               │      okw4robot        │  Driver-agnostic core
+               │  Keywords, OkwWidget  │  pip install robotframework-okw4robot
+               │  Context, Contracts   │
+               └───┬───────────────┬───┘
+                   │               │
+        ┌──────────▼──┐     ┌─────▼──────────┐
+        │ okw-web-    │     │ okw-java-      │     (more drivers
+        │ selenium    │     │ swing          │      e.g. okw-web-
+        │ WebSe_*     │     │ JavaSw_*       │      playwright)
+        └─────────────┘     └────────────────┘
+```
+
+| Package | Namespace | Status | Description |
+|---------|-----------|--------|-------------|
+| **okw4robot** | `okw4robot` | Stable | Core: keywords, OkwWidget interface, context, contracts |
+| **okw-web-selenium** | `okw_web_selenium` | Stable (53 tests) | Selenium WebDriver + WebSe_* widgets |
+| **okw-java-swing** | `okw_java_swing` | WIP | Java Swing via JSON-RPC |
+| **okw-contract-utils** | `okw_contract_utils` | Stable (PyPI) | Shared contracts (matchers, tokens, YES/NO) |
+| **okw-remote-ssh** | `robotframework_okw_remote_ssh` | Beta (PyPI) | SSH commands and SFTP |
+
+---
+
+## Getting Started
+
+### 1. Install the core
+
+```bash
+pip install robotframework-okw4robot
+```
+
+### 2. Install a driver package (e.g. Selenium)
+
+```bash
+pip install robotframework-okw-web-selenium
+```
+
+### 3. Write a Robot test
+
+```robotframework
+*** Settings ***
+Library    okw_web_selenium.library.OkwWebSeleniumLibrary
+
+*** Test Cases ***
+Login Test
+    StartHost     Chrome
+    StartApp      Chrome
+    SelectWindow  Chrome
+    SetValue      URL              https://example.com/login
+    StartApp      MyApp
+    SelectWindow  LoginDialog
+    SetValue      Username         admin
+    SetValue      Password         secret
+    ClickOn       Login
+    VerifyValue   Status           Logged in
+    StopHost
+```
+
+> **Note:** The test imports the *driver library* (`OkwWebSeleniumLibrary`),
+> not `OKW4RobotLibrary` directly. The driver library inherits all keywords
+> from the core.
+
+---
+
+## Architecture: Delegation, Not Control
+
+Keywords do not call adapter methods directly. Instead, they delegate to
+exactly **one** `okw_*` method on the widget:
+
+```
+Keyword SetValue "Name" "Smith"
+    │
+    ▼
+widget = resolve_widget("Name")        # YAML locator → WebSe_TextField
+widget.okw_set_value("Smith")          # Widget knows how.
+```
+
+The `OkwWidget` interface (in `okw4robot`) defines all `okw_*` methods
+with `NotImplementedError`. Driver packages implement them:
+
+| okw4robot (Interface) | okw-web-selenium (Implementation) |
+|-----------------------|-----------------------------------|
+| `OkwWidget.okw_set_value()` | `WebSe_TextField.okw_set_value()` → Selenium `clear` + `input_text` |
+| `OkwWidget.okw_click()` | `WebSe_Base.okw_click()` → Selenium `click_element` |
+| `OkwWidget.okw_exists()` | `WebSe_Base.okw_exists()` → Selenium `find_elements` |
+
+---
+
+## Project Structure
+
+```
+robotframework-okw4robot/
+  src/okw4robot/
+    library.py                  # OKW4RobotLibrary (all keyword mixins)
+    keywords/
+      host.py                   # StartHost, StopHost, SelectHost
+      app.py                    # StartApp, StopApp, SelectWindow
+      widget_keywords.py        # SetValue, ClickOn, VerifyValue, ...
+      attribute_keywords.py     # VerifyAttribute, MemorizeAttribute, LogAttribute
+      caption_keywords.py       # VerifyCaption, MemorizeCaption, LogCaption
+      label_keywords.py         # VerifyLabel, MemorizeLabel, LogLabel
+      placeholder_keywords.py   # VerifyPlaceholder, ...
+      tooltip_keywords.py       # VerifyTooltip, ...
+      table_keywords.py         # VerifyTableCellValue, ...
+      list_keywords.py          # VerifyListCount, VerifySelectedCount
+      params.py                 # SetOKWParameter (timeouts)
+    runtime/
+      context.py                # Central runtime context (adapter, app, window)
+    widgets/
+      okw_widget.py             # OkwWidget interface (NotImplementedError defaults)
+    utils/
+      yaml_loader.py            # YAML locator search (project → driver packages)
+      loader.py                 # Dynamic class loading
+      okw_helpers.py            # resolve_widget(), should_ignore(), ...
+      logging_mixin.py          # LoggingMixin for all classes
+      table_tokens.py           # $TAB/$LF token parser
+  tests/
+    unit/                       # 53 pytest unit tests with MockWidget
+  docs/
+    CONTRACT.md                 # Public contract
+    KEYWORDS.md                 # Keyword reference (all keywords)
+    SPECIFICATION.md            # Semantic specification
+    keywords_*.md               # Keyword documentation per topic
+    okw_parameters.md           # Timeouts and parameters
+    synchronization_strategy.md # Sync strategy (wait_before)
+    ...
+```
+
+---
+
+## Documentation
+
+### Contracts and Specification
+
+- [CONTRACT.md](docs/CONTRACT.md) – Public contract (architecture, YAML fallback)
+- [KEYWORDS.md](docs/KEYWORDS.md) – Keyword reference (all keywords at a glance)
+- [SPECIFICATION.md](docs/SPECIFICATION.md) – Semantic keyword specification
+
+### Keywords
+
+- [keywords_host_app.md](docs/keywords_host_app.md) – Host/App/Window keywords
+- [keywords_attribute.md](docs/keywords_attribute.md) – VerifyAttribute, MemorizeAttribute, LogAttribute
+- [keywords_caption.md](docs/keywords_caption.md) – VerifyCaption, MemorizeCaption, LogCaption
+- [keywords_label.md](docs/keywords_label.md) – VerifyLabel, MemorizeLabel, LogLabel
+- [keywords_placeholder.md](docs/keywords_placeholder.md) – VerifyPlaceholder, ...
+- [keywords_tooltip.md](docs/keywords_tooltip.md) – VerifyTooltip, ...
+- [keywords_table.md](docs/keywords_table.md) – Table keywords (index-based)
+- [keywords_table_headers.md](docs/keywords_table_headers.md) – Table keywords (header-based)
+- [keywords_list.md](docs/keywords_list.md) – VerifyListCount, VerifySelectedCount
+- [keywords_ignore_rule.md](docs/keywords_ignore_rule.md) – $IGNORE, $EMPTY, $DELETE
+
+### Concepts
+
+- [context.md](docs/context.md) – Runtime context (adapter, app, window)
+- [objektzustaende.md](docs/objektzustaende.md) – Widget states (exists, visible, enabled, ...)
+- [okw_parameters.md](docs/okw_parameters.md) – Timeouts and parameters ([DE](docs/okw_parameters_de.md))
+- [synchronization_strategy.md](docs/synchronization_strategy.md) – Sync strategy
+- [widgets_common.md](docs/widgets_common.md) – Widget hierarchy and OkwWidget interface
+- [table_tokens.md](docs/table_tokens.md) – $TAB/$LF token syntax
+- [regex_best_practices.md](docs/regex_best_practices.md) – Regex tips for Robot Framework
+
+---
+
+## Waiting for Values and Synchronization
+
+Verify keywords automatically wait for expected values (with timeout and polling):
+
+```robotframework
+# Set timeout (optional, default: 10s)
+SetOKWParameter    TimeOutVerifyValue    15
+
+# Keyword waits up to 15s for the expected value
+VerifyValue    Status    Logged in
+```
+
+Write actions (Click, SetValue, TypeKey, Select) check preconditions first:
+`exists → scroll_into_view → visible → enabled → editable → until_not_visible`
+
+Details: [docs/okw_parameters.md](docs/okw_parameters.md),
+[docs/synchronization_strategy.md](docs/synchronization_strategy.md)
+
+---
+
+## License
+
+- **Community** (non-commercial): see [LICENSE](LICENSE)
+- **Commercial**: see [COMMERCIAL_LICENSE.md](COMMERCIAL_LICENSE.md)
+- **FAQ**: [docs/license_faq.md](docs/license_faq.md)

robotframework_okw4robot-0.4.0/README.md

@@ -0,0 +1,208 @@
+# OKW4Robot
+
+Driver-agnostic keyword architecture for [Robot Framework](https://robotframework.org/).
+
+One unified set of keywords for different GUI technologies
+(Web/Selenium, Web/Playwright, Java Swing, ...) — the actual implementation
+lives in the respective driver package.
+
+> **Deutsche Version:** [README_de.md](README_de.md)
+
+---
+
+## OKW Ecosystem
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    Robot Tests (.robot)                   │
+│     StartHost Chrome / SetValue Name "Smith"             │
+└──────────────────────────┬──────────────────────────────┘
+                           │
+               ┌───────────▼───────────┐
+               │      okw4robot        │  Driver-agnostic core
+               │  Keywords, OkwWidget  │  pip install robotframework-okw4robot
+               │  Context, Contracts   │
+               └───┬───────────────┬───┘
+                   │               │
+        ┌──────────▼──┐     ┌─────▼──────────┐
+        │ okw-web-    │     │ okw-java-      │     (more drivers
+        │ selenium    │     │ swing          │      e.g. okw-web-
+        │ WebSe_*     │     │ JavaSw_*       │      playwright)
+        └─────────────┘     └────────────────┘
+```
+
+| Package | Namespace | Status | Description |
+|---------|-----------|--------|-------------|
+| **okw4robot** | `okw4robot` | Stable | Core: keywords, OkwWidget interface, context, contracts |
+| **okw-web-selenium** | `okw_web_selenium` | Stable (53 tests) | Selenium WebDriver + WebSe_* widgets |
+| **okw-java-swing** | `okw_java_swing` | WIP | Java Swing via JSON-RPC |
+| **okw-contract-utils** | `okw_contract_utils` | Stable (PyPI) | Shared contracts (matchers, tokens, YES/NO) |
+| **okw-remote-ssh** | `robotframework_okw_remote_ssh` | Beta (PyPI) | SSH commands and SFTP |
+
+---
+
+## Getting Started
+
+### 1. Install the core
+
+```bash
+pip install robotframework-okw4robot
+```
+
+### 2. Install a driver package (e.g. Selenium)
+
+```bash
+pip install robotframework-okw-web-selenium
+```
+
+### 3. Write a Robot test
+
+```robotframework
+*** Settings ***
+Library    okw_web_selenium.library.OkwWebSeleniumLibrary
+
+*** Test Cases ***
+Login Test
+    StartHost     Chrome
+    StartApp      Chrome
+    SelectWindow  Chrome
+    SetValue      URL              https://example.com/login
+    StartApp      MyApp
+    SelectWindow  LoginDialog
+    SetValue      Username         admin
+    SetValue      Password         secret
+    ClickOn       Login
+    VerifyValue   Status           Logged in
+    StopHost
+```
+
+> **Note:** The test imports the *driver library* (`OkwWebSeleniumLibrary`),
+> not `OKW4RobotLibrary` directly. The driver library inherits all keywords
+> from the core.
+
+---
+
+## Architecture: Delegation, Not Control
+
+Keywords do not call adapter methods directly. Instead, they delegate to
+exactly **one** `okw_*` method on the widget:
+
+```
+Keyword SetValue "Name" "Smith"
+    │
+    ▼
+widget = resolve_widget("Name")        # YAML locator → WebSe_TextField
+widget.okw_set_value("Smith")          # Widget knows how.
+```
+
+The `OkwWidget` interface (in `okw4robot`) defines all `okw_*` methods
+with `NotImplementedError`. Driver packages implement them:
+
+| okw4robot (Interface) | okw-web-selenium (Implementation) |
+|-----------------------|-----------------------------------|
+| `OkwWidget.okw_set_value()` | `WebSe_TextField.okw_set_value()` → Selenium `clear` + `input_text` |
+| `OkwWidget.okw_click()` | `WebSe_Base.okw_click()` → Selenium `click_element` |
+| `OkwWidget.okw_exists()` | `WebSe_Base.okw_exists()` → Selenium `find_elements` |
+
+---
+
+## Project Structure
+
+```
+robotframework-okw4robot/
+  src/okw4robot/
+    library.py                  # OKW4RobotLibrary (all keyword mixins)
+    keywords/
+      host.py                   # StartHost, StopHost, SelectHost
+      app.py                    # StartApp, StopApp, SelectWindow
+      widget_keywords.py        # SetValue, ClickOn, VerifyValue, ...
+      attribute_keywords.py     # VerifyAttribute, MemorizeAttribute, LogAttribute
+      caption_keywords.py       # VerifyCaption, MemorizeCaption, LogCaption
+      label_keywords.py         # VerifyLabel, MemorizeLabel, LogLabel
+      placeholder_keywords.py   # VerifyPlaceholder, ...
+      tooltip_keywords.py       # VerifyTooltip, ...
+      table_keywords.py         # VerifyTableCellValue, ...
+      list_keywords.py          # VerifyListCount, VerifySelectedCount
+      params.py                 # SetOKWParameter (timeouts)
+    runtime/
+      context.py                # Central runtime context (adapter, app, window)
+    widgets/
+      okw_widget.py             # OkwWidget interface (NotImplementedError defaults)
+    utils/
+      yaml_loader.py            # YAML locator search (project → driver packages)
+      loader.py                 # Dynamic class loading
+      okw_helpers.py            # resolve_widget(), should_ignore(), ...
+      logging_mixin.py          # LoggingMixin for all classes
+      table_tokens.py           # $TAB/$LF token parser
+  tests/
+    unit/                       # 53 pytest unit tests with MockWidget
+  docs/
+    CONTRACT.md                 # Public contract
+    KEYWORDS.md                 # Keyword reference (all keywords)
+    SPECIFICATION.md            # Semantic specification
+    keywords_*.md               # Keyword documentation per topic
+    okw_parameters.md           # Timeouts and parameters
+    synchronization_strategy.md # Sync strategy (wait_before)
+    ...
+```
+
+---
+
+## Documentation
+
+### Contracts and Specification
+
+- [CONTRACT.md](docs/CONTRACT.md) – Public contract (architecture, YAML fallback)
+- [KEYWORDS.md](docs/KEYWORDS.md) – Keyword reference (all keywords at a glance)
+- [SPECIFICATION.md](docs/SPECIFICATION.md) – Semantic keyword specification
+
+### Keywords
+
+- [keywords_host_app.md](docs/keywords_host_app.md) – Host/App/Window keywords
+- [keywords_attribute.md](docs/keywords_attribute.md) – VerifyAttribute, MemorizeAttribute, LogAttribute
+- [keywords_caption.md](docs/keywords_caption.md) – VerifyCaption, MemorizeCaption, LogCaption
+- [keywords_label.md](docs/keywords_label.md) – VerifyLabel, MemorizeLabel, LogLabel
+- [keywords_placeholder.md](docs/keywords_placeholder.md) – VerifyPlaceholder, ...
+- [keywords_tooltip.md](docs/keywords_tooltip.md) – VerifyTooltip, ...
+- [keywords_table.md](docs/keywords_table.md) – Table keywords (index-based)
+- [keywords_table_headers.md](docs/keywords_table_headers.md) – Table keywords (header-based)
+- [keywords_list.md](docs/keywords_list.md) – VerifyListCount, VerifySelectedCount
+- [keywords_ignore_rule.md](docs/keywords_ignore_rule.md) – $IGNORE, $EMPTY, $DELETE
+
+### Concepts
+
+- [context.md](docs/context.md) – Runtime context (adapter, app, window)
+- [objektzustaende.md](docs/objektzustaende.md) – Widget states (exists, visible, enabled, ...)
+- [okw_parameters.md](docs/okw_parameters.md) – Timeouts and parameters ([DE](docs/okw_parameters_de.md))
+- [synchronization_strategy.md](docs/synchronization_strategy.md) – Sync strategy
+- [widgets_common.md](docs/widgets_common.md) – Widget hierarchy and OkwWidget interface
+- [table_tokens.md](docs/table_tokens.md) – $TAB/$LF token syntax
+- [regex_best_practices.md](docs/regex_best_practices.md) – Regex tips for Robot Framework
+
+---
+
+## Waiting for Values and Synchronization
+
+Verify keywords automatically wait for expected values (with timeout and polling):
+
+```robotframework
+# Set timeout (optional, default: 10s)
+SetOKWParameter    TimeOutVerifyValue    15
+
+# Keyword waits up to 15s for the expected value
+VerifyValue    Status    Logged in
+```
+
+Write actions (Click, SetValue, TypeKey, Select) check preconditions first:
+`exists → scroll_into_view → visible → enabled → editable → until_not_visible`
+
+Details: [docs/okw_parameters.md](docs/okw_parameters.md),
+[docs/synchronization_strategy.md](docs/synchronization_strategy.md)
+
+---
+
+## License
+
+- **Community** (non-commercial): see [LICENSE](LICENSE)
+- **Commercial**: see [COMMERCIAL_LICENSE.md](COMMERCIAL_LICENSE.md)
+- **FAQ**: [docs/license_faq.md](docs/license_faq.md)

robotframework_okw4robot-0.4.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=65", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "robotframework-okw4robot"
+version = "0.4.0"
+description = "Driver-agnostic Robot Framework keyword library core for GUI test automation (OKW4Robot)."
+authors = [{ name = "Zoltán Hrabovszki" }]
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+keywords = ["robotframework", "testing", "testautomation", "gui", "okw", "okw4robot"]
+dependencies = [
+  "robotframework>=6.0",
+  "PyYAML>=6.0",
+  "okw-contract-utils>=0.2.0",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Framework :: Robot Framework",
+  "Framework :: Robot Framework :: Library",
+  "Topic :: Software Development :: Testing",
+]
+
+[project.urls]
+Repository = "https://github.com/Hrabovszki1023/robotframework-okw4robot"
+Homepage = "https://github.com/Hrabovszki1023/robotframework-okw4robot"
+Documentation = "https://hrabovszki1023.github.io/robotframework-okw4robot/"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+namespaces = false
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

robotframework_okw4robot-0.4.0/setup.cfg

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

robotframework_okw4robot-0.4.0/src/okw4robot/__init__.py

@@ -0,0 +1,3 @@
+from .library import OKW4RobotLibrary
+
+__all__ = ["OKW4RobotLibrary"]

robotframework_okw4robot-0.4.0/src/okw4robot/keywords/app.py

@@ -0,0 +1,37 @@
+from robot.api.deco import keyword
+from ..runtime.context import context
+from ..utils.yaml_loader import load_yaml_with_fallback
+from ..utils.logging_mixin import LoggingMixin
+
+class AppKeywords(LoggingMixin):
+
+    @keyword("StartApp")
+    def start_app(self, name: str):
+        self.log_info(f"Starte App '{name}'...")
+        model = load_yaml_with_fallback(name)
+        app_name = name.rsplit("/", 1)[-1]
+
+        if app_name not in model:
+            self.log_error(f"App name '{app_name}' not found in YAML root.")
+            raise KeyError(f"App name '{app_name}' not found in YAML root")
+
+        app_model = model[app_name]
+        context.set_app(app_name, app_model)
+        self.log_info(f"App '{app_name}' gestartet.")
+
+    @keyword("SelectWindow")
+    def select_window(self, name: str):
+        self.log_info(f"Wähle Fenster/Widget '{name}'...")
+        context.set_window(name)
+        self.log_info(f"Fenster/Widget '{name}' aktiviert.")
+
+    @keyword("StopApp")
+    def stop_app(self):
+        if context._app_model is None:
+            self.log_error("Keine App aktiv – nichts zu stoppen.")
+            raise RuntimeError("Stop App failed: No app is currently active.")
+
+        self.log_info(f"Beende App '{context._app_name}'.")
+        context.stop_app()
+
+    

robotframework_okw4robot-0.4.0/src/okw4robot/keywords/attribute_keywords.py

@@ -0,0 +1,54 @@
+from robot.api.deco import keyword
+from robot.api import logger
+from ..utils.okw_helpers import should_ignore, get_robot_timeout, resolve_widget, verify_with_timeout, normalize_var_name
+from okw_contract_utils import MatchMode
+
+
+def _get_attr(w, attr_name: str) -> str:
+    try:
+        val = w.okw_get_attribute(attr_name)
+        return "" if val is None else str(val)
+    except Exception:
+        return ""
+
+
+class AttributeKeywords:
+    @keyword("VerifyAttribute")
+    def verify_attribute(self, name, attribute, expected):
+        if should_ignore(expected):
+            logger.info(f"[VerifyAttribute] '{name}' ignored ($IGNORE)")
+            return
+        w = resolve_widget(name)
+        timeout = get_robot_timeout("${OKW_TIMEOUT_VERIFY_ATTRIBUTE}", 10.0)
+        verify_with_timeout(lambda: _get_attr(w, attribute), expected, MatchMode.EXACT, timeout, f"[VerifyAttribute] '{name}'")
+
+    @keyword("VerifyAttributeWCM")
+    def verify_attribute_wcm(self, name, attribute, expected):
+        if should_ignore(expected):
+            logger.info(f"[VerifyAttributeWCM] '{name}' ignored ($IGNORE)")
+            return
+        w = resolve_widget(name)
+        timeout = get_robot_timeout("${OKW_TIMEOUT_VERIFY_ATTRIBUTE}", 10.0)
+        verify_with_timeout(lambda: _get_attr(w, attribute), expected, MatchMode.WCM, timeout, f"[VerifyAttributeWCM] '{name}'")
+
+    @keyword("VerifyAttributeREGX")
+    def verify_attribute_regx(self, name, attribute, expected):
+        if should_ignore(expected):
+            logger.info(f"[VerifyAttributeREGX] '{name}' ignored ($IGNORE)")
+            return
+        w = resolve_widget(name)
+        timeout = get_robot_timeout("${OKW_TIMEOUT_VERIFY_ATTRIBUTE}", 10.0)
+        verify_with_timeout(lambda: _get_attr(w, attribute), expected, MatchMode.REGX, timeout, f"[VerifyAttributeREGX] '{name}'")
+
+    @keyword("MemorizeAttribute")
+    def memorize_attribute(self, name, attribute, variable):
+        from robot.libraries.BuiltIn import BuiltIn
+        w = resolve_widget(name)
+        value = _get_attr(w, attribute)
+        BuiltIn().set_test_variable(normalize_var_name(variable), value)
+
+    @keyword("LogAttribute")
+    def log_attribute(self, name, attribute):
+        w = resolve_widget(name)
+        value = _get_attr(w, attribute)
+        logger.info(f"[LogAttribute] {value}")