Robotframework-FlaUI Library
| License | |
| Python Builds (x86) | |
| Python Builds (x64) | |
| Tests | |
| Python | |
| Robotframework | |
| PyPi |
Introduction
Robotframework-FlaUI is a keyword based user interface automation testing library for Windows applications like Win32, WinForms, WPF or Store Apps. It's based on the FlaUI user interface automation library.
Installation
Install the latest stable release:
pip install --upgrade robotframework-flaui
Dependencies and python support
The robot framework FlaUI is supposed to support the current Python 3 versions.
Required dependencies
See dependencies from Documentation
Python.Net Wrapper Issues
Robotframework-Flaui 1.x
- With the release of Python.Net version 2.5.2, Python 3.9 support was implemented for the first time.
- However, no official support for Python 3.9 has been released yet.
- For more information see the issue #1389
- If there are problems installing the Python.Net library, please use Python 3.8 instead.
- This is only a potential problem by all robotframework-flaui 1.x versions which are implemented by Python.Net 2.5.2
Robotframework-Flaui 2.x
- Sometimes an AccessViolationException wil be occure on latest Python.Net Version v3.0.1
- For more information see the issue #1977
- A workaround is to set Python's memory allocation environment variable "PYTHONMALLOC=malloc"
Documentation
RFHUB2
RFHUB2 is an opensource project aimed to provide nice and easy way of collecting, browsing and sharing documentation of existing keywords written in RobotFramework and python. Built with Material-UI and FastAPI, served by Uvicorn.
Under docs/keywords are the necessary .XML files to import the keywords.
These can be imported separately according to their version with the RFHUB2-CLI tool or all versions.
rfhub2-cli .\docs\keywords\
rfhub2-cli .\docs\keywords\<VERSION>
GUI Inspector Tools
There are various tools around which help inspecting application that should be ui tested or automated.
Some of them are:
- FlaUI Inspect
- Alternatively FlaUInspectStable more stable version
- Microsoft Accessibility Insights For Windows
- VisualUIAVerify
- Inspect
- UISpy
Examples
Examples of use can be found in the atests folder.
Development
Preconditions
- Install Python, if not already installed.
- Python 3 is supported.
Dependency installation by Builddrone
python -m pip install -r buildsystem.txt
Test-Applications
Two test projects were used for the UI automation:
- FlaUI WPF Test App 'Standard application that contains all common UI elements'
- Notifier Test App 'Application which closes automatically after a time'
Testing locally TLDR
python -m venv .venv
.venv/Scripts/pip install -r requirements-dev.txt
cd ./atests
../.venv/Scripts/robot -v UIA:UIA3 -d ../result -P ../src -t "Element Should Be Offscreen" Element.robot
Building and testing locally
Use the builddrone tasks defined in blueprint.json:
python -m builddrone <task>
Following tasks are supported:
build- Create the package (dist) and keyword documentation (keywords)cleanup- Remove generated folders and local virtual environmentsrobocop- Run Robot Framework lint checks viarobocop_lint.pypylint- Run pylint for the Python sources insrctest- Run UIA2 and UIA3 acceptance tests and merge results intoresult
Example full local CI run:
python -m builddrone build
python -m builddrone robocop
python -m builddrone pylint
python -m builddrone test
Releasing a new version - Frequent tasks
- add or update keywords in folders
src/FlaUILibrary/flaui/modulesrc/FlaUILibrary/keywords
- add or update tests in folder
atests - update version in
src/FlaUILibrary/version.py - update
CHANGELOG.md- add a release near the top
- add the links at the bottom in section
### Added
Acknowledgements
FlaUI
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file robotframework_flaui-5.0.2.tar.gz.
File metadata
- Download URL: robotframework_flaui-5.0.2.tar.gz
- Upload date:
- Size: 314.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
99fb14b7167c69f01ffda03bd8b1d0ce0abcc61c083238ea558f202323312bc1
|
|
| MD5 |
f7bcb62170e9d27dfc0abafdaa5af20e
|
|
| BLAKE2b-256 |
8439331e9c9642e8487b10e524d7e8681fd5634aa263a17be03bb1ea80beff99
|
File details
Details for the file robotframework_flaui-5.0.2-cp314-cp314-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp314-cp314-win_amd64.whl
- Upload date:
- Size: 350.5 kB
- Tags: CPython 3.14, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b7c3f092341b4d9d8e0faca315fc8970a0bd4161a531bbac2d52853c24131f75
|
|
| MD5 |
a877b805be541fd6eb31eb636e1f85ed
|
|
| BLAKE2b-256 |
1aa477a7365c499e4a221e7ec2b8b5732cf54cea9fdcb57daa3b22b85e33ec89
|
File details
Details for the file robotframework_flaui-5.0.2-cp314-cp314-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp314-cp314-win32.whl
- Upload date:
- Size: 350.5 kB
- Tags: CPython 3.14, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c6202c58511e957a27c26d00af0ce78080be8bf6220ba27c289cc5e20bb6ce3
|
|
| MD5 |
c26870d535f9563028bb6967c8992642
|
|
| BLAKE2b-256 |
732583a40d63c436421d35c7d4ec9bb7451eadc86dde2742ecd31c924b24c181
|
File details
Details for the file robotframework_flaui-5.0.2-cp313-cp313-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp313-cp313-win_amd64.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.13, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ea7508aaba7d9604d4bec3313f51cad0ef0a1060a21fd400e2a5a0143d69297
|
|
| MD5 |
322cca9c95f21a1c519da7729cb13315
|
|
| BLAKE2b-256 |
dd1c676bb2d279407f3df57fe03c2dcdb827be9a87968b75b618d0cedc96e1f7
|
File details
Details for the file robotframework_flaui-5.0.2-cp313-cp313-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp313-cp313-win32.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.13, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
170f6a73a746dcf99b2aaafb915193693075ed74a7b0d461a0449070dcfa9571
|
|
| MD5 |
5f4e4181ac2ef0ee89a8e7670ae7cb2d
|
|
| BLAKE2b-256 |
c6cc0231bca317513c23e9c108ceb90966afdb03e2d88832e5bb1c269c7635dd
|
File details
Details for the file robotframework_flaui-5.0.2-cp312-cp312-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp312-cp312-win_amd64.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.12, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b17735f7c93a244af12bdd0b7b3f7fcc8f251ff4dc7d77caa64d6824518028e9
|
|
| MD5 |
f13ddda1e53c62fd21936143c6b43527
|
|
| BLAKE2b-256 |
c1da2ff74021f4b0296505453bf82e9e2ebbb3bec01e156e126c6abb13515aab
|
File details
Details for the file robotframework_flaui-5.0.2-cp312-cp312-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp312-cp312-win32.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.12, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8f338e5a3207e7ed9081597c5b86dda7f4f7fc66e990bfaa8df9d87764237f74
|
|
| MD5 |
f56691fcf70b14375480d9e079148b13
|
|
| BLAKE2b-256 |
509df7666f0111ae7b172820919f2ca3d6a25711b061c8dbefa18286538b49a5
|
File details
Details for the file robotframework_flaui-5.0.2-cp311-cp311-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp311-cp311-win_amd64.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.11, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6640cb1e5ddfe082dd8c1052d8a66d7fa780ab8b1ed5db4dd4f3b9fc1f84e453
|
|
| MD5 |
803b86a6cf075e0bc561299b914ffd91
|
|
| BLAKE2b-256 |
21593441c4cdd427deeb88d9fc61f8f49271e06b81ee4bb73532d5babd3da772
|
File details
Details for the file robotframework_flaui-5.0.2-cp311-cp311-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp311-cp311-win32.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.11, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aef1736f95e644bd354aadb96cd75c7372691603d598fc23b2a2e0f3fdd55fc0
|
|
| MD5 |
3bcfa2ea3deb3d5cdf0651e614e75738
|
|
| BLAKE2b-256 |
51b23b5d10d56da074086b3fd4a0af7b00def80e83ff7a761703d87b52e7e7b3
|
File details
Details for the file robotframework_flaui-5.0.2-cp310-cp310-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp310-cp310-win_amd64.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.10, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5d9d33ca923c553194d6f3e79ba962c97a7cb66200c4d80320ade270644cd1be
|
|
| MD5 |
a123e7027b2c9deddbb9c2abb5618515
|
|
| BLAKE2b-256 |
547427fce51d619850d914f92b06ca6da581715f0921b18eb1cb34bc8bb6d1a7
|
File details
Details for the file robotframework_flaui-5.0.2-cp310-cp310-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp310-cp310-win32.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.10, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
33b988409d24327154220ca609b9556e8c573436012f615d2420efee2f848190
|
|
| MD5 |
d892bb855d4eca32b9b1b67decd04a6d
|
|
| BLAKE2b-256 |
b08ad10def6e2a16201cac0e85e4f9fa89d124b0fa8f7efc5825eb805ea8e1ee
|
File details
Details for the file robotframework_flaui-5.0.2-cp39-cp39-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp39-cp39-win_amd64.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.9, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
27f3990270a74bed7fc0a4a7ac883e9d7154eac3bf03b1fdb67fcad8049842de
|
|
| MD5 |
26dad9a06c7b1274dea39efe7faae482
|
|
| BLAKE2b-256 |
fc876443421779180cde86ce8687f5cf612468c83727283705603fd8c8976fcd
|
File details
Details for the file robotframework_flaui-5.0.2-cp39-cp39-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp39-cp39-win32.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.9, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d828df4cdea03cfa7e38df06499c120afdcf92aa511b7e0f1b56ca9e506d907f
|
|
| MD5 |
f848529a5ebf679d05553ddfac5f816a
|
|
| BLAKE2b-256 |
44a54df606fc278e2f023ee8a784eae336848afa17e7f902f31e8e8fdfb87e52
|
File details
Details for the file robotframework_flaui-5.0.2-cp38-cp38-win_amd64.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp38-cp38-win_amd64.whl
- Upload date:
- Size: 340.2 kB
- Tags: CPython 3.8, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c39a7c3a6982ea4432c3d11922fcde1ea1f9d7389194484942a21647e50252c6
|
|
| MD5 |
fce25d3cdbf078195328f8ede6be5fea
|
|
| BLAKE2b-256 |
ac0531cd2785840c2863a6f86e0cffa2b94d238b66f1875c3088ebd3fecd4942
|
File details
Details for the file robotframework_flaui-5.0.2-cp38-cp38-win32.whl.
File metadata
- Download URL: robotframework_flaui-5.0.2-cp38-cp38-win32.whl
- Upload date:
- Size: 340.1 kB
- Tags: CPython 3.8, Windows x86
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ceb5cdf535499c5039911e66c387e091cd87649c268d938937bbb744e9d885ee
|
|
| MD5 |
f607467d29f02741e2f37405123ba60f
|
|
| BLAKE2b-256 |
b4ff2432318e386b8c83a5f079845ff48240bbab7830d8d11995f05480a13985
|