cambiahealth/project-bot-retired

This repo has been archived and is now read-only

Do you like the idea of GitHub's Project Automation feature but find it lacking?

This bot will automatically add new Issues or Pull Requests to a Project board based on specially formatted Cards in each Column of a Project. It also allows you to customize the rules for moving Issues between Columns.

Installation

Go to the project-bot GitHub App page and click [Install] (or [Configure] if you already installed it) to have it run on Public Project Boards.

To see what it looks like, you can look at the GitHub projects for this repository.

Example

To create an Automation Card, create a Card in a Project like this:

###### Automation Rules

<!-- Documentation: https://github.com/cambiahealth/project-bot -->

- `assigned_issue`
- `closed_issue`
- `added_label` **wontfix**
- `new_pullrequest` **repo1** **repo2**

Now, whenever any Issue that is assigned, or closed, or a wontfix label is added, or a new Pull Request is opened on the repo1 or repo2 repository will show up in this Column.

Syntax

This bot uses normal Project Board note cards with Markdown formatting for configuration.

Automation Cards

Automation Cards are identified by the string ###### Automation Rules that has to be used in the note text
The automation card must be at any the top or bottom of a column (but they tend to end up at the bottom as new cards are added at the top automatically)
There can be multiple automation cards per column, but you will probably not need that (unless you have many rules or add items from many repositories)
An automation card can contain other text besides the headline and rules if you really need it to (but best avoid other lists to confuse the parser)

Rules

Rules have to be listed in an unnumbered list in the Automation Card
This list can contain as many rules as you like
The rule (see list below) should to be wrapped in ` like so:
```
- `example_rule`
```
Rule Parameters should be wrapped in ** like so:
```
- `example_rule` **param 1** **param 2**
```
Items are added or moved into the column when any of the rules in the list are triggered. (It is currently not possible to use boolean logic to combine any rules.)

Available Rules

The following rules can be included in automation cards:

Add items

To add items to the project board, you have these two rules:

new_issue: When an Issue is created (optionally, a space-separated set of repo names)
new_pullrequest: When a Pull Request is created (optionally, a space-separated set of repo names)

Example automation card

The following will add issues and pull requests from repo1 and repo2 to the project (note the lack of the org prefix)

###### Automation Rules
- `new_issue` **repo1** **repo2**
- `new_pullrequest` **repo1** **repo2**

Move items

After an item has been added to a project board (manually or by the previous rules) it can be moved to another column by one of the following rules:

Issues

edited_issue: When an Issue is edited
assigned_issue: When an Issue is assigned to a user (but was not before)
assigned_to_issue: When an Issue is assigned to a specific user
unassigned_issue: When an Issue is no longer assigned to a user
milestoned_issue: When an Issue is added to a Milestone
demilestoned_issue: When an Issue is removed from a Milestone
closed_issue: When an Issue is closed
reopened_issue: When an Issue is reopened

Pull Requests

assigned_pullrequest: When a Pull Request is assigned to a user (but was not before)
unassigned_pullrequest: When a Pull Request is no longer assigned to a user
added_reviewer: (optional username or array of usernames that need to be added)
accepted_pullrequest: When at least one Reviewer Accepted, and there are no Rejections on a Pull request
merged_pullrequest: When a Pull Request is merged
closed_pullrequest: When a Pull Request is closed
reopened_pullrequest: When a Pull Request is reopened

Labels

added_label: (requires exactly one argument, the string representing the name of the label)
removed_label: (requires exactly one argument, the string representing the name of the label)

Other

Not finding the event you would like? Just create a new Issue in this Repository!

Screencap

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Awaiting Schedule

These updates are awaiting their schedule. Click on a checkbox to get an update now.

⬆️ Update dependency commonmark to ^0.30.0
⬆️ Update dependency @probot/serverless-lambda to v1
⬆️ Update dependency acorn to v8
⬆️ Update dependency jest to v29
⬆️ Update dependency nock to v13
⬆️ Update dependency probot to v12
⬆️ Update dependency standard to v17
⬆️ Lock file maintenance

Detected dependencies

circleci

.circleci/config.yml

sb 1

node 5

js 1

npm

package.json

@probot/serverless-lambda ^0.5.0

acorn ^6.4.2

commonmark ^0.29.0

probot ^10.19.0

jest ^24.8.0

nock ^10.0.6

smee-client ^1.1.0

standard ^13.1.0

travis

.travis.yml

node 18

Check this box to trigger a request for Renovate to run again on this repository

cambiahealth / project-bot-retired Goto Github PK

project-bot-retired's Introduction