Move labeled or milestoned pull request

Use Case

Everytime a specific label is added to an pull request (or pull request added to a milestone), the associated card in a project should be moved to a specific column. For example, you want any pull request that gets labeled with "priority" to automatically move to the column that corresponds to "on deck". If the pull request is not on the project board, it will be created in the desired column. If it has already been added, it will be moved to the correct column.

This action can be used for projects that are linked and setup at the org level or repository level. The token that is supplied though must have repo permissions. If the project is linked at the org level, it must also have org:read permissions.

Input

Input	Description
action-token	An access token that will be used to move or create an pull request in a desired column. The standard token that is present for each action will not be sufficient as it does not have sufficient privilages. You must create one that has repo permissions (see below)
project-url	The url of the project. Will be something like https://github.com/orgs/github/projects/1 or https://github.com/konradpabjan/example/projects/1
column-name	The name of the column in project that pull requests should be moved to
label-name	The label that should trigger an pull request to be moved to a specific column (mutually exclusive with milestone-name). Use * to use it with any label
milestone-name	The milestone that should trigger an pull request to be moved to a specific column (mutually exclusive with label-name)
delete-card	"true" if you want to delete the card from the project
columns-to-ignore	Comma separated list of column names that should be ignored. If an pull request/card already exists in a column with one of the names, it will be ignored. Use * to ignore all columns. This is optional

Creating an action-token

• Create a new personal access token with the appropriate permissions at https://github.com/settings/tokens
• Add the personal access token to your repository secrets: https://github.com/organization_name/repository_name/settings/secrets (for an organization), https://github.com/repository_owner/repository_name/settings/secrets (for a standard repository), and remember the name
• Use the newly saved token in your YAML file as input for action-token. In the example below, it is called MY_TOKEN

Example YAML (label)

This YAML is meant to be triggered whenever an pull request has been labled.

on:
  pull requests:
    types: [labeled]
jobs:
  Move_Labeled_Issue_On_Project_Board:
    runs-on: ubuntu-latest
    steps:
    - name: Ready for QA
      uses: pauldruziak/move-labeled-or-milestoned-pull-request@v1.0.2
      with:
        action-token: "${{ secrets.MY_TOKEN }}"
        project-url: "https://github.com/orgs/github/projects/1"
        column-name: "Ready for QA"
        label-name: "qa"
        columns-to-ignore: "QA in progress,QA passed,QA failed"
    - name: QA in progress
      uses: pauldruziak/move-labeled-or-milestoned-pull-request@v1.0.2
      with:
        action-token: "${{ secrets.MY_TOKEN }}"
        project-url: "https://github.com/orgs/github/projects/1"
        column-name: "QA in progress"
        label-name: "qa in progress"
    - name: QA passed
      uses: pauldruziak/move-labeled-or-milestoned-pull-request@v1.0.2
      with:
        action-token: "${{ secrets.MY_TOKEN }}"
        project-url: "https://github.com/orgs/github/projects/1"
        column-name: "QA passed"
        label-name: "qa passed"
    - name: QA failed
      uses: pauldruziak/move-labeled-or-milestoned-pull-request@v1.0.2
      with:
        action-token: "${{ secrets.MY_TOKEN }}"
        project-url: "https://github.com/orgs/github/projects/1"
        column-name: "QA failed"
        label-name: "qa failed"
    - name: WIP
      uses: pauldruziak/move-labeled-or-milestoned-pull-request@v1.0.2
      with:
        action-token: "${{ secrets.MY_TOKEN }}"
        project-url: "https://github.com/orgs/github/projects/1"
        label-name: "wip"
        delete-card: "true"

Example YAML (milestone)

This YAML is meant to be triggered whenever an pull request has been milestoned.

on:
  pull requests:
    types: [milestoned]
jobs:
  Move_Milestoned_Issue_On_Project_Board:
    runs-on: ubuntu-latest
    steps:
    - uses: pauldruziak/move-labeled-or-milestoned-pull-request@v1.0.2
      with:
        action-token: "${{ secrets.MY_TOKEN }}"
        project-url: "https://github.com/orgs/github/projects/1"
        column-name: "On Deck"
        milestone-name: "v1.0"
        columns-to-ignore: "In Review,Ready to deploy,Done"