Python to Maestro Converter

A simple tool to convert existing Python automation scripts (Selenium, Appium) into Maestro YAML flows.

Installation

pip install pythontomaestro

Usage

pythontomaestro <input_file> <output_dir> [--app-id APP_ID]

Example:

pythontomaestro tests/my_test.py output/ --app-id com.acme.myapp

This will read tests/my_test.py, convert the automation steps, and save the resulting YAML flows into the output/ directory (e.g., output/test_login_success.yaml).

--app-id sets the target application's Maestro appId. It defaults to com.example.app for backward compatibility; production flows should pass the real application ID.

Features

• Parses Python AST to extract automation steps.
• Maps Selenium/Appium commands (click, input, navigate) to Maestro commands (tapOn, inputText, openLink).
• Generates valid Maestro YAML flows.

⚠️ Limitations & Manual Review

Not everything can be converted automatically.

Python scripts often contain complex logic (loops, conditionals, custom helper methods) that do not map 1:1 to Maestro's declarative YAML syntax.

When the tool encounters such logic, it will:

1. Log a warning in the console.
2. Insert a TODO_UNSUPPORTED_ACTION in the generated YAML file.
3. Add a top-level warning comment to the file.

Example:

# WARNING: This flow contains unsupported actions (TODOs). Manual review required.
- tapOn:
    text: Login
- TODO_UNSUPPORTED_ACTION: 'Unsupported control flow: If statement (Suggestion: Unroll loops or use runScript for simple logic)'

You must manually review the generated YAML files and address any TODO items.

Author

Dhiraj Das · Follow @dkkkkd on X