tc-fetch 0.4.1

Download taskcluster artifacts
Documentation

tc-fetch

Fetch artifacts from taskcluster.

This is a small utility application designed to download and fetch logs from TaskCluster-based CI systems.

In particular it's built for use with Mozilla's CI and web-platform-tests CI.

Command line usage

tcfetch [--out-dir <path>] [--artifact-name <name>] [--filter-jobs <expression>]* <repo> <commit>

By default tcfetch is configured to fetch web-platform-tests results in wptreport format.

Valid repo names are:

commit must be the hash of a commit in the corresponding repository. For Mozilla repositories the minimum commit prefix is 12 characters. For web-platform-tests, anything non-ambiguous should work.

--out-dir - The path to put the downloaded artifact files.

--artifact-name - The name of the artifact to download (currently implemented as a suffix match on the full path).

--filter-jobs - A filter string used to select the task names to include. This is a string that's interpreted as a regex. If the string starts with !, any matching jobs are excluded. If the string starts with ^ (after removing any !), it's used as a regexp against the full task name, otherwise it's used as a substring match.

For example to fetch all Firefox logs from web-platform-tests commit 0f123ad and put them in a directory called logs:

tcfetch --out-dir logs --filter-jobs '-firefox-' wpt 0f123ad