Categories by origin for command listings in "manage.py help"

[Vlada Macek]

As the number of loaded modules and apps grows for bigger project, simple alphabetic list of "manage.py help" commands becomes a pell-mell.

Very quickly I learn from which Python module the command I search is originating from. This applies the most for my own commands, even the most frequent situation is that I need to find my own mgmt command name for copy'n'paste.

The attached patch displays the help list with colored categories like this:

Available subcommands:

[myapp]
  dump_all_objects
  import_images
  invalidate_memcached

[django]
  cleanup
  compilemessages
  createcachetable
  createsuperuser
  dbshell
  ...

[django_evolution]
  evolve

[django_extensions]
  clean_pyc
  compile_pyc
  create_app
  create_command
  create_jobs
  ...

[Vlada Macek]

Categorizes the commands in the "manage.py help" list

[Graham King]

Applies cleanly to trunk. All the tests pass. I love this. It would be very useful on my current work project.

I've tested it on three different projects, a very simple one with only the 'django' module, a two-module one (django and south), and a very complex one (76 management commands in 11 modules). Works perfectly. Strong +1 from me.

Could someone try it on Windows and Mac, just to be 100%? If it works OK on those (it's using color_style, so it should) then it's Ready For Checkin.

[Martin Mahner]

This works fine on a Mac however I see two problems with it:

1. Its backwards incompatible, I am not sure if its a huge deal but someone could parse this list, having an option 'manage.py help --list' to get the old behavior would be fine.
2. It's irritating, if an app overwrites a 'core' app, this command is under that app. See the South help list:

[south]
  convert_to_south
  datamigration
  graphmigrations
  migrate
  schemamigration
  startmigration
  syncdb
  test
  testserver

South overwrites 'test' and 'testserver' which I would expect under [django].

[Jannis Leidel]

FWIW, I agree with bartTC's points, except that 'manage.py help --commands' seems more fitting.

[Aymeric Augustin]

#16445 was a duplicate.

[Jacob]

Milestone 1.4 deleted

[Aymeric Augustin]

I'm uploading a new patch with the implementation discussed on IRC with jezdez, tests and docs.

[Aymeric Augustin]

I've also made the implementation of version / --version consistent with help / --help while I was there.

[Aymeric Augustin]

In [17462]:

Fixed #11745 -- Grouped commands by application in the output of manage.py help. Made 'version' consistent with 'help' while I was in the area, and added tests. Thanks Jannis for the feedback and review.

[Aymeric Augustin]

revert spam