Build status

Vision

How does the code work?

This is a javascript app built with Node.js, and all of the app code is in the src directory.

The app starts in bot.js, and it polls the Reddit servers in an infinite loop. The app has two major components:

personality/index.js create sassy responses to certain trigger words.

For changes not related to networking, running tests is often enough. But if you want to see the bot hitting the Reddit servers:

Create your bot's reddit account.
Create a reddit script app through your reddit preferences. (Use http://localhost as your redirect url, we don't need it.)
Get your OAuth username (random characters below "personal use script") and secret
Fork the main github repo and download the bot's code from your own repo
Create a file ./private/environment.yaml that looks like sample-environment.yaml
ensure your node --version is >= v6.2.1
run npm install
run node ./src/bot.js
You should have the bot up and running!

Note: You can run the bot in development mode (which won't POST requests to reddit servers) by changing the dev-mode environment variable to true

You do not need to create a reddit app to run the tests, you can use the sample-environment.yaml default values.

run npm test

Note: To run a single spec, add .only

First time getting involved in Open Source Software? Welcome, and we hope you stick around! See New to OSS guide

Thanks goes to these wonderful people who have contributed (emoji key):

_{Canna Wen} 💻 💬 🤔 👀	_{Daniel Albert} 💻	_{Bob Clingan} 💻	_fbontin 💻	_{Nitin Choudhary} 💻	_{Manuel Porto} 💻	_{Anna Do} 💻
_Charles 💻 💬 🤔	_Hasan 💻	_{Marc Fogleman} 💻	_{Eliot Wong} 💻	_Doomki 💻	_{Wing Lian} 💻	_NFerraro 💻
_{Nalin Bhardwaj} 💻 💬	_{thepassenger-hub} 💻	_{Sean Grimes} 💻	_{Rafal Dittwald} 📖	_namantw 💻	_{Dan C} 💻	_cmd-kvn 💻 🐛
_{Andrew Terranova} 💻 ⚠️	_{Jacob Allen} 💻 ⚠️	_darthpool 📖