hikari-arc 2.1.0__tar.gz → 2.2.0__tar.gz

hikari_arc-2.2.0/.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  formatting:
+    runs-on: ubuntu-latest
+    name: "Run ruff via nox"
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9"
+          python-version: "3.14"
+
+      - name: Run ruff via nox
+        run: |
+          uv run nox -s format
+
+  pyright:
+    runs-on: ubuntu-latest
+    name: "Run pyright via nox"
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9"
+          python-version: "3.14"
+
+      - name: Run pyright via nox
+        run: |
+          uv run nox -s pyright
+
+  slotscheck:
+    runs-on: ubuntu-latest
+    name: "Run slotscheck via nox"
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9"
+          python-version: "3.14"
+
+      - name: Run slotscheck via nox
+        run: |
+          uv run nox -s slotscheck
+
+  pytest:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
+
+    name: Run pytest via nox on Python ${{ matrix.python-version }}
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv with Python ${{ matrix.python-version }}
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9"
+          python-version: ${{ matrix.python-version }}
+      - run: |
+          uv run nox -s pytest

{hikari_arc-2.1.0 → hikari_arc-2.2.0}/.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.1.0 → hikari_arc-2.2.0}/.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.1.0 → hikari_arc-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hikari-arc
-Version: 2.1.0
+Version: 2.2.0
 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
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
@@ -27,12 +28,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.1
+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.1; extra == 'rest'
+Requires-Dist: hikari[server]>=2.3.3; extra == 'rest'
 Description-Content-Type: text/markdown
 
 <div align="center">

{hikari_arc-2.1.0 → hikari_arc-2.2.0}/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.1.0 → hikari_arc-2.2.0}/arc/command/option/custom/emoji.py

@@ -55,7 +55,7 @@ class EmojiOption(ConverterOption[hikari.Emoji, ClientT, EmojiParams, str]):
             return hikari.Emoji.parse(value)
         except ValueError as exc:
             raise OptionConverterFailureError(
-                self, value, f"Option '{self.name}' expected a valid color, got {value!r}."
+                self, value, f"Option '{self.name}' expected a valid emoji, got {value!r}."
             ) from exc
 
     @classmethod

{hikari_arc-2.1.0 → hikari_arc-2.2.0}/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.1.0 → hikari_arc-2.2.0}/arc/internal/about.py

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

{hikari_arc-2.1.0 → hikari_arc-2.2.0}/docs/changelog.md

@@ -9,6 +9,17 @@ hide:
 
 Here you can find all the changelogs for `hikari-arc`.
 
+## 2.2.0
+
+- Add Python 3.14 support.
+- Bump `hikari` to `v2.5+`.
+- Fix inconsistent error message in emoji converter.
+
+## 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`.
@@ -90,7 +101,6 @@ async def test(ctx: arc.GatewayContext) -> None:
     channel = ctx.channel
 ```
 
-
 ## 1.4.0
 
 - Add new optiontype with converter for `hikari.Emoji`.
@@ -186,7 +196,6 @@ In additon to these changes, the [documentation](https://arc.hypergonial.com) go
 - Add `@GatewayPlugin.listen`, `GatewayPlugin.subscribe`, `GatewayPlugin.unsubscribe`.
 - Make all first-order decorators work as second-order decorators as well.
 
-
 ## v0.3.0
 
 - Add [hooks](./guides/hooks.md).

{hikari_arc-2.1.0 → hikari_arc-2.2.0}/docs/guides/command_groups.md

@@ -75,6 +75,17 @@ hide:
     └─ subcommand
         │
         └─ subgroup
+
+    ----
+
+    INVALID
+    Group cannot contain regular commands, you have to use subcommands when using a group
+
+    group
+    │
+    ├─ command
+    │
+    └─ command
     ```
 
 !!! failure "Caution"
@@ -157,7 +168,7 @@ Subcommands can be included in either top-level groups or subgroups.
     Slash subcommands **must** use the [`@arc.slash_subcommand`][arc.command.slash.slash_subcommand] decorator
     instead of the [`@arc.slash_command`][arc.command.slash.slash_command] decorator.
 
-With the following setup, you should get something similar to this:
+With the following setup, you should get something similar to this. The final command name will automatically combine the name used at each tier:
 
 <figure markdown>
   ![Permissions Subcommands](../assets/subcommands.png){ width="800" }

{hikari_arc-2.1.0 → hikari_arc-2.2.0}/pyproject.toml

@@ -11,11 +11,11 @@ classifiers = [
     "Framework :: AsyncIO",
     "Intended Audience :: Developers",
     "Natural Language :: English",
-    "Topic :: Software Development :: Libraries :: Python Modules",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: 3 :: Only",
     "Topic :: Software Development :: Libraries",
@@ -23,31 +23,31 @@ 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.1"]
+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.1"]
+rest = ["hikari[server]>=2.3.3"]
 
 [dependency-groups]
 dev = [
-    "nox>=2025.2.9",
+    "nox>=2025.11.12",
     "pyright==1.1.397",
-    "pytest>=8.3",
-    "pytest-asyncio>=0.26",
-    "ruff>=0.11",
+    "pytest>=9.0",
+    "pytest-asyncio>=1.3",
+    "ruff>=0.14",
     "slotscheck>=0.19",
-    "typing-extensions>=4.13",
-    "uv>=0.6",
+    "typing-extensions>=4.15",
+    "uv>=0.9",
     "colorama>=0.4.6; sys_platform == 'win32'",
 ]
 docs = [
-    "black>=25.1.0",
-    "griffe-inherited-docstrings>=1.1.1",
+    "black>=26.1.0",
+    "griffe-inherited-docstrings>=1.1.2",
     "mkdocs>=1.6.1",
-    "mkdocs-glightbox>=0.4.0",
-    "mkdocs-material[imaging]>=9.6.11",
-    "mkdocstrings-python>=1.16.10",
+    "mkdocs-glightbox>=0.5",
+    "mkdocs-material[imaging]>=9.7",
+    "mkdocstrings-python>=1.16.10,<2.0",
 ]
 
 [project.urls]