Python framework to create Reddit moderation bots for Discord using reactions and streams.
GPL-3.0 License
Banhammer.py is a framework that allows you to build your very own Banhammer! Banhammer pursues the goal of bringing subreddit moderation to your very own Discord server, by streaming any and all moderatable items to Discord channels and allowing users to then moderate the subreddit through a joint bot account using Reactions, there's no need to use Reddit's moderation interface anymore!
Table of Contents
Banhammer.py requires a release of Python 3.6 or newer. You can install Banhammer.py via pip:
pip install banhammer.py
Once the dependencies have been installed, the bot can be created. For that the general structure of a Discord Client
or Bot
(if commands are of importance use Bot
) needs to be created and then Banhammer initialized as well as ran.
import apraw
import discord
import banhammer
from banhammer.models import Subreddit
from discord.ext import commands
bot = commands.Bot(command_prefix='>')
reddit = apraw.Reddit(client_id=CLIENT_ID, client_secret=CLIENT_SECRET,
password=PASSWORD, username=USERNAME, user_agent=USER_AGENT)
bh = banhammer.Banhammer(reddit, bot=bot)
@bot.event
async def on_command_error(ctx, error):
print(error)
@bot.event
async def on_ready():
print(str(bot.user) + ' is running.')
sub = Subreddit(bh, SUBNAME)
await sub.load_reactions()
await bh.add_subreddits(sub)
bh.run()
@bh.new()
async def handle_new(p):
msg = await bot.get_channel(CHANNEL_ID).send(embed=await p.get_embed())
await p.add_reactions(m)
bot.run(TOKEN)
bh.run()
must be called so that Banhammer can start the internal event loop. More examples can be found in the (examples)[examples] folder or in the Banhacker as well as the D6B GitHub repositories that both show different (and more complex) implementations of the framework.
Banhammer.py is open-source! That means we'd love to see your contributions and hopefully be able to accept them in the next release. If you want to become a contributor, try to follow these rules to keep the code clean:
variable_name
and ClassName
)async
where necessary.MessageBuilder
object to create custom messages/embeds.save()
function for Subreddit
object.Banhammer.py's source is provided under GPLv3.
Copyright , RaviAnand Mohabir