Commit 5a01324f authored by Paul McMillan's avatar Paul McMillan
Browse files

Fixed #16907 -- Deprecate databrowse.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@16871 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent f91af725
Loading
Loading
Loading
Loading
+5 −0
Original line number Diff line number Diff line
import warnings
from django.contrib.databrowse.sites import DatabrowsePlugin, ModelDatabrowse, DatabrowseSite, site


warnings.warn("The Databrowse contrib app is deprecated",
    PendingDeprecationWarning)
+3 −9
Original line number Diff line number Diff line
@@ -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
=====================

+16 −0
Original line number Diff line number Diff line
@@ -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.