{"id":20329658,"url":"https://github.com/alir3z4/django-databrowse","last_synced_at":"2025-04-11T20:52:48.903Z","repository":{"id":6275132,"uuid":"7508833","full_name":"Alir3z4/django-databrowse","owner":"Alir3z4","description":"Databrowse is a Django application that lets you browse your data.","archived":false,"fork":false,"pushed_at":"2024-03-06T21:45:11.000Z","size":96,"stargazers_count":42,"open_issues_count":3,"forks_count":20,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-11T20:52:43.412Z","etag":null,"topics":["data","database","django"],"latest_commit_sha":null,"homepage":"http://pypi.python.org/pypi/django-databrowse","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alir3z4.png","metadata":{"files":{"readme":"README.rst","changelog":"ChangeLog.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-08T20:37:48.000Z","updated_at":"2023-12-13T07:18:00.000Z","dependencies_parsed_at":"2022-08-24T03:30:23.828Z","dependency_job_id":null,"html_url":"https://github.com/Alir3z4/django-databrowse","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alir3z4%2Fdjango-databrowse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alir3z4%2Fdjango-databrowse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alir3z4%2Fdjango-databrowse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alir3z4%2Fdjango-databrowse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alir3z4","download_url":"https://codeload.github.com/Alir3z4/django-databrowse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248480515,"owners_count":21110936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","database","django"],"created_at":"2024-11-14T20:12:39.185Z","updated_at":"2025-04-11T20:52:48.874Z","avatar_url":"https://github.com/Alir3z4.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"=================\nDjango Databrowse\n=================\n\n.. image:: https://travis-ci.org/Alir3z4/django-databrowse.png\n   :alt: travis-cli tests status for django-databrowse\n   :target: https://travis-ci.org/Alir3z4/django-databrowse\n\n.. contents:: Table of contents\n\n.. note::\n\n    Extracted from `Django 1.4 since databrowse deprecation \u003chttps://docs.djangoproject.com/en/dev/releases/1.4/#django-contrib-databrowse\u003e`_\n\n------\n\nDatabrowse is a Django application that lets you browse your data.\n\nAs the Django admin dynamically creates an admin interface by introspecting\nyour models, Databrowse dynamically creates a rich, browsable Web site by\nintrospecting your models.\n\nInstallation\n------------\n``django-databrowse`` is available on pypi\n\nhttp://pypi.python.org/pypi/django-databrowse\n\nSo easily install it by ``pip``\n::\n    \n    $ pip install django-databrowse\n\nOr by ``easy_install``\n::\n    \n    $ easy_install django-databrowse\n\nAnother way is by cloning ``django-databrowse``'s `git repo \u003chttps://github.com/Alir3z4/django-databrowse\u003e`_ ::\n    \n    $ git clone git://github.com/Alir3z4/django-databrowse.git\n\nThen install it by running:\n::\n    \n    $ python setup.py install\n\n\nHow to use Databrowse\n---------------------\n\n1. Point Django at the default Databrowse templates. There are two ways to\n   do this:\n\n   * Add ``'django_databrowse'`` to your `INSTALLED_APPS`\n     setting. This will work if your `TEMPLATE_LOADERS` setting\n     includes the ``app_directories`` template loader (which is the case by\n     default). See the `template loader docs \u003chttps://docs.djangoproject.com/en/1.4/ref/templates/api/#template-loaders\u003e`_ for more.\n\n   * Otherwise, determine the full filesystem path to the\n     `django_databrowse/templates` directory, and add that\n     directory to your `TEMPLATE_DIRS \u003chttps://docs.djangoproject.com/en/1.4/ref/settings/#std:setting-TEMPLATE_DIRS\u003e`_  setting.\n\n2. Register a number of models with the Databrowse site::\n\n       import django_databrowse\n       from myapp.models import SomeModel, SomeOtherModel, YetAnotherModel\n\n       django_databrowse.site.register(SomeModel)\n       django_databrowse.site.register(SomeOtherModel, YetAnotherModel)\n\n   Note that you should register the model *classes*, not instances.\n\n   it is possible to register several models in the same\n   call to `django_databrowse.site.register`.\n\n   It doesn't matter where you put this, as long as it gets executed at some\n   point. A good place for it is in your `URLconf file \u003chttps://docs.djangoproject.com/en/1.4/topics/http/urls/\u003e`_ (``urls.py``).\n\n3. Change your URLconf to import the `~django_databrowse` module::\n\n       from django_databrowse\n\n   ...and add the following line to your URLconf::\n\n       (r'^django_databrowse/(.*)', django_databrowse.site.root),\n\n   The prefix doesn't matter -- you can use ``databrowse/`` or ``db/`` or\n   whatever you'd like.\n\n4. Run the Django server and visit ``/databrowse/`` in your browser.\n\nRequiring user login\n---------------------\n\nYou can restrict access to logged-in users with only a few extra lines of\ncode. Simply add the following import to your URLconf::\n\n    from django.contrib.auth.decorators import login_required\n\nThen modify the `URLconf \u003chttps://docs.djangoproject.com/en/1.4/topics/http/urls/\u003e`_ so that the\n`django_databrowse.site.root` view is decorated with\n`django.contrib.auth.decorators.login_required`::\n\n    (r'^databrowse/(.*)', login_required(django_databrowse.site.root)),\n\nIf you haven't already added support for user logins to your `URLconf\n\u003chttps://docs.djangoproject.com/en/1.4/topics/http/urls/\u003e`_, as described in the `user authentication docs\n\u003chttps://docs.djangoproject.com/en/1.4/ref/contrib/auth\u003e`_, then you will need to do so now with the following\nmapping::\n\n    (r'^accounts/login/$', 'django.contrib.auth.views.login'),\n\nThe final step is to create the login form required by\n`django.contrib.auth.views.login`. The\n`user authentication docs \u003chttps://docs.djangoproject.com/en/1.4/ref/contrib/auth\u003e`_ provide full details and a\nsample template that can be used for this purpose.\n\n\nTests\n-------------\n\n``django-databrowse`` has been tested Django 1.6 and later. To run the the tests:\n\n::\n   \n   $ python run_tests.py\n\nIt's also available on travis-ci:\n\nhttps://travis-ci.org/Alir3z4/django-databrowse/\n\n\nTranslations\n------------\n\nCurrently ``English`` is only available language that is being packaged. If you would like to contribute\nin localization you can find ``django-databrowse`` project on Transifex as well:\nhttps://www.transifex.com/projects/p/django-databrowse/\n\n**Translation Status on Transifex**\n\n.. image:: https://www.transifex.com/projects/p/django-databrowse/resource/django_databrowse/chart/image_png\n   :alt: django-databrowse translation status on transifex\n   :target: https://www.transifex.com/projects/p/django-databrowse/\n   \n\nReleasing\n----------\n\n* To make a release, first update the changelog with all the changes in the new release.\n* Tag the git repository with the release version.\n* Upload to PyPI.\n* Update https://github.com/Alir3z4/django-databrowse/releases.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falir3z4%2Fdjango-databrowse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falir3z4%2Fdjango-databrowse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falir3z4%2Fdjango-databrowse/lists"}