Ticket #22194: listtags.diff

django/core/checks/registry.py

@@ -54 +54 @@
         return errors
 
     def tag_exists(self, tag):
-        tags = chain(*[check.tags for check in self.registered_checks if hasattr(check, 'tags')])
-        return tag in tags
+        return tag in self.tags_available()
+
+    def tags_available(self):
+        return chain(*[check.tags for check in self.registered_checks if hasattr(check, 'tags')])
 
 
 registry = CheckRegistry()

django/core/management/commands/check.py

@@ -5 +5 @@
 
 from django.apps import apps
 from django.core import checks
+from django.core.checks.registry import registry
 from django.core.management.base import BaseCommand, CommandError
 
 
@@ -16 +17 @@
     option_list = BaseCommand.option_list + (
         make_option('--tag', '-t', action='append', dest='tags',
             help='Run only checks labeled with given tag.'),
+        make_option('--list-tags', action='store_true', dest='list_tags',
+                    help='List available tags.'),
     )
 
     def handle(self, *app_labels, **options):
+        if options.get('list_tags', False):
+            self.stdout.write('\n'.join(registry.tags_available()))
+            return
+
         if app_labels:
             app_configs = [apps.get_app_config(app_label) for app_label in app_labels]
         else:

docs/ref/django-admin.txt

@@ -126 +126 @@
 
     python manage.py check --tag security --tag compatibility
 
+.. django-admin-option:: --list-tags
+
+List all available tags.
+
 compilemessages
 ---------------
 

tests/check_framework/tests.py

@@ -194 +194 @@
     def test_invalid_tag(self):
         self.assertRaises(CommandError, call_command, 'check', tags=['missingtag'])
 
+    @override_system_checks([simple_system_check])
+    def test_list_tags_empty(self):
+        call_command('check', list_tags=True)
+        self.assertEqual('\n', sys.stdout.getvalue())
+
+    @override_system_checks([tagged_system_check])
+    def test_list_tags(self):
+        call_command('check', list_tags=True)
+        self.assertEqual('simpletag\n', sys.stdout.getvalue())
+
 
 def custom_error_system_check(app_configs, **kwargs):
     return [