patrol_cli
4.9.0, released 3 weeks ago by leancode.co
Command-line tool to run and debug Patrol UI tests on multiple platforms
What it does
Patrol CLI activates globally and provides commands such as `patrol test` and `patrol coverage pull` to execute end‑to‑end UI tests and collect coverage. It supports native interactions, shell completion, and analytics control.
AI-written summary of version 4.9.0, based on the package's README and metadata. Report an inaccuracy
Use it when
- You need to run Patrol tests from CI or locally via terminal
- You want to generate coverage reports for Android and Dart code
- You need shell completion for bash/zsh/fish
Skip it when
- You only run tests inside IDE or via Flutter's integration_test
- You need a GUI test runner
- You are on a platform not supported by Patrol
Strengths
- Cross‑platform support (Android, iOS, web, desktop)
- Handles native interactions beyond integration_test
- CLI offers shell completion and analytics opt‑out
- Coverage extraction for JaCoCo and Dart
Weaknesses
- Requires Dart >=2.18
- Relies on external tools like adb, idevicesyslog
- Not a library, only a CLI tool
- Limited to Patrol framework
Setup
- Kind
- Pure Dart
- Effort
- Medium
- Code generation
- No
- Direct dependencies
- 24
Activate globally with `dart pub global activate patrol_cli`; add `$HOME/.pub-cache/bin` to PATH; ensure Dart >=2.18 and platform tools (adb, Xcode) are installed.
```bash
$ dart pub global activate patrol_cli
$ patrol test
```Alternatives
Packages that do the same job and could replace patrol_cli.
- fluttersdk_dusk
Flutter E2E test driver for LLM agents and CLI via VM Service extensions without a test harness.
77Compare - test_rocket
A command-line tool to execute Dart and Flutter tests at high speed.
77Compare - flame_test
Classes and helpers for testing applications built with the Flame Engine.
80Compare - test
A full featured library for writing and running Dart tests across platforms.
90Compare
Works with
Packages commonly used together with patrol_cli: ones it builds on, ones built on it, and its own family.
- vm_servicepatrol_cli depends on itA library to communicate with a service implementing the Dart VM service protocol.
- yamlpatrol_cli depends on itA Dart library for parsing YAML documents into Dart data structures.
- uuidpatrol_cli depends on itGenerates and parses RFC‑4122/9562 UUIDs (v1‑v8) for Dart.
- globpatrol_cli depends on itA file and directory globbing library that supports Bash-style path matching and listing.
- package_configpatrol_cli depends on itRead and write Dart package configuration files.
- platformpatrol_cli depends on itCross‑platform abstraction for querying runtime platform info in Dart.
- coveragepatrol_cli depends on itCollects, manipulates, and formats code coverage data in Dart
- processpatrol_cli depends on itPluggable, mockable process invocation abstraction for Dart.