Initial commit

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Ispira (https://github.com/Ispira)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,21 @@
+## Quote bot for Discord
+---
+
+#### Prefix: `$`
+---
+
+#### Requirements
+- [Python 3.6](https://www.python.org/downloads/)
+  - You might have to check "Pre-releases" depending on when you're setting this up.
+- [Discord.py](https://github.com/Rapptz/discord.py)
+  - Use the non-voice option for less headaches, this bot doesn't use voice.
+---
+
+#### Setup
+- Install requirements
+- Clone or download this repo
+- Configure the bot's `config.json`
+  - Ignore `db.json`, this is the quote database and will be handled by the bot.
+- Start the bot
+  - If you're on windows it's probably `python bot.py` in a CMD window of the bot's folder.
+  - Otherwise it may be `python3`, `python3.6`, or something else depending on how you installed it.

bot.py

@@ -0,0 +1,124 @@
+import random
+import json
+
+from os import path
+from discord import Game
+from discord.ext import commands as c
+
+VERSION = "1.1.0"
+
+# Grab the config variables
+with open("config.json") as cfg:
+    config = json.load(cfg)
+
+# Grab the database
+with open("db.json") as dtb:
+    db = json.load(dtb)
+
+# Helper command to update the database
+def update_db(database):
+    with open("db.json", "w") as dtb:
+        json.dump(database, dtb, indent=4)
+
+description="""
+Basic quote bot.
+"""
+bot = c.Bot(c.when_mentioned_or(config["prefix"]), description=description)
+
+# Check for if the user running a command is the bot's owner.
+def is_owner():
+    return c.check(lambda ctx: ctx.message.author.id == config["owner"])
+
+# Change avatar and username
+async def update_profile(name, picture):
+    if path.isfile(picture):
+        with open(picture, "rb") as avatar:
+            await bot.edit_profile(avatar=avatar.read())
+            print("Bot avatar set.")
+        await bot.edit_profile(username=name)
+        print("Bot name set.")
+
+# Events
+@bot.event
+async def on_ready():
+    print("Attempting to set username and avatar.")
+    try:
+        await update_profile(config["bot_name"], config["avatar"])
+    except Exception as err:
+        print(f"Error setting name or avatar: {err}")
+
+    print("============READY")
+    print(f"QuoteBot v{VERSION}")
+    print(f"Logged in as: {bot.user.name} ({bot.user.id})")
+    print("============READY")
+
+@bot.event
+async def on_command_error(err, ctx):
+    channel = ctx.message.channel
+    if isinstance(err, c.CheckFailure):
+        await bot.send_message(channel, "You don't have permission to do that.")
+    elif isinstance(err, c.MissingRequiredArgument):
+        await bot.send_message(channel, "Missing argument(s).")
+
+# Commands
+@bot.command(name="quit")
+@is_owner()
+async def bot_quit():
+    """Shut the bot down."""
+    await bot.say("Shutting down...")
+    await bot.logout()
+
+@bot.command(name="status")
+@is_owner()
+async def bot_status(*, status: str = None):
+    """Change the bot's 'playing' status.
+
+    Running this command without any arguments will turn the 'playing' status off'
+    """
+    game = Game(name=status)
+    await bot.change_status(game=game)
+
+@bot.command(name="info")
+async def bot_info():
+    """Display info about the bot."""
+    await bot.say(f"QuoteBot v{VERSION}")
+
+@bot.group(aliases=["quotes"], pass_context=True)
+async def quote(ctx):
+    """Quotes!
+
+    Running the command without any arguments will display a random quote.
+    """
+    if ctx.invoked_subcommand is None:
+        try:
+            quote_body = random.choice(db["quotes"])
+        except IndexError:
+            await bot.say("There are no quotes.")
+            return
+        await bot.say(quote_body)
+
+@quote.command(name="add", aliases=["new", "create"])
+async def quote_new(name, *, body: str):
+    """Add a new quote."""
+    quote_body = f"<{name}> {body}"
+    if quote_body not in db["quotes"]:
+        db["quotes"].append(quote_body)
+        update_db(db)
+        await bot.say("Quote added.")
+    else:
+        await bot.say("That quote already exists.")
+
+@quote.command(name="remove", aliases=["del", "destroy"])
+async def quote_remove(*, body: str):
+    """Remove a quote.
+
+    Copy/Paste the entire line of a quote to remove it.
+    """
+    if body in db["quotes"]:
+        db["quotes"].remove(body)
+        update_db(db)
+        await bot.say("Quote removed.")
+    else:
+        await bot.say("Quote doesn't exist.")
+
+bot.run(config["token"])

config.json

@@ -0,0 +1,7 @@
+{
+    "token": "YOUR_BOT_TOKEN_HERE",
+    "owner": "BOT_OWNER_ID_HERE",
+    "prefix": "$",
+    "bot_name": "QuoteBot",
+    "avatar": "avatar.png"
+}

db.json

@@ -0,0 +1,5 @@
+{
+    "quotes": [
+        "<Ispira> Why wouldn't a quote bot be a great idea?"
+     ]
+}