Skip to main content

robo-appian

robo-appian is a reusable Python component library built on top of Playwright for automating Appian web applications. It provides Appian-focused operations that identify controls primarily through user-facing labels, accessible semantics, text, and meaningful scopes where supported, while consumer projects keep ownership of application workflows, assertions, business rules, credentials, waits, and test data.

Architecture

Consumer tests → robo-appian → Playwright → Appian web application

The first argument to scope-aware component methods is a Scope. A Scope is either a Playwright Page or a Playwright Locator. Pass a Page to search the whole document, or a Locator to restrict the search to a particular container. robo-appian does not create a separate scope object.

The project favors readable component calls such as:

from robo_appian import Button, Dropdown, InputText

InputText.fill_by_label(scope, "Request Name", "Example Request")
Dropdown.select(scope, "Request Type", "Travel")
Button.click(scope, "Submit")

This keeps reusable Appian lookup mechanics in the library instead of repeating them throughout consumer workflows.

Install

With pip:

pip install robo-appian
playwright install chromium

With Poetry:

poetry add robo-appian
poetry run playwright install chromium

Python 3.12 is required.

Documentation

Full documentation, guides, and API reference are published at:

https://dinilmithra.github.io/robo-appian/

The MkDocs site is the primary user documentation. It includes installation, architecture and label-oriented concepts, a first-test walkthrough, component-selection guidance, troubleshooting, and generated API reference pages.

For local documentation development:

poetry install --with docs
poetry run mkdocs build --strict
poetry run mkdocs serve

Generated site/ output is not source and should not be edited manually.

Developer

Dinil Mithra — developer and maintainer of robo-appian.

Metadata

Release files for robo-appian 0.1.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for robo-appian 0.1.13
File Size Uploaded
robo_appian-0.1.13.tar.gz 47.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for robo-appian 0.1.13
File Interpreter ABI Platform
robo_appian-0.1.13-py3-none-any.whl Python 3 none any Details

Total release size: 109.3 kB

Release files / robo_appian-0.1.13.tar.gz

Download URL robo_appian-0.1.13.tar.gz
Size 47.7 kB
Tags Source
SHA-256 checksum
How to use checksums
9bf8d15671c7518aade869d39da3441467b6d28fcdec4e7ef0961e5d09030211
BLAKE2b-256 checksum
How to use checksums
9c53b3e536d692bec138a95286f78ce67f7c5fe3c1bedd9c77a5668aad27e22d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.12.0 Windows/11

Release files / robo_appian-0.1.13-py3-none-any.whl

Download URL robo_appian-0.1.13-py3-none-any.whl
Size 61.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
13981ca1e70c5fdf7be0fdf8b7c466d490381921ce6c2ec1893c37e8fdf27b2f
BLAKE2b-256 checksum
How to use checksums
1192fc1d9ab61eeb31f264d82e4940436b760a3d527e47c52cc127e81472cd5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.12.0 Windows/11
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page