summaryrefslogtreecommitdiff
path: root/django/contrib/admin/decorators.py
diff options
context:
space:
mode:
Diffstat (limited to 'django/contrib/admin/decorators.py')
-rw-r--r--django/contrib/admin/decorators.py28
1 files changed, 28 insertions, 0 deletions
diff --git a/django/contrib/admin/decorators.py b/django/contrib/admin/decorators.py
new file mode 100644
index 0000000000..cc6943dbdd
--- /dev/null
+++ b/django/contrib/admin/decorators.py
@@ -0,0 +1,28 @@
+def register(*models, **kwargs):
+ """
+ Registers the given model(s) classes and wrapped ModelAdmin class with
+ admin site:
+
+ @register(Author)
+ class AuthorAdmin(admin.ModelAdmin):
+ pass
+
+ A kwarg of `site` can be passed as the admin site, otherwise the default
+ admin site will be used.
+ """
+ from django.contrib.admin import ModelAdmin
+ from django.contrib.admin.sites import site, AdminSite
+
+ def _model_admin_wrapper(admin_class):
+ admin_site = kwargs.pop('site', site)
+
+ if not isinstance(admin_site, AdminSite):
+ raise ValueError('site must subclass AdminSite')
+
+ if not issubclass(admin_class, ModelAdmin):
+ raise ValueError('Wrapped class must sublcass ModelAdmin.')
+
+ admin_site.register(models, admin_class=admin_class)
+
+ return admin_class
+ return _model_admin_wrapper