A tool to format in a very opinionated way HTML, XML and text containing XML snippets.

It satisfies a primary need: decrease the pain of diffing HTML/XML.

For this reason zpretty formats the markup following these rules of thumb:

maximize the vertical space/decrease the line length
attributes should be sorted consistently
attribute sorting is first semantic and then alphabetic

This tool understands the TAL language and has some features dedicated to it.

This tool is not a linter! If you are looking for linters safe bets are Tidy and xmllint.

You may have parsing problems! zpretty will close for you some known self closing tags, like input and img, that are allowed to be open in HTML.

zpretty is not clever enough to understand correctly valueless attributes! Some work is ongoing, but it works best with "normal" attributes.

Lack of feature/slowness are a known issue. For the moment the development focused in having a working tool. So it works fast enough: less than a second to format a ~100k file. New features are planned and also huge perfomance boost can be easily obtained. Anyway zpretty is not your option for formatting large files (> 1 MB).

See TODO section to know what is forecast for the future.

The source code and the issue tracker are hosted on GitHub.

INSTALL

The suggested installation method is using pip:

python3 -m pip install --user zpretty

The latest release of zpretty requires Python3. If you need to use Python2.7 use zpretty 0.9.x.

USAGE

Basic usage:

$ zpretty -h
usage: zpretty [-h] [--encoding ENCODING] [-i] [-v] [-x] [-z] [--check]
               [--include INCLUDE] [--exclude EXCLUDE]
               [--extend-exclude EXTEND_EXCLUDE]
               [paths ...]

positional arguments:
  paths                 The list of files or directory to prettify (defaults to
                        stdin). If a directory is passed, all files and
                        directories matching the regular expression passed to
                        --include will be prettified.

options:
  -h, --help            show this help message and exit
  --encoding ENCODING   The file encoding (defaults to utf8)
  -i, --inplace         Format files in place (overwrite existing file)
  -v, --version         Show zpretty version number
  -x, --xml             Treat the input file(s) as XML
  -z, --zcml            Treat the input file(s) as XML. Follow the ZCML
                        styleguide
  --check               Return code 0 if nothing would be changed, 1 if some
                        files would be reformatted
  --include INCLUDE     A regular expression that matches files and directories
                        that should be included on recursive searches. An empty
                        value means all files are included regardless of the
                        name. Use forward slashes for directories on all
                        platforms (Windows, too). Exclusions are calculated
                        first, inclusions later. [default:
                        \.(html|pt|xml|zcml)$]
  --exclude EXCLUDE     A regular expression that matches files and directories
                        that should be excluded on recursive searches. An empty
                        value means no paths are excluded. Use forward slashes
                        for directories on all platforms (Windows, too).
                        Exclusions are calculated first, inclusions later.
                        [default: /(\.direnv|\.eggs|\.git|\.hg|\.mypy_cache|\.no
                        x|\.tox|\.venv|venv|\.svn|\.ipynb_checkpoints|_build|buc
                        k-out|build|dist|__pypackages__)/]
  --extend-exclude EXTEND_EXCLUDE
                        Like --exclude, but adds additional files and
                        directories on top of the excluded ones. (Useful if you
                        simply want to add to the default)

The default exclude pattern is: `/(\.direnv|\.eggs|\.git|\.hg|\.mypy_cache|\.nox
|\.tox|\.venv|venv|\.svn|\.ipynb_checkpoints|_build|buck-
out|build|dist|__pypackages__)/`

Without parameters constraining the file type (e.g. -x, -z, ...) zpretty will try to guess the right options for you.

Example:

zpretty hello_world.html

pre-commit support

zpretty can be used as a pre-commit hook. To do so, add the following to your .pre-commit-config.yaml:

- repo: https://github.com/collective/zpretty
  rev: FIXME
  hooks:
    - id: zpretty

VSCode extension

There is a VSCode extension that uses zpretty:

https://marketplace.visualstudio.com/items?itemName=erral.erral-zcmlLanguageConfiguration

Thanks to @erral for the work!

DEVELOP

git clone ...
cd zpretty
make

RUNNING TESTS

make test