treeherder-cli 0.2.8

Fetch errors from a Firefox CI push on Treeherder, formatted as markdown
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

# treeherder-cli

Fetch and analyze Firefox CI logs from Treeherder.

> **Note:** This tool was previously published as `treeherder-check`. If you're upgrading, please `cargo install treeherder-cli` and update your scripts to use the new name.

## Installation

```bash
cargo install treeherder-cli
```

## Examples

```bash
# Basic: get failed jobs as markdown
treeherder-cli a13b9fc22101

# Use a Treeherder URL or a Lando commit ID instead of a revision hash
treeherder-cli "https://treeherder.mozilla.org/jobs?repo=try&revision=a13b9fc22101"
treeherder-cli 12345   # bare Lando commit ID
treeherder-cli "https://treeherder.mozilla.org/jobs?repo=try&landoCommitID=12345"

# Output as JSON
treeherder-cli a13b9fc22101 --json

# Filter by job name or platform
treeherder-cli a13b9fc22101 --filter "mochitest"
treeherder-cli a13b9fc22101 --platform "linux.*64"

# Group failures by test name (cross-platform view)
treeherder-cli a13b9fc22101 --group-by test

# Compare revisions to find regressions
treeherder-cli a13b9fc22101 --compare b2c3d4e5f678

# Check test history for intermittent detection
treeherder-cli --similar-history 543981186 --similar-count 100 --repo autoland

# Include intermittent failures
treeherder-cli a13b9fc22101 --include-intermittent

# Filter long-running jobs (>1 hour)
treeherder-cli a13b9fc22101 --duration-min 3600

# Fetch logs with pattern matching
treeherder-cli a13b9fc22101 --fetch-logs --pattern "ASSERTION|CRASH"

# Download artifacts
treeherder-cli a13b9fc22101 --download-artifacts --artifact-pattern "screenshot|errorsummary"

# Get performance/resource data
treeherder-cli a13b9fc22101 --perf

# Watch mode: poll until all jobs complete, then notify
treeherder-cli a13b9fc22101 --watch --notify
treeherder-cli a13b9fc22101 --watch --watch-interval 60  # poll every minute

# Stream failures as they appear (no need to wait for all jobs)
treeherder-cli a13b9fc22101 --stream-failures

# Show native crash stack details
treeherder-cli a13b9fc22101 --show-stack-traces
treeherder-cli a13b9fc22101 --show-stack-traces --all-crash-threads
treeherder-cli a13b9fc22101 --show-stack-traces --full-stack

# Cache logs for repeated queries
treeherder-cli a13b9fc22101 --fetch-logs --cache-dir ./logs
treeherder-cli --use-cache --cache-dir ./logs --pattern "ERROR"

# Switch repository
treeherder-cli a13b9fc22101 --repo autoland
```