Mirror of godotengine/issue-bot
Find a file
Rémi Verschelde 23293eeac5
Merge pull request #4 from aaronfranke/ci
Add CI checks for file formatting and style checks
2021-02-24 10:51:49 +01:00
.github/workflows Add CI checks for file formatting and style checks 2021-02-24 00:36:26 -05:00
misc Add CI checks for file formatting and style checks 2021-02-24 00:36:26 -05:00
.gitignore Add more debugging 2021-01-24 23:56:53 +01:00
bot.py Run scripts 2021-02-24 00:36:32 -05:00
Dockerfile Run scripts 2021-02-24 00:36:32 -05:00
README.md Add REPOSITORY_SHORTNAME_MAP feature 2021-01-27 15:14:03 +01:00
screenshot.png Add screenshot to README 2021-01-25 01:28:18 +01:00
test-regex.py Run scripts 2021-02-24 00:36:32 -05:00

Godot Issuebot

Simple bot to ferry between rocket.chat and Github. If you want to run one for yourself you can build the container.

What does it do? It will add issue/pr links to messages that mention a valid issue. Either by typing #1335 to go to the default repository or repository#345 for a particular one. The bot will edit the message in question and add links, description, and status to the message.

Shortnames can be configured which could for instance map proposals#1 to godot-proposals#1 for commonly used repositories.

screenshot

Environment variables

The following environment variables are supported:

  • BOT_DEBUG - optional Turn on exessive debug messages when set
  • REPOSITORY_SHORTNAME_MAP - optional A space separated list form of shortname:fullname ... with repository shorthands and full names
  • DEFAULT_AVATAR_URL - required url to some image if gh can't provide an avatar
  • DEFAULT_REPOSITORY - required default repository to search if a 'bare' issue # gets sent
  • ROCKET_WS_URL - required url to the rocket.chat server (wss://chat.godotengine.org/websocket)
  • ROCKET_USERNAME - required username of the rocket.chat user to login as
  • ROCKET_PASSWORD - required password of the rocket.chat user
  • GITHUB_PROJECT - required github project to search in
  • GITHUB_USERNAME - required username to use for the github APIs
  • GITHUB_TOKEN - required github user token to authenticate to the APIs with

Running without a container

Requirements are pretty small, only python-requests and python-websockets are required. After that make sure you set the above env variables and you're good to go!

Running the bot through podman

Docker users can probable just replace podman with docker

  • clone the repostiory
  • podman build . -t issuebot:latest
  • podman run -it --env-file=env issuebot:latest

example env file:

BOT_DEBUG=true
DEFAULT_AVATAR_URL=https://chat.godotengine.org/avatar/github
DEFAULT_REPOSITORY=godot
GITHUB_PROJECT=godotengine
ROCKET_WS_URL=wss://chat.godotengine.org/websocket
ROCKET_USERNAME=github
ROCKET_PASSWORD=supersecret
GITHUB_USERNAME=hpvb
GITHUB_TOKEN=verysecret
REPOSITORY_SHORTNAME_MAP="assetlib:godot-asset-library demos:godot-demo-projects docs:godot-docs proposals:godot-proposals"