hindent
Extensible Haskell pretty printer
https://github.com/mihaimaruseac/hindent
| Version on this page: | 6.2.0 |
| LTS Haskell 23.28: | 6.2.1 |
| Stackage Nightly 2024-12-09: | 6.2.1 |
| Latest on Hackage: | 6.2.1 |
hindent-6.2.0@sha256:2712035e7af8c61ad29dcf1ff2522c6c19313be821bb58bb199ffac53461f694,8741Module documentation for 6.2.0
hindent 
Haskell pretty printer
Install
$ stack install hindent
Usage
$ hindent --help
hindent - Reformat Haskell source code
Usage: hindent [--version | [--line-length ARG]
[--indent-size ARG | --tab-size ARG] [--no-force-newline]
[--sort-imports | --no-sort-imports] [--style STYLE]
[-X GHCEXT] [--validate] [FILENAMES]]
Available options:
--version Print the version
--line-length ARG Desired length of lines (default: 80)
--indent-size ARG Indentation size in spaces (default: 2)
--tab-size ARG Same as --indent-size, for compatibility
--no-force-newline Don't force a trailing newline
--sort-imports Sort imports in groups
--no-sort-imports Don't sort imports
--style STYLE Style to print with (historical, now ignored)
-X GHCEXT Language extension
--validate Check if files are formatted without changing them
-h,--help Show this help text
hindent is used in a pipeline style
$ cat path/to/sourcefile.hs | hindent
The default indentation size is 2 spaces. Configure indentation size with --indent-size:
$ echo 'example = case x of Just p -> foo bar' | hindent --indent-size 2; echo
example =
case x of
Just p -> foo bar
$ echo 'example = case x of Just p -> foo bar' | hindent --indent-size 4; echo
example =
case x of
Just p -> foo bar
Customization
Create a .hindent.yaml file in your project directory or in your
~/ home directory. The following fields are accepted and are the
default:
indent-size: 2
line-length: 80
force-trailing-newline: true
sort-imports: true
line-breaks: []
extensions: [
"GHC2021",
"ListTuplePuns",
]
By default, hindent preserves the newline or lack of newline in your input. With force-trailing-newline, it will make sure there is always a trailing newline.
hindent can be forced to insert a newline before specific operators and tokens with line-breaks. This is especially useful when utilizing libraries like servant which use long type aliases.
Using extensions, hindent can be made aware of valid syntactic compiler extensions that would normally be considered invalid syntax.
It is also possible to specify which extensions HIndent runs
with in your .hindent.yaml:
extensions:
- MagicHash
- RecursiveDo
Emacs
In
elisp/hindent.el
there is hindent-mode, which provides keybindings to reindent parts of the
buffer:
M-qreformats the current declaration. When inside a comment, it fills the current paragraph instead, like the standardM-q.C-M-\reformats the current region.
To enable it, add the following to your init file:
(add-to-list 'load-path "/path/to/hindent/elisp")
(require 'hindent)
(add-hook 'haskell-mode-hook #'hindent-mode)
Vim
The 'formatprg' option lets you use an external program (like
hindent) to format your text. Put the following line into
~/.vim/ftplugin/haskell.vim to set this option for Haskell files:
setlocal formatprg=hindent
Then you can format with hindent using gq. Read :help gq and help 'formatprg' for more details.
Note that unlike in emacs you have to take care of selecting a sensible buffer region as input to hindent yourself. If that is too much trouble you can try vim-textobj-haskell which provides a text object for top level bindings.
In order to format an entire source file execute:
:%!hindent
Alternatively you could use the vim-hindent plugin which runs hindent automatically when a Haskell file is saved.
IntelliJ / other JetBrains IDEs
- Install the “HaskForce” Haskell plugin (this is so we get the language type recognized in the file watcher)
- Install the “File Watchers” plugin under “Browse Repositories”
- Add a File Watcher with
- File type: Haskell Language
- Program:
/path/to/hindent - Arguments:
$FilePath$ - Immediate file synchronization: off
- Show console: Error
Now whenever you save a file, hindent should autoformat it.