Manual Setup

If there is not yet an integration for your CI service, you can upload reports manually using an tool you're comfortable with. The examples here use cURL.

curl "https://api.check-run-reporter.com/api/v1/submissions" \
  --user token:88888888-4444-4444-4444-aaaaaaaaaaaa \
  -X POST \
  -F report=@"./reports/junit.xml" \
  -F label="Unit Tests" \
  -F sha="$CIRCLE_SHA1" \
  -F root="$(pwd)"

Authorization

Report uploads are authorized using basic authorization. The user should always be "token". Each repository has its own token. You can find your repository tokens on the Repositories page.

Parameters

report

Path to the report file. May be specified more than once.

label

Label used in the GitHub UI to describe this submission. Common labels might be "Unit Tests", "ESLint", etc.

sha

The commit corresponding to this Check Run. This is available as an environment variable in most CI systems. For example, it's $CIRCLE_SHA1 on CircleCI and $BUILDKITE_COMMIT on Buildkite.

root

Stacktraces and (often) test reports contain the full filesystem path to failed test files or thrown exceptions. In order to annotate GitHub Pull Requests, we need those paths to be relative to the repository root. The root parameter should be the filesystem path to the checkout directory. Often, this can simply be "$(pwd)".