NAME

repomatic apply-labels - Label an issue or PR from its content and changed files

SYNOPSIS

repomatic apply-labels [OPTIONS]

DESCRIPTION

Label a freshly opened issue or pull request from the project's rules.

Two rule families, both tables under `[tool.repomatic.labels]` mapping a label to the patterns that apply it, overlaid on the bundled defaults:



  content-rules  keywords or /regex/flags matched against the title and


                 body, of an issue or a pull request alike


  file-rules     globs matched against the paths a pull request changes

Additive only. A label already on the thread stays, and none is ever removed, so a classification made by hand survives every later run.

This pre-labels for the maintainer's first pass and never replaces it, so the rules are tuned for precision: a missing label costs one click, a wrong one is noise on every issue that trips it.

Requires the gh CLI to be authenticated.

OPTIONS

--number INTEGER RANGE: Issue or PR number. Defaults to the number in $GITHUB_EVENT_PATH.
--pr / --issue: Specify issue or pull request. Auto-detected from $GITHUB_EVENT_PATH.
--repo TEXT: Repository in 'owner/repo' format. Defaults to $GITHUB_REPOSITORY.
--dry-run / --live: Report what would be done without making changes.
--help / -h: Show this message and exit.

ENVIRONMENT

APPLY_LABELS_NUMBER: Issue or PR number. Defaults to the number in $GITHUB_EVENT_PATH.
APPLY_LABELS_IS_PR: Specify issue or pull request. Auto-detected from $GITHUB_EVENT_PATH.
GITHUB_REPOSITORY: Repository in 'owner/repo' format. Defaults to $GITHUB_REPOSITORY.
APPLY_LABELS_REPO: Repository in 'owner/repo' format. Defaults to $GITHUB_REPOSITORY.
APPLY_LABELS_DRY_RUN: Report what would be done without making changes.
APPLY_LABELS__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

EXAMPLES

Preview what the current event's issue or PR would earn

repomatic apply\-labels

Apply them, as the labeller job does

repomatic apply\-labels \-\-live

Manual invocation against one pull request

repomatic apply\-labels \-\-live \-\-pr \-\-number 42

AUTHORS

Kevin Deldycke