full pythondoc

bot.py

@@ -2,25 +2,33 @@ import os
 import discord
 from datetime import datetime
 from dotenv import load_dotenv
+
+# Custom libs
 import emotes
 import help
 from utils import debug
 
+VERSION = "1.0"
+t0 = datetime.now()
+
+# Loading token
 load_dotenv()
 token = os.getenv('DISCORD_TOKEN')
 
 client = discord.Client()
 
-VERSION = "1.0"
-
-t0 = datetime.now()
 
 @client.event
 async def on_ready():
+    """
+    Called when client is connected
+    """
+    # Change status
     await client.change_presence(
         activity=discord.Game(f"v{VERSION} | %help"),
         status=discord.Status.online
     )
+    # Debug connected guilds
     print(f'{client.user} v{VERSION} has connected to Discord\nto the following guilds:')
     for guild in client.guilds:
         print(f'- {guild.name}(id: {guild.id})')
@@ -28,9 +36,18 @@ async def on_ready():
 
 @client.event
 async def on_message(message):
+    """
+    Called when a message is sent to any channel on any guild
+
+    :param message: message sent
+    :type message: discord.Message
+    """
+
+    # Ignore self messages
     if message.author == client.user:
         return
 
+    # Check if bot can respond on current channel or DM user
     permissions = message.channel.permissions_for(message.guild.me)
     if not permissions.send_messages:
         debug(message, f"missing 'send_messages' permission")
@@ -40,17 +57,16 @@ async def on_message(message):
             f" #{message.channel} in server '{message.guild}'")
         return
 
+    # Redirect to the correct command
     args = message.content.split(" ")
-
     if args[0] == "%info":
         debug(message, f"command '{message.content}'")
         await message.channel.send(f"Discord Analyst v{VERSION} started at {t0.isoformat()}")
-
     if args[0] == "%help":
         await help.compute(message, args)
-
     if args[0] == "%emotes":
         await emotes.compute(message, args)
 
 
+# Launch client
 client.run(token)