Arguments

detache.argument(name, type=None, default=None, required=True, nargs=1, help=None)

Command argument.

Parameters:
  • name – Name of the argument. Should match one of the function’s arguments.
  • type – (Optional) Argument type. Leave as None to accept any type.
  • default – (Optional) Default value.
  • required – (Optional) Whether the argument is required. Defaults to True
  • nargs – (Optional) Number of times the argument can occur. Defaults to 1. -1 allows unlimited arguments.
  • help – (Optional) Argument description.

If nargs is anything other than 1, the parsed argument will be returned as a list.

Détaché supports several argument types:

Custom types can also be created by inheriting from detache.Any. This type takes a hexadecimal number and converts it to an int, for example:

class Hex(detache.Any):
    # arguments are parsed using regex patterns
    pattern = "(0x)?[0-9a-f]+"

    @classmethod  # <- must be a classmethod
    def convert(cls, ctx, raw):
        # a context object and the raw argument are passed for conversion

        # remove 0x
        if raw.startswith("0x"):
            raw = raw[2:]

        return int(raw, base=16)  # return the converted argument

Variadic Arguments

Variadic arguments allow an argument to be passed a specific or unlimited number of times. This is set with the nargs parameter. If this is set to -1, an unlimited number of arguments is accepted.

Variadic arguments are passed to the underlying function as a list.

Example:

@detache.command("add", "Variadic argument test that adds numbers.")
@detache.argument("addends", detache.Number, nargs=-1, help="Addends")
async def add_cmd(self, ctx, addends):
    return sum(addends)

If nargs is -1, then setting required=False will allow the argument to not be passed at all. Otherwise, the argument must be passed at least once.