reviewpad/action-dev repository overview

⁠Reviewpad GitHub Action

🔥 Latest Stable Version: v3.x (Faro⁠ Edition)

🤔 For questions, check out the discussions⁠.

📃 For documentation, check out this document and the official documentation⁠.

🙌 Join our community on discord⁠!

This action runs the docker image reviewpad/action⁠.

It reads and automates the pull request workflows specified in the reviewpad.yml configuration file.

These workflows can be used to automatically label, assign reviewers, comment, merge and close pull requests.

For example, the following reviewpad.yml file:

api-version: reviewpad.com/v3.x

workflows:
  - name: label-pull-request-with-size
    if:
      - rule: $size() <= 50
        extra-actions:
          - $addLabel("small")
      - rule: $size() > 50 && $size() <= 150
        extra-actions:
          - $addLabel("medium")
      - rule: $size() > 150
        extra-actions:
          - $addLabel("large")

Specifies a workflow to automatically add a label based on the size of the pull request.

For more information on the release procedure, check the RELEASE.md⁠ document.

⁠Inputs

• event: The GitHub event context that trigger the action. Uses default ${{ toJSON(github) }}
• file: The local location of the Reviewpad configuration file. Uses default ./reviewpad.yml. Ignored if file_url is set.
• file_url (OPTIONAL): The remote location of the Reviewpad configuration file. If set, it will ignore the input file.
• token: Uses default ${{ github.token }}

⁠Usage

⁠Basic

Add the following step to your GitHub Action job:

- name: Run reviewpad action
  uses: reviewpad/[email protected]

⁠:link: Remote configuration

You can run reviewpad action with a remote configuration by setting the input file_url:

- name: Run reviewpad action
  uses: reviewpad/[email protected]
  with:
    file_url: https://github.com/reviewpad/action/blob/main/templates/start.yml

⁠:key: GitHub token

By default this action uses the github-actions[bot] token.

As described in the official GitHub documentation⁠:

If you want to use more advanced features such as the merge⁠ feature, we recommend that you explicitly provide a PAT (Personal Access Token) to run this action:

- name: Run reviewpad action
  uses: reviewpad/[email protected]
  with:
    token: ${{ secrets.GH_TOKEN }}

Please follow this link to know more⁠.