Metadata-Version: 2.1
Name: flaui-uiautomation-wrapper
Version: 0.1.0
Summary: Tool to perform UI Automation on Windows desktop applications using an underlying FlaUI wrapper.
Home-page: https://github.com/amruthvvkp/flaui-uiautomation-wrapper
License: LGPL-3.0-or-later
Keywords: testing,ui,ui-automation,automation,windows,windows automation,windows testing,desktop automation,flaui,qa
Author: Amruth VVKP
Author-email: amruthvvkp@gmail.com
Requires-Python: >=3.7,<3.12
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: arrow (>=1.2.3,<2.0.0)
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Requires-Dist: pillow (>=9.3.0,<10.0.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: pydantic-extra-types (>=2.0.0,<3.0.0)
Requires-Dist: pydantic-settings (>=2.0.0,<3.0.0)
Requires-Dist: pythonnet (>=3.0.1,<4.0.0)
Project-URL: Repository, https://github.com/amruthvvkp/flaui-uiautomation-wrapper
Description-Content-Type: text/markdown

# flaui-uiautomation-wrapper

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/flaui-uiautomation-wrapper)
![GitHub release (with filter)](https://img.shields.io/github/v/release/amruthvvkp/flaui-uiautomation-wrapper)
![PyPI - Version](https://img.shields.io/pypi/v/flaui-uiautomation-wrapper?link=https%3A%2F%2Fpypi.org%2Fproject%2Fflaui-uiautomation-wrapper%2F)
![PyPI - Downloads](https://img.shields.io/pypi/dm/flaui-uiautomation-wrapper?logo=semanticuireact)

![GitHub Release Date - Published_At](<https://img.shields.io/github/release-date/amruthvvkp/flaui-uiautomation-wrapper?style=social&logo=semantic-release&label=stable%20release&labelColor=rgb(78%2C%20176%2C%20103)>)
![GitHub (Pre-)Release Date](<https://img.shields.io/github/release-date-pre/amruthvvkp/flaui-uiautomation-wrapper?style=social&logo=semver&logoColor=rgb(212%2C%2072%2C%2042)&label=Pre-release&labelColor=rgb(212%2C%2072%2C%2042)>)

![GitHub milestones](https://img.shields.io/github/milestones/all/amruthvvkp/flaui-uiautomation-wrapper)
![GitHub issues](https://img.shields.io/github/issues/amruthvvkp/flaui-uiautomation-wrapper)
![GitHub pull requests](https://img.shields.io/github/issues-pr/amruthvvkp/flaui-uiautomation-wrapper)
![GitHub milestone details](https://img.shields.io/github/milestones/progress-percent/amruthvvkp/flaui-uiautomation-wrapper/1)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
![Interrogate](badges/interrogate_badge.svg)
[![Build status](https://ci.appveyor.com/api/projects/status/dnd20nw5wjqiigse?svg=true)](https://ci.appveyor.com/project/amruthvvkp/flaui-uiautomation-wrapper)
![GitHub branch checks state](https://img.shields.io/github/checks-status/amruthvvkp/flaui-uiautomation-wrapper/master)

[![GitHub contributors](https://img.shields.io/github/contributors/amruthvvkp/flaui-uiautomation-wrapper)](https://github.com/amruthvvkp/flaui-uiautomation-wrapper/graphs/contributors)
![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/amruthvvkp/flaui-uiautomation-wrapper/latest/master)
![GitHub last commit](https://img.shields.io/github/last-commit/amruthvvkp/flaui-uiautomation-wrapper)
![GitHub](https://img.shields.io/github/license/amruthvvkp/flaui-uiautomation-wrapper)
![PyPI - Format](https://img.shields.io/pypi/format/flaui-uiautomation-wrapper)

[FlaUI](https://github.com/FlaUI/FlaUI#:~:text=FlaUI%20is%20a%20.,of%20a%20wrapper%20around%20them.) is a .NET library that can be used to perform UI automated testing of Windows desktop applications like Win32, WinForms, WPF, etc.. It is a wrapper that works alongside Windows inbuilt UI Automation technology to perform UI automation as required.

FlaUI has interesting approaches on multiple non-python projects. On python there is an integration with RobotFramework which allows tests to be written on [RobotFramework](https://github.com/GDATASoftwareAG/robotframework-flaui) and the keywords from it's plugin are utilized to identify elements by XPATH and perform UI actions.

Other than RobotFramework-FLAUI, there are no Python libraries that help us leverage this useful C# library. The intend of this project is to make sure that a versatile and useful plug-and-play python wrapper is built which works well with IDE's intellisense, integrating with any Python frameworks like [PyTest](https://docs.pytest.org/en/7.1.x/), [Behave](https://behave.readthedocs.io/en/stable/), [TestPlan](https://github.com/morganstanley/testplan), etc. or any other tooling where UI automation is a necessary feature.

This project is in active development over the latest version of FlaUI (3.2.0) available on GitHub. New releases are expected to come by in the next few weeks and certainly the documentation would improve alongside the planned releases.

If you would like to contribute or request a feature, feel free to join the discussions on the [project's GitHub page](https://github.com/amruthvvkp/flaui-uiautomation-wrapper/discussions).

## Release Notes

Check out the release notes on [GitHub releases](https://github.com/amruthvvkp/flaui-uiautomation-wrapper/releases).

## Project Roadmap

Check out the project roadmap on [GitHub milestones](https://github.com/amruthvvkp/flaui-uiautomation-wrapper/milestone)

Active development is targetted towards the first major release of the project. The first major release is expected to be released by the end of 2023. The project roadmap is subject to change based on the project's progress.

You can track the project's progress on this [v1.0.0 roadmap](https://github.com/amruthvvkp/flaui-uiautomation-wrapper/milestone/1) page.

