appium-utility 0.1.0

Reusable Appium utility helpers

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

from appium.webdriver.webdriver import WebDriver
from appium_utils 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']")