"""Base class for module, never use directly !!!""" import asyncio import sys import pickle import traceback import discord from storage import FSStorage, FSObjects import storage.path as path class BaseClass: """Base class for all modules, Override it to make submodules""" name = "" help = { "description": "", "commands": { } } help_active = False color = 0x000000 command_text = None super_users = [] authorized_roles = [] def __init__(self, client): """Initialize module class Initialize module class, always call it to set self.client when you override it. :param client: client instance :type client: NikolaTesla""" self.client = client self.storage = FSStorage(path.join(self.client.base_path, self.name)) self.objects = FSObjects(self.storage) if not self.storage.isdir(path.join("storage", self.name)): self.storage.makedirs(path.join("storage", self.name), exist_ok=True) async def send_help(self, channel): embed = discord.Embed( title="[{nom}] - Aide".format(nom=self.name), description=self.help["description"].format(prefix=self.client.config['prefix']), color=self.color ) for command, description in self.help["commands"].items(): embed.add_field(name=command.format(prefix=self.client.config['prefix'], command=self.command_text), value=description.format(prefix=self.client.config['prefix'], command=self.command_text), inline=False) await channel.send(embed=embed) async def auth(self, user, role_list): if type(role_list) == list: if user.id in self.client.owners: return True for guild in self.client.guilds: if guild.get_member(user.id): for role_id in role_list: if role_id in [r.id for r in guild.get_member(user.id).roles]: return True elif type(role_list) == str: module_name = role_list if user.id in self.client.owners: return True authorized_roles = self.client.modules[module_name]["class"].authorized_roles if len(authorized_roles): for guild in self.client.guilds: if guild.get_member(user.id): for role_id in authorized_roles: if role_id in [r.id for r in guild.get_member(user.id).roles]: return True else: return True return False async def parse_command(self, message): """Parse a command_text from received message and execute function %git update com_update(m..) Parse message like `{prefix}{command_text} subcommand` and call class method `com_{subcommand}`. :param message: message to parse :type message: discord.Message""" if message.content.startswith(self.client.config["prefix"] + (self.command_text if self.command_text else "")): content = message.content.lstrip( self.client.config["prefix"] + (self.command_text if self.command_text else "")) sub_command, args, kwargs = self._parse_command_content(content) sub_command = "com_" + sub_command if sub_command in dir(self): await self.__getattribute__(sub_command)(message, args, kwargs) else: await self.command(message, [sub_command[4:]] + args, kwargs) @staticmethod def _parse_command_content(content): """Parse string Parse string like `subcommand argument "argument with spaces" -o -shortwaytopassoncharacteroption --longoption -o "option with argument"`. You can override this function to change parsing. :param content: content to parse :type content: str :return: parsed arguments: [subcommand, [arg1, arg2, ...], [(option1, arg1), (option2, arg2), ...]] :rtype: list[str, list, list]""" if not len(content.split()): return "", [], [] # Sub_command sub_command = content.split()[0] args_ = [] kwargs = [] if len(content.split()) > 1: # Take the other part of command_text content = content.split(" ", 1)[1].replace("\"", "\"\"") # Splitting around quotes quotes = [element.split("\" ") for element in content.split(" \"")] # Split all sub chains but brute chains and flat the resulting list args = [item.split() if item[0] != "\"" else [item, ] for sublist in quotes for item in sublist] # Second plating args = [item for sublist in args for item in sublist] # args_ are arguments, kwargs are options with arguments i = 0 while i < len(args): if args[i].startswith("\""): args_.append(args[i][1:-1]) elif args[i].startswith("--"): if i + 1 >= len(args): kwargs.append((args[i].lstrip("-"), None)) break if args[i + 1][0] != "-": kwargs.append((args[i].lstrip("-"), args[i + 1].strip("\""))) i += 1 else: kwargs.append((args[i].lstrip("-"), None)) elif args[i].startswith("-"): if len(args[i]) == 2: if i + 1 >= len(args): break if args[i + 1][0] != "-": kwargs.append((args[i].lstrip("-"), args[i + 1].strip("\""))) i += 1 else: kwargs.append((args[i].lstrip("-"), None)) else: kwargs.extend([(arg, None) for arg in args[i][1:]]) else: args_.append(args[i]) i += 1 return sub_command, args_, kwargs async def on_message(self, message): """Override this function to deactivate command_text parsing""" await self.parse_command(message) async def command(self, message, args, kwargs): """Override this function to handle all messages starting with `{prefix}{command_text}` Function which is executed for all command_text doesn't match with a `com_{subcommand}` function""" pass def dispatch(self, event, *args, **kwargs): # Method to call method = 'on_' + event try: # Try to get coro, if not exists pass without raise an error coro = getattr(self, method) except AttributeError: pass else: # Run event asyncio.ensure_future(self._run_event(coro, method, *args, **kwargs), loop=self.client.loop) async def _run_event(self, coro, event_name, *args, **kwargs): # Run event try: await coro(*args, **kwargs) except asyncio.CancelledError: # If function is cancelled pass silently pass except Exception: try: # Call error function await self.on_error(event_name, *args, **kwargs) except asyncio.CancelledError: # If error event is canceled pass silently pass async def on_error(self, event_method, *args, **kwargs): # Basic error handler print('Ignoring exception in {}'.format(event_method), file=sys.stderr) traceback.print_exc()