Banhammer.py 2.5.4b0

A Discord bot integration framework for Reddit moderation.

Banhammer.py

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

• Features
• Installation
• Quick Example
• Contributing
• Roadmap
• Links
• License

Features

• Streaming new and reported posts to your Discord bot.
• Adding and handling reactions.
• Fetching reactions from subreddit wiki.
• Changing bot presence on Discord.
• Generating embeds and messages for items and actions.

Installation

Banhammer.py requires a release of Python 3.6 or newer. You can install Banhammer.py via pip:

pip install banhammer.py

Quick Example

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.

Contributing

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:

• Follow Python naming conventions. (eg. variable_name and ClassName)
• Only use async where necessary.
• Use the OOP approach; create classes when it makes sense.
• Document as much as you can, preferably with inline comments.
• Use the NumPyDoc docstring format.
• Store data in JSON, INI or YAML format to eliminate dependencies for other formats.

Roadmap

• Returning actions performed.
• Improved support for modmail.
• MessageBuilder object to create custom messages/embeds.
• save() function for Subreddit object.
• Support for newer PRAW features (such as locking comments).
• Validation of inputs.
• Better exception handling and outputs.
• Support for variable function arguments.

Links

• Official Discord server
• PyPi Release
• Discord.py
• aPRAW

License

Banhammer.py's source is provided under GPLv3.

Copyright ©, RaviAnand Mohabir