hikari-arc 2.0.0__tar.gz → 2.1.1__tar.gz

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: "0.6.4"
+          version: "0.7.6"
           python-version: "3.13"
 
       - name: Run ruff via nox
@@ -26,7 +26,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: "0.6.4"
+          version: "0.7.6"
           python-version: "3.13"
 
       - name: Run pyright via nox
@@ -41,7 +41,7 @@ jobs:
         - name: Install uv
           uses: astral-sh/setup-uv@v5
           with:
-            version: "0.6.4"
+            version: "0.7.6"
             python-version: "3.13"
 
         - name: Run slotscheck via nox
@@ -61,7 +61,7 @@ jobs:
     - name: Install uv with Python ${{ matrix.python-version }}
       uses: astral-sh/setup-uv@v5
       with:
-        version: "0.6.4"
+        version: "0.7.6"
         python-version: ${{ matrix.python-version }}
     - run: |
         uv run nox -s pytest

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/.github/workflows/docs.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: "0.6.4"
+          version: "0.7.6"
           python-version: "3.11"
 
       - name: Build docs via nox

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/.github/workflows/publish.yml

@@ -11,7 +11,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: astral-sh/setup-uv@v5
         with:
-          version: "0.6.4"
+          version: "0.7.6"
           python-version: "3.13"
       - name: publish
         run: |

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hikari-arc
-Version: 2.0.0
+Version: 2.1.1
 Summary: A command handler for hikari with a focus on type-safety and correctness.
 Project-URL: Homepage, https://arc.hypergonial.com
 Project-URL: Documentation, https://arc.hypergonial.com
@@ -27,12 +27,12 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: alluka<0.4,>=0.3.3
 Requires-Dist: attrs>=25.3.0
-Requires-Dist: hikari>=2.2.0
+Requires-Dist: hikari>=2.3.3
 Provides-Extra: cron
 Requires-Dist: croniter==5.0.1; extra == 'cron'
 Requires-Dist: types-croniter==5.0.1.20241205; extra == 'cron'
 Provides-Extra: rest
-Requires-Dist: hikari[server]>=2.2.0; extra == 'rest'
+Requires-Dist: hikari[server]>=2.3.3; extra == 'rest'
 Description-Content-Type: text/markdown
 
 <div align="center">

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/arc/client.py

@@ -125,11 +125,11 @@ class GatewayClientBase(Client[GatewayBotT]):
 
     async def _on_gatewaybot_startup(self, event: hikari.StartedEvent) -> None:
         await self._on_startup()
-        await self.app.event_manager.dispatch(StartedEvent(self))
+        self.app.event_manager.dispatch(StartedEvent(self), return_tasks=False)
 
     async def _on_gatewaybot_shutdown(self, event: hikari.StoppingEvent) -> None:
         await self._on_shutdown()
-        await self.app.event_manager.dispatch(StoppingEvent(self))
+        self.app.event_manager.dispatch(StoppingEvent(self), return_tasks=False)
 
     async def _on_gatewaybot_interaction_create(self, event: hikari.InteractionCreateEvent) -> None:
         if isinstance(event.interaction, hikari.CommandInteraction):
@@ -141,7 +141,7 @@ class GatewayClientBase(Client[GatewayBotT]):
         if not self.app.event_manager.get_listeners(CommandErrorEvent):
             return await super()._on_error(ctx, exception)
 
-        self.app.event_manager.dispatch(CommandErrorEvent(self, ctx, exception))
+        self.app.event_manager.dispatch(CommandErrorEvent(self, ctx, exception), return_tasks=False)
 
     def subscribe(self, event_type: type[EventT], callback: EventCallbackT[EventT]) -> None:
         """Subscribe to an event.

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/arc/command/slash.py

@@ -13,7 +13,7 @@ from arc.errors import AutocompleteError, CommandInvokeError
 from arc.internal.options import resolve_options
 from arc.internal.sigparse import parse_command_signature
 from arc.internal.types import ClientT, CommandCallbackT, HookT, PostHookT, ResponseBuilderT, SlashCommandLike
-from arc.locale import CommandLocaleRequest, LocaleResponse
+from arc.locale import CommandLocaleRequest
 
 if t.TYPE_CHECKING:
     from asyncio.futures import Future
@@ -183,10 +183,13 @@ class SlashCommand(CallableCommandBase[ClientT, hikari.api.SlashCommandBuilder])
 
     def _request_command_locale(self) -> None:
         """Request the locale for this command."""
-        if self.name_localizations or self.description_localizations or self._client is None:
+        if self._client is None or not self._client._provided_locales or not self._client._command_locale_provider:
             return
 
-        if not self._client._provided_locales or not self._client._command_locale_provider:
+        for option in self.options.values():
+            option._request_option_locale(self._client, self)
+
+        if self.name_localizations or self.description_localizations:
             return
 
         name_locales: dict[hikari.Locale, str] = {}
@@ -196,8 +199,6 @@ class SlashCommand(CallableCommandBase[ClientT, hikari.api.SlashCommandBuilder])
             request = CommandLocaleRequest(self, locale, self.name)
             resp = self._client._command_locale_provider(request)
 
-            assert isinstance(resp, LocaleResponse)
-
             if resp.name is not None and resp.description is not None:
                 name_locales[locale] = resp.name
                 desc_locales[locale] = resp.description
@@ -205,9 +206,6 @@ class SlashCommand(CallableCommandBase[ClientT, hikari.api.SlashCommandBuilder])
         self.name_localizations: t.Mapping[hikari.Locale, str] = name_locales
         self.description_localizations: t.Mapping[hikari.Locale, str] = desc_locales
 
-        for option in self.options.values():
-            option._request_option_locale(self._client, self)
-
 
 @attr.define(slots=True, kw_only=True)
 class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
@@ -387,6 +385,9 @@ class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
         if self.name_localizations or self.description_localizations or self._client is None:
             return
 
+        for sub in self.children.values():
+            sub._request_command_locale(self._client)
+
         if not self._client._provided_locales or not self._client._command_locale_provider:
             return
 
@@ -404,9 +405,6 @@ class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
         self.name_localizations: t.Mapping[hikari.Locale, str] = name_locales
         self.description_localizations: t.Mapping[hikari.Locale, str] = desc_locales
 
-        for sub in self.children.values():
-            sub._request_option_locale(self._client, self)
-
     @t.overload
     def include(self) -> t.Callable[[SlashSubCommand[ClientT]], SlashSubCommand[ClientT]]: ...
 
@@ -551,11 +549,32 @@ class SlashSubGroup(SubCommandBase[ClientT, SlashGroup[ClientT]]):
             assert self._parent is not None
             await self._parent._handle_exception(ctx, exc)
 
-    def _request_option_locale(self, client: Client[t.Any], command: CommandProto) -> None:
-        super()._request_option_locale(client, command)
+    def _request_command_locale(self, client: Client[t.Any]) -> None:
+        if not client._provided_locales or not client._command_locale_provider:
+            return
+
+        for sub in self.children.values():
+            sub._request_command_locale(client)
+
+        if self.name_localizations or self.description_localizations:
+            return
+
+        name_locales = {}
+        desc_locales = {}
+
+        for locale in client._provided_locales:
+            request = CommandLocaleRequest(self, locale, self.name)
+            resp = client._command_locale_provider(request)
+
+            if resp.name is not None and resp.description is not None:
+                name_locales[locale] = resp.name
+                desc_locales[locale] = resp.description
+
+        self.name_localizations: t.Mapping[hikari.Locale, str] = name_locales
+        self.description_localizations: t.Mapping[hikari.Locale, str] = desc_locales
 
-        for subcommand in self.children.values():
-            subcommand._request_option_locale(client, command)
+    def _request_option_locale(self, client: Client[t.Any], command: CommandProto) -> None:
+        raise RuntimeError("_request_option_locale should not be called on a subgroup. (This is a bug)")
 
     @t.overload
     def include(self) -> t.Callable[[SlashSubCommand[ClientT]], SlashSubCommand[ClientT]]: ...
@@ -705,11 +724,32 @@ class SlashSubCommand(
             assert self._parent is not None
             await self._parent._handle_exception(ctx, e)
 
-    def _request_option_locale(self, client: Client[t.Any], command: CommandProto) -> None:
-        super()._request_option_locale(client, command)
+    def _request_command_locale(self, client: Client[t.Any]) -> None:
+        if not client._provided_locales or not client._command_locale_provider:
+            return
 
         for option in self.options.values():
-            option._request_option_locale(client, command)
+            option._request_option_locale(client, self)
+
+        if self.name_localizations or self.description_localizations:
+            return
+
+        name_locales = {}
+        desc_locales = {}
+
+        for locale in client._provided_locales:
+            request = CommandLocaleRequest(self, locale, self.name)
+            resp = client._command_locale_provider(request)
+
+            if resp.name is not None and resp.description is not None:
+                name_locales[locale] = resp.name
+                desc_locales[locale] = resp.description
+
+        self.name_localizations: t.Mapping[hikari.Locale, str] = name_locales
+        self.description_localizations: t.Mapping[hikari.Locale, str] = desc_locales
+
+    def _request_option_locale(self, client: Client[t.Any], command: CommandProto) -> None:
+        raise RuntimeError("_request_option_locale should not be called on a subcommand. (This is a bug)")
 
     async def __call__(self, ctx: Context[ClientT], *args: t.Any, **kwargs: t.Any) -> None:
         """Invoke this subcommand with the given context.

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/arc/context/base.py

@@ -60,6 +60,7 @@ class _ResponseGlue:
     attachments: t.Sequence[hikari.Resourceish] | hikari.UndefinedType = hikari.UNDEFINED
     embed: hikari.Embed | hikari.UndefinedType = hikari.UNDEFINED
     embeds: t.Sequence[hikari.Embed] | hikari.UndefinedType = hikari.UNDEFINED
+    poll: hikari.UndefinedType | hikari.api.PollBuilder = hikari.UNDEFINED
     mentions_everyone: bool | hikari.UndefinedType = hikari.UNDEFINED
     user_mentions: t.Sequence[hikari.Snowflakeish | hikari.PartialUser] | bool | hikari.UndefinedType = hikari.UNDEFINED
     role_mentions: t.Sequence[hikari.Snowflakeish | hikari.PartialRole] | bool | hikari.UndefinedType = hikari.UNDEFINED
@@ -75,6 +76,7 @@ class _ResponseGlue:
             "attachments": self.attachments,
             "embed": self.embed,
             "embeds": self.embeds,
+            "poll": self.poll,
             "mentions_everyone": self.mentions_everyone,
             "user_mentions": self.user_mentions,
             "role_mentions": self.role_mentions,
@@ -92,6 +94,7 @@ class _ResponseGlue:
             components=components or ([self.component] if self.component else hikari.UNDEFINED),
             attachments=attachments or ([self.attachment] if self.attachment else hikari.UNDEFINED),
             embeds=embeds or ([self.embed] if self.embed else hikari.UNDEFINED),
+            poll=self.poll,
             mentions_everyone=self.mentions_everyone,
             user_mentions=self.user_mentions,
             role_mentions=self.role_mentions,
@@ -332,7 +335,7 @@ class Context(t.Generic[ClientT]):
         return self._interaction.guild_locale
 
     @property
-    def app_permissions(self) -> hikari.Permissions | None:
+    def app_permissions(self) -> hikari.Permissions:
         """The permissions of the bot. Will be None in DMs."""
         return self._interaction.app_permissions
 
@@ -655,6 +658,7 @@ class Context(t.Generic[ClientT]):
         components: t.Sequence[hikari.api.ComponentBuilder] | hikari.UndefinedType = hikari.UNDEFINED,
         embed: hikari.Embed | hikari.UndefinedType = hikari.UNDEFINED,
         embeds: t.Sequence[hikari.Embed] | hikari.UndefinedType = hikari.UNDEFINED,
+        poll: hikari.UndefinedType | hikari.api.PollBuilder = hikari.UNDEFINED,
         mentions_everyone: bool | hikari.UndefinedType = hikari.UNDEFINED,
         user_mentions: t.Sequence[hikari.Snowflakeish | hikari.PartialUser]
         | bool
@@ -685,6 +689,8 @@ class Context(t.Generic[ClientT]):
             An embed to add to this message.
         embeds : Sequence[hikari.Embed] | hikari.UndefinedType
             A sequence of embeds to add to this message.
+        poll : hikari.UndefinedType | hikari.api.PollBuilder
+            If provided, the poll to set on the message.
         mentions_everyone : bool | hikari.UndefinedType
             If True, mentioning @everyone will be allowed.
         user_mentions : hikari.SnowflakeishSequence[hikari.PartialUser] | bool | hikari.UndefinedType
@@ -712,6 +718,7 @@ class Context(t.Generic[ClientT]):
                     attachments=attachments,
                     embed=embed,
                     embeds=embeds,
+                    poll=poll,
                     mentions_everyone=mentions_everyone,
                     user_mentions=user_mentions,
                     role_mentions=role_mentions,
@@ -729,6 +736,7 @@ class Context(t.Generic[ClientT]):
                     attachments=attachments,
                     embed=embed,
                     embeds=embeds,
+                    poll=poll,
                     mentions_everyone=mentions_everyone,
                     user_mentions=user_mentions,
                     role_mentions=role_mentions,

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/arc/internal/about.py

@@ -1,6 +1,6 @@
 import typing as t
 
-__version__: t.Final[str] = "2.0.0"
+__version__: t.Final[str] = "2.1.1"
 
 # MIT License
 #

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/arc/utils/hooks/basic.py

@@ -118,9 +118,6 @@ def has_permissions(perms: hikari.Permissions) -> t.Callable[[Context[t.Any]], H
 
 def _bot_has_permissions(ctx: Context[t.Any], perms: hikari.Permissions) -> HookResult:
     """Check if the bot has the specified permissions."""
-    if ctx.app_permissions is None:
-        raise GuildOnlyError("This command can only be used in a guild.")
-
     missing_perms = ~ctx.app_permissions & perms
 
     if missing_perms is not hikari.Permissions.NONE:

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/docs/changelog.md

@@ -9,6 +9,17 @@ hide:
 
 Here you can find all the changelogs for `hikari-arc`.
 
+## 2.1.1
+
+- Fix breaking change in hikari `v2.3.3` causing events dispatching to fail.
+- Fix option locale provider being invoked for slash subcommands and subgroups instead of the command locale provider.
+
+## 2.1.0
+
+- Add `poll` to `Context.respond`.
+- Adjust `Context.app_permissions` typing to match hikari, removing `None` from the union type.
+- Bump hikari to `v2.2.1`.
+
 ## 2.0.0
 
 - **Breaking:** Remove `is_dm_enabled` from all command, plugin, and client types. Use the newly added `invocation_contexts` instead.

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/pyproject.toml

@@ -23,22 +23,22 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 requires-python = ">=3.10"
-dependencies = ["alluka>=0.3.3,<0.4", "attrs>=25.3.0", "hikari>=2.2.0"]
+dependencies = ["alluka>=0.3.3,<0.4", "attrs>=25.3.0", "hikari>=2.3.3"]
 
 [project.optional-dependencies]
 cron = ["croniter==5.0.1", "types-croniter==5.0.1.20241205"]
-rest = ["hikari[server]>=2.2.0"]
+rest = ["hikari[server]>=2.3.3"]
 
 [dependency-groups]
 dev = [
-    "nox>=2025.2.9",
-    "pyright>=1.1.397",
+    "nox>=2025.5.1",
+    "pyright==1.1.397",
     "pytest>=8.3",
-    "pytest-asyncio>=0.25",
+    "pytest-asyncio>=0.26",
     "ruff>=0.11",
     "slotscheck>=0.19",
-    "typing-extensions>=4.12",
-    "uv>=0.6",
+    "typing-extensions>=4.13",
+    "uv>=0.7",
     "colorama>=0.4.6; sys_platform == 'win32'",
 ]
 docs = [
@@ -46,8 +46,8 @@ docs = [
     "griffe-inherited-docstrings>=1.1.1",
     "mkdocs>=1.6.1",
     "mkdocs-glightbox>=0.4.0",
-    "mkdocs-material[imaging]>=9.6.9",
-    "mkdocstrings-python>=1.16.7",
+    "mkdocs-material[imaging]>=9.6.14",
+    "mkdocstrings-python>=1.16.10",
 ]
 
 [project.urls]

{hikari_arc-2.0.0 → hikari_arc-2.1.1}/tests/test_command.py

@@ -29,6 +29,7 @@ def build_user(app: hikari.GatewayBot, id: hikari.Snowflakeish = 123456789) -> h
         global_name="Padoru",
         accent_color=None,
         flags=hikari.UserFlag.NONE,
+        avatar_decoration=None,
         discriminator="1234",
         is_bot=False,
         is_system=False,
@@ -51,6 +52,8 @@ def build_member(
         nickname=None,
         raw_communication_disabled_until=None,
         role_ids=role_ids or [],
+        guild_avatar_decoration=None,
+        guild_banner_hash=None,
         guild_avatar_hash=None,
         joined_at=datetime.datetime(2021, 1, 1, 0, 0, 0, tzinfo=datetime.timezone.utc),
         permissions=permissions or hikari.Permissions.NONE,