Duga
A bot named Duga for chat rooms on the Stack Exchange network. Responsibilities include:
- When used as a Github webhook, instantly informs a chatroom about the activity
- Can make requests to Github's API every now and then to check for recent events, informs a chat room if there is activity
- Uses the Stack Exchange API to check comments refering users to Code Review and Programmers. Posts these comments in The 2nd Monitor and The Whiteboard, respectively.
- Listens for chat commands in Duga's Playground.
Old Groovy Configuration
This is obsolete and duga-ktor should be used instead.
In the directory grails-app/conf, create a file named duga.groovy
// Configurations for the bot's Stack Exchange account:
rootUrl = 'https://stackexchange.com'
email = '[email protected]'
password = 'yourpassword'
// API configuration
stackAPI = 'xxxxxxxxx'
githubAPI = 'xxxxxxxxx'
commandPrefix = '@Duga ' // chat messages that begins with this will be considered as commands
// Database configuration
adminDefaultPass = 'xxxxxxxxx' // default password for username 'admin'
dataSource {
username = 'xxxxxxxxx'
password = 'xxxxxxxxx'
}
Also see the bottom part of grails-app/conf/application.groovy for more database configuration options.
Bot account setup
In order to run a StackExchange account as a chat bot, you need to follow the following steps:
- Create a StackExchange account on https://stackexchange.com
- Make sure you can log in to it
- Create an account on a specific site, for example https://codereview.stackexchange.com
- Earn 20 reputation, following the rules of the particular site
- Log in to https://chat.stackexchange.com
- Confirm that you can talk
Build and run tests
To build the project and run all tests:
./gradlew build