Metadata-Version: 2.4
Name: appium_utility
Version: 0.3.20
Summary: Reusable Appium utility helpers
Requires-Python: >=3
Description-Content-Type: text/markdown
Requires-Dist: Appium-Python-Client>=4.0.0
Requires-Dist: requests
Provides-Extra: dev
Requires-Dist: build>=1.3.0; extra == "dev"
Requires-Dist: pre-commit>=4.5.1; extra == "dev"
Requires-Dist: twine>=6.2.0; extra == "dev"
Requires-Dist: mypy>=1.19.1; extra == "dev"
Requires-Dist: types-requests; extra == "dev"

# AppiumUtility
A small, opinionated helper utility built on top of **Appium Python Client** to simplify common Android UI interactions.
This library is designed to reduce boilerplate and make test scripts more readable and consistent.


## Usage
```py
from appium.webdriver.webdriver import WebDriver
from appium_utility import AppiumUtility

driver: WebDriver = create_driver_somehow()
utils = AppiumUtility(driver)
utils.launch_app("com.example.app")
utils.hide_keyboard()
utils.click_by_text("*.Continue.*", regex=True)
utils.click_by_id("com.example:id/login")
utils.click_by_content_desc("Settings")
utils.click_by_xpath("//android.widget.Button[@text='OK']")
utils.swipe_up()
utils.swipe_down()
utils.swipe_until_text_visible("*.Continue.*", direction="SWIPE_UP", regex=True)
```
