From 84dfd7b3e3dd8c7dcca3160be03214db1d05076f Mon Sep 17 00:00:00 2001 From: Michael Van Buren Date: Wed, 8 Feb 2017 20:54:28 -0800 Subject: [PATCH] [commands] Add Command.usage argument to override argument display. --- discord/ext/commands/core.py | 3 +++ discord/ext/commands/formatter.py | 4 +++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/discord/ext/commands/core.py b/discord/ext/commands/core.py index 79dc1093b..29ebd9d86 100644 --- a/discord/ext/commands/core.py +++ b/discord/ext/commands/core.py @@ -93,6 +93,8 @@ class Command: brief : str The short help text for the command. If this is not specified then the first line of the long help text is used instead. + usage : str + A replacement for arguments in the default help text. aliases : list The list of aliases the command can be invoked under. pass_context : bool @@ -145,6 +147,7 @@ class Command: self.enabled = kwargs.get('enabled', True) self.help = kwargs.get('help') self.brief = kwargs.get('brief') + self.usage = kwargs.get('usage') self.rest_is_raw = kwargs.get('rest_is_raw', False) self.aliases = kwargs.get('aliases', []) self.pass_context = kwargs.get('pass_context', True) diff --git a/discord/ext/commands/formatter.py b/discord/ext/commands/formatter.py index fb883d33e..5fb51cfe7 100644 --- a/discord/ext/commands/formatter.py +++ b/discord/ext/commands/formatter.py @@ -203,7 +203,9 @@ class HelpFormatter: result.append(name) params = cmd.clean_params - if len(params) > 0: + if cmd.usage: + result.append(cmd.usage) + elif len(params) > 0: for name, param in params.items(): if param.default is not param.empty: # We don't want None or '' to trigger the [name=value] case and instead it should