# Golden Tests Harvester

A command-line tool that uploads golden images to Skia gold from a directory.

## Usage

This program assumes you've _already run_ a suite of golden tests that produce
a directory of images with a JSON digest named `digests.json`, which is
[documented in `lib/golden_tests_harvester.dart`][lib].

Provide the directory as the only positional argument to the program:

[lib]: lib/golden_tests_harvester.dart

```sh
dart ./tools/golden_tests_harvester/bin/golden_tests_harvester.dart <path/to/digests>
```

> [!INFO]
> Skia Gold must be setup and configured to accept the images being uploaded.
>
> In practice, that means it's the process is running on CI.

_Optionally_, you can run in `--dry-run` mode to see what would be uploaded
without actually uploading anything:

```sh
dart ./tools/golden_tests_harvester/bin/golden_tests_harvester.dart --dry-run <path/to/digests>
```

This flag is automatically set when running locally (i.e. outside of CI).