Skip to content

DarkMio/RedditRover

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reddit Rover

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:

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. If there are no plugins so far, the bot will exit automatically.

Installation & Usage

Running on Python 3+:

All other dependencies are standard builtins.

Documentation

I've tried to document this bot as best as possible. The full documentation can be found here: Documentation on Read The Docs

Debugging

Bot features are written in Abstract PluginBase Classes. Inherit from it and execute one of the test functions: test_single_submission(submission_id), test_single_comment(comment_id) or _test_single_thing(thing_id). Other than that, use atomic tests of your features however you please. Instantiating a plugin on its own works and supposed to test your features. Read into the documentation to get a detailed guide how this bot works and what you bot has to do.

Version & Changelog

An example of the web statistics can be found here: http://moddota.com/redditrover/

Planned features & work in progress

  • Some interface to control the bot. Mainly restarting, muting, ignoring, etc. Maybe web backend?

Help, questions, contribution

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

Thanks for your interest and have a good time.

About

A plugin based Reddit Bot Framework.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published