qamigrate 0.1.0

AI-powered Selenium to Playwright migration tool

QAMigrate

AI-powered test framework migration

A QATonic Innovations product.

---

QAMigrate converts test suites between frameworks automatically. It parses your code with Tree-sitter, generates equivalent code with Claude, and validates the output with the target language's compiler.

Today: Selenium Java -> Playwright Java Next: Cypress -> Playwright, TestNG -> JUnit 5, RestAssured -> Karate, and more.

What it does

Give it a Selenium file:

// Selenium
@FindBy(id = "username")
private WebElement usernameInput;

public void login(String user, String pass) {
    usernameInput.clear();
    usernameInput.sendKeys(user);
    passwordInput.sendKeys(pass);
    wait.until(ExpectedConditions.elementToBeClickable(loginButton));
    loginButton.click();
}

Get Playwright back:

// Playwright (generated by QAMigrate)
private final Locator usernameInput;

public LoginPage(Page page) {
    this.usernameInput = page.locator("#username");
}

public void login(String user, String pass) {
    usernameInput.fill(user);
    passwordInput.fill(pass);
    loginButton.click(); // Playwright auto-waits
}

Supported patterns

• @FindBy annotations (id, css, xpath, className, name, linkText)
• PageFactory.initElements removal
• WebDriverWait / ExpectedConditions removal (Playwright auto-waits)
• sendKeys -> fill, clear removal, click direct conversion
• Actions (hover, drag) -> Playwright equivalents
• Select dropdowns -> selectOption
• JavascriptExecutor -> page.evaluate()
• Alert/iframe handling
• File uploads -> setInputFiles
• TestNG -> JUnit 5 lifecycle (@BeforeMethod -> @BeforeEach, etc.)
• @DataProvider -> @MethodSource
• Assert.assertEquals/assertTrue -> Playwright assertions
• ChromeDriver setup -> Playwright.create() + browser.newContext()
• Base class inheritance preservation

Quick start

Prerequisites

• Python 3.11+
• Java 17+ (for compilation validation)
• Anthropic API key

Install

pip install qamigrate

Or from source:

git clone https://github.com/qamigrate/qamigrate.git
cd qamigrate
pip install -e .

Configure

# Set your API key
echo "ANTHROPIC_API_KEY=sk-ant-your-key" > .env

# Or export directly
export ANTHROPIC_API_KEY="sk-ant-your-key"

Migrate

# Initialize in your Selenium project
qamigrate init --project ./my-selenium-project

# Scan to see what patterns are detected
qamigrate scan --project ./my-selenium-project

# Migrate a single file
qamigrate migrate LoginPage.java --project ./my-selenium-project

# Migrate everything
qamigrate migrate --all --project ./my-selenium-project

Output goes to a playwright/ subdirectory next to each original file.

CLI commands

Command	Description
qamigrate init	Initialize QAMigrate in a Selenium project
qamigrate scan	Analyze codebase, detect patterns, show complexity
qamigrate migrate	Convert files to Playwright
qamigrate dashboard	Launch the web UI
qamigrate export	Export migration results as ZIP or report

How it works

Scanner (Tree-sitter)     Deterministic AST parsing, 70+ pattern detection
       |
Coder (Claude API)        Generates Playwright Java via structured output
       |
Compiler (javac)          Validates generated code compiles
       |
Fixer (rules + Claude)    Fixes compilation errors, retries up to 3x
       |
Output                    Clean Playwright Java file

No frameworks, no LangChain -- just a plain Python pipeline calling each step in sequence.

Configuration

Create qamigrate.yaml in your project root (or run qamigrate init):

coder:
  model: "claude-sonnet-4-20250514"
  max_tokens: 8192

compiler:
  build_tool: "maven"    # or "gradle"
  java_version: "17"
  skip: false            # set true if Playwright JARs not available locally

supervisor:
  max_retries: 3

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run linter
ruff check src tests

# Run tests
pytest tests -v

License

MIT