docs: Suppress Mkdocs warnings (#1386)

* docs: Suppress Mkdocs warnings

* fix: change kwargs typehint

Author: mAxYoLo01

README.md

@@ -37,7 +37,7 @@ In addition to core functionality, `interactions.py` provides a range of optiona
 
 So the base library doesn't do what you want? No problem! With builtin extensions, you are able to extend the functionality of the library. And if none of those pique your interest, there are a myriad of other extension libraries available.
 
-Just type `bot.load("extension")`
+Just type `bot.load_extension("extension")`
 
 <details>
     <summary>Extensions</summary>

docs/src/index.md

@@ -34,7 +34,7 @@ In addition to core functionality, interactions.py provides a range of optional
 
 So the base library doesn't do what you want? No problem! With builtin extensions, you are able to extend the functionality of the library. And if none of those pique your interest, there are a myriad of other extension libraries available.
 
-Just type `bot.load("extension")`
+Just type `bot.load_extension("extension")`
 
 ---
 

interactions/api/http/http_requests/guild.py

@@ -1,17 +1,18 @@
-from typing import TYPE_CHECKING, List, cast, Mapping, Any
+from typing import TYPE_CHECKING, Any, List, Mapping, cast
 
 import discord_typings
 
 from interactions.client.utils.serializer import dict_filter_none
 from interactions.models.internal.protocols import CanRequest
-from ..route import Route, PAYLOAD_TYPE
+
+from ..route import PAYLOAD_TYPE, Route
 
 __all__ = ("GuildRequests",)
 
 
 if TYPE_CHECKING:
-    from interactions.models.discord.snowflake import Snowflake_Type
     from interactions.models.discord.enums import AuditLogEventType
+    from interactions.models.discord.snowflake import Snowflake_Type
 
 
 class GuildRequests(CanRequest):
@@ -404,9 +405,6 @@ async def modify_guild_role_positions(
         Args:
             guild_id: The ID of the guild
             position_changes: A list of dicts representing the roles to move and their new positions
-
-            ``{"id": role_id, "position": new_position}``
-
             reason: The reason for this action
 
         Returns:

interactions/client/utils/attr_utils.py

@@ -36,20 +36,20 @@ def docs(doc_string: str) -> Dict[str, str]:
     return {"docs": doc_string}
 
 
-def str_validator(self: Any, attribute: attrs.Attribute, value: Any) -> None:
+def str_validator(cls: Any, attribute: attrs.Attribute, value: Any) -> None:
     """
     Validates that the value is a string. Helps convert and ives a warning if it isn't.
 
     Args:
-        self: The instance of the class.
+        cls: The instance of the class.
         attribute: The attr attribute being validated.
         value: The value being validated.
 
     """
     if not isinstance(value, str):
         if value is MISSING:
             return
-        setattr(self, attribute.name, str(value))
+        setattr(cls, attribute.name, str(value))
         get_logger().warning(
             f"Value of {attribute.name} has been automatically converted to a string. Please use strings in future.\n"
             "Note: Discord will always return value as a string"

interactions/ext/prefixed_commands/context.py

@@ -1,4 +1,4 @@
-from typing import Optional, Union, Iterable, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Iterable, Optional, Union
 
 from typing_extensions import Self
 
@@ -80,7 +80,7 @@ async def reply(
         content: Optional[str] = None,
         embeds: Optional[Union[Iterable[Union[Embed, dict]], Union[Embed, dict]]] = None,
         embed: Optional[Union[Embed, dict]] = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> Message:
         """
         Reply to the context's message. Takes all the same attributes as `send`.

interactions/models/discord/guild.py

@@ -3,47 +3,55 @@
 from asyncio import QueueEmpty
 from collections import namedtuple
 from functools import cmp_to_key
-from typing import List, Optional, Union, Set, Dict, Any, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Set, Union
 from warnings import warn
 
 import attrs
 
 import interactions.models as models
-from interactions.client.const import Absent, MISSING, PREMIUM_GUILD_LIMITS
+from interactions.client.const import MISSING, PREMIUM_GUILD_LIMITS, Absent
 from interactions.client.errors import EventLocationNotProvided, NotFound
 from interactions.client.mixins.serialization import DictSerializationMixin
-from interactions.client.utils.attr_converters import optional, list_converter
-from interactions.client.utils.attr_converters import timestamp_converter
+from interactions.client.utils.attr_converters import optional, list_converter, timestamp_converter
 from interactions.client.utils.attr_utils import docs
 from interactions.client.utils.deserialise_app_cmds import deserialize_app_cmds
-from interactions.client.utils.serializer import to_image_data, no_export_meta
-from interactions.models.discord.app_perms import CommandPermissions, ApplicationCommandPermission
+from interactions.client.utils.serializer import no_export_meta, to_image_data
+from interactions.models.discord.app_perms import (
+    ApplicationCommandPermission,
+    CommandPermissions,
+)
 from interactions.models.discord.auto_mod import AutoModRule, BaseAction, BaseTrigger
 from interactions.models.discord.file import UPLOADABLE_TYPE
 from interactions.models.misc.iterator import AsyncIterator
-from .base import DiscordObject, ClientObject
+
+from .base import ClientObject, DiscordObject
 from .enums import (
-    NSFWLevel,
-    Permissions,
-    SystemChannelFlags,
-    VerificationLevel,
+    AuditLogEventType,
+    AutoModEvent,
+    AutoModTriggerType,
+    ChannelType,
     DefaultNotificationLevel,
     ExplicitContentFilterLevel,
-    MFALevel,
-    ChannelType,
+    ForumLayoutType,
     IntegrationExpireBehaviour,
+    MFALevel,
+    NSFWLevel,
+    Permissions,
     ScheduledEventPrivacyLevel,
     ScheduledEventType,
-    AuditLogEventType,
-    AutoModEvent,
-    AutoModTriggerType,
-    ForumLayoutType,
+    SystemChannelFlags,
+    VerificationLevel,
+)
+from .snowflake import (
+    Snowflake_Type,
+    to_optional_snowflake,
+    to_snowflake,
+    to_snowflake_list,
 )
-from .snowflake import to_snowflake, Snowflake_Type, to_optional_snowflake, to_snowflake_list
 
 if TYPE_CHECKING:
-    from interactions.client.client import Client
     from interactions import InteractionCommand
+    from interactions.client.client import Client
 
 __all__ = (
     "GuildBan",
@@ -581,7 +589,7 @@ async def http_chunk(self) -> None:
             f"Cached {iterator.total_retrieved} members for {self.id} in {time.perf_counter() - start_time:.2f} seconds"
         )
 
-    async def gateway_chunk(self, wait=True, presences=True) -> None:
+    async def gateway_chunk(self, wait: bool = True, presences: bool = True) -> None:
         """
         Trigger a gateway `get_members` event, populating this object with members.
 
@@ -598,7 +606,7 @@ async def chunk(self) -> None:
         """Populates all members of this guild using the REST API."""
         await self.http_chunk()
 
-    async def chunk_guild(self, wait=True, presences=True) -> None:
+    async def chunk_guild(self, wait: bool = True, presences: bool = True) -> None:
         """
         Trigger a gateway `get_members` event, populating this object with members.