zprint-mode.el

Integrates zprint, the pretty-printer for Clojure(Script) files, into Emacs

zprint-mode reformats files quickly (<100ms) because it uses precompiled native binaries of zprint. It works on macOS or Linux.

Changelog

0.4 (2024-06-17)

Upgrade to zprint 1.2.9

0.3 (2020-07-13)

Upgrade to zprint 1.0.0

Detect python executable

0.2 (2019-11-30)

Upgrade to zprint 0.5.3

Fix Python 3 compatibility

0.1 (2018-11-11)

Initial release

Installation

The recommended way is to use MELPA. If MELPA is in your package-archives, do

M-x package-install RET zprint-mode RET

If you use Spacemacs, you can add zprint-mode to dotspacemacs-additional-packages and use SPC f e R to reload the packages.

See below for manual installation instructions.

Ad-hoc usage

Filter the current buffer through zprint my invoking M-x zprint.

If a region is selected, only that region will be pretty-printed.

You can set up a keyboard shortcut if that's your thing:

(global-set-key (kbd "C-c p") 'zprint)

Or if you're running Spacemacs or otherwise using Evil mode:

(evil-leader/set-key "op" 'zprint)

Automatic usage

Alternatively, you can enable zprint-mode in the current buffer. With zprint-mode enabled, the current buffer is auto-formatted whenever you save.

M-x zprint-mode

If you're feeling adventurous, you can enable zprint-mode for all Clojure(Script) files:

(add-hook 'clojure-mode-hook 'zprint-mode)
(add-hook 'clojurescript-mode-hook 'zprint-mode)

Manual installation

Download zprint-mode.el and save it somewhere where emacs can find it, e.g. ~/.emacs.d/lisp/.

You only need zprint-mode.el - the zprint graalvm binary is downloaded automagically on first run.

You will probably need to add that directory to Emacs's load path:

# e.g.
(add-to-list 'load-path "~/.emacs.d/lisp/")

Then you will need to require the package:

(require 'zprint-mode)

Author

Paulus Esterhazy pesterhazy@gmail.com