diff --git a/changelog/1167.misc.rst b/changelog/1167.misc.rst new file mode 100644 index 0000000000..3781b42690 --- /dev/null +++ b/changelog/1167.misc.rst @@ -0,0 +1 @@ +Reduce the amount of unknown (unresolved) types in public-facing APIs. diff --git a/disnake/abc.py b/disnake/abc.py index 64608875df..c0a5211698 100644 --- a/disnake/abc.py +++ b/disnake/abc.py @@ -1150,7 +1150,7 @@ async def move( ) -> None: ... - async def move(self, **kwargs) -> None: + async def move(self, **kwargs: Any) -> None: """|coro| A rich interface to help move a channel relative to other channels. diff --git a/disnake/channel.py b/disnake/channel.py index 779edd36ec..8eaf8dd794 100644 --- a/disnake/channel.py +++ b/disnake/channel.py @@ -3000,7 +3000,7 @@ async def move( ... @utils.copy_doc(disnake.abc.GuildChannel.move) - async def move(self, **kwargs) -> None: + async def move(self, **kwargs: Any) -> None: kwargs.pop("category", None) return await super().move(**kwargs) diff --git a/disnake/ext/commands/base_core.py b/disnake/ext/commands/base_core.py index b5e0498399..ef46210495 100644 --- a/disnake/ext/commands/base_core.py +++ b/disnake/ext/commands/base_core.py @@ -130,7 +130,7 @@ def __new__(cls, *args: Any, **kwargs: Any) -> Self: self.__original_kwargs__ = {k: v for k, v in kwargs.items() if v is not None} return self - def __init__(self, func: CommandCallback, *, name: Optional[str] = None, **kwargs) -> None: + def __init__(self, func: CommandCallback, *, name: Optional[str] = None, **kwargs: Any) -> None: self.__command_flag__ = None self._callback: CommandCallback = func self.name: str = name or func.__name__ @@ -281,7 +281,9 @@ def remove_check(self, func: AppCheck) -> None: except ValueError: pass - async def __call__(self, interaction: ApplicationCommandInteraction, *args, **kwargs) -> Any: + async def __call__( + self, interaction: ApplicationCommandInteraction, *args: Any, **kwargs: Any + ) -> Any: """|coro| Calls the internal callback that the application command holds. @@ -381,7 +383,7 @@ def get_cooldown_retry_after(self, inter: ApplicationCommandInteraction) -> floa return 0.0 # This method isn't really usable in this class, but it's usable in subclasses. - async def invoke(self, inter: ApplicationCommandInteraction, *args, **kwargs) -> None: + async def invoke(self, inter: ApplicationCommandInteraction, *args: Any, **kwargs: Any) -> None: await self.prepare(inter) try: diff --git a/disnake/ext/commands/ctx_menus_core.py b/disnake/ext/commands/ctx_menus_core.py index 835bd674e6..0e84b5a89d 100644 --- a/disnake/ext/commands/ctx_menus_core.py +++ b/disnake/ext/commands/ctx_menus_core.py @@ -78,7 +78,7 @@ def __init__( nsfw: Optional[bool] = None, guild_ids: Optional[Sequence[int]] = None, auto_sync: Optional[bool] = None, - **kwargs, + **kwargs: Any, ) -> None: name_loc = Localized._cast(name, False) super().__init__(func, name=name_loc.string, **kwargs) @@ -122,7 +122,11 @@ async def _call_external_error_handlers( inter.bot.dispatch("user_command_error", inter, error) async def __call__( - self, interaction: ApplicationCommandInteraction, target: Any = None, *args, **kwargs + self, + interaction: ApplicationCommandInteraction, + target: Any = None, + *args: Any, + **kwargs: Any, ) -> None: # the target may just not be passed in args = (target or interaction.target,) + args @@ -180,7 +184,7 @@ def __init__( nsfw: Optional[bool] = None, guild_ids: Optional[Sequence[int]] = None, auto_sync: Optional[bool] = None, - **kwargs, + **kwargs: Any, ) -> None: name_loc = Localized._cast(name, False) super().__init__(func, name=name_loc.string, **kwargs) @@ -218,7 +222,11 @@ async def _call_external_error_handlers( inter.bot.dispatch("message_command_error", inter, error) async def __call__( - self, interaction: ApplicationCommandInteraction, target: Any = None, *args, **kwargs + self, + interaction: ApplicationCommandInteraction, + target: Any = None, + *args: Any, + **kwargs: Any, ) -> None: # the target may just not be passed in args = (target or interaction.target,) + args @@ -237,7 +245,7 @@ def user_command( guild_ids: Optional[Sequence[int]] = None, auto_sync: Optional[bool] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[[InteractionCommandCallback[CogT, UserCommandInteraction, P]], InvokableUserCommand]: """A shortcut decorator that builds a user command. @@ -316,7 +324,7 @@ def message_command( guild_ids: Optional[Sequence[int]] = None, auto_sync: Optional[bool] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[ [InteractionCommandCallback[CogT, MessageCommandInteraction, P]], InvokableMessageCommand, diff --git a/disnake/ext/commands/interaction_bot_base.py b/disnake/ext/commands/interaction_bot_base.py index 5349abeb3e..110066b679 100644 --- a/disnake/ext/commands/interaction_bot_base.py +++ b/disnake/ext/commands/interaction_bot_base.py @@ -494,7 +494,7 @@ def slash_command( connectors: Optional[Dict[str, str]] = None, auto_sync: Optional[bool] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[[CommandCallback], InvokableSlashCommand]: """A shortcut decorator that invokes :func:`~disnake.ext.commands.slash_command` and adds it to the internal command list. @@ -585,7 +585,7 @@ def user_command( guild_ids: Optional[Sequence[int]] = None, auto_sync: Optional[bool] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[ [InteractionCommandCallback[CogT, UserCommandInteraction, P]], InvokableUserCommand ]: @@ -662,7 +662,7 @@ def message_command( guild_ids: Optional[Sequence[int]] = None, auto_sync: Optional[bool] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[ [InteractionCommandCallback[CogT, MessageCommandInteraction, P]], InvokableMessageCommand ]: diff --git a/disnake/ext/commands/slash_core.py b/disnake/ext/commands/slash_core.py index a23cf86bd3..5c8dac4617 100644 --- a/disnake/ext/commands/slash_core.py +++ b/disnake/ext/commands/slash_core.py @@ -142,7 +142,7 @@ def __init__( parent: InvokableSlashCommand, *, name: LocalizedOptional = None, - **kwargs, + **kwargs: Any, ) -> None: name_loc = Localized._cast(name, False) super().__init__(func, name=name_loc.string, **kwargs) @@ -193,7 +193,7 @@ def sub_command( options: Optional[list] = None, connectors: Optional[dict] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[[CommandCallback], SubCommand]: """A decorator that creates a subcommand in the subcommand group. Parameters are the same as in :class:`InvokableSlashCommand.sub_command` @@ -272,7 +272,7 @@ def __init__( description: LocalizedOptional = None, options: Optional[list] = None, connectors: Optional[Dict[str, str]] = None, - **kwargs, + **kwargs: Any, ) -> None: name_loc = Localized._cast(name, False) super().__init__(func, name=name_loc.string, **kwargs) @@ -345,7 +345,7 @@ async def _call_autocompleter( ) -> Optional[Choices]: return await _call_autocompleter(self, param, inter, user_input) - async def invoke(self, inter: ApplicationCommandInteraction, *args, **kwargs) -> None: + async def invoke(self, inter: ApplicationCommandInteraction, *args: Any, **kwargs: Any) -> None: for k, v in self.connectors.items(): if k in kwargs: kwargs[v] = kwargs.pop(k) @@ -439,7 +439,7 @@ def __init__( guild_ids: Optional[Sequence[int]] = None, connectors: Optional[Dict[str, str]] = None, auto_sync: Optional[bool] = None, - **kwargs, + **kwargs: Any, ) -> None: name_loc = Localized._cast(name, False) super().__init__(func, name=name_loc.string, **kwargs) @@ -525,7 +525,7 @@ def sub_command( options: Optional[list] = None, connectors: Optional[dict] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[[CommandCallback], SubCommand]: """A decorator that creates a subcommand under the base command. @@ -587,7 +587,7 @@ def sub_command_group( self, name: LocalizedOptional = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[[CommandCallback], SubCommandGroup]: """A decorator that creates a subcommand group under the base command. @@ -758,7 +758,7 @@ def slash_command( connectors: Optional[Dict[str, str]] = None, auto_sync: Optional[bool] = None, extras: Optional[Dict[str, Any]] = None, - **kwargs, + **kwargs: Any, ) -> Callable[[CommandCallback], InvokableSlashCommand]: """A decorator that builds a slash command. diff --git a/disnake/http.py b/disnake/http.py index 4588774242..1f09107fc3 100644 --- a/disnake/http.py +++ b/disnake/http.py @@ -2165,7 +2165,7 @@ def edit_guild_welcome_screen( guild_id: Snowflake, *, reason: Optional[str] = None, - **kwargs, + **kwargs: Any, ) -> Response[welcome_screen.WelcomeScreen]: valid_keys = ( "enabled", diff --git a/disnake/message.py b/disnake/message.py index 1bfb62cd43..08d03da025 100644 --- a/disnake/message.py +++ b/disnake/message.py @@ -2083,7 +2083,7 @@ async def create_thread( return Thread(guild=self.guild, state=self._state, data=data) async def reply( - self, content: Optional[str] = None, *, fail_if_not_exists: bool = True, **kwargs + self, content: Optional[str] = None, *, fail_if_not_exists: bool = True, **kwargs: Any ) -> Message: """|coro|