:warning: This project is effectively unmaintained! I (@tfausak) would recommend switching to another formatter. At time of writing (2022-11-11), I would suggest Ormolu. Or if you prefer some configuration, I would suggest Fourmolu.
haskell source code formatter
(see more examples and comparisons)
This project's goals roughly are to:
-XCPP
which is too hard);In theory, the core algorithm inside brittany reaches these goals. It is rather clever about making use of horizontal space while still being linear in the size of the input (although the constant factor is not small). See these examples of clever layouting.
But brittany is not finished yet, and there are some open issues that yet require fixing:
ghc-exactprint
as the parser, brittany supports full GHC
including extensions, but some of the less common syntactic elements
(even of 2010 haskell) are not handled.You can paste haskell code over here to test how it gets formatted by brittany. (Rg. privacy: the server does log the size of the input, but not the full input/output of requests.)
9.0.x
.~/.config/brittany/config.yaml
;
also reads (the first) brittany.yaml
found in current or parent
directories.via stack
stack install brittany # --resolver lts-16.31
If you use an lts that includes brittany this should just work; otherwise you may want to clone the repo and try again.
via cabal
Due to constant changes to the cabal UI, I have given up on making sure these instructions work before releases. Please do not expect these instructions to be up-to-date; they may produce incomprehensible error messages, they may be broken otherwise, they may work now but break with the next cabal release. Thanks for your understanding, and feel free to open issues for any problems you encounter. -- lennart
If you are using cabal-3.0, using
cabal install brittany --installdir=$HOME/.cabal/bin
might work. Keep in mind that cabal merely puts a symlink to the "store"
into the installdir, so you have to re-install if you ever clean your
store. On cabal-2.4, try cabal v2-install brittany
. On cabal-2.2 or
earlier you might be succesful using
cabal new-build exe:brittany; cp `find dist-newstyle/ -name brittany -type f | xargs -x ls -t | head -n1` $HOME/.cabal/bin/
.
Alternatively, you can also use the v1-approach with sandboxes as
cabal v1-sandbox init; cabal v1-install brittany --bindir=$HOME/.cabal/bin
.
(TODO: These instructions are more confusing than helpful. I am inclined to just remove them.)
on ArchLinux:
pacman -S haskell-brittany
In this gist I have described a haskell setup that includes a shortcut to run brittany formatting.
This extension
connects commandline brittany
to VSCode formatting API. Thanks to @MaxGabriel.
haskell-language-server
includes a brittany
plugin that directly uses the brittany library.
Relevant for any editors that properly support the language-server-protocol.
The Neoformat plugin comes with support for brittany built in.
Atom Beautify supports brittany as a formatter for Haskell. Since the default formatter is set to hindent, you will need to change this setting to brittany, after installing the extension.
format-all support brittany as the default formatter for Haskell.
Default mode of operation: Transform a single module, from stdin
to stdout
.
Can pass one or multiple files as input, and there is a flag to override them
in place instead of using stdout
(since 0.9.0.0). So:
brittany # stdin -> stdout
brittany mysource.hs # ./mysource.hs -> stdout
brittany --write-mode=inplace *.hs # apply formatting to all ./*.hs inplace
For stdin/stdout usage it makes sense to enable certain syntactic extensions
by default, i.e. to add something like this to your
~/.config/brittany/config.yaml
(execute brittany
once to create default):
conf_forward:
options_ghc:
- -XLambdaCase
- -XMultiWayIf
- -XGADTs
- -XPatternGuards
- -XViewPatterns
- -XRecursiveDo
- -XTupleSections
- -XExplicitForAll
- -XImplicitParams
- -XQuasiQuotes
- -XTemplateHaskell
- -XBangPatterns
For a long time this project has had a single maintainer, and as a consequence there have been some mildly large delays for reacting to feature requests and even PRs.
Sorry about that.
The good news is that this project is getting sponsored by PRODA LTD, and two previous contributors, Evan Borden and Taylor Fausak, have agreed on helping with organisational aspects. Thanks!
Still, this project has a long queue of very sensible feature requests, so it may take some time until new ones get our attention. But with the help of the co-maintainers, at least the reaction-times on PRs and the frequency of releases should improve significantly.
If you are interested in making your own contributions, there is a good amount of high-level documentation at
Copyright (C) 2016-2019 Lennart Spitzner\ Copyright (C) 2019 PRODA LTD
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License, version 3, as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.