From 716699dedf6ec7afc76eb61d5402184d5a808dc7 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Tue, 19 May 2020 20:14:06 +0300
Subject: Source: Created initial cog layout + setup function

---
 bot/cogs/source.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 bot/cogs/source.py

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
new file mode 100644
index 000000000..4897a16e3
--- /dev/null
+++ b/bot/cogs/source.py
@@ -0,0 +1,15 @@
+from discord.ext.commands import Cog
+
+from bot.bot import Bot
+
+
+class Source(Cog):
+    """Cog of Python Discord project source information."""
+
+    def __init__(self, bot: Bot):
+        self.bot = bot
+
+
+def setup(bot: Bot) -> None:
+    """Load `Source` cog."""
+    bot.add_cog(Source(bot))
-- 
cgit v1.2.3


From c71895c99366f5096442420edde10c70e562a4dd Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Tue, 19 May 2020 20:21:58 +0300
Subject: Source: Create converter for source object converting

---
 bot/cogs/source.py | 33 +++++++++++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 4897a16e3..76f75f83b 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -1,10 +1,39 @@
-from discord.ext.commands import Cog
+from typing import Union
+
+from discord.ext.commands import BadArgument, Cog, Context, Converter, Command, HelpCommand
 
 from bot.bot import Bot
 
 
+class SourceConverted(Converter):
+    """Convert argument to help command, command or Cog."""
+
+    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog]:
+        """
+        Convert argument into source object.
+
+        Order how arguments is checked:
+        1. When argument is `help`, return bot help command
+        2. When argument is valid command, return this command
+        3. When argument is valid Cog, return this Cog
+        4. Otherwise raise `BadArgument` error
+        """
+        if argument.lower() == "help":
+            return ctx.bot.help_command
+
+        command = ctx.bot.get_command(argument)
+        if command:
+            return command
+
+        cog = ctx.bot.get_cog(argument)
+        if cog:
+            return cog
+
+        raise BadArgument(f"Unable to convert `{argument}` to help command, command or cog.")
+
+
 class Source(Cog):
-    """Cog of Python Discord project source information."""
+    """Cog of Python Discord projects source information."""
 
     def __init__(self, bot: Bot):
         self.bot = bot
-- 
cgit v1.2.3


From a4ad94904638c94b44006d546861d399eba77ed5 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 08:46:27 +0300
Subject: Source: Create `get_source_link` function that build item's GitHub
 link

---
 bot/cogs/source.py | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 76f75f83b..1f9e0e84d 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -1,11 +1,14 @@
+import inspect
+import os
 from typing import Union
 
-from discord.ext.commands import BadArgument, Cog, Context, Converter, Command, HelpCommand
+from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand
 
 from bot.bot import Bot
+from bot.constants import URLs
 
 
-class SourceConverted(Converter):
+class SourceConverter(Converter):
     """Convert argument to help command, command or Cog."""
 
     async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog]:
@@ -38,6 +41,24 @@ class Source(Cog):
     def __init__(self, bot: Bot):
         self.bot = bot
 
+    @staticmethod
+    def get_source_link(source_item: Union[HelpCommand, Command, Cog]) -> str:
+        """Build GitHub link of source item."""
+        if isinstance(source_item, HelpCommand):
+            src = type(source_item)
+            filename = inspect.getsourcefile(src)
+        elif isinstance(source_item, Command):
+            src = source_item.callback.__code__
+            filename = src.co_filename
+        else:
+            src = type(source_item)
+            filename = inspect.getsourcefile(src)
+
+        lines, first_line_no = inspect.getsourcelines(src)
+        file_location = os.path.relpath(filename)
+
+        return f"{URLs.github_bot_repo}/blob/master/{file_location}#L{first_line_no}-L{first_line_no+len(lines)-1}"
+
 
 def setup(bot: Bot) -> None:
     """Load `Source` cog."""
-- 
cgit v1.2.3


From 6e923cb6386e95b7ad56c9fc8d2374a0feffd49e Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 08:46:48 +0300
Subject: Source: Add cog loading to __main__.py

---
 bot/__main__.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bot/__main__.py b/bot/__main__.py
index aa1d1aee8..d82adc802 100644
--- a/bot/__main__.py
+++ b/bot/__main__.py
@@ -57,6 +57,7 @@ bot.load_extension("bot.cogs.reddit")
 bot.load_extension("bot.cogs.reminders")
 bot.load_extension("bot.cogs.site")
 bot.load_extension("bot.cogs.snekbox")
+bot.load_extension("bot.cogs.source")
 bot.load_extension("bot.cogs.stats")
 bot.load_extension("bot.cogs.sync")
 bot.load_extension("bot.cogs.tags")
-- 
cgit v1.2.3


From dfda0abf922d49688774aae8e6f9c0ba8e44b96d Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 09:10:05 +0300
Subject: Source: Create `build_embed` function that build embed of source item

---
 bot/cogs/source.py | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 1f9e0e84d..bce51aa80 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -2,11 +2,18 @@ import inspect
 import os
 from typing import Union
 
+from discord import Embed
 from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand
 
 from bot.bot import Bot
 from bot.constants import URLs
 
+CANT_RUN_MESSAGE = "You can't run this command here."
+CAN_RUN_MESSAGE = "You are able to run this command."
+
+COG_CHECK_FAIL = "You can't use commands what is in this Cog here."
+COG_CHECK_PASS = "You can use commands from this Cog."
+
 
 class SourceConverter(Converter):
     """Convert argument to help command, command or Cog."""
@@ -59,6 +66,26 @@ class Source(Cog):
 
         return f"{URLs.github_bot_repo}/blob/master/{file_location}#L{first_line_no}-L{first_line_no+len(lines)-1}"
 
+    @staticmethod
+    async def build_embed(link: str, source_object: Union[HelpCommand, Command, Cog], ctx: Context) -> Embed:
+        """Build embed based on source object."""
+        if isinstance(source_object, HelpCommand):
+            title = "Help"
+            description = source_object.__doc__
+        else:
+            title = source_object.qualified_name
+            description = source_object.help
+
+        embed = Embed(title=title, description=description, url=link)
+        embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
+
+        if isinstance(source_object, Command):
+            embed.set_footer(text=CAN_RUN_MESSAGE if await source_object.can_run(ctx) else CANT_RUN_MESSAGE)
+        elif isinstance(source_object, Cog):
+            embed.set_footer(text=COG_CHECK_PASS if source_object.cog_check(ctx) else COG_CHECK_FAIL)
+
+        return embed
+
 
 def setup(bot: Bot) -> None:
     """Load `Source` cog."""
-- 
cgit v1.2.3


From b3742b8050aff7edbaccfa9d1d95843f5bf201a0 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 09:11:50 +0300
Subject: Source: Create `source` command with alias `src`

---
 bot/cogs/source.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index bce51aa80..af29caaaa 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -3,7 +3,7 @@ import os
 from typing import Union
 
 from discord import Embed
-from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand
+from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, group
 
 from bot.bot import Bot
 from bot.constants import URLs
@@ -48,6 +48,12 @@ class Source(Cog):
     def __init__(self, bot: Bot):
         self.bot = bot
 
+    @group(name='source', aliases=('src',), invoke_without_command=True)
+    async def source_command(self, ctx: Context, *, source_item: SourceConverter) -> None:
+        """Get GitHub link and information about help command, command or Cog."""
+        url = self.get_source_link(source_item)
+        await ctx.send(embed=await self.build_embed(url, source_item, ctx))
+
     @staticmethod
     def get_source_link(source_item: Union[HelpCommand, Command, Cog]) -> str:
         """Build GitHub link of source item."""
-- 
cgit v1.2.3


From ce34adbc64bacd15eeb1a2bfee7b0d022ec969eb Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 09:17:26 +0300
Subject: Source: Make `source` command to `command` instead `group`

---
 bot/cogs/source.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index af29caaaa..1774d0085 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -3,7 +3,7 @@ import os
 from typing import Union
 
 from discord import Embed
-from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, group
+from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, command
 
 from bot.bot import Bot
 from bot.constants import URLs
@@ -48,7 +48,7 @@ class Source(Cog):
     def __init__(self, bot: Bot):
         self.bot = bot
 
-    @group(name='source', aliases=('src',), invoke_without_command=True)
+    @command(name="source", aliases=("src",))
     async def source_command(self, ctx: Context, *, source_item: SourceConverter) -> None:
         """Get GitHub link and information about help command, command or Cog."""
         url = self.get_source_link(source_item)
-- 
cgit v1.2.3


From 1bb52f815e93c2e3d3fa565c150bbc5effff94f2 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 09:18:04 +0300
Subject: Source: Remove `command` shadowing on converter

---
 bot/cogs/source.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 1774d0085..c628c6b29 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -31,9 +31,9 @@ class SourceConverter(Converter):
         if argument.lower() == "help":
             return ctx.bot.help_command
 
-        command = ctx.bot.get_command(argument)
-        if command:
-            return command
+        cmd = ctx.bot.get_command(argument)
+        if cmd:
+            return cmd
 
         cog = ctx.bot.get_cog(argument)
         if cog:
-- 
cgit v1.2.3


From e5239c4b20d2496cf5a96192981f050c87150acd Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 09:37:26 +0300
Subject: Source: Implement no argument GitHub repo response

---
 bot/cogs/source.py | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index c628c6b29..22b75e2ee 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -1,9 +1,9 @@
 import inspect
 import os
-from typing import Union
+from typing import Optional, Union
 
 from discord import Embed
-from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, command
+from discord.ext.commands import Cog, Command, Context, Converter, HelpCommand, command
 
 from bot.bot import Bot
 from bot.constants import URLs
@@ -18,7 +18,7 @@ COG_CHECK_PASS = "You can use commands from this Cog."
 class SourceConverter(Converter):
     """Convert argument to help command, command or Cog."""
 
-    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog]:
+    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog, None]:
         """
         Convert argument into source object.
 
@@ -39,7 +39,7 @@ class SourceConverter(Converter):
         if cog:
             return cog
 
-        raise BadArgument(f"Unable to convert `{argument}` to help command, command or cog.")
+        return None
 
 
 class Source(Cog):
@@ -49,8 +49,14 @@ class Source(Cog):
         self.bot = bot
 
     @command(name="source", aliases=("src",))
-    async def source_command(self, ctx: Context, *, source_item: SourceConverter) -> None:
+    async def source_command(self, ctx: Context, *, source_item: Optional[SourceConverter] = None) -> None:
         """Get GitHub link and information about help command, command or Cog."""
+        if not source_item:
+            embed = Embed(title="Bot GitHub Repository", url=URLs.github_bot_repo)
+            embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
+            await ctx.send(embed=embed)
+            return
+
         url = self.get_source_link(source_item)
         await ctx.send(embed=await self.build_embed(url, source_item, ctx))
 
-- 
cgit v1.2.3


From 6d0a1b0c9e3f278f2b660659efd89db3c4a3595a Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 09:40:26 +0300
Subject: Source: Fix `Cog` instance of source no `help` attribute

---
 bot/cogs/source.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 22b75e2ee..1820392f3 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -84,9 +84,12 @@ class Source(Cog):
         if isinstance(source_object, HelpCommand):
             title = "Help"
             description = source_object.__doc__
-        else:
+        elif isinstance(source_object, Command):
             title = source_object.qualified_name
             description = source_object.help
+        else:
+            title = source_object.qualified_name
+            description = source_object.description
 
         embed = Embed(title=title, description=description, url=link)
         embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
-- 
cgit v1.2.3


From 00445f54a8593ff14d2f9c9595be86f15ab78072 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 16:23:05 +0300
Subject: Source: Make converter raising `BadArgument` again

---
 bot/cogs/source.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 1820392f3..633cb8ccf 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -1,9 +1,9 @@
 import inspect
 import os
-from typing import Optional, Union
+from typing import Union
 
 from discord import Embed
-from discord.ext.commands import Cog, Command, Context, Converter, HelpCommand, command
+from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, command
 
 from bot.bot import Bot
 from bot.constants import URLs
@@ -18,7 +18,7 @@ COG_CHECK_PASS = "You can use commands from this Cog."
 class SourceConverter(Converter):
     """Convert argument to help command, command or Cog."""
 
-    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog, None]:
+    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog]:
         """
         Convert argument into source object.
 
@@ -39,7 +39,7 @@ class SourceConverter(Converter):
         if cog:
             return cog
 
-        return None
+        raise BadArgument(f"Unable to convert `{argument}` to valid command or Cog.")
 
 
 class Source(Cog):
@@ -49,7 +49,7 @@ class Source(Cog):
         self.bot = bot
 
     @command(name="source", aliases=("src",))
-    async def source_command(self, ctx: Context, *, source_item: Optional[SourceConverter] = None) -> None:
+    async def source_command(self, ctx: Context, *, source_item: SourceConverter = None) -> None:
         """Get GitHub link and information about help command, command or Cog."""
         if not source_item:
             embed = Embed(title="Bot GitHub Repository", url=URLs.github_bot_repo)
-- 
cgit v1.2.3


From dd05246e29fa46ff53456a499244373c23a24d06 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 16:23:58 +0300
Subject: Source: Remove links from title of embeds

---
 bot/cogs/source.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 633cb8ccf..b285b4089 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -52,7 +52,7 @@ class Source(Cog):
     async def source_command(self, ctx: Context, *, source_item: SourceConverter = None) -> None:
         """Get GitHub link and information about help command, command or Cog."""
         if not source_item:
-            embed = Embed(title="Bot GitHub Repository", url=URLs.github_bot_repo)
+            embed = Embed(title="Bot GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
             await ctx.send(embed=embed)
             return
@@ -91,7 +91,7 @@ class Source(Cog):
             title = source_object.qualified_name
             description = source_object.description
 
-        embed = Embed(title=title, description=description, url=link)
+        embed = Embed(title=title, description=description)
         embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
 
         if isinstance(source_object, Command):
-- 
cgit v1.2.3


From 36ef3514674812afab6c94b12b3f9d3768b324f5 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 16:25:26 +0300
Subject: Source: Remove Cog check displaying from command

---
 bot/cogs/source.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index b285b4089..220da535d 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -11,9 +11,6 @@ from bot.constants import URLs
 CANT_RUN_MESSAGE = "You can't run this command here."
 CAN_RUN_MESSAGE = "You are able to run this command."
 
-COG_CHECK_FAIL = "You can't use commands what is in this Cog here."
-COG_CHECK_PASS = "You can use commands from this Cog."
-
 
 class SourceConverter(Converter):
     """Convert argument to help command, command or Cog."""
@@ -96,8 +93,6 @@ class Source(Cog):
 
         if isinstance(source_object, Command):
             embed.set_footer(text=CAN_RUN_MESSAGE if await source_object.can_run(ctx) else CANT_RUN_MESSAGE)
-        elif isinstance(source_object, Cog):
-            embed.set_footer(text=COG_CHECK_PASS if source_object.cog_check(ctx) else COG_CHECK_FAIL)
 
         return embed
 
-- 
cgit v1.2.3


From e2ce4ac6f372a92cc8c31c09237521e6b3aeb23b Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 16:35:11 +0300
Subject: Source: Rename cog + move checks status from footer to field

- Renamed cog from `Source` to `BotSource` for itself (bot will be
unable to get cog, because this always return command).
- Moved checks status from footer to field and changed it's content.
---
 bot/cogs/source.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 220da535d..972507762 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -8,9 +8,6 @@ from discord.ext.commands import BadArgument, Cog, Command, Context, Converter,
 from bot.bot import Bot
 from bot.constants import URLs
 
-CANT_RUN_MESSAGE = "You can't run this command here."
-CAN_RUN_MESSAGE = "You are able to run this command."
-
 
 class SourceConverter(Converter):
     """Convert argument to help command, command or Cog."""
@@ -39,7 +36,7 @@ class SourceConverter(Converter):
         raise BadArgument(f"Unable to convert `{argument}` to valid command or Cog.")
 
 
-class Source(Cog):
+class BotSource(Cog):
     """Cog of Python Discord projects source information."""
 
     def __init__(self, bot: Bot):
@@ -92,11 +89,11 @@ class Source(Cog):
         embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
 
         if isinstance(source_object, Command):
-            embed.set_footer(text=CAN_RUN_MESSAGE if await source_object.can_run(ctx) else CANT_RUN_MESSAGE)
+            embed.add_field(name="Can be used by you here?", value=await source_object.can_run(ctx))
 
         return embed
 
 
 def setup(bot: Bot) -> None:
     """Load `Source` cog."""
-    bot.add_cog(Source(bot))
+    bot.add_cog(BotSource(bot))
-- 
cgit v1.2.3


From dc96a187cf7af6d4d1d39a325e3ffad67d3549a5 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Wed, 20 May 2020 16:38:56 +0300
Subject: Source: Fix description of cog

---
 bot/cogs/source.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 972507762..5b8d8ded2 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -37,7 +37,7 @@ class SourceConverter(Converter):
 
 
 class BotSource(Cog):
-    """Cog of Python Discord projects source information."""
+    """Cog of Python Discord Python bot project source information."""
 
     def __init__(self, bot: Bot):
         self.bot = bot
-- 
cgit v1.2.3


From e5534bc73d4b2d7b4b87326ab3b729b955e7c344 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 08:26:23 +0300
Subject: Source: Fix docstrings

Co-authored-by: Mark <kozlovmark@gmail.com>
---
 bot/cogs/source.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 5b8d8ded2..6e71ae5b2 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -10,7 +10,7 @@ from bot.constants import URLs
 
 
 class SourceConverter(Converter):
-    """Convert argument to help command, command or Cog."""
+    """Convert an argument into a help command, command, or cog."""
 
     async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog]:
         """
@@ -37,14 +37,14 @@ class SourceConverter(Converter):
 
 
 class BotSource(Cog):
-    """Cog of Python Discord Python bot project source information."""
+    """Displays information about the bot's source code."""
 
     def __init__(self, bot: Bot):
         self.bot = bot
 
     @command(name="source", aliases=("src",))
     async def source_command(self, ctx: Context, *, source_item: SourceConverter = None) -> None:
-        """Get GitHub link and information about help command, command or Cog."""
+        """Display information and a GitHub link to the source code of a command or cog."""
         if not source_item:
             embed = Embed(title="Bot GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
@@ -95,5 +95,5 @@ class BotSource(Cog):
 
 
 def setup(bot: Bot) -> None:
-    """Load `Source` cog."""
+    """Load the BotSource cog."""
     bot.add_cog(BotSource(bot))
-- 
cgit v1.2.3


From befbb1afed56b60336c8668a9134e28e069e0eac Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 08:47:46 +0300
Subject: Source: Remove checks running from source command

---
 bot/cogs/source.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 6e71ae5b2..7076c1eb3 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -52,7 +52,7 @@ class BotSource(Cog):
             return
 
         url = self.get_source_link(source_item)
-        await ctx.send(embed=await self.build_embed(url, source_item, ctx))
+        await ctx.send(embed=await self.build_embed(url, source_item))
 
     @staticmethod
     def get_source_link(source_item: Union[HelpCommand, Command, Cog]) -> str:
@@ -73,7 +73,7 @@ class BotSource(Cog):
         return f"{URLs.github_bot_repo}/blob/master/{file_location}#L{first_line_no}-L{first_line_no+len(lines)-1}"
 
     @staticmethod
-    async def build_embed(link: str, source_object: Union[HelpCommand, Command, Cog], ctx: Context) -> Embed:
+    async def build_embed(link: str, source_object: Union[HelpCommand, Command, Cog]) -> Embed:
         """Build embed based on source object."""
         if isinstance(source_object, HelpCommand):
             title = "Help"
@@ -88,9 +88,6 @@ class BotSource(Cog):
         embed = Embed(title=title, description=description)
         embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
 
-        if isinstance(source_object, Command):
-            embed.add_field(name="Can be used by you here?", value=await source_object.can_run(ctx))
-
         return embed
 
 
-- 
cgit v1.2.3


From 756ed4286339a26e6e1e4edb7431a026d8817881 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 09:09:35 +0300
Subject: Source: Direct aliases to their original commands

---
 bot/cogs/source.py | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 7076c1eb3..0880dd62f 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -54,15 +54,20 @@ class BotSource(Cog):
         url = self.get_source_link(source_item)
         await ctx.send(embed=await self.build_embed(url, source_item))
 
-    @staticmethod
-    def get_source_link(source_item: Union[HelpCommand, Command, Cog]) -> str:
+    def get_source_link(self, source_item: Union[HelpCommand, Command, Cog]) -> str:
         """Build GitHub link of source item."""
         if isinstance(source_item, HelpCommand):
             src = type(source_item)
             filename = inspect.getsourcefile(src)
         elif isinstance(source_item, Command):
-            src = source_item.callback.__code__
-            filename = src.co_filename
+            if source_item.cog_name == "Alias":
+                cmd_name = source_item.callback.__name__.replace("_alias", "")
+                cmd = self.bot.get_command(cmd_name.replace("_", " "))
+                src = cmd.callback.__code__
+                filename = src.co_filename
+            else:
+                src = source_item.callback.__code__
+                filename = src.co_filename
         else:
             src = type(source_item)
             filename = inspect.getsourcefile(src)
@@ -72,15 +77,20 @@ class BotSource(Cog):
 
         return f"{URLs.github_bot_repo}/blob/master/{file_location}#L{first_line_no}-L{first_line_no+len(lines)-1}"
 
-    @staticmethod
-    async def build_embed(link: str, source_object: Union[HelpCommand, Command, Cog]) -> Embed:
+    async def build_embed(self, link: str, source_object: Union[HelpCommand, Command, Cog]) -> Embed:
         """Build embed based on source object."""
         if isinstance(source_object, HelpCommand):
             title = "Help"
             description = source_object.__doc__
         elif isinstance(source_object, Command):
+            if source_object.cog_name == "Alias":
+                cmd_name = source_object.callback.__name__.replace("_alias", "")
+                cmd = self.bot.get_command(cmd_name.replace("_", " "))
+                description = cmd.help
+            else:
+                description = source_object.help
+
             title = source_object.qualified_name
-            description = source_object.help
         else:
             title = source_object.qualified_name
             description = source_object.description
-- 
cgit v1.2.3


From a064e2b6b4f6fabdb6a0fae5de5ee957dbb85b75 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 09:31:07 +0300
Subject: Source: Implement tags file showing to source command

---
 bot/cogs/source.py | 43 +++++++++++++++++++++++++++----------------
 1 file changed, 27 insertions(+), 16 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 0880dd62f..1c702f81d 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -10,21 +10,22 @@ from bot.constants import URLs
 
 
 class SourceConverter(Converter):
-    """Convert an argument into a help command, command, or cog."""
-
-    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog]:
-        """
-        Convert argument into source object.
-
-        Order how arguments is checked:
-        1. When argument is `help`, return bot help command
-        2. When argument is valid command, return this command
-        3. When argument is valid Cog, return this Cog
-        4. Otherwise raise `BadArgument` error
-        """
+    """Convert an argument into a help command, tag, command, or cog."""
+
+    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog, str]:
+        """Convert argument into source object."""
         if argument.lower() == "help":
             return ctx.bot.help_command
 
+        tags_cog = ctx.bot.get_cog("Tags")
+
+        if argument.lower() in tags_cog._cache:
+            tag = argument.lower()
+            if tags_cog._cache[tag]["restricted_to"] != "developers":
+                return f"bot/resources/tags/{tags_cog._cache[tag]['restricted_to']}/{tag}.md"
+            else:
+                return f"bot/resources/tags/{tag}.md"
+
         cmd = ctx.bot.get_command(argument)
         if cmd:
             return cmd
@@ -44,7 +45,7 @@ class BotSource(Cog):
 
     @command(name="source", aliases=("src",))
     async def source_command(self, ctx: Context, *, source_item: SourceConverter = None) -> None:
-        """Display information and a GitHub link to the source code of a command or cog."""
+        """Display information and a GitHub link to the source code of a command, tag, or cog."""
         if not source_item:
             embed = Embed(title="Bot GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
@@ -54,7 +55,7 @@ class BotSource(Cog):
         url = self.get_source_link(source_item)
         await ctx.send(embed=await self.build_embed(url, source_item))
 
-    def get_source_link(self, source_item: Union[HelpCommand, Command, Cog]) -> str:
+    def get_source_link(self, source_item: Union[HelpCommand, Command, Cog, str]) -> str:
         """Build GitHub link of source item."""
         if isinstance(source_item, HelpCommand):
             src = type(source_item)
@@ -68,14 +69,21 @@ class BotSource(Cog):
             else:
                 src = source_item.callback.__code__
                 filename = src.co_filename
+        elif isinstance(source_item, str):
+            filename = source_item
         else:
             src = type(source_item)
             filename = inspect.getsourcefile(src)
 
-        lines, first_line_no = inspect.getsourcelines(src)
+        if not isinstance(source_item, str):
+            lines, first_line_no = inspect.getsourcelines(src)
+            lines_extension = f"#L{first_line_no}-L{first_line_no+len(lines)-1}"
+        else:
+            lines_extension = ""
+
         file_location = os.path.relpath(filename)
 
-        return f"{URLs.github_bot_repo}/blob/master/{file_location}#L{first_line_no}-L{first_line_no+len(lines)-1}"
+        return f"{URLs.github_bot_repo}/blob/master/{file_location}{lines_extension}"
 
     async def build_embed(self, link: str, source_object: Union[HelpCommand, Command, Cog]) -> Embed:
         """Build embed based on source object."""
@@ -91,6 +99,9 @@ class BotSource(Cog):
                 description = source_object.help
 
             title = source_object.qualified_name
+        elif isinstance(source_object, str):
+            title = f"Tag: {source_object.split('/')[-1].split('.')[0]}"
+            description = ""
         else:
             title = source_object.qualified_name
             description = source_object.description
-- 
cgit v1.2.3


From bb6cc2193cad398d68db29d4f991fce94ae06549 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 09:44:34 +0300
Subject: Source: Migrate from os.path to Path

---
 bot/cogs/source.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 1c702f81d..21f18f45f 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -1,5 +1,5 @@
 import inspect
-import os
+from pathlib import Path
 from typing import Union
 
 from discord import Embed
@@ -22,9 +22,9 @@ class SourceConverter(Converter):
         if argument.lower() in tags_cog._cache:
             tag = argument.lower()
             if tags_cog._cache[tag]["restricted_to"] != "developers":
-                return f"bot/resources/tags/{tags_cog._cache[tag]['restricted_to']}/{tag}.md"
+                return f"/bot/bot/resources/tags/{tags_cog._cache[tag]['restricted_to']}/{tag}.md"
             else:
-                return f"bot/resources/tags/{tag}.md"
+                return f"/bot/bot/resources/tags/{tag}.md"
 
         cmd = ctx.bot.get_command(argument)
         if cmd:
@@ -74,6 +74,7 @@ class BotSource(Cog):
         else:
             src = type(source_item)
             filename = inspect.getsourcefile(src)
+            print(filename)
 
         if not isinstance(source_item, str):
             lines, first_line_no = inspect.getsourcelines(src)
@@ -81,7 +82,8 @@ class BotSource(Cog):
         else:
             lines_extension = ""
 
-        file_location = os.path.relpath(filename)
+        file_location = Path(filename).relative_to("/bot/")
+        print(file_location)
 
         return f"{URLs.github_bot_repo}/blob/master/{file_location}{lines_extension}"
 
-- 
cgit v1.2.3


From 9db1377d8c4796d0e2eedc8eeee039566a7770b5 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 09:46:15 +0300
Subject: Source: Move big unions to variable of type

---
 bot/cogs/source.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 21f18f45f..40200eb69 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -8,11 +8,13 @@ from discord.ext.commands import BadArgument, Cog, Command, Context, Converter,
 from bot.bot import Bot
 from bot.constants import URLs
 
+SourceType = Union[HelpCommand, Command, Cog, str]
+
 
 class SourceConverter(Converter):
     """Convert an argument into a help command, tag, command, or cog."""
 
-    async def convert(self, ctx: Context, argument: str) -> Union[HelpCommand, Command, Cog, str]:
+    async def convert(self, ctx: Context, argument: str) -> SourceType:
         """Convert argument into source object."""
         if argument.lower() == "help":
             return ctx.bot.help_command
@@ -55,7 +57,7 @@ class BotSource(Cog):
         url = self.get_source_link(source_item)
         await ctx.send(embed=await self.build_embed(url, source_item))
 
-    def get_source_link(self, source_item: Union[HelpCommand, Command, Cog, str]) -> str:
+    def get_source_link(self, source_item: SourceType) -> str:
         """Build GitHub link of source item."""
         if isinstance(source_item, HelpCommand):
             src = type(source_item)
@@ -87,7 +89,7 @@ class BotSource(Cog):
 
         return f"{URLs.github_bot_repo}/blob/master/{file_location}{lines_extension}"
 
-    async def build_embed(self, link: str, source_object: Union[HelpCommand, Command, Cog]) -> Embed:
+    async def build_embed(self, link: str, source_object: SourceType) -> Embed:
         """Build embed based on source object."""
         if isinstance(source_object, HelpCommand):
             title = "Help"
-- 
cgit v1.2.3


From 2db5add0893d090b7bdbc172ea2e83044301b2f6 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 09:54:01 +0300
Subject: Source: Implement file and line showing in source embed footer

---
 bot/cogs/source.py | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 40200eb69..fbe519c43 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -1,6 +1,6 @@
 import inspect
 from pathlib import Path
-from typing import Union
+from typing import Optional, Tuple, Union
 
 from discord import Embed
 from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, command
@@ -54,10 +54,10 @@ class BotSource(Cog):
             await ctx.send(embed=embed)
             return
 
-        url = self.get_source_link(source_item)
-        await ctx.send(embed=await self.build_embed(url, source_item))
+        url, location, first_line = self.get_source_link(source_item)
+        await ctx.send(embed=await self.build_embed(url, source_item, location, first_line))
 
-    def get_source_link(self, source_item: SourceType) -> str:
+    def get_source_link(self, source_item: SourceType) -> Tuple[str, str, Optional[int]]:
         """Build GitHub link of source item."""
         if isinstance(source_item, HelpCommand):
             src = type(source_item)
@@ -82,14 +82,15 @@ class BotSource(Cog):
             lines, first_line_no = inspect.getsourcelines(src)
             lines_extension = f"#L{first_line_no}-L{first_line_no+len(lines)-1}"
         else:
+            first_line_no = None
             lines_extension = ""
 
         file_location = Path(filename).relative_to("/bot/")
-        print(file_location)
+        url = f"{URLs.github_bot_repo}/blob/master/{file_location}{lines_extension}"
 
-        return f"{URLs.github_bot_repo}/blob/master/{file_location}{lines_extension}"
+        return url, file_location, first_line_no or None
 
-    async def build_embed(self, link: str, source_object: SourceType) -> Embed:
+    async def build_embed(self, link: str, source_object: SourceType, loc: str, first_line: Optional[int]) -> Embed:
         """Build embed based on source object."""
         if isinstance(source_object, HelpCommand):
             title = "Help"
@@ -112,6 +113,8 @@ class BotSource(Cog):
 
         embed = Embed(title=title, description=description)
         embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
+        line_text = f":{first_line}" if first_line else ""
+        embed.set_footer(text=f"{loc}{line_text}")
 
         return embed
 
-- 
cgit v1.2.3


From ff308186375eee5ddf734d9d0d49879c49995b29 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 11:53:28 +0300
Subject: Source: Show only first line of every source item docstring instead
 full

---
 bot/cogs/source.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index fbe519c43..232ee618e 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -76,7 +76,6 @@ class BotSource(Cog):
         else:
             src = type(source_item)
             filename = inspect.getsourcefile(src)
-            print(filename)
 
         if not isinstance(source_item, str):
             lines, first_line_no = inspect.getsourcelines(src)
@@ -94,14 +93,14 @@ class BotSource(Cog):
         """Build embed based on source object."""
         if isinstance(source_object, HelpCommand):
             title = "Help"
-            description = source_object.__doc__
+            description = source_object.__doc__.splitlines()[1]
         elif isinstance(source_object, Command):
             if source_object.cog_name == "Alias":
                 cmd_name = source_object.callback.__name__.replace("_alias", "")
                 cmd = self.bot.get_command(cmd_name.replace("_", " "))
-                description = cmd.help
+                description = cmd.short_doc
             else:
-                description = source_object.help
+                description = source_object.short_doc
 
             title = source_object.qualified_name
         elif isinstance(source_object, str):
@@ -109,7 +108,7 @@ class BotSource(Cog):
             description = ""
         else:
             title = source_object.qualified_name
-            description = source_object.description
+            description = source_object.description.splitlines()[0]
 
         embed = Embed(title=title, description=description)
         embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
-- 
cgit v1.2.3


From 522c7489ea86d5c150145d610fc3a0fef7bd16bc Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 11:55:14 +0300
Subject: Source: Add thumbnail to source command bot repo embed

---
 bot/cogs/source.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 232ee618e..3f03f790c 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -51,6 +51,7 @@ class BotSource(Cog):
         if not source_item:
             embed = Embed(title="Bot GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
+            embed.set_thumbnail(url="https://avatars1.githubusercontent.com/u/9919")
             await ctx.send(embed=embed)
             return
 
-- 
cgit v1.2.3


From ed8298cad287c2bc37566d2688b77dc64d62a7af Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 11:57:29 +0300
Subject: Source: Few text fixes, made help command detection better

---
 bot/cogs/source.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 3f03f790c..32f8d5e08 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -16,7 +16,7 @@ class SourceConverter(Converter):
 
     async def convert(self, ctx: Context, argument: str) -> SourceType:
         """Convert argument into source object."""
-        if argument.lower() == "help":
+        if argument.lower().startswith("help"):
             return ctx.bot.help_command
 
         tags_cog = ctx.bot.get_cog("Tags")
@@ -49,7 +49,7 @@ class BotSource(Cog):
     async def source_command(self, ctx: Context, *, source_item: SourceConverter = None) -> None:
         """Display information and a GitHub link to the source code of a command, tag, or cog."""
         if not source_item:
-            embed = Embed(title="Bot GitHub Repository")
+            embed = Embed(title="Bot's GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
             embed.set_thumbnail(url="https://avatars1.githubusercontent.com/u/9919")
             await ctx.send(embed=embed)
@@ -93,7 +93,7 @@ class BotSource(Cog):
     async def build_embed(self, link: str, source_object: SourceType, loc: str, first_line: Optional[int]) -> Embed:
         """Build embed based on source object."""
         if isinstance(source_object, HelpCommand):
-            title = "Help"
+            title = "Help Command"
             description = source_object.__doc__.splitlines()[1]
         elif isinstance(source_object, Command):
             if source_object.cog_name == "Alias":
-- 
cgit v1.2.3


From 0a4b365f5efdb31450647b8d628b3787142d4617 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 11:58:54 +0300
Subject: Source: Add command and cog prefixes to title of embed

---
 bot/cogs/source.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 32f8d5e08..9e6109ca2 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -103,12 +103,12 @@ class BotSource(Cog):
             else:
                 description = source_object.short_doc
 
-            title = source_object.qualified_name
+            title = f"Command: {source_object.qualified_name}"
         elif isinstance(source_object, str):
             title = f"Tag: {source_object.split('/')[-1].split('.')[0]}"
             description = ""
         else:
-            title = source_object.qualified_name
+            title = f"Cog: {source_object.qualified_name}"
             description = source_object.description.splitlines()[0]
 
         embed = Embed(title=title, description=description)
-- 
cgit v1.2.3


From 0007fb7e50f273108e70bcafbd736bfc75ce3e51 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 11:59:44 +0300
Subject: Source: In converter move cog checking before command

---
 bot/cogs/source.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 9e6109ca2..a5f90e490 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -28,14 +28,14 @@ class SourceConverter(Converter):
             else:
                 return f"/bot/bot/resources/tags/{tag}.md"
 
-        cmd = ctx.bot.get_command(argument)
-        if cmd:
-            return cmd
-
         cog = ctx.bot.get_cog(argument)
         if cog:
             return cog
 
+        cmd = ctx.bot.get_command(argument)
+        if cmd:
+            return cmd
+
         raise BadArgument(f"Unable to convert `{argument}` to valid command or Cog.")
 
 
-- 
cgit v1.2.3


From aa83e72bd28f822c6ba84d73c5be05c6aea5d59b Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 12:01:26 +0300
Subject: Source: Simplify imports

---
 bot/cogs/source.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index a5f90e490..5668ab6c6 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -3,18 +3,18 @@ from pathlib import Path
 from typing import Optional, Tuple, Union
 
 from discord import Embed
-from discord.ext.commands import BadArgument, Cog, Command, Context, Converter, HelpCommand, command
+from discord.ext import commands
 
 from bot.bot import Bot
 from bot.constants import URLs
 
-SourceType = Union[HelpCommand, Command, Cog, str]
+SourceType = Union[commands.HelpCommand, commands.Command, commands.Cog, str]
 
 
-class SourceConverter(Converter):
+class SourceConverter(commands.Converter):
     """Convert an argument into a help command, tag, command, or cog."""
 
-    async def convert(self, ctx: Context, argument: str) -> SourceType:
+    async def convert(self, ctx: commands.Context, argument: str) -> SourceType:
         """Convert argument into source object."""
         if argument.lower().startswith("help"):
             return ctx.bot.help_command
@@ -36,17 +36,17 @@ class SourceConverter(Converter):
         if cmd:
             return cmd
 
-        raise BadArgument(f"Unable to convert `{argument}` to valid command or Cog.")
+        raise commands.BadArgument(f"Unable to convert `{argument}` to valid command or Cog.")
 
 
-class BotSource(Cog):
+class BotSource(commands.Cog):
     """Displays information about the bot's source code."""
 
     def __init__(self, bot: Bot):
         self.bot = bot
 
-    @command(name="source", aliases=("src",))
-    async def source_command(self, ctx: Context, *, source_item: SourceConverter = None) -> None:
+    @commands.command(name="source", aliases=("src",))
+    async def source_command(self, ctx: commands.Context, *, source_item: SourceConverter = None) -> None:
         """Display information and a GitHub link to the source code of a command, tag, or cog."""
         if not source_item:
             embed = Embed(title="Bot's GitHub Repository")
@@ -60,10 +60,10 @@ class BotSource(Cog):
 
     def get_source_link(self, source_item: SourceType) -> Tuple[str, str, Optional[int]]:
         """Build GitHub link of source item."""
-        if isinstance(source_item, HelpCommand):
+        if isinstance(source_item, commands.HelpCommand):
             src = type(source_item)
             filename = inspect.getsourcefile(src)
-        elif isinstance(source_item, Command):
+        elif isinstance(source_item, commands.Command):
             if source_item.cog_name == "Alias":
                 cmd_name = source_item.callback.__name__.replace("_alias", "")
                 cmd = self.bot.get_command(cmd_name.replace("_", " "))
@@ -92,10 +92,10 @@ class BotSource(Cog):
 
     async def build_embed(self, link: str, source_object: SourceType, loc: str, first_line: Optional[int]) -> Embed:
         """Build embed based on source object."""
-        if isinstance(source_object, HelpCommand):
+        if isinstance(source_object, commands.HelpCommand):
             title = "Help Command"
             description = source_object.__doc__.splitlines()[1]
-        elif isinstance(source_object, Command):
+        elif isinstance(source_object, commands.Command):
             if source_object.cog_name == "Alias":
                 cmd_name = source_object.callback.__name__.replace("_alias", "")
                 cmd = self.bot.get_command(cmd_name.replace("_", " "))
-- 
cgit v1.2.3


From 30510d6cfd877e5441022b8a8d893871fbf2a0a9 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 12:16:26 +0300
Subject: Source: Show aliases on title of command source embed

---
 bot/cogs/source.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 5668ab6c6..8fd8cbed4 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -103,7 +103,8 @@ class BotSource(commands.Cog):
             else:
                 description = source_object.short_doc
 
-            title = f"Command: {source_object.qualified_name}"
+            aliases_string = f" (or {', '.join(source_object.aliases)})" if source_object.aliases else ""
+            title = f"Command: {source_object.qualified_name}{aliases_string}"
         elif isinstance(source_object, str):
             title = f"Tag: {source_object.split('/')[-1].split('.')[0]}"
             description = ""
-- 
cgit v1.2.3


From 2c0cb510219a27a875628ff4453be2ba7f0a9d7f Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Sun, 31 May 2020 12:17:10 +0300
Subject: Source: Include tag into converter's `BadArgument` raising

---
 bot/cogs/source.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 8fd8cbed4..a3922297a 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -36,7 +36,7 @@ class SourceConverter(commands.Converter):
         if cmd:
             return cmd
 
-        raise commands.BadArgument(f"Unable to convert `{argument}` to valid command or Cog.")
+        raise commands.BadArgument(f"Unable to convert `{argument}` to valid command, tag, or Cog.")
 
 
 class BotSource(commands.Cog):
-- 
cgit v1.2.3


From 00f52a15c67fa2a8dc9dc87769ba56cff9e2cdf4 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Mon, 1 Jun 2020 07:55:49 +0300
Subject: Tags: Add tag file location storage to cache

---
 bot/cogs/tags.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bot/cogs/tags.py b/bot/cogs/tags.py
index 6f03a3475..571c0ed28 100644
--- a/bot/cogs/tags.py
+++ b/bot/cogs/tags.py
@@ -47,6 +47,7 @@ class Tags(Cog):
                         "description": file.read_text(encoding="utf8"),
                     },
                     "restricted_to": "developers",
+                    "location": str(file)
                 }
 
                 # Convert to a list to allow negative indexing.
-- 
cgit v1.2.3


From 9f93a40bb8d8bd7d0538465f9d4eda79d02e540c Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Mon, 1 Jun 2020 08:11:41 +0300
Subject: Source: Simplify tags name and location parsing

---
 bot/cogs/source.py | 22 ++++++++++++++--------
 bot/cogs/tags.py   |  2 +-
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index a3922297a..e01209c28 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -21,12 +21,8 @@ class SourceConverter(commands.Converter):
 
         tags_cog = ctx.bot.get_cog("Tags")
 
-        if argument.lower() in tags_cog._cache:
-            tag = argument.lower()
-            if tags_cog._cache[tag]["restricted_to"] != "developers":
-                return f"/bot/bot/resources/tags/{tags_cog._cache[tag]['restricted_to']}/{tag}.md"
-            else:
-                return f"/bot/bot/resources/tags/{tag}.md"
+        if tags_cog and argument.lower() in tags_cog._cache:
+            return argument.lower()
 
         cog = ctx.bot.get_cog(argument)
         if cog:
@@ -56,6 +52,12 @@ class BotSource(commands.Cog):
             return
 
         url, location, first_line = self.get_source_link(source_item)
+
+        # There is no URL only when bot can't fetch Tags cog
+        if not url:
+            await ctx.send("Unable to get `Tags` cog.")
+            return
+
         await ctx.send(embed=await self.build_embed(url, source_item, location, first_line))
 
     def get_source_link(self, source_item: SourceType) -> Tuple[str, str, Optional[int]]:
@@ -73,7 +75,11 @@ class BotSource(commands.Cog):
                 src = source_item.callback.__code__
                 filename = src.co_filename
         elif isinstance(source_item, str):
-            filename = source_item
+            tags_cog = self.bot.get_cog("Tags")
+            if not tags_cog:
+                return "", "", None
+
+            filename = tags_cog._cache[source_item]["location"]
         else:
             src = type(source_item)
             filename = inspect.getsourcefile(src)
@@ -106,7 +112,7 @@ class BotSource(commands.Cog):
             aliases_string = f" (or {', '.join(source_object.aliases)})" if source_object.aliases else ""
             title = f"Command: {source_object.qualified_name}{aliases_string}"
         elif isinstance(source_object, str):
-            title = f"Tag: {source_object.split('/')[-1].split('.')[0]}"
+            title = f"Tag: {source_object}"
             description = ""
         else:
             title = f"Cog: {source_object.qualified_name}"
diff --git a/bot/cogs/tags.py b/bot/cogs/tags.py
index 571c0ed28..3d76c5c08 100644
--- a/bot/cogs/tags.py
+++ b/bot/cogs/tags.py
@@ -47,7 +47,7 @@ class Tags(Cog):
                         "description": file.read_text(encoding="utf8"),
                     },
                     "restricted_to": "developers",
-                    "location": str(file)
+                    "location": f"/bot/{file}"
                 }
 
                 # Convert to a list to allow negative indexing.
-- 
cgit v1.2.3


From c397b871fbce903f251abd32662d40d33a95e0de Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Mon, 1 Jun 2020 08:16:59 +0300
Subject: Source: Move calling `get_source_link` to `build_embed`

---
 bot/cogs/source.py | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index e01209c28..00a5b344b 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -51,14 +51,11 @@ class BotSource(commands.Cog):
             await ctx.send(embed=embed)
             return
 
-        url, location, first_line = self.get_source_link(source_item)
+        embed = await self.build_embed(source_item, ctx)
 
-        # There is no URL only when bot can't fetch Tags cog
-        if not url:
-            await ctx.send("Unable to get `Tags` cog.")
-            return
-
-        await ctx.send(embed=await self.build_embed(url, source_item, location, first_line))
+        # When embed don't exist, then there was error and this is already handled.
+        if embed:
+            await ctx.send(embed=await self.build_embed(source_item, ctx))
 
     def get_source_link(self, source_item: SourceType) -> Tuple[str, str, Optional[int]]:
         """Build GitHub link of source item."""
@@ -96,8 +93,15 @@ class BotSource(commands.Cog):
 
         return url, file_location, first_line_no or None
 
-    async def build_embed(self, link: str, source_object: SourceType, loc: str, first_line: Optional[int]) -> Embed:
+    async def build_embed(self, source_object: SourceType, ctx: commands.Context) -> Optional[Embed]:
         """Build embed based on source object."""
+        url, location, first_line = self.get_source_link(source_object)
+
+        # There is no URL only when bot can't fetch Tags cog
+        if not url:
+            await ctx.send("Unable to get `Tags` cog.")
+            return
+
         if isinstance(source_object, commands.HelpCommand):
             title = "Help Command"
             description = source_object.__doc__.splitlines()[1]
@@ -119,9 +123,9 @@ class BotSource(commands.Cog):
             description = source_object.description.splitlines()[0]
 
         embed = Embed(title=title, description=description)
-        embed.add_field(name="Source Code", value=f"[Go to GitHub]({link})")
+        embed.add_field(name="Source Code", value=f"[Go to GitHub]({url})")
         line_text = f":{first_line}" if first_line else ""
-        embed.set_footer(text=f"{loc}{line_text}")
+        embed.set_footer(text=f"{location}{line_text}")
 
         return embed
 
-- 
cgit v1.2.3


From 18968d27ae5bc3b004c881a0c78bcfb305371158 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Mon, 1 Jun 2020 08:18:27 +0300
Subject: Source: Update `get_source_link` docstring

---
 bot/cogs/source.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 00a5b344b..50fd4599d 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -58,7 +58,7 @@ class BotSource(commands.Cog):
             await ctx.send(embed=await self.build_embed(source_item, ctx))
 
     def get_source_link(self, source_item: SourceType) -> Tuple[str, str, Optional[int]]:
-        """Build GitHub link of source item."""
+        """Build GitHub link of source item, return this link, file location and first line number."""
         if isinstance(source_item, commands.HelpCommand):
             src = type(source_item)
             filename = inspect.getsourcefile(src)
-- 
cgit v1.2.3


From ea937e5a69b4cf233216510c96800bdf5940ff16 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Mon, 1 Jun 2020 08:19:21 +0300
Subject: Source: Remove showing aliases for commands

---
 bot/cogs/source.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 50fd4599d..57ae17f77 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -113,8 +113,7 @@ class BotSource(commands.Cog):
             else:
                 description = source_object.short_doc
 
-            aliases_string = f" (or {', '.join(source_object.aliases)})" if source_object.aliases else ""
-            title = f"Command: {source_object.qualified_name}{aliases_string}"
+            title = f"Command: {source_object.qualified_name}"
         elif isinstance(source_object, str):
             title = f"Tag: {source_object}"
             description = ""
-- 
cgit v1.2.3


From 8429c2284901675297c78f00bf0e5a6b15d80e31 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Mon, 1 Jun 2020 13:17:40 +0300
Subject: Source: Refactor Tags cog missing handling

---
 bot/cogs/source.py | 36 ++++++++++++++++--------------------
 1 file changed, 16 insertions(+), 20 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 57ae17f77..32a78a0c0 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -8,7 +8,7 @@ from discord.ext import commands
 from bot.bot import Bot
 from bot.constants import URLs
 
-SourceType = Union[commands.HelpCommand, commands.Command, commands.Cog, str]
+SourceType = Union[commands.HelpCommand, commands.Command, commands.Cog, str, commands.ExtensionNotLoaded]
 
 
 class SourceConverter(commands.Converter):
@@ -19,11 +19,6 @@ class SourceConverter(commands.Converter):
         if argument.lower().startswith("help"):
             return ctx.bot.help_command
 
-        tags_cog = ctx.bot.get_cog("Tags")
-
-        if tags_cog and argument.lower() in tags_cog._cache:
-            return argument.lower()
-
         cog = ctx.bot.get_cog(argument)
         if cog:
             return cog
@@ -32,6 +27,14 @@ class SourceConverter(commands.Converter):
         if cmd:
             return cmd
 
+        tags_cog = ctx.bot.get_cog("Tags")
+
+        if not tags_cog:
+            await ctx.send("Unable to get `Tags` cog.")
+            return commands.ExtensionNotLoaded("bot.cogs.tags")
+        elif argument.lower() in tags_cog._cache:
+            return argument.lower()
+
         raise commands.BadArgument(f"Unable to convert `{argument}` to valid command, tag, or Cog.")
 
 
@@ -44,6 +47,10 @@ class BotSource(commands.Cog):
     @commands.command(name="source", aliases=("src",))
     async def source_command(self, ctx: commands.Context, *, source_item: SourceConverter = None) -> None:
         """Display information and a GitHub link to the source code of a command, tag, or cog."""
+        # When we have problem to get Tags cog, exit early
+        if isinstance(source_item, commands.ExtensionNotLoaded):
+            return
+
         if not source_item:
             embed = Embed(title="Bot's GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
@@ -51,11 +58,8 @@ class BotSource(commands.Cog):
             await ctx.send(embed=embed)
             return
 
-        embed = await self.build_embed(source_item, ctx)
-
-        # When embed don't exist, then there was error and this is already handled.
-        if embed:
-            await ctx.send(embed=await self.build_embed(source_item, ctx))
+        embed = await self.build_embed(source_item)
+        await ctx.send(embed=embed)
 
     def get_source_link(self, source_item: SourceType) -> Tuple[str, str, Optional[int]]:
         """Build GitHub link of source item, return this link, file location and first line number."""
@@ -73,9 +77,6 @@ class BotSource(commands.Cog):
                 filename = src.co_filename
         elif isinstance(source_item, str):
             tags_cog = self.bot.get_cog("Tags")
-            if not tags_cog:
-                return "", "", None
-
             filename = tags_cog._cache[source_item]["location"]
         else:
             src = type(source_item)
@@ -93,15 +94,10 @@ class BotSource(commands.Cog):
 
         return url, file_location, first_line_no or None
 
-    async def build_embed(self, source_object: SourceType, ctx: commands.Context) -> Optional[Embed]:
+    async def build_embed(self, source_object: SourceType) -> Optional[Embed]:
         """Build embed based on source object."""
         url, location, first_line = self.get_source_link(source_object)
 
-        # There is no URL only when bot can't fetch Tags cog
-        if not url:
-            await ctx.send("Unable to get `Tags` cog.")
-            return
-
         if isinstance(source_object, commands.HelpCommand):
             title = "Help Command"
             description = source_object.__doc__.splitlines()[1]
-- 
cgit v1.2.3


From 51d681654d9a9acc71763edffcea0d5eb1ef1b29 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Thu, 18 Jun 2020 08:13:15 +0300
Subject: Source: Simplify missing tag cog handling

---
 bot/cogs/source.py | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 32a78a0c0..d59371c6e 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -29,10 +29,7 @@ class SourceConverter(commands.Converter):
 
         tags_cog = ctx.bot.get_cog("Tags")
 
-        if not tags_cog:
-            await ctx.send("Unable to get `Tags` cog.")
-            return commands.ExtensionNotLoaded("bot.cogs.tags")
-        elif argument.lower() in tags_cog._cache:
+        if tags_cog and argument.lower() in tags_cog._cache:
             return argument.lower()
 
         raise commands.BadArgument(f"Unable to convert `{argument}` to valid command, tag, or Cog.")
@@ -47,10 +44,6 @@ class BotSource(commands.Cog):
     @commands.command(name="source", aliases=("src",))
     async def source_command(self, ctx: commands.Context, *, source_item: SourceConverter = None) -> None:
         """Display information and a GitHub link to the source code of a command, tag, or cog."""
-        # When we have problem to get Tags cog, exit early
-        if isinstance(source_item, commands.ExtensionNotLoaded):
-            return
-
         if not source_item:
             embed = Embed(title="Bot's GitHub Repository")
             embed.add_field(name="Repository", value=f"[Go to GitHub]({URLs.github_bot_repo})")
-- 
cgit v1.2.3


From 31f53259fd73503399b904e5a7075ceeded4c742 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Thu, 18 Jun 2020 08:58:18 +0300
Subject: Source: Split handling tag and other source items file location

---
 bot/cogs/source.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index d59371c6e..2ca852af3 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -82,7 +82,12 @@ class BotSource(commands.Cog):
             first_line_no = None
             lines_extension = ""
 
-        file_location = Path(filename).relative_to("/bot/")
+        # Handle tag file location differently than others to avoid errors in some cases
+        if not first_line_no:
+            file_location = Path(filename).relative_to("/bot/")
+        else:
+            file_location = Path(filename).relative_to(Path.cwd()).as_posix()
+
         url = f"{URLs.github_bot_repo}/blob/master/{file_location}{lines_extension}"
 
         return url, file_location, first_line_no or None
-- 
cgit v1.2.3


From caa421054669f886750a54fb2fdbea3315c58a58 Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Thu, 18 Jun 2020 09:07:47 +0300
Subject: Source: Exclude `tag` from error message when tags cog not loaded

---
 bot/cogs/source.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 2ca852af3..223552651 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -28,11 +28,14 @@ class SourceConverter(commands.Converter):
             return cmd
 
         tags_cog = ctx.bot.get_cog("Tags")
+        show_tag = True
 
-        if tags_cog and argument.lower() in tags_cog._cache:
+        if not tags_cog:
+            show_tag = False
+        elif argument.lower() in tags_cog._cache:
             return argument.lower()
 
-        raise commands.BadArgument(f"Unable to convert `{argument}` to valid command, tag, or Cog.")
+        raise commands.BadArgument(f"Unable to convert `{argument}` to valid command{', tag,' if show_tag else ''} or Cog.")
 
 
 class BotSource(commands.Cog):
-- 
cgit v1.2.3


From 4c9a62f93fd7b92051dd40e4d799236d65e154ab Mon Sep 17 00:00:00 2001
From: ks129 <45097959+ks129@users.noreply.github.com>
Date: Thu, 18 Jun 2020 09:10:55 +0300
Subject: Source: Split to multiple lines to fix too long line on error raising

---
 bot/cogs/source.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bot/cogs/source.py b/bot/cogs/source.py
index 223552651..f1db745cd 100644
--- a/bot/cogs/source.py
+++ b/bot/cogs/source.py
@@ -35,7 +35,9 @@ class SourceConverter(commands.Converter):
         elif argument.lower() in tags_cog._cache:
             return argument.lower()
 
-        raise commands.BadArgument(f"Unable to convert `{argument}` to valid command{', tag,' if show_tag else ''} or Cog.")
+        raise commands.BadArgument(
+            f"Unable to convert `{argument}` to valid command{', tag,' if show_tag else ''} or Cog."
+        )
 
 
 class BotSource(commands.Cog):
-- 
cgit v1.2.3