djade 0.1.0

A Django template formatter.

A Django template formatter.

---

Improve your Django and Git skills with my books.

---

Installation

Use pip:

python -m pip install djade

Python 3.8 to 3.13 supported.

Usage

djade is a commandline tool that rewrites files in place. Run it on a file to modify it:

djade templates/index.html

Djade implements some rules listed in the Django contribution style guide’s template style section:

• One space around variables and tags:

  -{{egg}}
  +{{ egg }}
  
  -{%  crack egg  %}
  +{% crack egg %}

• Add labels to {% endblock %} tags that aren’t on the same line as their opening {% block %} tag:

   {% block shell %}
   ...
  -{% endblock %}
  +{% endblock shell %}

• In {% load %} tags, alphabetically sort libraries:

  -{% load omelette frittata %}
  +{% load friattata omelette %}

Djade also implements some extra rules:

• Leading empty lines are removed:

  -
   {% extends 'white.html' %}
   ...

• Trailing empty lines are removed, and a trailing newline inserted if necessary:

   ...
   {% endblock content %}
  -
  -

• One space around comment tags:

  -{#egg#}
  +{# egg #}

• Remove labels from {% endblock %} tags on the same line as their opening {% block %} tag:

  -{% block shell %}...{% endblock shell %}
  +{% block shell %}...{% endblock %}

• Merge consecutive {% load %} tags:

  -{% load omelette %}
  -
  -{% load frittata %}
  +{% load frittata omelette %}