Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
tag

GitHub Action

Multi Labeler

v1.5.1

Multi Labeler

tag

Multi Labeler

Multi labeler for title, body, comments, commit messages, branch, author or files with automated status checks

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: Multi Labeler

              
  uses: fuxingloh/multi-labeler@v1.5.1
Learn more about this action in fuxingloh/multi-labeler

Choose a version

Multi Labeler

codecov CodeFactor Release License MIT

Multi labeler for title, body, comments, commit messages, branch, author or files. Optionally, generate a status check based on the labels.

Features

Psst! For a more wholesome OSS governance solution check out DeFiCh/oss-governance-bot. I am also the main contributor for the GitHub Action.

  • Single compiled javascript file, extremely fast. Use fewer credits!
  • Append based multi-labeler, using .github/labeler.yml as config.
  • Automatically fail if labeler.yml is malformed, type-checked.
  • Set label to sync for conditional labeling, removed if condition failed.
  • Regex Matcher:
    • PR/Issue title
    • PR/Issue body
    • PR/Issue comments
    • PR commit messages
    • PR branch name
  • File Matcher:
    • Files count
    • Files any glob match
    • Files all glob match
  • Author Matcher
  • Generate status checks:
    • Any label match
    • All label match

Usage

.github/workflow/labeler.yml

on:
  pull_request_target: # for OSS with public contributions   
  pull_request:   
  # Useful for triaging code review, and generate compliance status check.
  # Semantic release? Done.
  # Make a file change in a mono repo. Tag the mono repo getting changed to generate better release!
  
  issues:         
  # Useful for triaging error!
  # '- [x] Is this a bug?' = 'bug' label!
  
  issue_comment:
  # To pickup comment body in pr or issue and generate a label. 
  # Imagine someone comment 'Me too, I get TimeoutException from ...' in comment body. 
  # Generate a 'bug/timeout' label for better triaging!

jobs:
  labeler:
    name: Labeler
    runs-on: ubuntu-latest
    steps:
      # follows semantic versioning. Lock to different version: v1, v1.5, v1.5.0 or use a commit hash.
      - uses: fuxingloh/multi-labeler@v1 
        with:
          github-token: ${{secrets.GITHUB_TOKEN}} # optional, default to '${{ github.token }}'  
          config-path: .github/labeler.yml # optional, default to '.github/labeler.yml'

.github/labeler.yml

# .github/labeler.yml

version: v1

labels:
  - label: "feat"
    sync: true # remove label if match failed, default: false (pull_request/issue only)
    matcher:
      # Matcher will match on any 7 matcher
      title: "^feat:.*"
      body: "/feat"
      comment: "/feat"
      branch: "^feat/.*"
      commits: "^feat:.*"
      author:
        - github-actions
        - fuxingloh
      files:
        any: [ "app/*" ]
        all: [ "!app/config/**" ]
        count:
          gte: 1
          lte: 1000

# Optional, if you want labels to generate a success/failure status check
checks:
  - context: "Status Check"
    url: "https://go.to/detail"
    description:
      success: "Ready for review & merge."
      failure: "Missing labels for release."
    labels:
      any:
        - any
        - have
      all:
        - all
        - must
        - have

Examples

Semantic Pull Request

.github/workflow/pr-triage.yml

on:
  pull_request:
    types: [ opened, edited, synchronize, ready_for_review ]
    branches: [ master, main ]

jobs:
  labeler:
    name: Labeler
    runs-on: ubuntu-latest
    steps:
      - uses: fuxingloh/multi-labeler@v1

.github/labeler.yml

version: v1

labels:
  - label: "feat"
    matcher:
      title: "^feat: .*"
      commits: "^feat: .*"

  - label: "fix"
    matcher:
      title: "^fix: .*"
      commits: "^fix: .*"

  - label: "chore"
    matcher:
      title: "^chore: .*"
      commits: "^chore: .*"

  - label: "docs"
    matcher:
      title: "^docs: .*"
      commits: "^docs: .*"

checks:
  - context: "Semantic Pull Request"
    url: "https://github.com/fuxingloh/multi-labeler/blob/main/.github/labeler.yml"
    description:
      success: Ready for review & merge.
      failure: Missing semantic label for merge.
    labels:
      any:
        - feat
        - fix
        - chore
        - docs
PR Triage

.github/workflow/pr-triage.yml

on:
  pull_request:
    types: [ opened, edited, synchronize, ready_for_review ]
    branches: [ master, main ]

jobs:
  labeler:
    name: Labeler
    runs-on: ubuntu-latest
    steps:
      - uses: fuxingloh/multi-labeler@v1

.github/labeler.yml

version: v1

labels:
  - label: "feat"
    matcher:
      title: "^feat:.*"
      branch: "^feat/.*"
      commits: "^feat:.*"

  - label: "fix"
    matcher:
      title: "^fix:.*"
      branch: "^fix/.*"
      commits: "^fix:.*"
Issue Triage

.github/workflow/issue-triage.yml

on:
  issues:
    types: [ opened, edited ]

jobs:
  labeler:
    name: Labeler
    runs-on: ubuntu-latest
    steps:
      - uses: fuxingloh/multi-labeler@v1

.github/labeler.yml

version: v1

labels:
  - label: "bug"
    matcher:
      body: "(\\n|.)*- \\[x\\] bug(\\n|.)*"
Comment Triage

.github/workflow/comment-slash.yml

on:
  issue_comment:
    types: [ created, edited ]

jobs:
  labeler:
    name: Labeler
    runs-on: ubuntu-latest
    steps:
      - uses: fuxingloh/multi-labeler@v1

.github/labeler.yml

version: v1

labels:
  - label: "coverage"
    matcher:
      comment: "# \\[Codecov\\] .*"

  - label: "stale"
    matcher:
      comment: "/stale"

Configuration

Once you’ve added multi-labeler to your repository, it must be enabled by adding a .github/labeler.yml configuration file to the repository.

Matchers

PR/Issue Title: RegEx

version: v1

labels:
  - label: "feat"
    matcher:
      title: "^feat:.*"

PR/Issue Body: RegEx

version: v1

labels:
  - label: "bug"
    matcher:
      # e.g. '- [x] bug'
      body: "(\\n|.)*- \\[x\\] bug(\\n|.)*"

PR/Issue Comment: Regex

version: v1

labels:
  - label: "stale"
    matcher:
      comment: "/stale"

PR Branch: RegEx

version: v1

labels:
  - label: "feat"
    matcher:
      branch: "^feat/.*"

PR Commits: RegEx

Check all commits and find any match, max of 250 commits only.

version: v1

labels:
  - label: "feat"
    matcher:
      commits: "^feat: .*"

PR/Issue Author

Check for pr or issue author match.

version: v1

labels:
  - label: "single"
    matcher:
      author: "fuxingloh"
  - label: "any"
    matcher:
      author:
        - adam
        - claire

PR Files: Glob Matcher

Maximum of 3000 files only. If you use this to audit changes, take note of the 3000 files limitation. Matcher within files are 'and condition', all must match.

PR Files Basic

version: v1

labels:
  - label: "github"
    sync: true
    matcher:
      # This is shorthand for any: [".github/**"]
      files: ".github/**"

  - label: "security"
    sync: true
    matcher:
      # This is shorthand for any: ["web/security/**", "security/**"]
      files: [ "web/security/**", "security/**" ]

PR Files Count

version: v1

labels:
  - label: "size: s"
    sync: true
    matcher:
      files:
        count:
          gte: 1
          lte: 4

  - label: "size: m"
    sync: true
    matcher:
      files:
        count:
          gte: 5
          lte: 10

  - label: "size: l"
    sync: true
    matcher:
      files:
        count:
          gte: 11

PR Files Any & All

version: v1

labels:
  - label: "ci"
    sync: true
    matcher:
      files:
        any: [ ".github/workflow/**", ".circleci/**" ]
        all: [ "!app/**" ]

  - label: "attention"
    sync: true
    matcher:
      files:
        any: [ "app/**" ]
        count:
          neq: 1

PR Status Checks

PR Check any

version: v1

checks:
  - context: "Release Drafter"
    url: "https://go.to/detail"
    description:
      success: "Ready for review & merge."
      failure: "Missing labels for release."
    labels:
      any:
        - feat
        - fix
        - chore
        - docs

PR Check any + all

version: v1

checks:
  - context: "Merge check"
    description: "Labels for merge."
    labels:
      any: [ "reviewed", "size:s" ]
      all: [ "app" ]

Why?

There are so many labeler why create another? 😧

  1. I want a lightweight labeler that is written in TypeScript so that it don't have to build a docker image everytime it runs.
  2. I want a simple match first append based multi-labeler without it being a turing complete solution.
  3. I want to write my rules with .github/labeler.yml for a single source of label truth.
  4. I don't want it to do anything else, labels only.
    1. Assume you are using GitHub branch protection (labels only).
    2. I want to run this in PR triage before everything else (labels only).
    3. Chain this action with another action; this should just be for (labels only).