blob: 1b1155b935d481c1e104d9b685f0f5c87ac6e541 [file] [view]
# CI Info Scripts
This directory contains Dart scripts for interacting with LUCI/Buildbucket to analyze CI runs in `flutter/packages`. These scripts are useful for diagnosing CI failures and flakes.
No credentials or LUCI access are needed. Flutter's builds are public, and the scripts make only unauthenticated requests to Buildbucket.
## Usage
### Setup
Fetch dependencies once, then run the scripts from the repository root through
`run.sh`:
```bash
dart pub get -C script/ci_info
script/ci_info/run.sh <script> [args...]
```
If dependencies are missing or `pubspec.yaml` has changed since they were
fetched, `run.sh` exits and asks you to run `dart pub get` again.
`run.sh` uses the Dart SDK bundled with Flutter directly rather than Flutter's
`dart` wrapper, so several scripts can run in parallel without waiting on
Flutter's startup lock.
### Scripts
#### `bin/find_builds.dart`
Finds LUCI builds for a given Pull Request or commit SHA.
**Usage:**
```bash
script/ci_info/run.sh find_builds [options]
```
**Options:**
- `--pr`: GitHub PR number (presubmit tryjobs).
- `--commit`: Full commit SHA (postsubmit builds).
- `--repo`: Repository `owner/name` (defaults to `flutter/packages`).
- `--project`: LUCI project (defaults to `flutter`).
- `--limit`: Max builds to retrieve (defaults to `400`).
- `--[no-]failed-only`: Only show failed builds (`FAILURE` or `INFRA_FAILURE`).
- `--[no-]json`: Output as JSON.
- `-h`, `--help`: Print usage information.
### Common Features
- **Caching**: All scripts cache network responses under `<system-temp>/ci_info_cache` (or the directory specified by the `CI_INFO_CACHE` environment variable) to speed up repeated runs.
## Development
Shared logic lives in `lib/` and unit tests live in `test/`. When making changes,
run the unit tests, analyzer, and formatter from `script/ci_info`:
```bash
cd script/ci_info
dart pub get
dart test
dart analyze --fatal-infos
dart format .
```