Misleading list of options available for manage.py commands

[Maxime Lorant]

Every commands has some options available, since the BaseCommand initialize some options to the options parser: verbosity, settings, traceback..

However, this can be misleading, because these arguments are not used by every commands and sometimes this choice is by design. For example, the runserver command does not use the verbosity option, and it has been explained why only there: https://code.djangoproject.com/ticket/15132

I think the framework should not show generic options that are not used in the current commands (through an explicit list of generic options ignored or an explicit list of commands used ?)

[Tim Graham]

I don't know that this is a big problem that is worth changing, but I guess if someone wants to propose a patch to fix the issue for runserver, we could entertain it. The documentation says these options are "​available on all options" so this would require an update too. One consideration is that subclasses of runserver might use these options (verbosity most likely) so removing them by default would be backwards incompatible.

[Yuneui Jeong]

Can I have a look at and work on this ticket? This is my first contribution, but I'll try my best.

[Yuneui Jeong]

Here's the PR for this ticket: ​https://github.com/django/django/pull/14612

[Jan Szoja]

That shounds like nice and easy ticket for the beginner like myself.
I will start with allowing setting argparse.SUPPRESS(as suggester in PR) in BaseCommand and possibly more advance way to tell which default commands are supported. Will see.

[Jan Szoja]

Pull Request awailable at:
​https://github.com/django/django/pull/14694

I've added new attribute to BaseCommand class, which allows to disable any option/argument predefined in BaseCommand.create_parser.
All tests passed for admin_scripts.

[Mariusz Felisiak <felisiak.mariusz@…>]

In 3cca5fdd:

Refs #25264 -- Doc's that not all default options are supported by every management command.

[Mariusz Felisiak <felisiak.mariusz@…>]

In 97f377c:

Refs #25264 -- Added test for command --help output with default options and custom arguments.

[Mariusz Felisiak <felisiak.mariusz@…>]

In b667ac2:

Fixed #25264 -- Allowed suppressing base command options in --help output.

This also suppresses -verbosity and --trackback options in the
runserver's help.

[Mariusz Felisiak <felisiak.mariusz@…>]

In 4e55806:

[3.2.x] Refs #25264 -- Doc's that not all default options are supported by every management command.

Backport of 3cca5fdd3eb5906a385adaf9872581d4ed359041 from main