Template v2.6

* Added new `dailyfact` command that gives a random fact every day, using cool down
* Fixed some typos in README.md
* Remade the `on_command_error` event for `CommandOnCooldown`

Author: kkrypt0nn

README.md

@@ -13,11 +13,11 @@
 This repository is a template that everyone can use for the start of their discord bot.
 
 When I first started creating my discord bot it took me a while to get everything setup and working with cogs and more.
-I would've been happy if there were any template existing. But there wasn't any existing template. That's why I decided
-to create my own template to let <b>you</b> guys create your discord bot in an easy way.
+I would've been happy if there were any template existing. However, there wasn't any existing template. That's why I
+decided to create my own template to let <b>you</b> guys create your discord bot easily.
 
 Please note that this template is not supposed to be the best template, but a good template to start learning how
-discord.py works and to make your own bot in a simple way. You're
+discord.py works and to make your own bot in a simple way.
 
 If you plan to use this template to make your own template or bot, you **have to** give me credits somewhere and keep
 the copyright notice on the files.
@@ -30,17 +30,17 @@ information.
 
 ## Support
 
-Before requesting support you should know that this template requires you to have a **basic knowledge** of Python. Do
-not use this template if you don't know the basics. [Here's](https://pythondiscord.com/pages/resources) a link for
-resources to learn python.
+Before requesting support, you should know that this template requires you to have at least a **basic knowledge** of
+Python and the library is made for advanced users. Do not use this template if you don't know the
+basics. [Here's](https://pythondiscord.com/pages/resources) a link for resources to learn python.
 
 If you need some help for something, do not hesitate to join my discord server [here](https://discord.gg/HzJ3Gfr).
 
 All the updates of the template are available [here](UPDATES.md).
 
 ## How to download it
 
-This repository is now a template, on the top left you can simple click on "**Use this template**" to create a GitHub
+This repository is now a template, on the top left you can simply click on "**Use this template**" to create a GitHub
 repository based on this template.
 
 Alternatively you can do the following:
@@ -54,7 +54,7 @@ Alternatively you can do the following:
   https://discordapp.com/oauth2/authorize?&client_id=YOUR_APPLICATION_ID_HERE&scope=bot&permissions=8 (
   Replace `YOUR_APPLICATION_ID_HERE` with the application ID)
 
-## How to setup
+## How to set up
 
 To set up the bot I made it as simple as possible. I now created a [config.yaml](config.yaml) file where you can put the
 needed things to edit.
@@ -71,7 +71,8 @@ Here is an explanation of what everything is:
 
 ## How to start
 
-To start the bot you simply need to launch, either your terminal (Linux, Mac & Windows) or your Command Prompt (Windows)
+To start the bot you simply need to launch, either your terminal (Linux, Mac & Windows), or your Command Prompt (
+Windows)
 .
 
 Before running the bot you will need to install all the requirements with this command:

UPDATES.md

@@ -2,6 +2,12 @@
 
 Here is the list of all the updates that I made on this template.
 
+### Version 2.6
+
+* Added new `dailyfact` command that gives a random fact every day, using cool down
+* Fixed some typos in [README.md](README.md)
+* Remade the `on_command_error` event for `CommandOnCooldown`
+
 ### Version 2.5
 
 * Code reformat

bot.py

@@ -3,7 +3,7 @@
 Description:
 This is a template to create your own discord bot in python.
 
-Version: 2.5
+Version: 2.6
 """
 
 import os
@@ -117,9 +117,12 @@ async def on_command_completion(ctx):
 @bot.event
 async def on_command_error(context, error):
     if isinstance(error, commands.CommandOnCooldown):
+        minutes, seconds = divmod(error.retry_after, 60)
+        hours, minutes = divmod(minutes, 60)
+        hours = hours % 24
         embed = discord.Embed(
-            title="Error!",
-            description="This command is on a %.2fs cool down" % error.retry_after,
+            title="Hey, please slow down!",
+            description=f"You can use this command again in {f'{round(hours)} hours' if round(hours) > 0 else ''} {f'{round(minutes)} minutes' if round(minutes) > 0 else ''} {f'{round(seconds)} seconds' if round(seconds) > 0 else ''}.",
             color=config["error"]
         )
         await context.send(embed=embed)

cogs/fun.py

@@ -3,9 +3,11 @@
 import random
 import sys
 
+import aiohttp
 import discord
 import yaml
 from discord.ext import commands
+from discord.ext.commands import BucketType
 
 if not os.path.isfile("config.yaml"):
     sys.exit("'config.yaml' not found! Please add it and try again.")
@@ -18,6 +20,41 @@ class Fun(commands.Cog, name="fun"):
     def __init__(self, bot):
         self.bot = bot
 
+    """
+    Why 1 and 86400?
+    -> Because the user should be able to use the command *once* every *86400* seconds
+    
+    Why BucketType.user?
+    -> Because the cool down only affects the current user, if you want other types of cool downs, here are they:
+    - BucketType.default for a global basis.
+    - BucketType.user for a per-user basis.
+    - BucketType.server for a per-server basis.
+    - BucketType.channel for a per-channel basis.
+    """
+
+    @commands.command(name="dailyfact")
+    @commands.cooldown(1, 86400, BucketType.user)
+    async def dailyfact(self, context):
+        """
+        Get a daily fact, command can only be ran once every day per user.
+        """
+        # This will prevent your bot from stopping everything when doing a web request - see: https://discordpy.readthedocs.io/en/stable/faq.html#how-do-i-make-a-web-request
+        async with aiohttp.ClientSession() as session:
+            async with session.get("https://uselessfacts.jsph.pl/random.json?language=en") as request:
+                if request.status == 200:
+                    data = await request.json()
+                    embed = discord.Embed(description=data["text"], color=config["main_color"])
+                    await context.send(embed=embed)
+                else:
+                    embed = discord.Embed(
+                        title="Error!",
+                        description="There is something wrong with the API, please try again later",
+                        color=config["error"]
+                    )
+                    await context.send(embed=embed)
+                    # We need to reset the cool down since the user didn't got his daily fact.
+                    self.dailyfact.reset_cooldown(context)
+
     @commands.command(name="dick")
     async def dick(self, context, member: discord.Member = None):
         """