curlylint

What it is and what it does

Curlylint is a command-line linter for HTML templates written in curly-brace template languages—Jinja, Nunjucks, Django templates, Twig, and Liquid. It parses template syntax and HTML structure together to detect issues that a plain HTML linter would miss. The tool focuses on accessibility checks, flagging common patterns that create barriers for users with disabilities.

The package is built on parsy for parsing, attrs for data structures, click for CLI, and toml for configuration files. It started as a fork of jinjalint and is classified as Alpha software. While the project is dormant (no releases since March 2022), it remains archived-free on GitHub and has no known security vulnerabilities.

Use it for:

• Lint Django template files in a CI/CD pipeline to catch accessibility violations before deployment.
• Check Jinja templates in a static site generator or Flask application for common HTML issues.
• Validate Nunjucks or Twig templates in a web project to enforce accessibility standards.
• Integrate template linting into a pre-commit hook to catch issues during development.
• Audit existing template codebases for accessibility problems across multiple template languages.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Lints HTML templates in Jinja, Nunjucks, Django, Twig, and Liquid, checking for accessibility and common template issues via command-line tool.

Yes, if you actively lint templates in one of the five supported languages and need accessibility-focused checks. The low install friction and permissive license make it easy to try. However, dormancy since 2022 means no active maintenance—use it for existing projects but verify compatibility with your template engine versions and be prepared to maintain a fork if critical issues arise.

Install

curlylint on PyPI

pip install curlylint

uv add curlylint

poetry add curlylint

Installing curlylint

Before you install

Low install friction with six runtime dependencies. Maintenance is dormant—last release was 2022-03-30 and no commits since 2024-01-28—so expect no active bug fixes or feature development.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, provided you retain the license notice.

Quickstart

pip install curlylint
curlylint template-directory/

Requires Python 3.6 or later.

Verify before relying

• Whether dormant status and 1598 days since last release affect real-world usability with current template engine versions.
• Scope and maturity of accessibility checks relative to other linters in this space.
• Whether the tool handles all syntax variants of the five supported template languages equally well.

Package facts

Evidence: curlylint-0.13.1-py3-none-any.whl

Keywords: curlylint, linter, linting, jinja, jinja2, django templates, twig, nunjucks, liquid, templates, html

Tags

More Quality Assurance packages