Skip to main content

Generate diagrams showing relationships between templates in Django projects

Project description

https://travis-ci.org/paul-butcher/django_template_tree.svg?branch=master

Generate diagrams showing relationships between templates in Django projects

Documentation

The full documentation is at https://django_template_tree.readthedocs.io.

Quickstart

Install django-template_tree:

pip install django_template_tree

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'template_tree',
    ...
)

Add django-template_tree’s URL patterns:

from template_tree import urls as template_tree_urls
from django import settings
if settings.DEBUG:
    urlpatterns += [
        url(r'^__tt__/', include('template_tree.urls', namespace='template_tree')),
    ]

Features

Displays a collapsible tree diagram showing the hierarchy of templates used by a Django application.

_static/screenshot.png

Nodes can be collapsed and expanded, by clicking on them.

_static/screenshot-collapsed.png

Apps can be filtered out of the tree, using the ‘exclude_app’ querystring parameter, thus:

http://localhost:8000/__tt__/?exclude_app=template_tree&exclude_app=admin

By default, admin is excluded, so http://localhost:8000/__tt__/ is equivalent to http://localhost:8000/__tt__/?exclude_app=admin

In order to show the admin app as well, you will need to ‘unexclude’ it thus: http://localhost:8000/__tt__/?exclude_app=

Visiting the template_tree url, requesting an application/json response will return json data compatible with d3 hierarchies, so you can roll your own diagrams.

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Credits

Tools used in rendering this package:

History

0.1.0 (2018-01-06)

  • 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.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_template_tree-0.1.1-py2.py3-none-any.whl (7.7 kB) Copy SHA256 hash SHA256 Wheel 2.7 Feb 4, 2018
django_template_tree-0.1.1.tar.gz (7.3 kB) Copy SHA256 hash SHA256 Source None Feb 4, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page