A linter & autoformatter for consistent HTML code, or else.
Project description
Cutesy 🥰
A cute little HTML linter, until y̵ou ma̴k̵e i̴͌ͅt̴̖̀ a̵̤̤͕̰͐̅͘͘n̶̦̣͙̑̌̆̄ǵ̷̗̗̀͝r̷̭̈́͂͘ẙ̶͔̟̞̊̈…̴̢͘
Cutesy checks HTML documents for consistency and best practices. It’s opinionated. It includes a set of rules, most of which can be fixed automatically.
Cutesy expects (and enforces) HTML5 files, with UTF-8 encoding.
Cutesy works with templating languages, such as Django Template Language or Ruby's ERB. These are handled during the "preprocessing" step. Because of this, Cutesy takes dynamic template tags into account for certain types of formatting (such as indentation) & some rules (such as balancing HTML tags).
Preprocessing is (or will be) supported for these templating languages:
- Django
- Jinja
- ERB
- Handlebars
- EJS
- Mustache
- Nunjucks
- Smarty
- Liquid
Benefits
- Better web experiences & metrics, due to enforced best practices.
- Quicker development; Write without worrying about formatting, and let Cutesy apply the formatting automatically.
- Maximum readability, due to consistent style.
- Faster code review, due to the smallest possible diffs.
Installation
Cutesy is written in Python. Install via PyPI:
pip install cutesy
Usage
Minimal usage:
cutesy "some_file.html"
Lint multiple files using a glob pattern:
cutesy "*.html"
cutesy "path/to/templates/**/*.html"
# etc…
Fix files automatically (recommended):
cutesy "*.html" --fix
Cutesy can check HTML fragments, or whole HTML documents. By default, files specifying a non-HTML5 doctype (anything other than <!doctype html>) are ignored.
To assume (and enforce) that all matching files are HTML5, use the --check-doctype flag:
cutesy "*.html" --fix --check-doctype
To lint files written in a template language, such as the Django Template Language:
cutesy "*.html" --fix --preprocessor="django"
Other options:
--return-zero: Exit with code 0 even when problems are found
Testing, etc.
Install development requirements (Requires Python >= 3.8):
make install
Sort imports:
make format
Lint:
make lint
Test:
make test
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
