Removed auto_convert since we don't need it anymore.

Author: eunwoo1104

discord_slash/client.py

@@ -339,7 +339,6 @@ def add_slash_command(self,
                           cmd,
                           name: str = None,
                           description: str = None,
-                          auto_convert: dict = None,
                           guild_ids: typing.List[int] = None,
                           options: list = None,
                           has_subcommands: bool = False):
@@ -352,8 +351,6 @@ def add_slash_command(self,
         :type name: str
         :param description: Description of the slash command. Defaults to command docstring or ``None``.
         :type description: str
-        :param auto_convert: Dictionary of how to convert option values. Default ``None``.
-        :type auto_convert: dict
         :param guild_ids: List of Guild ID of where the command will be used. Default ``None``, which will be global command.
         :type guild_ids: List[int]
         :param options: Options of the slash command. This will affect ``auto_convert`` and command data at Discord API. Default ``None``.
@@ -377,13 +374,9 @@ def add_slash_command(self,
         if options is None:
             options = manage_commands.generate_options(cmd, description)
 
-        if options:
-            auto_convert = manage_commands.generate_auto_convert(options)
-
         _cmd = {
             "func": cmd,
             "description": description,
-            "auto_convert": auto_convert,
             "guild_ids": guild_ids,
             "api_options": options,
             "has_subcommands": has_subcommands
@@ -399,7 +392,6 @@ def add_subcommand(self,
                        description: str = None,
                        base_description: str = None,
                        subcommand_group_description: str = None,
-                       auto_convert: dict = None,
                        guild_ids: typing.List[int] = None,
                        options: list = None):
         """
@@ -419,8 +411,6 @@ def add_subcommand(self,
         :type base_description: str
         :param subcommand_group_description: Description of the subcommand_group. Default ``None``.
         :type subcommand_group_description: str
-        :param auto_convert: Dictionary of how to convert option values. Default ``None``.
-        :type auto_convert: dict
         :param guild_ids: List of guild ID of where the command will be used. Default ``None``, which will be global command.
         :type guild_ids: List[int]
         :param options: Options of the subcommand. This will affect ``auto_convert`` and command data at Discord API. Default ``None``.
@@ -441,13 +431,9 @@ def add_subcommand(self,
         if options is None:
             options = manage_commands.generate_options(cmd, description)
 
-        if options:
-            auto_convert = manage_commands.generate_auto_convert(options)
-
         _cmd = {
             "func": None,
             "description": base_description,
-            "auto_convert": {},
             "guild_ids": guild_ids,
             "api_options": [],
             "has_subcommands": True
@@ -458,7 +444,6 @@ def add_subcommand(self,
             "description": description,
             "base_desc": base_description,
             "sub_group_desc": subcommand_group_description,
-            "auto_convert": auto_convert,
             "guild_ids": guild_ids,
             "api_options": options
         }
@@ -487,7 +472,6 @@ def slash(self,
               *,
               name: str = None,
               description: str = None,
-              auto_convert: dict = None,
               guild_id: int = None,
               guild_ids: typing.List[int] = None,
               options: typing.List[dict] = None):
@@ -499,11 +483,11 @@ def slash(self,
         All args must be passed as keyword-args.
 
         .. note::
-            Role, User, and Channel types are passed as id if you don't set ``auto_convert``, since API doesn't give type of the option for now.\n
-            Also, if ``options`` is passed, then ``auto_convert`` will be automatically created or overrided.
+            If you don't pass `options` but has extra args, then it will automatically generate options.
+            However, it is not recommended to use it since descriptions will be "No Description." or the command's description.
 
         .. warning::
-            Unlike discord.py's command, ``*args``, keyword-only args, converters, etc. are NOT supported.
+            Unlike discord.py's command, ``*args``, keyword-only args, converters, etc. are not supported or behave differently.
 
         Example:
 
@@ -518,21 +502,10 @@ async def _slash(ctx): # Normal usage.
             async def _pick(ctx, choice1, choice2): # Command with 1 or more args.
                 await ctx.send(content=str(random.choice([choice1, choice2])))
 
-        Example of formatting ``auto_convert``:
-
-        .. code-block:: python
-
-            {"option_role": "role",                      # For key put name of the option and for value put type of the option.
-             "option_user": SlashCommandOptionType.USER, # Also can use an enumeration member for the type
-             "option_user_two": 6,                       # or number
-             "option_channel": "CHANNEL"}                # or upper case string.
-
         :param name: Name of the slash command. Default name of the coroutine.
         :type name: str
         :param description: Description of the slash command. Default ``None``.
         :type description: str
-        :param auto_convert: Dictionary of how to convert option values. Default ``None``.
-        :type auto_convert: dict
         :param guild_id: Deprecated. Use ``guild_ids`` instead.
         :type guild_id: int
         :param guild_ids: List of Guild ID of where the command will be used. Default ``None``, which will be global command.
@@ -545,7 +518,7 @@ async def _pick(ctx, choice1, choice2): # Command with 1 or more args.
             guild_ids = [guild_id]
 
         def wrapper(cmd):
-            self.add_slash_command(cmd, name, description, auto_convert, guild_ids, options)
+            self.add_slash_command(cmd, name, description, guild_ids, options)
             return cmd
 
         return wrapper
@@ -560,14 +533,20 @@ def subcommand(self,
                    base_desc: str = None,
                    subcommand_group_description: str = None,
                    sub_group_desc: str = None,
-                   auto_convert: dict = None,
                    guild_ids: typing.List[int] = None,
                    options: typing.List[dict] = None):
         """
         Decorator that registers subcommand.\n
         Unlike discord.py, you don't need base command.\n
         All args must be passed as keyword-args.
 
+        .. note::
+            If you don't pass `options` but has extra args, then it will automatically generate options.
+            However, it is not recommended to use it since descriptions will be "No Description." or the command's description.
+
+        .. warning::
+            Unlike discord.py's command, ``*args``, keyword-only args, converters, etc. are not supported or behave differently.
+
         Example:
 
         .. code-block:: python
@@ -599,8 +578,6 @@ async def _group_kick_user(ctx, user):
         :param subcommand_group_description: Description of the subcommand_group. Default ``None``.
         :type subcommand_group_description: str
         :param sub_group_desc: Alias of ``subcommand_group_description``.
-        :param auto_convert: Dictionary of how to convert option values. Default ``None``.
-        :type auto_convert: dict
         :param guild_ids: List of guild ID of where the command will be used. Default ``None``, which will be global command.
         :type guild_ids: List[int]
         :param options: Options of the subcommand. This will affect ``auto_convert`` and command data at Discord API. Default ``None``.
@@ -610,7 +587,7 @@ async def _group_kick_user(ctx, user):
         subcommand_group_description = subcommand_group_description or sub_group_desc
 
         def wrapper(cmd):
-            self.add_subcommand(cmd, base, subcommand_group, name, description, base_description, subcommand_group_description, auto_convert, guild_ids, options)
+            self.add_subcommand(cmd, base, subcommand_group, name, description, base_description, subcommand_group_description, guild_ids, options)
             return cmd
 
         return wrapper

discord_slash/cog_ext.py

@@ -7,7 +7,6 @@
 def cog_slash(*,
               name: str = None,
               description: str = None,
-              auto_convert: dict = None,
               guild_ids: typing.List[int] = None,
               options: typing.List[dict] = None):
     """
@@ -30,8 +29,6 @@ async def ping(self, ctx: SlashContext):
     :type name: str
     :param description: Description of the slash command. Default ``None``.
     :type description: str
-    :param auto_convert: Dictionary of how to convert option values. Default ``None``.
-    :type auto_convert: dict
     :param guild_ids: List of Guild ID of where the command will be used. Default ``None``, which will be global command.
     :type guild_ids: List[int]
     :param options: Options of the slash command. This will affect ``auto_convert`` and command data at Discord API. Default ``None``.
@@ -44,15 +41,9 @@ def wrapper(cmd):
         else:
             opts = options
 
-        if opts:
-            auto_conv = manage_commands.generate_auto_convert(opts)
-        else:
-            auto_conv = auto_convert
-
         _cmd = {
             "func": cmd,
             "description": desc,
-            "auto_convert": auto_conv,
             "guild_ids": guild_ids,
             "api_options": opts,
             "has_subcommands": False
@@ -70,7 +61,6 @@ def cog_subcommand(*,
                    base_desc: str = None,
                    subcommand_group_description: str = None,
                    sub_group_desc: str = None,
-                   auto_convert: dict = None,
                    guild_ids: typing.List[int] = None,
                    options: typing.List[dict] = None):
     """
@@ -103,8 +93,6 @@ async def group_say(self, ctx: SlashContext, text: str):
     :param subcommand_group_description: Description of the subcommand_group. Default ``None``.
     :type subcommand_group_description: str
     :param sub_group_desc: Alias of ``subcommand_group_description``.
-    :param auto_convert: Dictionary of how to convert option values. Default ``None``.
-    :type auto_convert: dict
     :param guild_ids: List of guild ID of where the command will be used. Default ``None``, which will be global command.
     :type guild_ids: List[int]
     :param options: Options of the subcommand. This will affect ``auto_convert`` and command data at Discord API. Default ``None``.
@@ -120,18 +108,12 @@ def wrapper(cmd):
         else:
             opts = options
 
-        if opts:
-            auto_conv = manage_commands.generate_auto_convert(opts)
-        else:
-            auto_conv = auto_convert
-
         _sub = {
             "func": cmd,
             "name": name or cmd.__name__,
             "description": desc,
             "base_desc": base_description,
             "sub_group_desc": subcommand_group_description,
-            "auto_convert": auto_conv,
             "guild_ids": guild_ids,
             "api_options": opts
         }

discord_slash/model.py

@@ -17,7 +17,6 @@ class CommandObject:
     :ivar name: Name of the command.
     :ivar func: The coroutine of the command.
     :ivar description: Description of the command.
-    :ivar auto_convert: Dictionary of the `auto_convert` of the command.
     :ivar allowed_guild_ids: List of the allowed guild id.
     :ivar options: List of the option of the command. Used for `auto_register`.
     :ivar __commands_checks__: Check of the command.
@@ -26,7 +25,6 @@ def __init__(self, name, cmd):  # Let's reuse old command formatting.
         self.name = name.lower()
         self.func = cmd["func"]
         self.description = cmd["description"]
-        self.auto_convert = cmd["auto_convert"] or {}
         self.allowed_guild_ids = cmd["guild_ids"] or []
         self.options = cmd["api_options"] or []
         self.has_subcommands = cmd["has_subcommands"]

discord_slash/utils/manage_commands.py

@@ -207,24 +207,6 @@ def generate_options(function: Callable, description: str = "No description.") -
     return options
 
 
-def generate_auto_convert(options: list) -> dict:
-    """
-    Generate an auto_convert dict from command options.
-
-    .. note::
-        This is automatically used if you pass options.
-
-    :param options: The list of options.
-    """
-    auto_convert = {}
-    for x in options:
-        if x["type"] in (SlashCommandOptionType.SUB_COMMAND, SlashCommandOptionType.SUB_COMMAND_GROUP):
-            raise Exception("You can't use subcommand or subcommand_group type!")
-        auto_convert[x["name"]] = x["type"]
-
-    return auto_convert
-
-
 def create_choice(value: str, name: str):
     """
     Creates choices used for creating command option.

docs/migrate_to_109.rst

@@ -104,4 +104,7 @@ Note that removing `if not hasattr(...):` block then moving to main file like th
     # No worries for not doing `bot.slash` because its automatically added now.
     ...
 
+Auto-convert
+------------
 
+It got deleted, so please remove all of it if you used it.