PullQueue

PullQueue is a lightweight slack bot/app that listens for all messages in a channel and adds any github pull requests to a queue.

Note: This app does NOT store or persist any data, nor does it connect to github for additional information; instead, it uses slack pinned messages to maintain its state.

How it works

1. Any message in the channel will be parsed for github urls, which will trigger the bot.
2. If there is no queue, the bot will send a message creating it and pinning it to the channel. If there's already a pinned message, it will be edited.
3. For each github url in the message, an item will be added to the queue containing:
   • Author who requested it
   • Github link
   • Link to original message sent in the channel
   • Complete button to remove it from the queue
4. The bot will send a message reply to the original message, confirming that it has added the person's request(s) to the queue.
5. You can modify the variables in variables.py for additional optional features
   • Reactions to original messages can remove items from the queue
   • Show organization repo in the information text in the queue
   • Feedback text when removing item from queue
   • Reply to original thread saying the PRs have been added to the queue
6. You can also call /prs for the bot to re-send the queue to the channel and pin it again.
7. This bot also has support for daily morning reminders with /startreminders

---

Setup

Clone the repo. Follow instructions to create a slack app for your workspace and run the app, using this repo as the code for your app. You can either use the manifest included in ./manifest/manifest.yml to create your app's settings in the Slack API portal, or manually tweak the scopes and event subscriptions:

Bot Token scopes required for the app to function correctly:

• app_mentions:read
• channels:history
• chat:write
• commands
• groups.history
• pins.read
• pins.write
• reactions:read
• users.profile:read

Bot event subscriptions should include:

• message.channels
• reaction_added

Make sure your event and interactivity urls route to your your.server.com/slack/events.

Also make sure to add the necessary slash events and route them to your.server.com/slack/events:

• /prs
• /start_reminders (for 9am reminders every weekday about number of pending PRs)
• /stop_reminder (to remove the channel from reminders)