Skip to main content

Hierarchical view system Python Django with breadcrumbs

Project description

Django DjangoViewHiearchy

.. image::

.. image::

.. image::

* **WIP:** This app is still being developed and documented! Use at your
own risk.

* **NOTE:** Presently *only* supports Python 3.5+ and Django 1.9+ (see `issue
#1 <>`_)

Hierarchical view system Python Django. Define an arbitrary hierarchical
URL structure in your ````, define how breadcrumbs get generated for
each view, and then this package will automatically generate breadcrumbs
attached to the request object that can be easily rendered in any page, to
easily link "up" the view hierarchy.


* Supports both Class Based Views and simple functional views

* Auto-generates an ``urlpatterns`` for any nested URL pattern, keeping
your ``urlpatterns`` more DRY

* Automatically generates breadcrumbs with both title and URL available as
``request.breadcrumbs`` for each node in ancestor tree

Quick start


1. Install django_view_hierarchy and put in requirements file
3. Create a view hierarchy with one or more


1. Install

.. code-block:: bash

pip install django_view_hierarchy


In your ```` file, add something like:

.. code-block:: python


3. Use decorator or mixin to add view hierarchy to views

For Class Based Views, do the following:

.. code-block:: python

from django.views import View
from django_view_hierarchy.views import BreadcrumbMixin

class UserList(BreadcrumbMixin, View):
breadcrumb = 'All users' # Static

For more complicated examples, you may need to specify a breadcrumb that
involves fetching data from the DB or giving your view a name:

.. code-block:: python
class UserDetailView(BreadcrumbMixin, View):
view_name = 'user_details' # Optionally give view a name
def get_breadcrumb(self):
pk = self.kwargs['pk']
user = User.objects.get(pk=pk)
return user.username

For function-style views, you can do the same thing as follows:

.. code-block:: python
from django_view_hierarchy.decorators import breadcrumb

def user_list_view(request):
return render_to_response('...')

@breadcrumb(lambda request, pk: User.objects.get(pk).username, 'user_details')
def user_detail_view(request, pk):
return render_to_response('...')

4. Configure hierarchy in

For example, to make a set of views like:

* ``/users/`` for a list of all users
* ``/users/<userid>/`` for a particular user
* ``/users/<userid>/followers/`` for a sub-page of a particular user,
showing off their followers

The hierarchy can be built like:

.. code-block:: python
from django_view_hierarchy.helpers import view_hierarchy
urlpatterns = view_hierarchy({
'users': {
'': UserListView,
'(?P<pk>\d+)': {
'': UserDetailView,
'followers': user_followers_view,

Note that Class Based Views *should not* include `as_view`, this will be
done automatically.

5. Use breadcrumbs in views and/or templates

.. code-block:: html

{% for breadcrumb in request.breadcrumbs %}
<a href="{{ breadcrumb.url }}">{{ breadcrumb.title }}</a>
{% endfor %}


Tools used in creating this package:

* Cookiecutter_
* `cookiecutter-djangopackage`_

.. _Cookiecutter:
.. _`cookiecutter-djangopackage`:


0.1.0 (2017-11-10)

* First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_view_hierarchy-0.1.2.tar.gz (20.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page