From 5a01324f20305213cb4429b8ef4c376fe19a7fd7 Mon Sep 17 00:00:00 2001 From: Paul McMillan Date: Thu, 22 Sep 2011 04:10:02 +0000 Subject: [PATCH] Fixed #16907 -- Deprecate databrowse. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16871 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- django/contrib/databrowse/__init__.py | 5 +++++ docs/ref/contrib/databrowse.txt | 12 +++--------- docs/releases/1.4.txt | 16 ++++++++++++++++ 3 files changed, 24 insertions(+), 9 deletions(-) diff --git a/django/contrib/databrowse/__init__.py b/django/contrib/databrowse/__init__.py index e2f48ac822d..24098b013d4 100644 --- a/django/contrib/databrowse/__init__.py +++ b/django/contrib/databrowse/__init__.py @@ -1 +1,6 @@ +import warnings from django.contrib.databrowse.sites import DatabrowsePlugin, ModelDatabrowse, DatabrowseSite, site + + +warnings.warn("The Databrowse contrib app is deprecated", + PendingDeprecationWarning) diff --git a/docs/ref/contrib/databrowse.txt b/docs/ref/contrib/databrowse.txt index 33c8228520c..794855877aa 100644 --- a/docs/ref/contrib/databrowse.txt +++ b/docs/ref/contrib/databrowse.txt @@ -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 ===================== diff --git a/docs/releases/1.4.txt b/docs/releases/1.4.txt index 8de9e8d358a..5b92f95f59e 100644 --- a/docs/releases/1.4.txt +++ b/docs/releases/1.4.txt @@ -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. +