testmuai-playwright-bindings 0.1.16

TestMu binding for Playwright Python — thin test runtime for TestMu-exported tests on the LambdaTest grid

testmuai-playwright-bindings

TestMu binding for Playwright Python — a thin test runtime for running TestMu-exported tests locally or on the LambdaTest grid.

Installation

pip install testmuai-playwright-bindings

Then install the Playwright browsers (one-time):

playwright install

Quick Start

Set credentials (LambdaTest grid) once in your environment:

export LT_USERNAME="your_username"
export LT_ACCESS_KEY="your_access_key"

Then write a test:

import testmu

@testmu.test
async def my_test(page):
    async with testmu.step("Open site"):
        await page.goto("https://example.com")

    async with testmu.step("Verify title"):
        await testmu.expect(page).to_have_title("Example Domain")

testmu.run(my_test)

testmu.run() is a synchronous entry point — it sets up the session, launches the browser, runs your test, and tears everything down.

Configuration

Configuration is sourced from environment variables. See .env.example for the full list. The most common ones:

Variable	Purpose	Required
LT_USERNAME	LambdaTest grid username	For cloud features
LT_ACCESS_KEY	LambdaTest grid access key	For cloud features
TESTMU_HEADLESS	true (default) or false	No
TESTMU_SMART	1 to enable vision/heal AI features	No

Test-level metadata (build, name, variables, etc.) can be passed via testmu.configure(...) at the top of generated test files.

Features

• @testmu.test — decorator that wraps async Playwright tests with session lifecycle management
• testmu.step(...) — context manager for structured test steps
• testmu.var() / testmu.set_var() — template-based variable resolution (with ATMS lookup when authed)
• Helpers — execute_js, execute_api, execute_db, vision_query, network_query, smartui_snapshot_async, and more
• Reporters — local console reporter and TestMu cloud reporter (LambdaTest dashboard)
• Self-healing locators — automatic locator recovery via heal patch (when smart mode enabled)

Requirements

• Python ≥ 3.11
• Playwright ≥ 1.57.0

Links

• PyPI: https://pypi.org/project/testmuai-playwright-bindings/
• TestMu: https://testmu.ai
• LambdaTest grid: https://www.lambdatest.com
• Issues: https://github.com/LambdaTest/testmuai-bindings/issues

License

Released under the MIT License.