Assertion Helpers

robo-appian provides Appian-facing assertion helpers so application projects can use a stable Appian error boundary instead of depending directly on browser-runtime assertion types.

from robo_appian import assert_text, assert_visible, wait_visible

Wait for visibility

wait_visible(page.get_by_text("Item saved"))

Assert visibility

assert_visible(page.get_by_text("Item saved"))

Assert text

assert_text(status, "Approved")

Assert text does not match

from robo_appian import assert_not_text

assert_not_text(status, "Draft")

When these checks fail, they raise RoboAppianError with an Appian-specific error code and useful details.

API

wait_visible

wait_visible(
    locator: Any,
    *,
    timeout: float | None = None,
    message: str = ""
) -> None

Wait for a locator to become visible using the configured Appian timeout.

assert_visible

assert_visible(locator: Any, *, message: str = '') -> None

Assert locator visibility.

assert_text

assert_text(
    locator: Any,
    expected: Any,
    *,
    message: str = "",
    **kwargs: Any
) -> None

Assert locator text through the Appian public error boundary.

assert_not_text

assert_not_text(
    locator: Any,
    expected: Any,
    *,
    message: str = "",
    **kwargs: Any
) -> None

Assert locator text does not match expected.