[Fixed]-How should I validate HTML in Django templates during the development process?

Alternatively, a roll-your-own approach to validating pages on your site during your usual unit testing process would look something like this:

1. Go through your urls.py and generate as many possible URLs for the site as you can
2. Use the built-in Django test client to fetch each of those urls
3. Validate them somehow (See perhaps Validate (X)HTML in Python)

Not sure if anyone’s done any of the work on this is a reusable way.

One solution is to make a script that renders all the templates based on an input dictionary of variables test values.

The main logic to retrieve the list of variables defined in the templates is the following:

from django.template.loader import get_template

def extract_required_vars(node):
    if not hasattr(node, 'nodelist'):
        return []
    var_names = []
    for child_node in node.nodelist:
        if isinstance(child_node, VariableNode):
            var_names.append(child_node.filter_expression.token)
        elif isinstance(child_node, ForNode):
            var_names.append(child_node.sequence.var.var)
        elif isinstance(child_node, ExtendsNode):
            template = get_template(child_node.parent_name.var)
            var_names.extend(extract_required_vars(template))
        elif isinstance(child_node, IncludeNode):
            template = get_template(child_node.template.var)
            var_names.extend(extract_required_vars(template))
        var_names.extend(extract_required_vars(child_node))
    return var_names

required_vars = extract_required_vars(get_template('index.html'))

The script then checks that the variables defined in the templates are either in the project settings or in the dict provided by user as test input.

/path/to/project/templates/templates/allusers.html
  -> ok: users, STATIC_URL
/path/to/project/templates/entrer-en-contact.html
  -> ok: contactform, STATIC_URL
/path/to/project/templates/dest-summary.html
  -> ok: STATIC_URL
  -> missing: dest_username

More details in this blog post.

See django-extensions project, it has a built in template validator which can be run with a manage command like so:

python manage.py validate_templates

This only tries to load your template using django’s template loader, so checks for things like missing tags. As long as it can create a Template object it will pass. Here is more documentation on get_template which is the method it calls.

The Django Check HTML Middleware can detect typos in your HTML:

https://github.com/guettli/django-check-html-middleware