Skip to content

A GitHub action that verifies your pull request contains a reference to an issue.

License

Notifications You must be signed in to change notification settings

gordsport/verify-linked-issue-action

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Verify Linked Issue Action

A GitHub action that verifies your pull request contains a reference to an issue.

On a PR that does not include a linked issue or reference to an issue in the body, the check should fail and a comment will be added to the PR.

Failing checks

Installation

As a part of an existing workflow

- name: Verify Linked Issue
  uses: hattan/verify-linked-issue-action@v1.1.5
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Pleasure ensure the following types on the pull_request triggers:

  pull_request:
    types: [edited, synchronize, opened, reopened]

As a separate workflow

Inputs

(Optional) The action will add the following text to a PR when verification fails. 'Build Error! No Linked Issue found. Please link an issue or mention it in the body using #<issue_id>'

You can customize this message by providing an optional 'message' input with the string you would like to include as the comment.

- name: Verify Linked Issue
  uses: hattan/verify-linked-issue-action@v1.1.5
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  with:
    message: 'Error! This is a custom error'

File Templates

If you want a more complex message, consider using a static template file. (Support for dynamic templates will be coming soon!)

There are two options when using template files:

  • Option 1) Default File Path: Add a file to .github called VERIFY_PR_COMMENT_TEMPLATE.md. The content of this file will be used as the fail comment in the PR.
  • Option 2) Speciy a filename input with the path to a template file.
- name: Verify Linked Issue
  uses: hattan/verify-linked-issue-action@v1.1.5
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  with:
    filename: 'example/templates/fail_comment.txt'

Trying it out

  • Create a new pull request and take care to not include a linked item or mention an issue.
  • The build should fail.
  • Edit the PR body and add a reference to a valid issue (e.g. #123 )

Failed Build log

Known Issues

  • There must be a space after the issue number (ie "#12 " not "#12".) This is due to the way the RegEx is structured and will be resolved in a future release.

  • The Issue reference by # needs to be in the body, we don't currently look in the title. That is a future enhancement.

v1

About

A GitHub action that verifies your pull request contains a reference to an issue.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%