Extracted from Django 1.4 since databrowse deprecation
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.
django-databrowse is available on pypi
So easily install it by
$ pip install django-databrowse
$ easy_install django-databrowse
Another way is by cloning
django-databrowse's git repo
$ git clone git://github.com/Alir3z4/django-databrowse.git
Then install it by running:
$ python setup.py install
Point Django at the default Databrowse templates. There are two ways to do this:
'django_databrowse'to your INSTALLED_APPS setting. This will work if your TEMPLATE_LOADERS setting includes the
app_directoriestemplate loader (which is the case by default). See the template loader docs for more.
- Otherwise, determine the full filesystem path to the django_databrowse/templates directory, and add that directory to your TEMPLATE_DIRS setting.
Register a number of models with the Databrowse site:
import django_databrowse from myapp.models import SomeModel, SomeOtherModel, YetAnotherModel django_databrowse.site.register(SomeModel) django_databrowse.site.register(SomeOtherModel, YetAnotherModel)
Note that you should register the model classes, not instances.
it is possible to register several models in the same call to django_databrowse.site.register.
It doesn't matter where you put this, as long as it gets executed at some point. A good place for it is in your URLconf file (
Change your URLconf to import the ~django_databrowse module:
...and add the following line to your URLconf:
The prefix doesn't matter -- you can use
db/or whatever you'd like.
Run the Django server and visit
/databrowse/in your browser.
You can restrict access to logged-in users with only a few extra lines of code. Simply add the following import to your URLconf:
from django.contrib.auth.decorators import login_required
Then modify the URLconf so that the django_databrowse.site.root view is decorated with django.contrib.auth.decorators.login_required:
The final step is to create the login form required by django.contrib.auth.views.login. The user authentication docs provide full details and a sample template that can be used for this purpose.
django-databrowse has been tested Django 1.6 and later. To run the the tests:
$ python run_tests.py
It's also available on travis-ci:
English is only available language that is being packaged. If you would like to contribute
in localization you can find
django-databrowse project on Transifex as well:
Translation Status on Transifex