@ckeditor/ckeditor5-dev-stale-bot
v44.0.0
Published
A stale bot is used to mark issues and pull requests that have not recently been updated.
Downloads
7,552
Readme
CKEditor 5 Stale bot
A stale bot is used to mark issues and pull requests that have not recently been updated.
More information about development tools packages can be found at the following URL: https://github.com/ckeditor/ckeditor5-dev.
Usage
To execute the stale bot, run the following command:
yarn run ckeditor5-dev-stale-bot [<args>...]
This script accepts the following arguments:
--config-path
– Required. Path to a JSON or JavaScript file containing stale bot configuration.--dry-run
– Optional,false
by default. Allows disabling any changes to GitHub if set totrue
. By default stale bot makes use of your real, live, production data.
Configuration
The following configuration options are supported by the stale bot:
GITHUB_TOKEN
– Required. A GitHub token with therepo:*
scope needed for managing repositories and issues.REPOSITORY_SLUG
– Required. The repository name in the format ofowner/name
, where stale bot will check for stale issues and pull requests.STALE_LABELS
– Required. A list of labels to add on staled issues and pull requests.CLOSE_ISSUE_LABELS
– Required. A list of labels to add after closing a stale issue.CLOSE_PR_LABELS
– Required. A list of labels to add after closing a stale pull request.STALE_ISSUE_MESSAGE
– Required. A comment that is added on the staled issues.STALE_PR_MESSAGE
– Required. A comment that is added on the staled pull requests.CLOSE_ISSUE_MESSAGE
– Required. A comment that is added on the closed issues.CLOSE_PR_MESSAGE
– Required. A comment that is added on the closed pull requests.DAYS_BEFORE_STALE
– Optional, 365 by default. The number of days without the required activity that qualifies an issue or pull request to be marked as stale. The dates taken into account are:- the creation date,
- the last date of editing an issue or pull request,
- the last date of adding a reaction to the body of issue or pull request,
- the last date of adding or editing a comment,
- the last date of changing a label.
DAYS_BEFORE_STALE_PENDING_ISSUE
– Optional, 14 by default. The number of days without a comment on pending issue from a non-team member that qualifies the issue to be marked as stale.PENDING_ISSUE_LABELS
– Optional, an empty array by default. A list of labels that identify a pending issue. If empty, then pending issues are not processed.STALE_PENDING_ISSUE_MESSAGE
– Optional, set to the value fromSTALE_ISSUE_MESSAGE
by default. A comment that is added on the staled pending issues.DAYS_BEFORE_CLOSE
– Optional, 30 by default. The number of days before closing the stale issues or the stale pull requests.IGNORE_VIEWER_ACTIVITY
– Optional,true
by default. If set, the activity from the currently authenticated user is ignored.IGNORED_ISSUE_LABELS
– Optional, an empty array by default. A list of labels, whose assignment to an issue causes the issue to be ignored, even if it fits the stale criteria.IGNORED_PR_LABELS
– Optional, an empty array by default. A list of labels, whose assignment to a pull request causes the pull request to be ignored, even if it fits the stale criteria.IGNORED_ACTIVITY_LABELS
– Optional, an empty array by default. A list of labels, whose assignment to an issue or pull request is not counted as an activity event.IGNORED_ACTIVITY_LOGINS
– Optional, an empty array by default. A list of GitHub logins, whose activities are not counted.
Changelog
See the CHANGELOG.md
file.
License
Licensed under the terms of GNU General Public License Version 2 or later. For full details about the license, please check the LICENSE.md
file.