hikari-arc 1.3.4__tar.gz → 1.4.0__tar.gz

{hikari_arc-1.3.4/hikari_arc.egg-info → hikari_arc-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hikari-arc
-Version: 1.3.4
+Version: 1.4.0
 Summary: A command handler for hikari with a focus on type-safety and correctness.
 Home-page: https://github.com/hypergonial/hikari-arc
 Author: hypergonial
@@ -15,40 +15,49 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 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 :: Implementation :: CPython
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10.0,<3.13
+Requires-Python: >=3.10.0,<3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: hikari>=2.0.0.dev122
+Requires-Dist: hikari>=2.0.0
 Requires-Dist: alluka<0.4,>=0.3.0
 Requires-Dist: attrs>=23.1
 Requires-Dist: colorama; sys_platform == "win32"
 Provides-Extra: docs
-Requires-Dist: mkdocs-material[imaging]~=9.5.25; extra == "docs"
+Requires-Dist: mkdocs-material[imaging]~=9.5.39; extra == "docs"
 Requires-Dist: mkdocs~=1.6.0; extra == "docs"
-Requires-Dist: mkdocstrings-python~=1.10.3; extra == "docs"
-Requires-Dist: black~=24.4.2; extra == "docs"
-Requires-Dist: griffe-inherited-docstrings~=1.0.0; extra == "docs"
+Requires-Dist: mkdocstrings-python~=1.11.1; extra == "docs"
+Requires-Dist: black~=24.8.0; extra == "docs"
+Requires-Dist: griffe-inherited-docstrings~=1.0.1; extra == "docs"
 Requires-Dist: mkdocs-glightbox~=0.4.0; extra == "docs"
 Provides-Extra: dev
-Requires-Dist: ruff==0.4.6; extra == "dev"
-Requires-Dist: pyright==1.1.365; extra == "dev"
+Requires-Dist: ruff==0.6.9; extra == "dev"
+Requires-Dist: pyright==1.1.369; extra == "dev"
 Requires-Dist: nox==2024.4.15; extra == "dev"
-Requires-Dist: typing_extensions==4.12.0; extra == "dev"
-Requires-Dist: pytest==8.2.1; extra == "dev"
-Requires-Dist: pytest-asyncio==0.23.7; extra == "dev"
+Requires-Dist: typing_extensions==4.12.2; extra == "dev"
+Requires-Dist: pytest==8.3.2; extra == "dev"
+Requires-Dist: pytest-asyncio==0.24.0; extra == "dev"
 Requires-Dist: slotscheck==0.19.0; extra == "dev"
 Provides-Extra: rest
-Requires-Dist: hikari[server]>=2.0.0.dev122; extra == "rest"
+Requires-Dist: hikari[server]>=2.0.0; extra == "rest"
 Provides-Extra: cron
-Requires-Dist: croniter==2.0.5; extra == "cron"
-Requires-Dist: types-croniter==2.0.0.20240423; extra == "cron"
+Requires-Dist: croniter==3.0.3; extra == "cron"
+Requires-Dist: types-croniter==3.0.3.20240731; extra == "cron"
 
-# hikari-arc
+<div align="center">
+    <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/branding/composed-darkmode.svg">
+        <source media="(prefers-color-scheme: light)" srcset="./docs/assets/branding/composed-lightmode.svg">
+        <img alt="The arc logo" src="./docs/assets/branding/composed-lightmode.svg" width="30%">
+    </picture>
+</div>
+
+---
 
 <div align="center">
 
@@ -120,6 +129,8 @@ See [Contributing](./CONTRIBUTING.md).
 - [`Tanjun`](https://github.com/FasterSpeeding/Tanjun) - For the idea of using `typing.Annotated` and [dependency injection](https://arc.hypergonial.com/guides/dependency_injection/) in a command handler. `arc` also uses the same dependency injection library, [`Alluka`](https://github.com/FasterSpeeding/Alluka), under the hood.
 - [`hikari-crescent`](https://github.com/hikari-crescent/hikari-crescent) The design of [hooks](https://arc.hypergonial.com/guides/hooks/) is largely inspired by `crescent`.
 - [`FastAPI`](https://github.com/tiangolo/fastapi) - Some design ideas and most of the [documentation](https://arc.hypergonial.com/) [configuration](https://github.com/hypergonial/hikari-arc/blob/main/mkdocs.yml) derives from `FastAPI`.
+- The `arc` logo was made by [@PythonTryHard](https://github.com/PythonTryHard).
+
 
 ## Links
 

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/README.md

@@ -1,4 +1,12 @@
-# hikari-arc
+<div align="center">
+    <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/branding/composed-darkmode.svg">
+        <source media="(prefers-color-scheme: light)" srcset="./docs/assets/branding/composed-lightmode.svg">
+        <img alt="The arc logo" src="./docs/assets/branding/composed-lightmode.svg" width="30%">
+    </picture>
+</div>
+
+---
 
 <div align="center">
 
@@ -70,6 +78,8 @@ See [Contributing](./CONTRIBUTING.md).
 - [`Tanjun`](https://github.com/FasterSpeeding/Tanjun) - For the idea of using `typing.Annotated` and [dependency injection](https://arc.hypergonial.com/guides/dependency_injection/) in a command handler. `arc` also uses the same dependency injection library, [`Alluka`](https://github.com/FasterSpeeding/Alluka), under the hood.
 - [`hikari-crescent`](https://github.com/hikari-crescent/hikari-crescent) The design of [hooks](https://arc.hypergonial.com/guides/hooks/) is largely inspired by `crescent`.
 - [`FastAPI`](https://github.com/tiangolo/fastapi) - Some design ideas and most of the [documentation](https://arc.hypergonial.com/) [configuration](https://github.com/hypergonial/hikari-arc/blob/main/mkdocs.yml) derives from `FastAPI`.
+- The `arc` logo was made by [@PythonTryHard](https://github.com/PythonTryHard).
+
 
 ## Links
 

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/__init__.py

@@ -31,6 +31,7 @@ from .command import (
     ChannelParams,
     ColorParams,
     ColourParams,
+    EmojiParams,
     FloatParams,
     IntParams,
     MemberParams,
@@ -131,6 +132,7 @@ __all__ = (
     "MemberParams",
     "ColorParams",
     "ColourParams",
+    "EmojiParams",
     "SlashCommand",
     "SlashGroup",
     "SlashSubCommand",

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/abc/client.py

@@ -1354,7 +1354,7 @@ class Client(t.Generic[AppT], abc.ABC):
             dir_path = pathlib.Path(dir_path)
 
         try:
-            dir_path.resolve().relative_to(pathlib.Path.cwd())
+            dir_path.absolute().relative_to(pathlib.Path.cwd())
         except ValueError:
             raise ExtensionLoadError("dir_path must be relative to the current working directory.")
 

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/abc/option.py

@@ -102,6 +102,9 @@ class OptionType(enum.IntEnum):
     COLOR = 10002
     """Denotes a command option where the value will be a color."""
 
+    EMOJI = 10003
+    """Denotes a command option where the value will be an emoji."""
+
     @classmethod
     def from_hikari(cls, option_type: hikari.OptionType) -> OptionType:
         """Convert a hikari.OptionType to an OptionType."""
@@ -248,8 +251,8 @@ class OptionBase(abc.ABC, t.Generic[T]):
             "name": self.name,
             "description": self.description,
             "autocomplete": False,
-            "name_localizations": self.name_localizations,
-            "description_localizations": self.description_localizations,
+            "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()},
         }
 
     def to_command_option(self) -> hikari.CommandOption:

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/command/__init__.py

@@ -10,6 +10,8 @@ from .option import (
     ColorParams,
     ColourOption,
     ColourParams,
+    EmojiOption,
+    EmojiParams,
     FloatOption,
     FloatParams,
     IntOption,
@@ -54,6 +56,8 @@ __all__ = (
     "FloatParams",
     "UserOption",
     "UserParams",
+    "EmojiParams",
+    "EmojiOption",
     "ChannelOption",
     "ChannelParams",
     "RoleOption",

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/command/message.py

@@ -47,7 +47,7 @@ class MessageCommand(CallableCommandBase[ClientT, hikari.api.ContextMenuCommandB
             default_member_permissions=self.default_permissions,
             is_dm_enabled=self.is_dm_enabled,
             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(

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/command/option/__init__.py

@@ -1,7 +1,16 @@
 from .attachment import AttachmentOption, AttachmentParams
 from .bool import BoolOption, BoolParams
 from .channel import ChannelOption, ChannelParams
-from .custom import ColorOption, ColorParams, ColourOption, ColourParams, MemberOption, MemberParams
+from .custom import (
+    ColorOption,
+    ColorParams,
+    ColourOption,
+    ColourParams,
+    EmojiOption,
+    EmojiParams,
+    MemberOption,
+    MemberParams,
+)
 from .float import FloatOption, FloatParams
 from .int import IntOption, IntParams
 from .mentionable import MentionableOption, MentionableParams
@@ -34,6 +43,8 @@ __all__ = (
     "ColorParams",
     "ColourOption",
     "ColourParams",
+    "EmojiOption",
+    "EmojiParams",
 )
 
 # MIT License

hikari_arc-1.4.0/arc/command/option/custom/__init__.py

@@ -0,0 +1,14 @@
+from .color import ColorOption, ColorParams, ColourOption, ColourParams
+from .emoji import EmojiOption, EmojiParams
+from .member import MemberOption, MemberParams
+
+__all__ = (
+    "ColorOption",
+    "ColorParams",
+    "ColourOption",
+    "ColourParams",
+    "MemberOption",
+    "MemberParams",
+    "EmojiOption",
+    "EmojiParams",
+)

hikari_arc-1.4.0/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.

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/command/slash.py

@@ -110,8 +110,8 @@ class SlashCommand(CallableCommandBase[ClientT, hikari.api.SlashCommandBuilder])
             default_member_permissions=self.default_permissions,
             is_dm_enabled=self.is_dm_enabled,
             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(
@@ -265,8 +265,8 @@ class SlashGroup(CommandBase[ClientT, hikari.api.SlashCommandBuilder]):
             default_member_permissions=self.default_permissions,
             is_dm_enabled=self.is_dm_enabled,
             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 +291,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

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/command/user.py

@@ -48,7 +48,7 @@ class UserCommand(CallableCommandBase[ClientT, hikari.api.ContextMenuCommandBuil
             default_member_permissions=self.default_permissions,
             is_dm_enabled=self.is_dm_enabled,
             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(

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/context/base.py

@@ -107,8 +107,8 @@ class InteractionResponse:
 
     __slots__ = ("_context", "_message", "_delete_after_task")
 
-    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
 
@@ -418,6 +418,9 @@ class Context(t.Generic[ClientT]):
         """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: ...
 

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/arc/internal/about.py

@@ -5,7 +5,7 @@ __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] = "1.4.0"
 
 # MIT License
 #

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/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."""
 

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/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] = {

hikari_arc-1.4.0/cron_requirements.txt

@@ -0,0 +1,2 @@
+croniter==3.0.3
+types-croniter==3.0.3.20240731

hikari_arc-1.4.0/dev_requirements.txt

@@ -0,0 +1,7 @@
+ruff==0.6.9
+pyright==1.1.369
+nox==2024.4.15
+typing_extensions==4.12.2
+pytest==8.3.2
+pytest-asyncio==0.24.0
+slotscheck==0.19.0

hikari_arc-1.4.0/doc_requirements.txt

@@ -0,0 +1,6 @@
+mkdocs-material[imaging]~=9.5.39
+mkdocs~=1.6.0
+mkdocstrings-python~=1.11.1
+black~=24.8.0
+griffe-inherited-docstrings~=1.0.1
+mkdocs-glightbox~=0.4.0

{hikari_arc-1.3.4 → hikari_arc-1.4.0/hikari_arc.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hikari-arc
-Version: 1.3.4
+Version: 1.4.0
 Summary: A command handler for hikari with a focus on type-safety and correctness.
 Home-page: https://github.com/hypergonial/hikari-arc
 Author: hypergonial
@@ -15,40 +15,49 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 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 :: Implementation :: CPython
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10.0,<3.13
+Requires-Python: >=3.10.0,<3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: hikari>=2.0.0.dev122
+Requires-Dist: hikari>=2.0.0
 Requires-Dist: alluka<0.4,>=0.3.0
 Requires-Dist: attrs>=23.1
 Requires-Dist: colorama; sys_platform == "win32"
 Provides-Extra: docs
-Requires-Dist: mkdocs-material[imaging]~=9.5.25; extra == "docs"
+Requires-Dist: mkdocs-material[imaging]~=9.5.39; extra == "docs"
 Requires-Dist: mkdocs~=1.6.0; extra == "docs"
-Requires-Dist: mkdocstrings-python~=1.10.3; extra == "docs"
-Requires-Dist: black~=24.4.2; extra == "docs"
-Requires-Dist: griffe-inherited-docstrings~=1.0.0; extra == "docs"
+Requires-Dist: mkdocstrings-python~=1.11.1; extra == "docs"
+Requires-Dist: black~=24.8.0; extra == "docs"
+Requires-Dist: griffe-inherited-docstrings~=1.0.1; extra == "docs"
 Requires-Dist: mkdocs-glightbox~=0.4.0; extra == "docs"
 Provides-Extra: dev
-Requires-Dist: ruff==0.4.6; extra == "dev"
-Requires-Dist: pyright==1.1.365; extra == "dev"
+Requires-Dist: ruff==0.6.9; extra == "dev"
+Requires-Dist: pyright==1.1.369; extra == "dev"
 Requires-Dist: nox==2024.4.15; extra == "dev"
-Requires-Dist: typing_extensions==4.12.0; extra == "dev"
-Requires-Dist: pytest==8.2.1; extra == "dev"
-Requires-Dist: pytest-asyncio==0.23.7; extra == "dev"
+Requires-Dist: typing_extensions==4.12.2; extra == "dev"
+Requires-Dist: pytest==8.3.2; extra == "dev"
+Requires-Dist: pytest-asyncio==0.24.0; extra == "dev"
 Requires-Dist: slotscheck==0.19.0; extra == "dev"
 Provides-Extra: rest
-Requires-Dist: hikari[server]>=2.0.0.dev122; extra == "rest"
+Requires-Dist: hikari[server]>=2.0.0; extra == "rest"
 Provides-Extra: cron
-Requires-Dist: croniter==2.0.5; extra == "cron"
-Requires-Dist: types-croniter==2.0.0.20240423; extra == "cron"
+Requires-Dist: croniter==3.0.3; extra == "cron"
+Requires-Dist: types-croniter==3.0.3.20240731; extra == "cron"
 
-# hikari-arc
+<div align="center">
+    <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/branding/composed-darkmode.svg">
+        <source media="(prefers-color-scheme: light)" srcset="./docs/assets/branding/composed-lightmode.svg">
+        <img alt="The arc logo" src="./docs/assets/branding/composed-lightmode.svg" width="30%">
+    </picture>
+</div>
+
+---
 
 <div align="center">
 
@@ -120,6 +129,8 @@ See [Contributing](./CONTRIBUTING.md).
 - [`Tanjun`](https://github.com/FasterSpeeding/Tanjun) - For the idea of using `typing.Annotated` and [dependency injection](https://arc.hypergonial.com/guides/dependency_injection/) in a command handler. `arc` also uses the same dependency injection library, [`Alluka`](https://github.com/FasterSpeeding/Alluka), under the hood.
 - [`hikari-crescent`](https://github.com/hikari-crescent/hikari-crescent) The design of [hooks](https://arc.hypergonial.com/guides/hooks/) is largely inspired by `crescent`.
 - [`FastAPI`](https://github.com/tiangolo/fastapi) - Some design ideas and most of the [documentation](https://arc.hypergonial.com/) [configuration](https://github.com/hypergonial/hikari-arc/blob/main/mkdocs.yml) derives from `FastAPI`.
+- The `arc` logo was made by [@PythonTryHard](https://github.com/PythonTryHard).
+
 
 ## Links
 

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/hikari_arc.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ arc/command/option/str.py
 arc/command/option/user.py
 arc/command/option/custom/__init__.py
 arc/command/option/custom/color.py
+arc/command/option/custom/emoji.py
 arc/command/option/custom/member.py
 arc/context/__init__.py
 arc/context/autocomplete.py

hikari_arc-1.4.0/hikari_arc.egg-info/requires.txt

@@ -0,0 +1,30 @@
+hikari>=2.0.0
+alluka<0.4,>=0.3.0
+attrs>=23.1
+
+[:sys_platform=="win32"]
+colorama
+
+[cron]
+croniter==3.0.3
+types-croniter==3.0.3.20240731
+
+[dev]
+ruff==0.6.9
+pyright==1.1.369
+nox==2024.4.15
+typing_extensions==4.12.2
+pytest==8.3.2
+pytest-asyncio==0.24.0
+slotscheck==0.19.0
+
+[docs]
+mkdocs-material[imaging]~=9.5.39
+mkdocs~=1.6.0
+mkdocstrings-python~=1.11.1
+black~=24.8.0
+griffe-inherited-docstrings~=1.0.1
+mkdocs-glightbox~=0.4.0
+
+[rest]
+hikari[server]>=2.0.0

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/requirements.txt

@@ -1,3 +1,3 @@
-hikari>=2.0.0.dev122
+hikari>=2.0.0
 alluka>=0.3.0,<0.4
 attrs>=23.1

hikari_arc-1.4.0/rest_requirements.txt

@@ -0,0 +1 @@
+hikari[server]>=2.0.0

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/setup.py

@@ -61,7 +61,7 @@ setup(
         "rest": parse_requirements_file("rest_requirements.txt"),
         "cron": parse_requirements_file("cron_requirements.txt"),
     },
-    python_requires=">=3.10.0,<3.13",
+    python_requires=">=3.10.0,<3.14",
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Framework :: AsyncIO",
@@ -71,6 +71,7 @@ setup(
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
         "Programming Language :: Python :: Implementation :: CPython",
         "Programming Language :: Python :: 3 :: Only",
         "Topic :: Software Development :: Libraries",

{hikari_arc-1.3.4 → hikari_arc-1.4.0}/tests/test_command.py

@@ -1,4 +1,5 @@
 import datetime
+import typing as t
 
 import hikari
 import pytest
@@ -55,6 +56,25 @@ def build_member(
         permissions=permissions or hikari.Permissions.NONE,
         premium_since=None,
         user=build_user(app, id),
+        guild_flags=hikari.GuildMemberFlags.NONE,
+    )
+
+
+def build_resolved(
+    members: dict[hikari.Snowflake, hikari.InteractionMember] | None = None,
+    roles: dict[hikari.Snowflake, hikari.Role] | None = None,
+    channels: dict[hikari.Snowflake, hikari.InteractionChannel] | None = None,
+    users: dict[hikari.Snowflake, hikari.User] | None = None,
+    attachments: dict[hikari.Snowflake, hikari.Attachment] | None = None,
+    messages: dict[hikari.Snowflake, hikari.Message] | None = None,
+) -> hikari.ResolvedOptionData:
+    return hikari.ResolvedOptionData(
+        members=members or {},
+        roles=roles or {},
+        channels=channels or {},
+        users=users or {},
+        attachments=attachments or {},
+        messages=messages or {},
     )
 
 
@@ -62,7 +82,7 @@ def build_inter(
     app: hikari.GatewayBot,
     *,
     cmd_name: str,
-    options: list[hikari.CommandInteractionOption] | None = None,
+    options: t.Sequence[hikari.CommandInteractionOption] | None = None,
     resolved: hikari.ResolvedOptionData | None = None,
     author_id: hikari.Snowflakeish = 123456789,
     author_role_ids: list[hikari.Snowflake] | None = None,
@@ -100,11 +120,12 @@ def build_inter(
         id=hikari.Snowflake(123456789),
         application_id=hikari.Snowflake(123456789),
         command_id=hikari.Snowflake(123456789),
+        registered_guild_id=hikari.Snowflake(123456789),
         command_name=parts[0],
         command_type=hikari.CommandType.SLASH,
         entitlements=[],
         app_permissions=hikari.Permissions.all_permissions(),
-        options=options,
+        options=options or [],
         resolved=resolved,
         type=hikari.InteractionType.APPLICATION_COMMAND,
         token="padoru padoru",
@@ -113,7 +134,7 @@ def build_inter(
         guild_id=hikari.Snowflake(123456789),
         guild_locale="en-US",
         user=build_user(app, author_id),
-        member=build_member(app, author_id, role_ids=author_role_ids, permissions=author_perms),
+        member=build_member(app, author_id, role_ids=author_role_ids or [], permissions=author_perms),
         locale="en-US",
     )
 
@@ -223,6 +244,20 @@ async def plugin_error_handler(ctx: MockContext, error: Exception) -> None:
     raise error
 
 
+@client.include
+@arc.slash_command("converters")
+async def converters(
+    ctx: MockContext,
+    user: arc.Option[hikari.Member, arc.MemberParams()],
+    color: arc.Option[hikari.Color, arc.ColorParams()],
+    emoji: arc.Option[hikari.Emoji, arc.EmojiParams()],
+) -> None:
+    assert isinstance(user, hikari.InteractionMember)
+    assert isinstance(color, hikari.Color)
+    assert isinstance(emoji, hikari.Emoji)
+    await ctx.respond("All is well!")
+
+
 @pytest.mark.asyncio
 async def test_ping(app: hikari.GatewayBot) -> None:
     response = await client.push_inter(build_inter(app, cmd_name="ping"))
@@ -317,3 +352,26 @@ async def test_nested_errhandler_unhandled(app: hikari.GatewayBot) -> None:
     response = await client.push_inter(inter)
     assert isinstance(response, hikari.impl.InteractionMessageBuilder)
     assert response.content == "❌ Something went wrong. Please contact the bot developer."
+
+
+@pytest.mark.asyncio
+async def test_converters(app: hikari.GatewayBot) -> None:
+    inter = build_inter(
+        app,
+        cmd_name="converters",
+        resolved=build_resolved(members={hikari.Snowflake(123456789): build_member(app, 123456789)}),
+        options=[
+            hikari.CommandInteractionOption(
+                name="user", type=hikari.OptionType.USER, value=hikari.Snowflake(123456789), options=None
+            ),
+            hikari.CommandInteractionOption(
+                name="color", type=hikari.OptionType.STRING, value="123 123 123", options=None
+            ),
+            hikari.CommandInteractionOption(
+                name="emoji", type=hikari.OptionType.STRING, value="<:padoru:123456789>", options=None
+            ),
+        ],
+    )
+    response = await client.push_inter(inter)
+    assert isinstance(response, hikari.impl.InteractionMessageBuilder)
+    assert response.content == "All is well!"

hikari_arc-1.3.4/arc/command/option/custom/__init__.py

@@ -1,4 +0,0 @@
-from .color import ColorOption, ColorParams, ColourOption, ColourParams
-from .member import MemberOption, MemberParams
-
-__all__ = ("ColorOption", "ColorParams", "ColourOption", "ColourParams", "MemberOption", "MemberParams")

hikari_arc-1.3.4/cron_requirements.txt

@@ -1,2 +0,0 @@
-croniter==2.0.5
-types-croniter==2.0.0.20240423

hikari_arc-1.3.4/dev_requirements.txt

@@ -1,7 +0,0 @@
-ruff==0.4.6
-pyright==1.1.365
-nox==2024.4.15
-typing_extensions==4.12.0
-pytest==8.2.1
-pytest-asyncio==0.23.7
-slotscheck==0.19.0

hikari_arc-1.3.4/doc_requirements.txt

@@ -1,6 +0,0 @@
-mkdocs-material[imaging]~=9.5.25
-mkdocs~=1.6.0
-mkdocstrings-python~=1.10.3
-black~=24.4.2
-griffe-inherited-docstrings~=1.0.0
-mkdocs-glightbox~=0.4.0

hikari_arc-1.3.4/hikari_arc.egg-info/requires.txt

@@ -1,30 +0,0 @@
-hikari>=2.0.0.dev122
-alluka<0.4,>=0.3.0
-attrs>=23.1
-
-[:sys_platform=="win32"]
-colorama
-
-[cron]
-croniter==2.0.5
-types-croniter==2.0.0.20240423
-
-[dev]
-ruff==0.4.6
-pyright==1.1.365
-nox==2024.4.15
-typing_extensions==4.12.0
-pytest==8.2.1
-pytest-asyncio==0.23.7
-slotscheck==0.19.0
-
-[docs]
-mkdocs-material[imaging]~=9.5.25
-mkdocs~=1.6.0
-mkdocstrings-python~=1.10.3
-black~=24.4.2
-griffe-inherited-docstrings~=1.0.0
-mkdocs-glightbox~=0.4.0
-
-[rest]
-hikari[server]>=2.0.0.dev122

hikari_arc-1.3.4/rest_requirements.txt

@@ -1 +0,0 @@
-hikari[server]>=2.0.0.dev122