Fixed #16907 -- Deprecate databrowse.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16871 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Paul McMillan 2011-09-22 04:10:02 +00:00
parent f91af72523
commit 5a01324f20
3 changed files with 24 additions and 9 deletions

View File

@ -1 +1,6 @@
import warnings
from django.contrib.databrowse.sites import DatabrowsePlugin, ModelDatabrowse, DatabrowseSite, site
warnings.warn("The Databrowse contrib app is deprecated",
PendingDeprecationWarning)

View File

@ -5,21 +5,15 @@ Databrowse
.. module:: django.contrib.databrowse
:synopsis: Databrowse is a Django application that lets you browse your data.
.. deprecated:: 1.4
This module has been deprecated.
Databrowse is a Django application that lets you browse your data.
As the Django admin dynamically creates an admin interface by introspecting
your models, Databrowse dynamically creates a rich, browsable Web site by
introspecting your models.
.. admonition:: Note
Databrowse is **very** new and is currently under active development. It
may change substantially before the next Django release.
With that said, it's easy to use, and it doesn't require writing any
code. So you can play around with it today, with very little investment in
time or coding.
How to use Databrowse
=====================

View File

@ -640,3 +640,19 @@ Until Django 1.3 the functions :func:`~django.conf.urls.include`,
were located in a ``django.conf.urls.defaults`` module.
Starting with Django 1.4 they are now available in :mod:`django.conf.urls`.
``django.contrib.databrowse``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Databrowse has not seen active development for some time, and this does not
show any sign of changing. There had been a suggestion for a GSOC project to
integrate the functionality of databrowse into the admin, but no progress was
made. While Databrowse has been deprecated, an enhancement of
django.contrib.admin providing a similar feature set is still possible.
.. _GSOC Proposal: https://code.djangoproject.com/wiki/SummerOfCode2011#Integratedatabrowseintotheadmin
The code that powers Databrowse is licensed under the same terms as Django
itself, and so is available to be adopted by an individual or group as
a third-party project.