suupr_tests_cli 1.0.0-beta.4

Headless CLI runner for automated Suupr Tests in CI/CD environments.

Suupr Tests CLI Runner

Warning

BETA STATUS: This package is currently in Beta. We are actively refining the API to improve performance and orchestration capabilities. Breaking changes may occur between beta releases. Please pin your version and check the CHANGELOG before updating.

A standalone, headless CLI tool for running automated Suupr Tests in CI/CD environments.

Features

• Headless Execution: Launch your Flutter app in machine mode and run your tests without manual intervention.
• Smart Connection: Automatically handshakes with the Dart VM Service and elects the correct UI isolate.
• Advanced Reporting: Color-coded terminal output showing PASSED, FAILED, and SKIPPED statuses.
• Recursive Suites: Point the CLI to a directory (e.g., test/suuprtests/) and it will automatically crawl for and execute every .json suite found in subdirectories.
• CI Ready: Exits with non-zero codes on failure, making it perfect for GitHub Actions, GitLab CI, and Bitrise.

Installation

Add suupr_tests_cli as a dev dependency to your project:

dart pub add dev:suupr_tests_cli

Usage

# Run a single suite
dart run suupr_tests_cli run --app-path=./my_app ./test/suuprtests/login_flow.json

# Run all suites in a directory recursively
dart run suupr_tests_cli run --app-path=./my_app ./test/suuprtests/

CI/CD Orchestration

For a "Zero-Touch" automation setup, check out our Sample GitHub Actions Workflow. It demonstrates how to automate your entire testing fleet with a single gatekeeping step.

Options

• --app-path: (Required) The path to the root of your target Flutter project.
• --device-id: (Optional) The specific target device ID (e.g., macos, linux, emulator-5554).
• --help: Show usage information.

License

MIT