hikari-arc 1.3.4__py3-none-any.whl → 2.0.0__py3-none-any.whl

arc/command/option/custom/emoji.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+import typing as t
+
+import attr
+import hikari
+
+from arc.abc.option import ConverterOption, OptionParams, OptionType
+from arc.errors import OptionConverterFailureError
+from arc.internal.types import ClientT
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+
+__all__ = ("EmojiOption", "EmojiParams")
+
+
+@t.final
+class EmojiParams(OptionParams[hikari.Color]):
+    """The parameters for an emoji option.
+
+    Parameters
+    ----------
+    description : str
+        The description of the option
+    name : str
+        The name of the option. If not provided, the name of the parameter will be used.
+    name_localizations : Mapping[hikari.Locale, str] | None
+        The name of the option in different locales
+    description_localizations : Mapping[hikari.Locale, str] | None
+        The description of the option in different locales
+    """
+
+    __slots__ = ()
+
+
+@attr.define(slots=True, kw_only=True)
+class EmojiOption(ConverterOption[hikari.Emoji, ClientT, EmojiParams, str]):
+    """A slash command option that represents an emoji.
+
+    ??? hint
+        To add an option of this type to your command, add an argument to your command function with the following type hint:
+        ```py
+        opt_name: arc.Option[hikari.Emoji, EmojiParams(...)]
+        ```
+    """
+
+    @property
+    def option_type(self) -> OptionType:
+        return OptionType.EMOJI
+
+    def _convert_value(self, value: str) -> hikari.Emoji:
+        try:
+            return hikari.Emoji.parse(value)
+        except ValueError as exc:
+            raise OptionConverterFailureError(
+                self, value, f"Option '{self.name}' expected a valid color, got {value!r}."
+            ) from exc
+
+    @classmethod
+    def _from_params(
+        cls, *, name: str, arg_name: str, is_required: bool, params: EmojiParams, **kwargs: t.Any
+    ) -> te.Self:
+        return cls(
+            name=name,
+            arg_name=arg_name,
+            description=params.description,
+            is_required=is_required,
+            name_localizations=params.name_localizations,
+            description_localizations=params.description_localizations,
+            **kwargs,
+        )
+
+
+# MIT License
+#
+# Copyright (c) 2023-present hypergonial
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.

arc/command/option/float.py

@@ -43,7 +43,7 @@ class FloatParams(OptionWithChoicesParams[float, ClientT]):
         The callback that is invoked when the user autocompletes the option
     """
 
-    __slots__: t.Sequence[str] = ("_min", "_max")
+    __slots__: t.Sequence[str] = ("_max", "_min")
 
     def __init__(
         self,

arc/command/option/int.py

@@ -43,7 +43,7 @@ class IntParams(OptionWithChoicesParams[int, ClientT]):
         The callback that is invoked when the user autocompletes the option
     """
 
-    __slots__: t.Sequence[str] = ("_min", "_max")
+    __slots__: t.Sequence[str] = ("_max", "_min")
 
     def __init__(
         self,

arc/command/option/str.py

@@ -44,7 +44,7 @@ class StrParams(OptionWithChoicesParams[str, ClientT]):
         The callback that is invoked when the user autocompletes the option
     """
 
-    __slots__: t.Sequence[str] = ("_min_length", "_max_length")
+    __slots__: t.Sequence[str] = ("_max_length", "_min_length")
 
     def __init__(
         self,

arc/command/slash.py

@@ -25,8 +25,8 @@ if t.TYPE_CHECKING:
     from arc.abc.plugin import PluginBase
 
 __all__ = (
-    "SlashCommandLike",
     "SlashCommand",
+    "SlashCommandLike",
     "SlashGroup",
     "SlashSubCommand",
     "SlashSubGroup",
@@ -108,10 +108,11 @@ class SlashCommand(CallableCommandBase[ClientT, hikari.api.SlashCommandBuilder])
             id=id,
             options=[option.to_command_option() for option in self.options.values()],
             default_member_permissions=self.default_permissions,
-            is_dm_enabled=self.is_dm_enabled,
+            integration_types=self.integration_types,
+            context_types=self.invocation_contexts,
             is_nsfw=self.is_nsfw,
-            name_localizations=self.name_localizations,  # pyright: ignore reportGeneralTypeIssues
-            description_localizations=self.description_localizations,  # pyright: ignore reportGeneralTypeIssues
+            name_localizations={str(key): value for key, value in self.name_localizations.items()},
+            description_localizations={str(key): value for key, value in self.description_localizations.items()},
         )
 
     async def invoke(
@@ -263,10 +264,11 @@ class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
             id=id,
             options=[subcmd.to_command_option() for subcmd in self.children.values()],
             default_member_permissions=self.default_permissions,
-            is_dm_enabled=self.is_dm_enabled,
+            integration_types=self.integration_types,
+            context_types=self.invocation_contexts,
             is_nsfw=self.is_nsfw,
-            name_localizations=self.name_localizations,  # pyright: ignore reportGeneralTypeIssues
-            description_localizations=self.description_localizations,  # pyright: ignore reportGeneralTypeIssues
+            name_localizations={str(key): value for key, value in self.name_localizations.items()},
+            description_localizations={str(key): value for key, value in self.description_localizations.items()},
         )
 
     async def _invoke_subcmd(
@@ -291,7 +293,7 @@ class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
     async def invoke(
         self, interaction: hikari.CommandInteraction, *args: t.Any, **kwargs: t.Any
     ) -> Future[ResponseBuilderT] | None:
-        if interaction.options is None:
+        if not interaction.options:
             raise CommandInvokeError("Cannot invoke slash group with empty options.")
 
         # Get first-order subcommand
@@ -363,7 +365,7 @@ class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
             opt = next(o for o in subsub.options if o.name in subsubcmd.options and o.is_focused)
             local_opt = subsubcmd.options[opt.name]
 
-        if not isinstance(local_opt, OptionWithChoices) or not local_opt.autocomplete_with:
+        if not isinstance(local_opt, OptionWithChoices) or not local_opt.autocomplete_with:  # pyright: ignore reportUnknownMemberType
             raise AutocompleteError(
                 f"Slash option got autocomplete interaction without autocomplete callback: '{local_opt.name}'."
             )
@@ -522,7 +524,8 @@ class SlashSubGroup(SubCommandBase[ClientT, SlashGroup[ClientT]]):
                 autodefer=self._autodefer,
                 default_permissions=hikari.UNDEFINED,
                 is_nsfw=hikari.UNDEFINED,
-                is_dm_enabled=hikari.UNDEFINED,
+                integration_types=hikari.UNDEFINED,
+                invocation_contexts=hikari.UNDEFINED,
             )
         )
 
@@ -675,7 +678,8 @@ class SlashSubCommand(
                 autodefer=self._autodefer,
                 default_permissions=hikari.UNDEFINED,
                 is_nsfw=hikari.UNDEFINED,
-                is_dm_enabled=hikari.UNDEFINED,
+                integration_types=hikari.UNDEFINED,
+                invocation_contexts=hikari.UNDEFINED,
             )
         )
 
@@ -739,7 +743,8 @@ def slash_command(
     description: str = "No description provided.",
     *,
     guilds: t.Sequence[hikari.PartialGuild | hikari.Snowflakeish] | hikari.UndefinedType = hikari.UNDEFINED,
-    is_dm_enabled: bool | hikari.UndefinedType = hikari.UNDEFINED,
+    integration_types: t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType = hikari.UNDEFINED,
+    invocation_contexts: t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType = hikari.UNDEFINED,
     is_nsfw: bool | hikari.UndefinedType = hikari.UNDEFINED,
     autodefer: bool | AutodeferMode | hikari.UndefinedType = hikari.UNDEFINED,
     default_permissions: hikari.Permissions | hikari.UndefinedType = hikari.UNDEFINED,
@@ -756,8 +761,10 @@ def slash_command(
         The description of the command
     guilds : t.Sequence[hikari.PartialGuild | hikari.Snowflakeish] | hikari.UndefinedType
         The guilds this command should be enabled in, if left as undefined, the command is global
-    is_dm_enabled : bool | hikari.UndefinedType
-        If True, the command is usable in direct messages
+    integration_types : t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType
+        The integration types this command supports the installation of
+    invocation_contexts : t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType
+        The context types this command can be invoked in
     is_nsfw : bool | hikari.UndefinedType
         If True, the command is only usable in NSFW channels
     autodefer : bool | AutodeferMode | hikari.UndefinedType
@@ -804,7 +811,8 @@ def slash_command(
             description_localizations=description_localizations or {},
             default_permissions=default_permissions,
             guilds=guild_ids,
-            is_dm_enabled=is_dm_enabled,
+            integration_types=integration_types,
+            invocation_contexts=invocation_contexts,
             is_nsfw=is_nsfw,
         )
 

arc/command/user.py

@@ -46,9 +46,10 @@ class UserCommand(CallableCommandBase[ClientT, hikari.api.ContextMenuCommandBuil
             type=self.command_type,
             id=id,
             default_member_permissions=self.default_permissions,
-            is_dm_enabled=self.is_dm_enabled,
+            context_types=self.invocation_contexts,
+            integration_types=self.integration_types,
             is_nsfw=self.is_nsfw,
-            name_localizations=self.name_localizations,  # pyright: ignore reportGeneralTypeIssues
+            name_localizations={str(key): value for key, value in self.name_localizations.items()},
         )
 
     async def invoke(
@@ -70,7 +71,8 @@ def user_command(
     name: str,
     *,
     guilds: t.Sequence[hikari.PartialGuild | hikari.Snowflakeish] | hikari.UndefinedType = hikari.UNDEFINED,
-    is_dm_enabled: bool | hikari.UndefinedType = hikari.UNDEFINED,
+    invocation_contexts: t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType = hikari.UNDEFINED,
+    integration_types: t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType = hikari.UNDEFINED,
     is_nsfw: bool | hikari.UndefinedType = hikari.UNDEFINED,
     autodefer: bool | AutodeferMode | hikari.UndefinedType = hikari.UNDEFINED,
     default_permissions: hikari.Permissions | hikari.UndefinedType = hikari.UNDEFINED,
@@ -87,8 +89,10 @@ def user_command(
         The name of the command.
     guilds : t.Sequence[hikari.PartialGuild | hikari.Snowflakeish] | hikari.UndefinedType
         The guilds this command should be enabled in, if left as undefined, the command is global
-    is_dm_enabled : bool | hikari.UndefinedType
-        Whether this command is enabled in DMs.
+    integration_types : t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType
+        The integration types this command supports the installation of
+    invocation_contexts : t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType
+        The context types this command can be invoked in
     is_nsfw : bool | hikari.UndefinedType
         Whether this command is NSFW.
     autodefer : bool | AutodeferMode | hikari.UndefinedType
@@ -117,7 +121,8 @@ def user_command(
             name=name,
             autodefer=AutodeferMode(autodefer) if isinstance(autodefer, bool) else autodefer,
             guilds=guild_ids,
-            is_dm_enabled=is_dm_enabled,
+            invocation_contexts=invocation_contexts,
+            integration_types=integration_types,
             is_nsfw=is_nsfw,
             default_permissions=default_permissions,
             name_localizations=name_localizations or {},

arc/context/__init__.py

@@ -1,7 +1,7 @@
 from .autocomplete import AutocompleteData
 from .base import AutodeferMode, Context, InteractionResponse
 
-__all__ = ("Context", "InteractionResponse", "AutocompleteData", "AutodeferMode")
+__all__ = ("AutocompleteData", "AutodeferMode", "Context", "InteractionResponse")
 
 # MIT License
 #

arc/context/autocomplete.py

@@ -51,7 +51,7 @@ class AutocompleteData(t.Generic[ClientT, ChoiceT]):
         """
         if self.focused_option is None:
             return None
-        return t.cast(ChoiceT | str, self.focused_option.value)
+        return t.cast("ChoiceT | str", self.focused_option.value)
 
     @property
     def guild_id(self) -> hikari.Snowflake | None:
@@ -68,19 +68,33 @@ class AutocompleteData(t.Generic[ClientT, ChoiceT]):
         """The member that triggered the interaction."""
         return self.interaction.member
 
+    @property
+    def invocation_context(self) -> hikari.ApplicationContextType:
+        """The context in which the interaction was invoked."""
+        return self.interaction.context
+
+    @property
+    def authorizing_integration_owners(self) -> t.Mapping[hikari.ApplicationIntegrationType, hikari.Snowflake]:
+        """Includes details about the authorizing user or server for the installation(s) relevant to the interaction.
+
+        For apps installed to a user, it can be used to tell the difference between the authorizing user
+        and the user that triggered an interaction (like a message component).
+        """
+        return self.interaction.authorizing_integration_owners
+
     @property
     def user(self) -> hikari.User:
         """The user that triggered the interaction."""
         return self.interaction.user
 
+    @property
+    def channel(self) -> hikari.InteractionChannel:
+        return self.interaction.channel
+
     def get_guild(self) -> hikari.Guild | None:
         """Get the guild that triggered the interaction."""
         return self.interaction.get_guild()
 
-    def get_channel(self) -> hikari.TextableGuildChannel | None:
-        """Get the channel that triggered the interaction."""
-        return self.interaction.get_channel()
-
 
 # MIT License
 #

arc/context/base.py

@@ -11,7 +11,7 @@ import alluka
 import attr
 import hikari
 
-from arc.abc.option import OptionType  # noqa: TCH001 Needed for tests
+from arc.abc.option import OptionType  # noqa: TC001 Needed for tests
 from arc.errors import NoResponseIssuedError, ResponseAlreadyIssuedError
 from arc.internal.options import OPTIONTYPE_TO_TYPE, resolve_snowflake_value
 from arc.internal.types import ClientT, ResponseBuilderT
@@ -20,7 +20,7 @@ from arc.locale import CustomLocaleRequest
 if t.TYPE_CHECKING:
     from arc.abc.command import CallableCommandProto
 
-__all__ = ("Context", "InteractionResponse", "AutodeferMode")
+__all__ = ("AutodeferMode", "Context", "InteractionResponse")
 
 logger = logging.getLogger(__name__)
 
@@ -105,10 +105,10 @@ class InteractionResponse:
     when a message response is issued.
     """
 
-    __slots__ = ("_context", "_message", "_delete_after_task")
+    __slots__ = ("_context", "_delete_after_task", "_message")
 
-    def __init__(self, context: Context[ClientT], message: hikari.Message | None = None) -> None:
-        self._context: Context[ClientT] = context
+    def __init__(self, context: Context[t.Any], message: hikari.Message | None = None) -> None:
+        self._context: Context[t.Any] = context
         self._message: hikari.Message | None = message
         self._delete_after_task: asyncio.Task[None] | None = None
 
@@ -247,18 +247,18 @@ class Context(t.Generic[ClientT]):
     """A context object that is proxying a Discord command interaction."""
 
     __slots__ = (
+        "_autodefer_task",
         "_client",
         "_command",
-        "_interaction",
-        "_responses",
-        "_resp_builder",
-        "_issued_response",
-        "_response_lock",
-        "_autodefer_task",
         "_created_at",
         "_has_command_failed",
-        "_options",
         "_injection_ctx",
+        "_interaction",
+        "_issued_response",
+        "_options",
+        "_resp_builder",
+        "_response_lock",
+        "_responses",
     )
 
     def __init__(
@@ -341,11 +341,69 @@ class Context(t.Generic[ClientT]):
         """The ID of the channel the context represents."""
         return self._interaction.channel_id
 
+    @property
+    def channel(self) -> hikari.InteractionChannel:
+        """The channel the context represents."""
+        return self._interaction.channel
+
     @property
     def guild_id(self) -> hikari.Snowflake | None:
         """The ID of the guild the context represents. Will be None in DMs."""
         return self._interaction.guild_id
 
+    @property
+    def invocation_context(self) -> hikari.ApplicationContextType:
+        """The context in which the interaction was invoked.
+
+        This can be used to determine if the command was invoked in DMs, a guild, or a group DM.
+        """
+        return self._interaction.context
+
+    @property
+    def authorizing_integration_owners(self) -> t.Mapping[hikari.ApplicationIntegrationType, hikari.Snowflake]:
+        """Includes details about the authorizing user or guild for the installation(s) relevant to the interaction.
+
+        For apps installed to a user, it can be used to tell the difference between the authorizing user
+        and the user that triggered an interaction.
+        """
+        return self._interaction.authorizing_integration_owners
+
+    @property
+    def authorizing_guild_id(self) -> hikari.Snowflake | None:
+        """The ID of the guild that this command was installed in.
+
+        This will be `None` if the command was not installed in the guild.
+
+        This is a shorthand for
+
+        ```
+        authorizing_integration_owners.get(hikari.ApplicationIntegrationType.GUILD_INSTALL)
+        ```
+
+        !!! note
+            It is possible for both this value and `authorizing_user_id` to not be `None`, if the command is installed
+            in both a guild and by a user.
+        """
+        return self._interaction.authorizing_integration_owners.get(hikari.ApplicationIntegrationType.GUILD_INSTALL)
+
+    @property
+    def authorizing_user_id(self) -> hikari.Snowflake | None:
+        """The ID of the user that installed this command.
+
+        This will be `None` if the command was not installed by a user.
+
+        This is a shorthand for
+
+        ```
+        authorizing_integration_owners.get(hikari.ApplicationIntegrationType.USER_INSTALL)
+        ```
+
+        !!! note
+            It is possible for both this value and `authorizing_guild_id` to not be `None`, if the command is installed
+            in both a guild and by a user.
+        """
+        return self._interaction.authorizing_integration_owners.get(hikari.ApplicationIntegrationType.USER_INSTALL)
+
     @property
     def is_valid(self) -> bool:
         """Returns if the underlying interaction expired or not.
@@ -414,9 +472,8 @@ class Context(t.Generic[ClientT]):
         """Gets the guild this context represents, if any. Requires application cache."""
         return self._interaction.get_guild()
 
-    def get_channel(self) -> hikari.TextableGuildChannel | None:
-        """Gets the channel this context represents, None if in a DM. Requires application cache."""
-        return self._interaction.get_channel()
+    @t.overload
+    def get_option(self, name: str, opt_type: t.Literal[OptionType.EMOJI]) -> hikari.Emoji | None: ...
 
     @t.overload
     def get_option(self, name: str, opt_type: t.Literal[OptionType.COLOR]) -> hikari.Color | None: ...

arc/internal/__init__.py

@@ -1,16 +1,7 @@
-from .about import __author__, __author_email__, __maintainer__, __version__
 from .deprecation import warn_deprecate
 from .version import CURRENT_VERSION, Version
 
-__all__ = (
-    "warn_deprecate",
-    "Version",
-    "CURRENT_VERSION",
-    "__author__",
-    "__author_email__",
-    "__maintainer__",
-    "__version__",
-)
+__all__ = ("CURRENT_VERSION", "Version", "warn_deprecate")
 
 # MIT License
 #

arc/internal/about.py

@@ -1,11 +1,6 @@
 import typing as t
 
-__author__: t.Final[str] = "hypergonial"
-__author_email__: t.Final[str] = "git@hypergonial.com"
-__maintainer__: t.Final[str] = "hypergonial"
-__license__: t.Final[str] = "MIT"
-__url__: t.Final[str] = "https://github.com/hypergonial/hikari-arc"
-__version__: t.Final[str] = "1.3.4"
+__version__: t.Final[str] = "2.0.0"
 
 # MIT License
 #

arc/internal/options.py

@@ -23,6 +23,7 @@ OPTIONTYPE_TO_TYPE: dict[OptionType, type[t.Any]] = {
     OptionType.ATTACHMENT: hikari.Attachment,
     OptionType.COLOR: hikari.Color,
     OptionType.MEMBER: hikari.Member,
+    OptionType.EMOJI: hikari.Emoji,
 }
 """Used for runtime type checking in Context.get_option, not much else at the moment."""
 

arc/internal/sigparse.py

@@ -17,6 +17,8 @@ from arc.command.option import (
     ChannelParams,
     ColorOption,
     ColorParams,
+    EmojiOption,
+    EmojiParams,
     FloatOption,
     FloatParams,
     IntOption,
@@ -53,6 +55,7 @@ TYPE_TO_OPTION_MAPPING: dict[type[t.Any], type[CommandOptionBase[t.Any, t.Any, t
     hikari.Member: MemberOption,
     hikari.InteractionMember: MemberOption,
     hikari.Color: ColorOption,
+    hikari.Emoji: EmojiOption,
     hikari.User: UserOption,
 }
 
@@ -68,6 +71,7 @@ OPT_TO_PARAMS_MAPPING: dict[type[CommandOptionBase[t.Any, t.Any, t.Any]], type[t
     AttachmentOption: AttachmentParams,
     MemberOption: MemberParams,
     ColorOption: ColorParams,
+    EmojiOption: EmojiParams,
 }
 
 BASE_CHANNEL_TYPE_MAP: dict[type[hikari.PartialChannel], hikari.ChannelType] = {

arc/internal/sync.py

@@ -50,8 +50,9 @@ def _rebuild_hikari_command(
             description=command.description,
             options=list(command.options) if command.options else [],
             default_member_permissions=command.default_member_permissions,
-            is_dm_enabled=command.is_dm_enabled,
             is_nsfw=command.is_nsfw,
+            integration_types=command.integration_types,
+            context_types=command.context_types,
             name_localizations=command.name_localizations,
             description_localizations=command.description_localizations,
         )
@@ -61,8 +62,9 @@ def _rebuild_hikari_command(
             id=command.id,
             type=command.type,
             default_member_permissions=command.default_member_permissions,
-            is_dm_enabled=command.is_dm_enabled,
             is_nsfw=command.is_nsfw,
+            integration_types=command.integration_types,
+            context_types=command.context_types,
             name_localizations=command.name_localizations,
         )
     else:
@@ -93,7 +95,8 @@ def _compare_commands(arc_command: CommandBase[t.Any, t.Any], hk_command: hikari
         and arc_command.name == hk_command.name
         and cmd_dict.get("description") == getattr(hk_command, "description", None)
         and arc_command.is_nsfw == hk_command.is_nsfw
-        and arc_command.is_dm_enabled == hk_command.is_dm_enabled
+        and set(arc_command.invocation_contexts) == set(hk_command.context_types)
+        and set(arc_command.integration_types) == set(hk_command.integration_types)
         and (
             hk_command.guild_id in arc_command.guilds
             if hk_command.guild_id is not None and arc_command.guilds is not hikari.UNDEFINED

arc/internal/version.py

@@ -9,7 +9,7 @@ if t.TYPE_CHECKING:
     import typing_extensions as te
 
 
-__all__ = ("Version", "CURRENT_VERSION")
+__all__ = ("CURRENT_VERSION", "Version")
 
 
 @total_ordering

arc/locale.py

@@ -14,12 +14,12 @@ if t.TYPE_CHECKING:
     from arc.context.base import Context
 
 __all__ = (
-    "LocaleRequestType",
+    "CommandLocaleRequest",
+    "CustomLocaleRequest",
     "LocaleRequest",
+    "LocaleRequestType",
     "LocaleResponse",
-    "CommandLocaleRequest",
     "OptionLocaleRequest",
-    "CustomLocaleRequest",
 )
 
 

arc/plugin.py

@@ -11,7 +11,7 @@ from arc.internal.types import EventCallbackT, EventT, GatewayClientT, RESTClien
 if t.TYPE_CHECKING:
     from arc.context.base import AutodeferMode
 
-__all__ = ("RESTPluginBase", "GatewayPluginBase")
+__all__ = ("GatewayPluginBase", "RESTPluginBase")
 
 P = t.ParamSpec("P")
 T = t.TypeVar("T")
@@ -33,8 +33,11 @@ class RESTPluginBase(PluginBase[RESTClientT]):
     autodefer : bool | AutodeferMode
         If True, all commands in this plugin will automatically defer if it is taking longer than 2 seconds to respond.
         This can be overridden on a per-command basis.
-    is_dm_enabled : bool | hikari.UndefinedType
-        Whether commands in this plugin are enabled in DMs
+    integration_types : t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType
+        The integration types that commands will support the installation of
+        This can be overridden on a per-command basis.
+    invocation_contexts : t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType
+        The context types that commands can be invoked in
         This can be overridden on a per-command basis.
     default_permissions : hikari.Permissions | hikari.UndefinedType
         The default permissions for this plugin
@@ -81,8 +84,11 @@ class GatewayPluginBase(PluginBase[GatewayClientT]):
     autodefer : bool | AutodeferMode
         If True, all commands in this plugin will automatically defer if it is taking longer than 2 seconds to respond.
         This can be overridden on a per-command basis.
-    is_dm_enabled : bool | hikari.UndefinedType
-        Whether commands in this plugin are enabled in DMs
+    integration_types : t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType
+        The integration types that commands will support the installation of
+        This can be overridden on a per-command basis.
+    invocation_contexts : t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType
+        The context types that commands can be invoked in
         This can be overridden on a per-command basis.
     default_permissions : hikari.Permissions | hikari.UndefinedType
         The default permissions for this plugin
@@ -115,7 +121,8 @@ class GatewayPluginBase(PluginBase[GatewayClientT]):
         default_enabled_guilds: t.Sequence[hikari.Snowflakeish | hikari.PartialGuild]
         | hikari.UndefinedType = hikari.UNDEFINED,
         autodefer: bool | AutodeferMode | hikari.UndefinedType = hikari.UNDEFINED,
-        is_dm_enabled: bool | hikari.UndefinedType = hikari.UNDEFINED,
+        integration_types: t.Sequence[hikari.ApplicationIntegrationType] | hikari.UndefinedType = hikari.UNDEFINED,
+        invocation_contexts: t.Sequence[hikari.ApplicationContextType] | hikari.UndefinedType = hikari.UNDEFINED,
         default_permissions: hikari.Permissions | hikari.UndefinedType = hikari.UNDEFINED,
         is_nsfw: bool | hikari.UndefinedType = hikari.UNDEFINED,
     ) -> None:
@@ -123,7 +130,8 @@ class GatewayPluginBase(PluginBase[GatewayClientT]):
             name=name,
             default_enabled_guilds=default_enabled_guilds,
             autodefer=autodefer,
-            is_dm_enabled=is_dm_enabled,
+            integration_types=integration_types,
+            invocation_contexts=invocation_contexts,
             default_permissions=default_permissions,
             is_nsfw=is_nsfw,
         )