Metadata-Version: 2.4
Name: robo-appian-pr
Version: 0.0.14
Summary: Automate your Appian code testing with Python. Boost quality, save time.
License: Apache-2.0
License-File: LICENSE
Author: Dinil Mithra
Author-email: dinilmithra.mailme@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: playwright (>=1.52.0,<2.0.0)
Requires-Dist: requests (>=2.25.1,<3.0.0)
Requires-Dist: tomli (>=2.0.0,<3.0.0)
Project-URL: Homepage, https://github.com/dinilmithra/robo_appian
Project-URL: Repository, https://github.com/dinilmithra/robo_appian.git
Description-Content-Type: text/markdown

# Robo Appian

[![PyPI version](https://img.shields.io/badge/version-0.0.1-blue.svg)](https://pypi.org/project/robo-appian-pr/)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)

Robo Appian is a Python library for automated UI testing of Appian applications. It provides user-friendly utilities and best practices to help you write robust, maintainable, and business-focused test automation.

## Features
- Simple, readable API for Appian UI automation
- Utilities for buttons, inputs, dropdowns, tables, tabs, and more
- Playwright-based page-first APIs with direct component utilities
- Data-driven and workflow testing support
- Error handling and debugging helpers
- Designed for both technical and business users

## Documentation
Full documentation, guides, and API reference are available at:

➡️ [Robo Appian Documentation](https://dinilmithra.github.io/robo_appian/)

## Quick Start
1. Install Robo Appian:
   ```bash
   pip install robo-appian-pr
   ```
2. Install browser binaries:
   ```bash
   playwright install
   ```
3. See the [Getting Started Guide](docs/getting-started/installation.md) for setup and your first test.

## Example Usage
```python
from robo_appian import InputUtils, ButtonUtils

# Set value in a text field by label
InputUtils.setValueByLabelText(page, "Username", "testuser")

# Click a button by label
ButtonUtils.clickByLabelText(page, "Sign In")
```

## Project Structure
- `robo_appian/` - Library source code
- `docs/` - Documentation and guides

## Version Management

The version is managed centrally in `pyproject.toml` and automatically loaded at runtime via `ComponentUtils.get_version()`. This ensures:
- Single source of truth for versioning
- No version synchronization issues
- Dynamic version reporting in logs and debug info

Current version: **0.0.1**

See [CHANGELOG.md](CHANGELOG.md) for release history and updates.

## Contributing
Contributions are welcome! Please see the [contributing guidelines](CONTRIBUTING.md) or open an issue to get started.

## License
Apache License 2.0. See [LICENSE](LICENSE) for details.

---

For questions or support, contact [Dinil Mithra](mailto:dinilmithra.mailme@gmail.com) or connect on [LinkedIn](https://www.linkedin.com/in/dinilmithra).

