aboutsummaryrefslogtreecommitdiffstats
path: root/bot/converters.py
diff options
context:
space:
mode:
Diffstat (limited to 'bot/converters.py')
-rw-r--r--bot/converters.py20
1 files changed, 20 insertions, 0 deletions
diff --git a/bot/converters.py b/bot/converters.py
index 6c87a50fe..3066eaabb 100644
--- a/bot/converters.py
+++ b/bot/converters.py
@@ -15,6 +15,7 @@ from discord.utils import DISCORD_EPOCH, snowflake_time
from bot.api import ResponseCodeError
from bot.constants import URLs
+from bot.exts.info.doc import _inventory_parser
from bot.utils.regex import INVITE_RE
log = logging.getLogger(__name__)
@@ -175,6 +176,25 @@ class ValidURL(Converter):
return url
+class InventoryURL(Converter):
+ """
+ Represents an Intersphinx inventory URL.
+
+ This converter checks whether intersphinx accepts the given inventory URL, and raises
+ `BadArgument` if that is not the case.
+
+ Otherwise, it simply passes through the given URL.
+ """
+
+ @staticmethod
+ async def convert(ctx: Context, url: str) -> str:
+ """Convert url to Intersphinx inventory URL."""
+ await ctx.trigger_typing()
+ if await _inventory_parser.fetch_inventory(ctx.bot.http_session, url) is None:
+ raise BadArgument(f"Failed to fetch inventory file after {_inventory_parser.FAILED_REQUEST_ATTEMPTS}.")
+ return url
+
+
class Snowflake(IDConverter):
"""
Converts to an int if the argument is a valid Discord snowflake.