Metadata-Version: 2.4
Name: tquality-py-appium
Version: 0.1.1
Summary: Appium integration for the tquality test automation framework, built on tquality-py-core.
Project-URL: Homepage, https://github.com/Tquality-ru/tquality-py-appium
Project-URL: Repository, https://github.com/Tquality-ru/tquality-py-appium
Project-URL: Issues, https://github.com/Tquality-ru/tquality-py-appium/issues
Project-URL: Changelog, https://github.com/Tquality-ru/tquality-py-appium/blob/master/CHANGELOG.md
Author: ООО «Точка качества»
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: allure,android,appium,ios,mobile,page-object,qa,test-automation,testing,tquality
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: appium-python-client>=4.0
Requires-Dist: dependency-injector>=4.49
Requires-Dist: pytest-xdist>=3.8.0
Requires-Dist: pytest>=9.0.3
Requires-Dist: selenium>=4.25
Requires-Dist: tquality-py-core>=0.1.6
Description-Content-Type: text/markdown

# tquality-py-appium

Appium integration for the [tquality](https://tquality.ru) test automation
framework, built on
[tquality-py-core](https://github.com/Tquality-ru/tquality-py-core).

[Русская версия](README.ru.md)

## Installation

```bash
pip install tquality-py-appium
# or
uv add tquality-py-appium
```

## Quickstart

```bash
# Generate config.json5 with framework behavior defaults
tquality-appium-config init

# Generate starter capabilities.json5 (devices + applications)
tquality-appium-config caps-init
```

Edit `capabilities.json5` to describe your devices and applications.
Pick the active one via `selectedDevice` / `selectedApplication`, or
override at runtime:

```bash
TEST_SELECTED_DEVICE=Mi9 TEST_SELECTED_APPLICATION=aflProd pytest
```

## Documentation

See [tquality-py-core](https://github.com/Tquality-ru/tquality-py-core) for
the driver-agnostic concepts (`BaseConfig`, `Logger`, `BaseForm`,
`BaseElement`, JSON-schema cascading config) - everything from core is
re-exported here.

Appium-specific:

- `AppiumConfig` - framework behavior (timeouts, default context, screencast)
- `CapabilitiesConfig` - devices + applications, loaded from `capabilities.json5`
- `AppiumDriverService` - manages `appium.webdriver.Remote` session
- `ContextManager` - native/webview switching
- `AppiumServices` - DI container

## License

Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
