jira-reviews-reminder 0.1.2

Notifies in Slack channel with a list of jira tickets that have pending review from x days. Adds the reviewer and PR details if exists.

# Slack Bot Jira Review Reminder Notifies in Slack channel with a list of jira tickets that have pending review from x days. Adds the reviewer and PR details if exists.

###Installation `buildoutcfg pip install jira-reviews-reminder ` ### Usage

After installing the package run below command: `buildoutcfg SLACK_TOKEN=<your slack token> SLACK_CHANNEL=<> JIRA_PROJECT=<> JIRA_USER=<jira user email/ID> JIRA_TOKEN=<> IGNORE_JIRA=<> ISSUE_CHANGED_BEFORE=<> JIRA_SERVER=<> ISSUE_PAGE_SIZE=<> SLACK_USERS_GROUP=<> JIRA_REVIEWER_FIELD=<> jira-reviews-reminder ` This script will run and exit. So, preferably schedule a cron job.

#### Example: To run every day 11 AM and 5 PM `buildoutcfg 0 11,17 * * * SLACK_TOKEN=<your slack token> SLACK_CHANNEL=<> JIRA_PROJECT=<> JIRA_USER=<jira user email/ID> JIRA_TOKEN=<> IGNORE_JIRA=<> ISSUE_CHANGED_BEFORE=<> JIRA_SERVER=<> ISSUE_PAGE_SIZE=<> SLACK_USERS_GROUP=<> JIRA_REVIEWER_FIELD=<> jira-reviews-reminder `

### Environment Variables

##### SLACK_TOKEN Create a slack bot app and get the Bot User OAuth Token. Use it as Env variable.

<a href=”https://slack.com/intl/en-in/help/articles/115005265703-Create-a-bot-for-your-workspace”>Instructions to create Slack Bot</a>

> Make sure your bot has all necessary permissions/scopes: > users:read.email, chat:write.public, channels:read, channels:join

##### SLACK_CHANNEL Slack channel of your team/jira project. No need to prefix with #

##### JIRA_PROJECT The jira project key of your team. Tickets belonging to these projects will be processed.

TODO: Pass comma separated projects, if multiple projects need to be assessed.

##### JIRA_USER and JIRA_TOKEN Jira user ID/email and user/app token - need this to authorize the jira client.

##### IGNORE_JIRA (Optional) Comma separated Jira IDs. Any jira ID passed in this env variable will not be processed.

##### ISSUE_CHANGED_BEFORE This variable is used to trigger reminder if the ticket is in review state from x unti of time.

Example: If the variable value is -1d. Only those jira will be processed which are in In Review state for more than 1 day.

##### JIRA_SERVER Jira hosted server - to establish connection.

Example: https://something.atlassian.net

##### ISSUE_PAGE_SIZE (Optional) Maximum number of issues to assess that are In review. > defaults to 20

#### SLACK_USERS_GROUP (Optional) This is your team’s slack user group. If a ticket doesn’t have any reviewer, this user group is tagged in Slack notification.

##### JIRA_REVIEWER_FIELD A few of the attributes in jira ticket are placed in dynamic fields/custom fields. This could be different for different projects.

Find out which field in the API response corresponds to the Reviewers field.

Example: customfield_10200

API Details: > GET /rest/api/2/issue/your_jira_ID