Attach QC reports to a GitHub release

Update a GitHub release with one or more QC reports, formatted in GitHub markdown.

Usage

AttachReleaseReports(
  strReleaseID = GuessReleaseID(strOwner = strOwner, strRepo = strRepo, strGHToken =
    strGHToken),
  lglCompleted = TRUE,
  lglMilestone = length(chrMilestones),
  chrMilestones = GuessMilestones(),
  dfITM = NULL,
  strRunID = Sys.getenv("GITHUB_RUN_ID"),
  strPkgRoot = ".",
  strOwner = GetGHOwner(),
  strRepo = GetGHRepo(),
  strGHToken = gh::gh_token(),
  lglWarn = TRUE,
  chrIgnoredLabels = DefaultIgnoreLabels(),
  envCall = rlang::caller_env()
)

Arguments

strReleaseID

(length-1 character) ID (typically numeric but can be very long) of a GitHub release.

lglCompleted

(length-1 logical) Whether to include the QCCompletedIssues() report.

lglMilestone

(length-1 logical) Whether to include the QCMilestones() report.

chrMilestones

(character) The name(s) of milestone(s) to filter issues by.

dfITM

(qcthat_IssueTestMatrix) A qcthat_IssueTestMatrix object as returned by AsIssueTestMatrix() (often via QCPackage()).

strRunID

(length-1 character) ID (typically numeric but can be very long) of a GitHub Actions workflow run.

strPkgRoot

(length-1 character) The path to a directory in the package. Will be expanded using gert::git_find().

strOwner

(length-1 character) GitHub username or organization name.

strRepo

(length-1 character) GitHub repository name.

strGHToken

(length-1 character) GitHub token with permissions appropriate to the action being performed.

lglWarn

(length-1 logical) Whether to warn when an extra value is included in the filter (but the report still returns results). Defaults to TRUE.

chrIgnoredLabels

(character) GitHub labels to ignore, such as "qcthat-nocov".

envCall

(environment) The environment to use for error reporting. Typically set to rlang::caller_env().

Value

dfITM, invisibly.