RedditRover - the Reddit Multibot Framework

RedditRover is a bot modular bot framework that makes it easy to host all kinds of reddit bots at once. It is intended to make it easy for new and experienced Programmers to host a variety of bots that can react to Reddits content without having to mangle with all ins and outs of reddit, praw and API limitations. Running it is easy:

$ RedditRover/main.py

That will already do start the entire hosting and loading process - given you have already written a plugin, it will start shortly after to fire content to your plugin.

Contents:

• Writing a plugin
  • The basic structure
  • 1. Config File
  • 2. Importing the base class
  • 3. Object from PluginBase
  • 4. Function for instantiating the plugin
  • 5. Test Block (optional)
  • About PRAW objects
  • The entire code
• Bot Configuration
  • Framework Config
  • Plugin Config
• FAQ: Common problems and answers
  • What does RedditRover offer?
  • What are use cases of RedditRover?
  • What assumptions does this framework make?
  • How does a plugin work?
  • Requests, API limitations, slow framework
  • My plugin missed a post
  • Do you accept donations?
• Core: Code Overview
  • PluginBase Group
  • RedditRover Group
  • Database Group
  • LogProvider Group
  • MultiThreader Group
  • Handlers Group
• misc package
  • misc.multiple_strings module
  • misc.warning_filter module
  • Module contents

• Module Index

Installation & Usage

Running on Python 3+:

pip install praw --upgrade

All other dependencies are standard builtins.

Help, questions, contribution

Check out the FAQ, which should cover most issues. Pull Requests, emails and messages on Reddit are welcome.