Metadata-Version: 2.4
Name: appium_utility
Version: 0.2.0
Summary: Reusable Appium utility helpers
Requires-Python: >=3
Description-Content-Type: text/markdown
Requires-Dist: Appium-Python-Client>=4.0.0
Provides-Extra: dev
Requires-Dist: build>=1.3.0; extra == "dev"

# AppiumUtils

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.

---

## Features

- Launch and control Android apps
- Perform common key actions (home, back, enter, backspace)
- Simplified tap helpers (by text, id, content-desc, xpath)
- Text input and clearing using the currently focused element
- Swipe using screen **percentage-based coordinates**
- Scroll until text becomes visible
- Assertion helpers for text visibility



## Usage
```py
from appium.webdriver.webdriver import WebDriver
from appiumutils import AppiumUtils

driver: WebDriver = create_driver_somehow()
utils = AppiumUtils(driver)
utils.launch_app("com.example.app")
utils.hide_keyboard()
utils.tap_by_text("Continue")
utils.tap_by_id("com.example:id/login")
utils.tap_by_content_desc("Settings")
utils.tap_by_xpath("//android.widget.Button[@text='OK']")

```
