robotframework-plugins 2026.11.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. robotframework_plugins/__init__.py +14 -0
  2. robotframework_plugins/_assets/catalog.json +143 -0
  3. robotframework_plugins/_assets/plugins/rf-agentskills/.claude-plugin/plugin.json +25 -0
  4. robotframework_plugins/_assets/plugins/rf-agentskills/CHANGELOG.md +198 -0
  5. robotframework_plugins/_assets/plugins/rf-agentskills/README.md +27 -0
  6. robotframework_plugins/_assets/plugins/rf-agentskills/catalog.yaml +25 -0
  7. robotframework_plugins/_assets/plugins/rf-api/.claude-plugin/plugin.json +25 -0
  8. robotframework_plugins/_assets/plugins/rf-api/CHANGELOG.md +9 -0
  9. robotframework_plugins/_assets/plugins/rf-api/README.md +27 -0
  10. robotframework_plugins/_assets/plugins/rf-api/catalog.yaml +27 -0
  11. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/SKILL.md +113 -0
  12. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/authentication-patterns.robot +39 -0
  13. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/basic-crud.robot +46 -0
  14. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/file-upload.robot +28 -0
  15. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/session-handling.robot +48 -0
  16. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/async-jobs.md +42 -0
  17. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/authentication.md +58 -0
  18. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/install.md +10 -0
  19. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/loose-assertions.md +20 -0
  20. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/request-options.md +90 -0
  21. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/response-validation.md +64 -0
  22. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/troubleshooting.md +64 -0
  23. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/SKILL.md +120 -0
  24. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/basic-rest.robot +51 -0
  25. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schema-validation.robot +38 -0
  26. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schemas/user.json +10 -0
  27. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/authentication.md +61 -0
  28. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/install.md +11 -0
  29. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/json-handling.md +89 -0
  30. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/loose-assertions.md +18 -0
  31. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/migrate-from-requests.md +15 -0
  32. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/schema-validation.md +85 -0
  33. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/troubleshooting.md +68 -0
  34. robotframework_plugins/_assets/plugins/rf-core/.claude-plugin/plugin.json +19 -0
  35. robotframework_plugins/_assets/plugins/rf-core/CHANGELOG.md +13 -0
  36. robotframework_plugins/_assets/plugins/rf-core/README.md +38 -0
  37. robotframework_plugins/_assets/plugins/rf-core/agents/rf-debug-expert.md +120 -0
  38. robotframework_plugins/_assets/plugins/rf-core/agents/rf-migration-guide.md +73 -0
  39. robotframework_plugins/_assets/plugins/rf-core/agents/rf-test-architect.md +98 -0
  40. robotframework_plugins/_assets/plugins/rf-core/catalog.yaml +19 -0
  41. robotframework_plugins/_assets/plugins/rf-core/hooks/README.md +445 -0
  42. robotframework_plugins/_assets/plugins/rf-core/hooks/hooks.json +70 -0
  43. robotframework_plugins/_assets/plugins/rf-core/scripts/_hook_input.mjs +101 -0
  44. robotframework_plugins/_assets/plugins/rf-core/scripts/_pending_errors.mjs +65 -0
  45. robotframework_plugins/_assets/plugins/rf-core/scripts/_python_env.mjs +181 -0
  46. robotframework_plugins/_assets/plugins/rf-core/scripts/check_rf_environment.mjs +181 -0
  47. robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_inject_rf_context.mjs +74 -0
  48. robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_remind_robot_tests.mjs +128 -0
  49. robotframework_plugins/_assets/plugins/rf-core/scripts/report_pending_errors.mjs +72 -0
  50. robotframework_plugins/_assets/plugins/rf-core/scripts/rf_error_hints.mjs +126 -0
  51. robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot.mjs +517 -0
  52. robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot_project.mjs +103 -0
  53. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/SKILL.md +313 -0
  54. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/api.resource +30 -0
  55. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/calc.resource +23 -0
  56. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/embedded.resource +20 -0
  57. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/keywords.resource +26 -0
  58. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/login.resource +10 -0
  59. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/01__keyword_driven.robot +15 -0
  60. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/02__data_driven.robot +10 -0
  61. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/03__templates.robot +17 -0
  62. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/04__bdd.robot +10 -0
  63. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/05__embedded.robot +13 -0
  64. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/__init__.robot +6 -0
  65. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/__init__.robot +7 -0
  66. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/users.robot +18 -0
  67. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/env.robot +15 -0
  68. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/common.py +11 -0
  69. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/dev.yaml +3 -0
  70. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/staging.yaml +3 -0
  71. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/arguments.md +139 -0
  72. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/control-structures.md +175 -0
  73. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/embedded-arguments.md +135 -0
  74. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/migration.md +90 -0
  75. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/resources-and-variable-files.md +127 -0
  76. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/styles.md +92 -0
  77. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/suites-and-init.md +96 -0
  78. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/tags-and-selection.md +104 -0
  79. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/templates.md +124 -0
  80. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/variables-and-scopes.md +129 -0
  81. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/scripts/rf_conventions.py +883 -0
  82. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/SKILL.md +216 -0
  83. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ExampleLibrary.py +61 -0
  84. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ResultListener.py +60 -0
  85. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.py +48 -0
  86. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.robot +20 -0
  87. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/example_library.robot +31 -0
  88. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/listener.robot +12 -0
  89. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/api-variants.md +291 -0
  90. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/communication.md +248 -0
  91. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/conversion.md +347 -0
  92. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/listeners.md +150 -0
  93. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/packaging-and-docs.md +155 -0
  94. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/scripts/check_library.py +842 -0
  95. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/SKILL.md +159 -0
  96. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/github-actions-robot.yml +32 -0
  97. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/gitignore.txt +22 -0
  98. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.poetry.toml +28 -0
  99. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.uv.toml +20 -0
  100. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/requirements.txt +9 -0
  101. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/robot.toml +16 -0
  102. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/smoke.robot +22 -0
  103. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/ci.md +61 -0
  104. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/cli-tools.md +33 -0
  105. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/libraries.md +47 -0
  106. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/poetry.md +77 -0
  107. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/project-layout.md +86 -0
  108. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/troubleshooting.md +73 -0
  109. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/uv.md +108 -0
  110. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/venv-pip.md +71 -0
  111. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-debug-expert.toml +119 -0
  112. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-migration-guide.toml +72 -0
  113. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-test-architect.toml +97 -0
  114. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-debug-expert.md +123 -0
  115. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-migration-guide.md +76 -0
  116. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-test-architect.md +101 -0
  117. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/plugins/rf-core.js +93 -0
  118. robotframework_plugins/_assets/plugins/rf-desktop/.claude-plugin/plugin.json +24 -0
  119. robotframework_plugins/_assets/plugins/rf-desktop/CHANGELOG.md +10 -0
  120. robotframework_plugins/_assets/plugins/rf-desktop/README.md +26 -0
  121. robotframework_plugins/_assets/plugins/rf-desktop/catalog.yaml +23 -0
  122. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/SKILL.md +268 -0
  123. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/calculator.robot +45 -0
  124. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/mock-deterministic.robot +33 -0
  125. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/cli-and-inspector.md +82 -0
  126. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/install.md +14 -0
  127. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/keywords-reference.md +102 -0
  128. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/locators-and-queries.md +95 -0
  129. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/platform-setup.md +65 -0
  130. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/status-and-migration.md +41 -0
  131. robotframework_plugins/_assets/plugins/rf-mobile/.claude-plugin/plugin.json +24 -0
  132. robotframework_plugins/_assets/plugins/rf-mobile/CHANGELOG.md +9 -0
  133. robotframework_plugins/_assets/plugins/rf-mobile/README.md +26 -0
  134. robotframework_plugins/_assets/plugins/rf-mobile/catalog.yaml +23 -0
  135. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/SKILL.md +134 -0
  136. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/android-basic.robot +60 -0
  137. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/gestures-example.robot +59 -0
  138. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/hybrid-app.robot +54 -0
  139. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/ios-basic.robot +48 -0
  140. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/capabilities.md +117 -0
  141. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/gestures-touch.md +84 -0
  142. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/install.md +21 -0
  143. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/locators-mobile.md +74 -0
  144. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/platform-specific.md +105 -0
  145. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/troubleshooting.md +70 -0
  146. robotframework_plugins/_assets/plugins/rf-web/.claude-plugin/plugin.json +25 -0
  147. robotframework_plugins/_assets/plugins/rf-web/CHANGELOG.md +9 -0
  148. robotframework_plugins/_assets/plugins/rf-web/README.md +27 -0
  149. robotframework_plugins/_assets/plugins/rf-web/catalog.yaml +27 -0
  150. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/SKILL.md +134 -0
  151. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/authentication-flow.robot +34 -0
  152. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/basic-web-test.robot +29 -0
  153. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/form-handling.robot +49 -0
  154. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/iframe-shadow-dom.robot +31 -0
  155. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/assertion-engine.md +79 -0
  156. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/authentication-storage.md +86 -0
  157. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/browser-context-page.md +110 -0
  158. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/downloads-uploads.md +51 -0
  159. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/iframes-shadow-dom.md +67 -0
  160. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/install.md +67 -0
  161. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/locators.md +83 -0
  162. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/migrate-from-selenium.md +22 -0
  163. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/selector-drift.md +29 -0
  164. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/troubleshooting.md +100 -0
  165. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/SKILL.md +123 -0
  166. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/basic-web-test.robot +64 -0
  167. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/multi-window.robot +55 -0
  168. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/wait-patterns.robot +53 -0
  169. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/browser-setup.md +103 -0
  170. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/frames-windows.md +84 -0
  171. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/install.md +12 -0
  172. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/javascript-execution.md +65 -0
  173. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/locators.md +86 -0
  174. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/troubleshooting.md +122 -0
  175. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/waiting-strategies.md +84 -0
  176. robotframework_plugins/_assets.py +120 -0
  177. robotframework_plugins/_catalog.py +123 -0
  178. robotframework_plugins/_snapshot.py +320 -0
  179. robotframework_plugins/adapters/__init__.py +53 -0
  180. robotframework_plugins/adapters/_base.py +400 -0
  181. robotframework_plugins/adapters/claude_code.py +312 -0
  182. robotframework_plugins/adapters/claude_desktop.py +129 -0
  183. robotframework_plugins/adapters/codex.py +276 -0
  184. robotframework_plugins/adapters/copilot.py +87 -0
  185. robotframework_plugins/adapters/cursor.py +295 -0
  186. robotframework_plugins/adapters/goose.py +240 -0
  187. robotframework_plugins/adapters/opencode.py +170 -0
  188. robotframework_plugins/bundle.py +85 -0
  189. robotframework_plugins/cli.py +1311 -0
  190. robotframework_plugins/detect.py +121 -0
  191. robotframework_plugins/manifest.py +338 -0
  192. robotframework_plugins/py.typed +0 -0
  193. robotframework_plugins/skillzip.py +39 -0
  194. robotframework_plugins/transforms.py +725 -0
  195. robotframework_plugins-2026.11.0.dist-info/METADATA +198 -0
  196. robotframework_plugins-2026.11.0.dist-info/RECORD +199 -0
  197. robotframework_plugins-2026.11.0.dist-info/WHEEL +4 -0
  198. robotframework_plugins-2026.11.0.dist-info/entry_points.txt +2 -0
  199. robotframework_plugins-2026.11.0.dist-info/licenses/LICENSE +201 -0
@@ -0,0 +1,65 @@
1
+ # PlatynUI Platform Setup
2
+
3
+ ## Install matrix
4
+
5
+ | What | Command | Build | Requirements |
6
+ |------|---------|-------|--------------|
7
+ | **RF library (new_core)** | `uv add robotframework-PlatynUI==0.12.0.dev330` **or** `uv add --prerelease allow robotframework-PlatynUI` (into the project env; see rf-setup (plugin rf-core)) | Prebuilt wheel (bundles `platynui-native` `_native.abi3.so`) | **Python 3.12+**. No Rust, no git. |
8
+ | CLI | `uv tool install --prerelease allow platynui-cli` | Prebuilt wheel | Python 3.12+ |
9
+ | Inspector | `uv tool install --prerelease allow platynui-inspector` | Prebuilt wheel | Python 3.12+, a display |
10
+ | Mock-enabled native build | `uv run maturin develop -m packages/native/Cargo.toml --features mock-provider` | **Source build** | **Rust 1.95+** (2024 edition), Cargo, system libs |
11
+
12
+ ### The version footgun (read this)
13
+
14
+ ```bash
15
+ uv add robotframework-PlatynUI # → 0.9.2 (OLD: different lib, NO BareMetal)
16
+ uv add --prerelease allow robotframework-PlatynUI # → 0.12.0.dev* (new_core) # pip: pip install --pre robotframework-PlatynUI
17
+ uv add robotframework-PlatynUI==0.12.0.dev330 # exact pin (no opt-in needed) # pip: pip install robotframework-PlatynUI==0.12.0.dev330
18
+ ```
19
+
20
+ `new_core` is published **only as a pre-release**. An unpinned install without the pre-release opt-in silently resolves the old stable `0.9.2`, whose `PlatynUI` library is a different, near-undocumented surface with **no `BareMetal`**. Always opt into pre-releases (`--prerelease allow`; pip `--pre`) or pin.
21
+
22
+ ## Linux runtime requirements
23
+
24
+ Two things must be true for PlatynUI to actually drive a Linux desktop:
25
+
26
+ 1. **A running AT-SPI2 accessibility bus.** The Linux UI provider reads the tree over AT-SPI2/D-Bus. If it isn't up, the tree is empty.
27
+ - Install `at-spi2-core`; ensure the bus runs in your session.
28
+ - Some toolkits (egui/AccessKit apps) only expose their tree when a screen reader is considered active — set `org.a11y.Status.ScreenReaderEnabled=true` (the PlatynUI repo ships `scripts/linux-a11y-enable.sh`).
29
+ - Verify: `platynui-cli list-providers` should show the `atspi` provider `Active = yes`.
30
+ 2. **A session/display.** X11 needs `$DISPLAY`; Wayland needs `$WAYLAND_DISPLAY`. There is no headless tree mode for the real providers.
31
+
32
+ ### X11 vs Wayland — prefer X11
33
+
34
+ X11 is the complete path; Wayland is experimental/degraded:
35
+
36
+ - **Input injection:** X11 uses XTest (simple, complete). Wayland forbids client input injection — needs libei/EIS (GNOME 45+/KDE 6.1+), wlroots virtual input, or a portal with a consent dialog. Fragmented per compositor.
37
+ - **Screen coordinates:** under Wayland, AT-SPI `GetExtents(SCREEN)` returns `(0,0)` — pointer targeting by absolute screen coords is unreliable.
38
+ - **Screenshots / highlight / window management:** X11 complete; Wayland screenshot not implemented, highlight/window control limited.
39
+
40
+ **Recommendation:** run on **X11 (or an XWayland-backed session) with AT-SPI2**. A pure Wayland session works for tree traversal but is degraded for clicks, screenshots, and window control.
41
+
42
+ ## Docker / headless (CI)
43
+
44
+ The real providers need a session + AT-SPI, so for containers stand up a nested/headless display and the a11y bus:
45
+
46
+ - Install `at-spi2-core`, dbus, and a display server (Xvfb/Xephyr for X11, or Weston `headless`).
47
+ - Start AT-SPI in an isolated `dbus-run-session` (`at-spi-bus-launcher --launch-immediately --a11y=1` + `at-spi2-registryd`), then enable accessibility.
48
+ - Run the tools against that display.
49
+
50
+ The PlatynUI repo's own `scripts/` (`setup-atspi.sh`, `startxsession.sh`, `startwaylandsession.sh`, `linux-a11y-enable.sh`) are a working reference recipe.
51
+
52
+ ## Mock provider (deterministic, no desktop)
53
+
54
+ `use_mock=${True}` / `Runtime.new_with_mock()` runs a simulated desktop with no native APIs — ideal for deterministic tests. **But the published wheels are built without it** and raise `ProviderError: Runtime.new_with_mock() requires building with feature 'mock-provider'`. To use mock you must build the native package from source with `--features mock-provider`. For most CI needs, the display-free check is **libdoc** (keyword introspection works without a desktop because the runtime is lazy), not a live mock run.
55
+
56
+ ## Troubleshooting
57
+
58
+ | Symptom | Fix |
59
+ |---------|-----|
60
+ | Installed library has no `BareMetal` | You got `0.9.2` (unpinned install without pre-release opt-in). Reinstall with `uv add --prerelease allow robotframework-PlatynUI` or pin `==0.12.0.dev330`. |
61
+ | Linux tree empty / no nodes | AT-SPI not running / a11y disabled. Install `at-spi2-core`, enable a11y, check `platynui-cli list-providers`. |
62
+ | Wayland: clicks land wrong, screenshots fail | Use an X11/XWayland session. |
63
+ | `ProviderError: ... feature 'mock-provider'` | `use_mock` needs a source build with `--features mock-provider`. |
64
+ | `ElementNotFoundError` after ~30 s | Wrong namespace (`item:`/`app:`?), prefer `@Id`; verify with `platynui-cli query`. |
65
+ | Inspector crashes under WSL2 | `WINIT_UNIX_BACKEND=x11 WAYLAND_DISPLAY= platynui-inspector`. |
@@ -0,0 +1,41 @@
1
+ # PlatynUI Status & Migration
2
+
3
+ ## Verified against
4
+
5
+ This skill was authored and verified against **`robotframework-PlatynUI==0.12.0.dev330`** (library version `0.12.0-dev.330`, the `new_core` rewrite). PlatynUI is **preview/pre-release** — keyword names, CLI output, and platform behavior may change before a stable release. Re-verify with the keyword-fidelity test when bumping versions.
6
+
7
+ ## Which library to use
8
+
9
+ | Library | Status | Use it? |
10
+ |---------|--------|---------|
11
+ | `PlatynUI.BareMetal` | **Functional, permanent.** Low-level keyword surface mapping the Rust runtime ~1:1. 24 documented keywords. | ✅ Yes — this is the surface this skill documents. |
12
+ | `PlatynUI` (high-level) | **Placeholder.** A single `Dummy Keyword`; importing it warns `"The PlatynUI library is not implemented yet. This is a placeholder."` | ❌ No — not implemented. |
13
+
14
+ `Library PlatynUI.BareMetal` is the only usable RF entry point today. The high-level object model (typed widget classes — `Button`, `Edit`, `List`, `Tree`, …) exists in Python and is largely built, but its **Robot Framework keyword layer (migration Phase 5) is pending**, so none of it is exposed as keywords yet.
15
+
16
+ ## Two different PyPI surfaces (don't mix them up)
17
+
18
+ | Install | Version | `PlatynUI` lib | `PlatynUI.BareMetal` |
19
+ |---------|---------|----------------|----------------------|
20
+ | Unpinned, no pre-release opt-in | `0.9.2` (old stable) | 19 keywords, **1 documented** | **absent** |
21
+ | Pre-release opt-in (`--prerelease allow` / pip `--pre`) or `==0.12.0.dev330` | `0.12.0.dev330` (new_core) | placeholder (1 `Dummy Keyword`) | **24 keywords, all documented** |
22
+
23
+ The old `0.9.2` is a genuinely different library — different keywords, almost no docs. If an agent or user reports keywords that don't match this skill (or "no BareMetal"), they almost certainly installed `0.9.2`. Fix: opt into pre-releases (`--prerelease allow` / pip `--pre`) or pin.
24
+
25
+ ## Semantic actions are direction, not API
26
+
27
+ PlatynUI's design narrative (and RoboCon talk) describes high-level **semantic verbs** — `Activate`, `Select`, `Set Value`, `Check`, condition-based `Wait` — driven by typed page objects. **These are not shipped keywords.** With `BareMetal` you express the same intent by composing primitives:
28
+
29
+ | Intended semantic verb | BareMetal equivalent today |
30
+ |------------------------|----------------------------|
31
+ | `Activate` / `Click` a control | `Pointer Click //control:Button[@Id='…']` |
32
+ | `Set Value` of a field | `Keyboard Type //control:Edit[…] <Ctrl+A>new value` |
33
+ | `Select` a list item | `Pointer Click //item:ListItem[@Name='…']` |
34
+ | `Wait Until` visible | (implicit — descriptor resolution retries ~30 s) |
35
+ | assert state | `Get Attribute … Value == expected` |
36
+
37
+ When the high-level keyword library ships, prefer it for readability — but until then, document and write BareMetal.
38
+
39
+ ## Transitional internals (don't hard-code)
40
+
41
+ The design notes mark the in-library `UiNodeDescriptor` and the `${PLATYNUI_ROOT_DESCRIPTOR}` variable (set by `Set Root`) as transitional — a future shared mechanism may rename the root variable (e.g. `${PLATYNUI_ROOT_ELEMENT}`). Use the `Set Root` keyword rather than touching the variable directly.
@@ -0,0 +1,24 @@
1
+ {
2
+ "name": "rf-mobile",
3
+ "version": "1.0.0",
4
+ "description": "AppiumLibrary skill for Robot Framework mobile tests on Android and iOS.",
5
+ "author": {
6
+ "name": "manykarim",
7
+ "email": "manykarim@users.noreply.github.com"
8
+ },
9
+ "homepage": "https://github.com/MarketSquare/robotframework-plugins",
10
+ "repository": "https://github.com/MarketSquare/robotframework-plugins",
11
+ "license": "Apache-2.0",
12
+ "keywords": [
13
+ "robotframework",
14
+ "testing",
15
+ "mobile-testing",
16
+ "appium"
17
+ ],
18
+ "dependencies": [
19
+ {
20
+ "name": "rf-core",
21
+ "version": "^1.0"
22
+ }
23
+ ]
24
+ }
@@ -0,0 +1,9 @@
1
+ # Changelog
2
+
3
+ The `rf-mobile` plugin, versioned on its own (`rf-mobile--v<version>` tags); see `RELEASING.md` at the repository root.
4
+
5
+ ## 1.0.0 (2026-11-18)
6
+
7
+ First release, split out of `rf-agentskills` 3.0.0: `rf-appium`. It depends on `rf-core` `^1.0`. Skill names are unchanged; their plugin prefix is now `rf-mobile:` instead of `rf-agentskills:`, for example `/rf-mobile:rf-appium`.
8
+
9
+ - **Install steps moved here** from `rf-setup`: `rf-appium` has `references/install.md`, with the Appium server and driver steps.
@@ -0,0 +1,26 @@
1
+ # rf-mobile plugin
2
+
3
+ Robot Framework skills for mobile tests. Install instructions for every agent are in the [repository README](https://github.com/MarketSquare/robotframework-plugins#install).
4
+
5
+ ## Install
6
+
7
+ ```
8
+ /plugin install rf-mobile --marketplace MarketSquare/robotframework-plugins
9
+ ```
10
+
11
+ That one step works on Claude Code 2.1.275 or later. The commands for other agents and older versions are in the repository README.
12
+
13
+ | Skill | Library and package |
14
+ |---|---|
15
+ | `rf-appium` | AppiumLibrary: `robotframework-appiumlibrary` |
16
+
17
+ ## Needs rf-core
18
+
19
+ This plugin depends on `rf-core`, which holds Robot Framework syntax, environment setup, the subagents and the validation hooks. Claude Code installs `rf-core` with it. Copilot CLI and Codex don't install plugin dependencies, so install `rf-core` there too:
20
+
21
+ ```bash
22
+ copilot plugin install rf-core@robotframework-plugins
23
+ codex plugin add rf-core@robotframework-plugins
24
+ ```
25
+
26
+ The `robotframework-plugins` installer adds `rf-core` for you. Don't install this plugin next to the `rf-agentskills` bundle: the bundle carries its own copy of every skill, and you would see each skill twice.
@@ -0,0 +1,23 @@
1
+ # Programme manifest: see schemas/catalog.schema.json and CONTRIBUTING.md.
2
+ name: rf-mobile
3
+ summary: AppiumLibrary skill for Android and iOS tests.
4
+ tier: verified
5
+ status: active
6
+ maintainers:
7
+ - github: manykarim
8
+ name: Many Kasiriha
9
+ libraries:
10
+ - name: AppiumLibrary
11
+ package: robotframework-appiumlibrary
12
+ versions: ">=3,<4"
13
+ skills: [rf-appium]
14
+ robotframework: ">=7.0"
15
+ agents:
16
+ - claude-code
17
+ - copilot-cli
18
+ - vscode-copilot
19
+ - codex
20
+ - cursor
21
+ - opencode
22
+ - goose
23
+ - claude-desktop
@@ -0,0 +1,134 @@
1
+ ---
2
+ name: rf-appium
3
+ description: "Use first, before answering, for RF mobile tests with AppiumLibrary. Not installs/drivers: rf-setup."
4
+ license: Apache-2.0
5
+ compatibility: Requires Python 3.10+, robotframework>=7, robotcode[all]>=2.8 in the project environment and robotframework-appiumlibrary 3.x, an Appium server 2+/3 (Node.js) with the UiAutomator2 or XCUITest driver, the Android SDK or Xcode, and a device or emulator.
6
+ metadata:
7
+ author: manykarim
8
+ version: "1.0.0"
9
+ ---
10
+
11
+ # AppiumLibrary Skill
12
+
13
+ AppiumLibrary drives native, hybrid and mobile-web apps on Android and iOS through an Appium 2+ server.
14
+ Desktop apps belong to rf-platynui (plugin rf-desktop); desktop browsers to rf-browser (plugin rf-web) or rf-selenium.
15
+ Verified against AppiumLibrary 3.2.1, Robot Framework 7.4.
16
+
17
+ ## When to use
18
+
19
+ Load this skill first, before exploring the project or answering from memory, when a Robot Framework test drives a mobile app with AppiumLibrary (`Library AppiumLibrary`) on Android or iOS:
20
+
21
+ - writing or fixing a mobile test: Open Application capabilities (UiAutomator2, XCUITest), locators such as `accessibility_id`, waits, gestures and scrolling, the on-screen keyboard, WEBVIEW contexts in hybrid apps;
22
+ - an element cannot be located on a device, or the user mentions Appium, an .apk/.ipa, an emulator or a simulator, even if they only say "our app" or "mobile test".
23
+
24
+ Not this skill: native desktop apps use `rf-platynui` (plugin `rf-desktop`); desktop browsers use `rf-browser` (plugin `rf-web`) or `rf-selenium`; installing the Appium server and drivers uses `rf-setup` (plugin `rf-core`).
25
+
26
+ ## Installation
27
+
28
+ Install into the project environment, with the tool the project already uses. Full steps and verification: `references/install.md`. For a new environment, Poetry and venv + pip forms, and troubleshooting, see `rf-setup` (plugin `rf-core`).
29
+
30
+ ```bash
31
+ uv add robotframework-appiumlibrary
32
+ ```
33
+ The Appium server and platform drivers live outside the Python environment and are installed with npm (requires Node.js):
34
+
35
+ ```bash
36
+ npm install -g appium
37
+ appium driver install uiautomator2 # Android
38
+ appium driver install xcuitest # iOS
39
+ ```
40
+ Android SDK, JDK and Xcode prerequisites, and checking the drivers: `references/install.md`.
41
+
42
+ ## Import and defaults
43
+
44
+ Start the server (`appium`, default `http://127.0.0.1:4723`, no `/wd/hub` base path) before the suite. Default: one session per suite, Android, UiAutomator2, W3C capabilities with the `appium:` prefix written out:
45
+
46
+ ```robotframework
47
+ *** Settings ***
48
+ Library AppiumLibrary timeout=15s
49
+ Suite Setup Open Android App
50
+ Suite Teardown Close All Applications
51
+
52
+ *** Variables ***
53
+ ${APPIUM_URL} http://127.0.0.1:4723
54
+
55
+ *** Keywords ***
56
+ Open Android App
57
+ Open Application ${APPIUM_URL}
58
+ ... platformName=Android
59
+ ... appium:automationName=UiAutomator2
60
+ ... appium:deviceName=emulator-5554
61
+ ... appium:app=${CURDIR}/app.apk
62
+ ... appium:autoGrantPermissions=${True}
63
+ ```
64
+
65
+ `timeout=15s` because the library default (5 s) is short for emulators; it drives every `Wait Until …` keyword. `run_on_failure` already captures a screenshot. For iOS (`XCUITest`), an installed app (`appPackage`/`bundleId`), mobile browsers or cloud grids, use the capability sets in `references/capabilities.md`.
66
+
67
+ ## Which keyword for which situation
68
+
69
+ | Situation | Use | Details |
70
+ |---|---|---|
71
+ | Find an element | `accessibility_id=…`, then `id=…`, `android=…` / `predicate=…` / `chain=…`, XPath last | `references/locators-mobile.md` |
72
+ | Wait for a screen or element | `Wait Until Page Contains Element`, `Wait Until Element Is Visible` | — |
73
+ | Assert visible / enabled / gone | `Expect Element <locator> visible` (also `not visible`, `enabled`, `disabled`); text: `Expect Text` | — |
74
+ | Assert text of an element | `Element Text Should Be`, `Element Should Contain Text` | — |
75
+ | Type, clear, hide keyboard | `Input Text`, `Clear Text`, `Hide Keyboard` | — |
76
+ | Tap, long press, double tap | `Tap <locator> duration=2s`, `Tap <locator> count=2` | `references/gestures-touch.md` |
77
+ | Scroll or swipe | `Scroll Down` (Android), `Swipe By Percent`, `Swipe start_x=…` | `references/gestures-touch.md` |
78
+ | Pinch, zoom, other gestures | `Execute Script mobile: pinchOpenGesture elementId=…` | `references/gestures-touch.md` |
79
+ | Hybrid app web content | `Get Contexts`, `Switch To Context` | `references/platform-specific.md` |
80
+ | Android keys and activities, iOS alerts | `Press Keycode`, `Start Activity`, `Click Alert Button` | `references/platform-specific.md` |
81
+ | Inspect the screen for locators | `Log Source`, `Get Source` | `references/troubleshooting.md` |
82
+
83
+ ## Agent workflow
84
+
85
+ 1. Look up each keyword before you use it: `robotcode doc keyword AppiumLibrary "<Keyword>"`; find names with `robotcode doc keywords AppiumLibrary "<text>"`. Copy names and arguments exactly as robotcode shows them.
86
+ 2. Write the test with the defaults above and the decision table.
87
+ 3. Check the changed files statically: `robotcode analyze code <changed files>` (through the project environment, e.g. `uv run robotcode …`). Fix every error it reports.
88
+ 4. Run them by longname: `robotcode robot -bl "<Suite.Sub.Test>"` (longnames from `robotcode discover tests`), or pass a whole directory. Don't pass a single `.robot` file: it skips the parent `__init__.robot`.
89
+ 5. Read the results: `robotcode results show --failed`, then `robotcode results log -bl "<longname>"`. Don't parse output.xml by hand.
90
+ 6. Fix the cause and go back to step 3 (static check). Stop when the tests pass or the failure is shown to be in the system under test, and say which.
91
+
92
+ ## Gotchas
93
+
94
+ - **Actions don't wait** — `Click Element`, `Input Text` and `Get Text` look the element up once and fail with "did not match any elements" if the screen isn't there yet, because only the `Wait Until …` keywords and `Expect Element` poll. Put `Wait Until Page Contains Element` before the first action on a new screen; no `Sleep`.
95
+ - **`Element Should Be Visible/Enabled/Disabled` and `Text Should Be Visible` are deprecated** — libdoc marks them "Use `Expect Element`". Write `Expect Element <locator> visible` or `Expect Text <text> visible`; both retry for `timeout=5s` by default (their own argument, not the import `timeout`).
96
+ - **Removed keywords models still write** — `Long Press`, `Zoom`, `Quit Application` and the others below no longer exist in AppiumLibrary 3.2.1 and fail with "No keyword with name". Use the replacements:
97
+
98
+ | Removed | Use |
99
+ |---|---|
100
+ | `Long Press` | `Tap <locator> duration=2s` |
101
+ | `Click A Point` | `Tap With Positions 500ms ${{ (x, y) }}` |
102
+ | `Zoom` / `Pinch` | `Execute Script` with `mobile: pinchOpenGesture` / `pinchCloseGesture` (Android), `mobile: pinch` (iOS) |
103
+ | `Quit Application` / `Reset Application` | `Close Application` (then `Open Application`) |
104
+ | `Background App` | `Background Application` |
105
+ | `Get Window Size` | `Get Window Width` / `Get Window Height` |
106
+
107
+ - **Durations need units** — `Swipe` and `Tap With Positions` read a bare number as milliseconds (and warn that bare numbers are going away), while `Tap duration=2` means two seconds. Write `duration=500ms` or `duration=1s`. `Swipe` arguments are keyword-only: `Swipe start_x=500 start_y=1500 end_x=500 end_y=400 duration=500ms`. `Tap With Positions` takes the duration first: `Tap With Positions 300ms ${{ (500, 800) }}`.
108
+ - **Locator prefixes** — without a prefix the text is an `id` (XPath only if it starts with `//`), and any unknown `name=` style prefix fails with "prefix … is not supported". iOS predicate strings use `predicate=`, class chains `chain=`; the `ios=` strategy is the retired UI Automation lookup and fails with the current Appium Python client.
109
+ - **Capabilities** — the Appium Python client adds `appium:` to every name that is not W3C-standard and has no `:`, so `automationName=` works, but vendor capabilities keep their own prefix (`bstack:options=`, `sauce:options=`). Writing `appium:` yourself keeps logs and cloud docs aligned.
110
+ - **Hybrid context sticks** — after `Switch To Context WEBVIEW_…` every locator is a web locator (`css=`, `xpath=`); native locators fail until `Switch To Context NATIVE_APP`.
111
+ - **Sessions leak** — a failed test leaves the app session open; close it with `Close All Applications` in Suite Teardown (or `Close Application` in Test Teardown for per-test sessions).
112
+
113
+ ## When to read the references
114
+
115
+ | Read | When |
116
+ |---|---|
117
+ | `references/install.md` | installing the library, its post-install steps, verifying the install, or a failed post-install step |
118
+ | `references/capabilities.md` | iOS, installed apps, mobile browsers, cloud grids, reset and timeout capabilities |
119
+ | `references/locators-mobile.md` | Choosing or debugging a locator (UiAutomator, predicate, class chain, XPath) |
120
+ | `references/gestures-touch.md` | Scrolling to an element, swipes, long press, pinch/zoom, drag and drop |
121
+ | `references/platform-specific.md` | Android keys, activities, permissions, iOS alerts, pickers, hybrid apps |
122
+ | `references/troubleshooting.md` | An error message from the server, session creation, a device or a locator |
123
+
124
+ Examples in `assets/examples/`: `android-basic.robot`, `ios-basic.robot`, `gestures-example.robot`, `hybrid-app.robot`.
125
+
126
+ ## Companion Skills
127
+
128
+ | Need | Skill |
129
+ |------|-------|
130
+ | Native desktop tests with PlatynUI | `rf-platynui` (plugin `rf-desktop`) |
131
+ | Install Robot Framework or a library, fix the environment | `rf-setup` (plugin `rf-core`) |
132
+ | Write tests, suites, user keywords, resources and variables in Robot Framework syntax | `rf-language` (plugin `rf-core`) |
133
+
134
+ For running, discovering, keyword documentation, result analysis and debugging with the robotcode CLI, use the `robotcode` skill of the robotcode plugin (`robotcode@robotframework-agent-plugins`); the commands above work without it.
@@ -0,0 +1,60 @@
1
+ *** Settings ***
2
+ Documentation Android native app: login, list scrolling, device keys and orientation.
3
+ ... Needs an Appium 2+ server with the UiAutomator2 driver and an emulator.
4
+ Library AppiumLibrary timeout=15s
5
+ Suite Setup Open Android App
6
+ Suite Teardown Close All Applications
7
+ Test Teardown Portrait
8
+
9
+ *** Variables ***
10
+ ${APPIUM_URL} http://127.0.0.1:4723
11
+ ${APP} ${CURDIR}${/}apps${/}demo-app.apk
12
+ ${PACKAGE} com.example.demo
13
+
14
+ *** Test Cases ***
15
+ Valid Login Shows Welcome Text
16
+ Log In As demo demo
17
+ Expect Element accessibility_id=welcome_text visible
18
+ Element Text Should Be accessibility_id=welcome_text Welcome, demo
19
+
20
+ Invalid Login Shows Error
21
+ Log In As demo wrong
22
+ Expect Text Invalid credentials visible
23
+
24
+ Item Deep In A List Can Be Opened
25
+ Click Element accessibility_id=nav_items
26
+ Click Element android=new UiScrollable(new UiSelector().scrollable(true)).scrollIntoView(new UiSelector().text("Item 50"))
27
+ Wait Until Page Contains Element accessibility_id=item_detail
28
+
29
+ Back Key Returns To Previous Screen
30
+ Click Element accessibility_id=nav_settings
31
+ Wait Until Page Contains Element id=${PACKAGE}:id/settings_title
32
+ Press Keycode 4
33
+ Expect Element id=${PACKAGE}:id/settings_title not visible
34
+
35
+ App Survives Rotation And Background
36
+ Landscape
37
+ Expect Element accessibility_id=home_screen visible
38
+ Background Application 2
39
+ ${state}= Execute Script mobile: queryAppState appId=${PACKAGE}
40
+ Should Be Equal As Integers ${state} 4
41
+
42
+ *** Keywords ***
43
+ Open Android App
44
+ Open Application ${APPIUM_URL}
45
+ ... platformName=Android
46
+ ... appium:automationName=UiAutomator2
47
+ ... appium:deviceName=emulator-5554
48
+ ... appium:app=${APP}
49
+ ... appium:autoGrantPermissions=${True}
50
+ Wait Until Page Contains Element accessibility_id=home_screen
51
+
52
+ Log In As
53
+ [Arguments] ${username} ${password}
54
+ Click Element accessibility_id=nav_login
55
+ Wait Until Element Is Visible accessibility_id=username_input
56
+ Clear Text accessibility_id=username_input
57
+ Input Text accessibility_id=username_input ${username}
58
+ Input Password accessibility_id=password_input ${password}
59
+ Hide Keyboard
60
+ Click Element accessibility_id=login_button
@@ -0,0 +1,59 @@
1
+ *** Settings ***
2
+ Documentation Gestures with AppiumLibrary 3.x keywords: tap, long press, scroll,
3
+ ... swipe, pinch/zoom via driver commands, drag and drop (Android, UiAutomator2).
4
+ Library AppiumLibrary timeout=15s
5
+ Suite Setup Open Gestures Demo
6
+ Suite Teardown Close All Applications
7
+
8
+ *** Variables ***
9
+ ${APPIUM_URL} http://127.0.0.1:4723
10
+ ${APP} ${CURDIR}${/}apps${/}gestures-demo.apk
11
+
12
+ *** Test Cases ***
13
+ Long Press Opens Context Menu
14
+ Tap accessibility_id=item_1 duration=2s
15
+ Expect Element accessibility_id=context_menu visible
16
+
17
+ Double Tap Zooms Image
18
+ Tap accessibility_id=photo count=2 duration=100ms
19
+ Expect Element accessibility_id=photo_zoomed visible
20
+
21
+ Scroll Down Finds Terms Checkbox
22
+ Scroll Down accessibility_id=terms_checkbox timeout=20s
23
+ Expect Element accessibility_id=terms_checkbox visible
24
+
25
+ Carousel Moves To Next Page
26
+ ${before}= Get Text accessibility_id=carousel_title
27
+ Swipe By Percent 90 50 10 50 duration=300ms
28
+ Wait Until Keyword Succeeds 5s 500ms
29
+ ... Element Should Not Contain Text accessibility_id=carousel_title ${before}
30
+
31
+ Pull To Refresh Reloads List
32
+ Swipe By Percent 50 25 50 75 duration=500ms
33
+ Wait Until Page Does Not Contain Element accessibility_id=refresh_spinner
34
+
35
+ Content Scrolls Up With A Pixel Swipe
36
+ ${width}= Get Window Width
37
+ ${height}= Get Window Height
38
+ VAR ${x} ${{ int(${width} / 2) }}
39
+ Swipe start_x=${x} start_y=${{ int(${height} * 0.8) }} end_x=${x} end_y=${{ int(${height} * 0.2) }} duration=500ms
40
+
41
+ Map Zooms In And Out
42
+ ${map}= Get Webelement accessibility_id=map_view
43
+ Execute Script mobile: pinchOpenGesture elementId=${map.id} percent=${0.75}
44
+ Execute Script mobile: pinchCloseGesture elementId=${map.id} percent=${0.5}
45
+
46
+ Card Can Be Dragged To Done Column
47
+ Drag And Drop accessibility_id=card_1 accessibility_id=done_column
48
+ Expect Element accessibility_id=done_card_1 visible
49
+
50
+ Two Finger Tap On Coordinates
51
+ Tap With Positions 300ms ${{ (300, 800) }} ${{ (700, 800) }}
52
+
53
+ *** Keywords ***
54
+ Open Gestures Demo
55
+ Open Application ${APPIUM_URL}
56
+ ... platformName=Android
57
+ ... appium:automationName=UiAutomator2
58
+ ... appium:app=${APP}
59
+ Wait Until Page Contains Element accessibility_id=gestures_home
@@ -0,0 +1,54 @@
1
+ *** Settings ***
2
+ Documentation Hybrid app: native screens plus a WebView form (Android, UiAutomator2).
3
+ ... The app must enable WebView debugging; chromedriver must match the WebView.
4
+ Library AppiumLibrary timeout=20s
5
+ Library Collections
6
+ Suite Setup Open Hybrid App
7
+ Suite Teardown Close All Applications
8
+ Test Teardown Switch To Context NATIVE_APP
9
+
10
+ *** Variables ***
11
+ ${APPIUM_URL} http://127.0.0.1:4723
12
+ ${APP} ${CURDIR}${/}apps${/}hybrid-demo.apk
13
+
14
+ *** Test Cases ***
15
+ WebView Form Submits And Native Screen Confirms
16
+ Click Element accessibility_id=open_web_form
17
+ Switch To WebView
18
+ Wait Until Page Contains Element css=input#email
19
+ Input Text css=input#email demo@example.com
20
+ Click Element css=button[type=submit]
21
+ Wait Until Page Contains Thank you
22
+ Switch To Context NATIVE_APP
23
+ Click Element accessibility_id=back_button
24
+ Expect Element accessibility_id=home_screen visible
25
+
26
+ WebView Title Is Readable
27
+ Click Element accessibility_id=open_web_form
28
+ Switch To WebView
29
+ ${title}= Execute Script return document.title
30
+ Should Not Be Empty ${title}
31
+
32
+ *** Keywords ***
33
+ Open Hybrid App
34
+ Open Application ${APPIUM_URL}
35
+ ... platformName=Android
36
+ ... appium:automationName=UiAutomator2
37
+ ... appium:app=${APP}
38
+ ... appium:chromedriverAutodownload=${True}
39
+ Wait Until Page Contains Element accessibility_id=home_screen
40
+
41
+ Switch To WebView
42
+ [Documentation] Waits until a WEBVIEW context exists, then switches to it.
43
+ Wait Until Keyword Succeeds 20s 1s WebView Context Exists
44
+ @{contexts}= Get Contexts
45
+ FOR ${context} IN @{contexts}
46
+ IF '${context}'.startswith('WEBVIEW')
47
+ Switch To Context ${context}
48
+ RETURN
49
+ END
50
+ END
51
+
52
+ WebView Context Exists
53
+ @{contexts}= Get Contexts
54
+ Should Contain Match ${contexts} WEBVIEW*
@@ -0,0 +1,48 @@
1
+ *** Settings ***
2
+ Documentation iOS native app on a simulator: login, alerts, table rows and picker wheels.
3
+ ... Needs an Appium 2+ server with the XCUITest driver and Xcode.
4
+ Library AppiumLibrary timeout=20s
5
+ Suite Setup Open iOS App
6
+ Suite Teardown Close All Applications
7
+
8
+ *** Variables ***
9
+ ${APPIUM_URL} http://127.0.0.1:4723
10
+ ${APP} ${CURDIR}${/}apps${/}DemoApp.app
11
+
12
+ *** Test Cases ***
13
+ Valid Login Shows Welcome Text
14
+ Accept Alert If Present
15
+ Click Element accessibility_id=loginTab
16
+ Input Text accessibility_id=usernameField demo
17
+ Input Password accessibility_id=passwordField demo
18
+ Hide Keyboard Done
19
+ Click Element predicate=type == 'XCUIElementTypeButton' AND name == 'Log In'
20
+ Expect Text Welcome, demo visible
21
+
22
+ Third Settings Row Opens Details
23
+ Click Element accessibility_id=settingsTab
24
+ Wait Until Page Contains Element chain=**/XCUIElementTypeTable
25
+ Click Element chain=**/XCUIElementTypeTable/XCUIElementTypeCell[3]
26
+ Wait Until Page Contains Element accessibility_id=detailView
27
+
28
+ Country Can Be Picked
29
+ Click Element accessibility_id=formTab
30
+ Click Element accessibility_id=countryField
31
+ @{wheels}= Get Webelements class=XCUIElementTypePickerWheel
32
+ Input Value ${wheels}[0] Germany
33
+ Click Element accessibility_id=Done
34
+ Element Should Contain Text accessibility_id=countryField Germany
35
+
36
+ *** Keywords ***
37
+ Open iOS App
38
+ Open Application ${APPIUM_URL}
39
+ ... platformName=iOS
40
+ ... appium:automationName=XCUITest
41
+ ... appium:deviceName=iPhone 15
42
+ ... appium:platformVersion=17.5
43
+ ... appium:app=${APP}
44
+
45
+ Accept Alert If Present
46
+ ${present}= Run Keyword And Return Status
47
+ ... Wait Until Page Contains Element class=XCUIElementTypeAlert timeout=3s
48
+ IF ${present} Click Alert Button Allow