feat: add create-project-card and move-project-card helpers (#25)

Author: salvadorgonmo

.github/workflows/create-project-card.yml

@@ -0,0 +1,22 @@
+name: Create Project Card
+
+on:
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'src/helpers/create-project-card.ts'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - uses: ./
+        with:
+          helper: create-project-card
+          project_name: 'test project'
+          project_destination_column_name: 'test column 1'
+          pull_number: ${{ github.event.pull_request.number }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/move-project-card.yml

@@ -0,0 +1,23 @@
+name: Move Project Card
+
+on:
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'src/helpers/move-project-card.ts'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - uses: ./
+        with:
+          helper: move-project-card
+          project_name: 'test project'
+          project_origin_column_name: 'test column 1'
+          project_destination_column_name: 'test column 2'
+          pull_number: ${{ github.event.pull_request.number }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -13,6 +13,13 @@ Each of the following helpers are defined in a file of the same name in `src/hel
 ### [**assign-pr-reviewers**](.github/workflows/assign-pr-reviewers.yml)
   * Randomly assigns members of a github team to review a PR. If `login` is provided, it does nothing if that user is already part of the team
   * You can also pass a `slack_webhook_url` to notify the assignees that they are assigned to the PR!
+### [**create-project-card**](.github/workflows/create-project-card.yml)
+  * Creates a Project card into your GitHub Project repository by providing a `project_name` and `project_destination_column_name` in which the card should be created.
+  * If `note` is provided, it will add that information into the card. If it is not provided, it will use the PR information details to populate it.
+  * Useful when opening a pull request and want to track its information details into a GitHub Project.
+### [**move-project-card**](.github/workflows/move-project-card.yml)
+  * Moves a GitHub Project card to a new column, using the `project_origin_column_name` and`project_destination_column_name` you provide.
+  * In order to move a card from one place to another, it must already exist.
 ### [**auto-approve-pr**](.github/workflows/auto-approve-pr.yml)
   * Automatically approves a PR if the reviewer's login matches the provided login
 ### [**check-pr-title**](.github/workflows/check-pr-title.yml)

action.yml

@@ -13,6 +13,18 @@ inputs:
   pull_number:
     description: 'The pull request number'
     required: false
+  project_name:
+    description: 'The GitHub Project name'
+    required: false
+  project_destination_column_name:
+    description: 'The name of the column that the card should be created or moved to'
+    required: false
+  note:
+    description: 'The body text that should be added into a Project Card'
+    required: false
+  project_origin_column_name: 
+    description: 'The name of the column from where the card should be taken'
+    required: false
   sha:
     description: 'The commit hash'
     required: false