pull-request-vir
TypeScript icon, indicating that this package has built-in type declarations

1.1.0 • Public • Published

pull-request-vir

GitHub Action for pull requests.

type docs: https://electrovir.github.io/pull-request-vir

usage

  1. install this package into whatever repo you're planning to use it

    • npm i pull-request-vir
  2. create a config using that import

    1. the config file can be named anything but must be JavaScript or TypeScript

    2. import definePullRequestVirConfig into the config file

    3. export its output as the default output:

      import type {Config} from 'pull-request-vir';
      
      export const config: Config = {
          // see type definition for full config options
          assignToAuthor: true,
          blockNoMerge: true,
          reviewRules: [
              {
                  autoAdd: true,
                  users: [
                      'electrovir',
                      'another-user',
                      'ghost',
                  ],
                  required: 2,
                  requiredIf: [/^src\/backend\//],
              },
          ],
      };
  3. create a GitHub Actions workflow that uses pull-request-vir:

    # recommended triggers
    on:
        pull_request_review:
            types: [submitted, dismissed]
        pull_request:
            types:
                [
                    opened,
                    reopened,
                    labeled,
                    edited,
                    ready_for_review,
                    review_requested,
                    review_request_removed,
                ]
    jobs:
        merge-checks:
            runs-on: ubuntu-latest
            steps:
                # you must checkout your repo so that pull-request-vir can read your config
                - uses: actions/checkout@v4.1.1
                - uses: electrovir/pull-request-vir@latest
                  with:
                      config_file: relative/path/to/config.ts
  4. push to GitHub and (hopefully) watch the magic

Package Sidebar

Install

npm i pull-request-vir

Weekly Downloads

158

Version

1.1.0

License

(MIT or CC0 1.0)

Unpacked Size

55.2 kB

Total Files

44

Last publish

Collaborators

  • electrovir