Metadata-Version: 2.3
Name: robotframework-platynui
Version: 0.2.0.dev1
Summary: Cross-platform UI automation toolkit for Robot Framework with XPath-based element selection
Keywords: robotframework,automation,testing,ui,xpath,cross-platform
Author: Daniel Biehl
Author-email: Daniel Biehl <daniel.biehl@imbus.de>
License: Apache-2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Framework :: Robot Framework
Classifier: Framework :: Robot Framework :: Library
Requires-Dist: robotframework>=7.0.0
Requires-Dist: platynui-native==0.2.0.dev1
Requires-Dist: platynui-cli==0.2.0.dev1 ; extra == 'cli'
Requires-Dist: platynui-inspector==0.2.0.dev1 ; extra == 'inspector'
Maintainer: Daniel Biehl
Maintainer-email: Daniel Biehl <daniel.biehl@imbus.de>
Requires-Python: >=3.10
Project-URL: Changelog, https://github.com/imbus/robotframework-PlatynUI/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/imbus/robotframework-PlatynUI#readme
Project-URL: Homepage, https://github.com/imbus/robotframework-PlatynUI
Project-URL: Issues, https://github.com/imbus/robotframework-PlatynUI/issues
Project-URL: Source, https://github.com/imbus/robotframework-PlatynUI
Provides-Extra: cli
Provides-Extra: inspector
Description-Content-Type: text/markdown

# Robot Framework PlatynUI

Cross-platform UI automation for Robot Framework. Early alpha stage.

> [!WARNING]
> Preview quality. APIs and behavior may change. Use for evaluation only.

## Quick install (preview)

Install the pre-release packages from PyPI (explicit flags required):

```pwsh
# CLI
uv pip install --pre robotframework-platynui-cli
pip install --pre robotframework-platynui-cli
uv tool install --prerelease allow robotframework-platynui-cli

# Inspector GUI
uv pip install --pre robotframework-platynui-inspector
pip install --pre robotframework-platynui-inspector
uv tool install --prerelease allow robotframework-platynui-inspector
```

Try it:

```pwsh
platynui-cli list-providers
platynui-cli info --format json
platynui-inspector
```

## What is PlatynUI?

PlatynUI is a Robot Framework library and toolset to inspect, query, and control native desktop UIs across Windows, Linux, and macOS. It ships with:

- A CLI for XPath queries, highlighting, screenshots, keyboard/pointer input
- A GUI inspector to explore the UI tree and attributes
- Python bindings to integrate with Robot Framework test suites

Why PlatynUI?
- Consistent, cross-platform API surface
- Works with native accessibility stacks
- XPath-like queries to find elements

## Vision and direction

This repository is a ground‑up rewrite of the original project (see https://github.com/imbus/robotframework-PlatynUI), keeping the vision but modernizing the architecture and tooling.

We’re building PlatynUI to be:

- Robot Framework‑first: a clean keyword library with simple Python packaging and installation.
- Cross‑platform at the core: shared logic in Rust for performance, determinism, and safety; Python exposes the library to Robot Framework.
- Query‑centric: an XPath 2.0‑inspired language tailored for desktop UIs with a streaming evaluator and predictable document‑order semantics.
- Uniformly modeled: a single UI model with namespaces (control, item, app, native), typed attributes, and discoverable patterns (e.g., Focusable, WindowSurface, Invoke, Text).
- Provider‑based: native OS providers (Windows UIA, Linux AT‑SPI, macOS AX) plus room for external providers (e.g., JSON‑RPC) and fast mock providers for tests.
- Tooled for productivity: a CLI for diagnostics/automation, a GUI Inspector for exploring the tree and crafting queries, and a server façade later on.
- Reliability‑oriented: pointer/keyboard profiles, motion/acceleration and timing controls, highlighting and screenshots for feedback, and typed errors to reduce flakiness.
- Extensible: hook points for custom providers and functions; as we leave preview, public APIs will stabilize.

Expect differences to the original project’s API and keywords during the preview phase—capabilities converge, but names and behaviors may change as the new core matures.

## Package docs

- CLI: `packages/cli/README.md`
- Inspector: `packages/inspector/README.md`
- Native Python bindings: `packages/native/README.md`

## Documentation (design notes)

- Architecture & Runtime Concept (German): `docs/architekturkonzept_runtime.md`
- Implementation Plan (German): `docs/architekturkonzept_runtime_umsetzungsplan.md`
- Pattern Catalogue (German): `docs/patterns.md`
- Provider Checklist (draft): `docs/provider_checklist.md`
- Windows UIA Provider – Design: `docs/provider_windows_uia_design.md`

## Contributing

Contributions are welcome. Please see `CONTRIBUTING.md` for guidelines. Development notes and deeper build instructions live in the repository docs and package READMEs.

## License

Apache-2.0. See `LICENSE` in this repository.
