searchbot-discord/main.py

# -*- coding: utf-8 -*-

# search - a tiny little search utility bot for discord.
# All original work by taciturasa, with some code by ry00001.
# Used and modified with permission.
# See LICENSE for license information.

'''Main File'''

import discord
from discord.ext import commands
import traceback
import json
import os
import asyncio
import aiohttp
import random


class Bot(commands.Bot):
    """Custom Bot Class that subclasses the commands.ext one"""

    def __init__(self, **options):
        """Initializes the main parts of the bot."""

        # Logging
        print('Performing initialization...\n')

        # Initializes parent class
        super().__init__(self._get_prefix_new, **options)

        # Get Config Values
        with open('config.json') as f:
            self.config = json.load(f)
            self.prefix = self.config['PREFIX']
            self.version = self.config['VERSION']
            self.maintenance = self.config['MAINTENANCE']
            self.description = self.config['DESCRIPTION']
            self.case_insensitive = self.config['CASE_INSENSITIVE']

        # Get Instances
        with open('searxes.txt') as f:
            self.instances = f.read().split('\n')

        # Logging
        print('Initialization complete.\n\n')

    async def _get_prefix_new(self, bot, msg):
        """More flexible check for prefix."""

        # Adds empty prefix if in DMs
        if isinstance(msg.channel, discord.DMChannel) and self.config['PREFIXLESS_DMS']:
            plus_empty = self.prefix.copy()
            plus_empty.append('')
            return commands.when_mentioned_or(*plus_empty)(bot, msg)
        # Keeps regular if not
        else:
            return commands.when_mentioned_or(*self.prefix)(bot, msg)

    async def on_ready(self):
        """Initializes the main portion of the bot once it has connected."""

        # Prerequisites
        self.request = aiohttp.ClientSession()
        self.appinfo = await self.application_info()
        if self.description == '':
            self.description = self.appinfo.description

        # NOTE Extension Entry Point
        # Loads core, which loads all other extensions
        self.load_extension('extensions.core')

        # Logging
        msg = "CONNECTED!\n"
        msg += "-----------------------------\n"
        msg += f"ACCOUNT: {bot.user}\n"
        msg += f"OWNER: {self.appinfo.owner}\n"
        msg += "-----------------------------\n"
        print(msg)

    async def on_message(self, message):
        """Handles what the bot does whenever a message comes across."""

        # Prerequisites
        mentions = [self.user.mention, f'<@!{self.user.id}>']
        ctx = await self.get_context(message)

        # Handling
        # Turn away bots
        if message.author.bot:
            return

        # Ignore blocked users
        elif message.author.id in self.config.get('BLOCKED'):
            return

        # Maintenance mode
        elif self.maintenance and not message.author.is_owner():
            return

        # Empty ping for assistance
        elif message.content in mentions and self.config.get('MENTION_ASSIST'):
            assist_msg = (
                "**Hi there! How can I help?**\n\n"
                # Two New Lines Here
                f"You may use **{self.user.mention} `term here`** to search, "
                f"or **{self.user.mention} `help`** for assistance.")
            await ctx.send(assist_msg)

        # Move on to command handling
        else:
            await self.process_commands(message)


# Creates Bot object
bot = Bot()


@bot.listen()
async def on_command_error(ctx, error):
    """Handles all errors stemming from ext.commands."""

    # Lets other cogs handle CommandNotFound.
    # Change this if you want command not found handling
    if isinstance(error, commands.CommandNotFound):
        return

    # Provides a very pretty embed if something's actually a dev's fault.
    elif isinstance(error, commands.CommandInvokeError):
        # Prerequisites
        error = error.original
        _traceback = traceback.format_tb(error.__traceback__)
        _traceback = ''.join(_traceback)
        appinfo = await bot.application_info()

        # Main Message
        embed_fallback = f"**An error occured: {type(error).__name__}. Please contact {appinfo.owner}.**"

        # Embed Building
        error_embed = discord.Embed(
            title=f"{type(error).__name__}",
            color=0xFF0000,
            description=(  # TODO Change if has logging
                "This is (probably) a bug. This has not been automatically "
                f"reported, so please give **{appinfo.owner}** a heads-up in DMs.")
        )

        # Formats Traceback
        trace_content = (
            "```py\n\nTraceback (most recent call last):"
            "\n{}{}: {}```").format(
                _traceback,
                type(error).__name__,
                error)

        # Adds Traceback
        error_embed.add_field(
            name="`{}` in command `{}`".format(
                type(error).__name__, ctx.command.qualified_name),
            value=(trace_content[:1018] + '...```')
            if len(trace_content) > 1024
            else trace_content)

        # Sending
        await ctx.send(embed_fallback, embed=error_embed)

    # If anything else goes wrong, just go ahead and send it in chat.
    else:
        await ctx.send(error)

# NOTE Bot Entry Point
# Starts the bot
bot.run(bot.config['TOKEN'])