nixfmt

nixfmt is a formatter for Nix code, intended to easily apply a uniform style.

You are encouraged to test this out on your code and submit any undesirable formatting you find as an issue

State

nixfmt will form the basis for the initial official standard Nix formatter, as established by RFC 166.

The established standard Nix formatting differs considerably from the original one. Be aware of this if you track the main branch. Until the first new release the main branch should be considered very unstable.

For more details, see the RFC implementation tracking issue.

Installation

• nixfmt is in nixpkgs master as of 2019-09-04:

  nix-env -iA nixpkgs.nixfmt
  

• To get the most recent version, install from master:

  nix-env -f https://github.com/NixOS/nixfmt/archive/master.tar.gz -i
  

• Nix with flakes

  nix profile install github:NixOS/nixfmt
  

Development

With Nix

Haskell dependencies will be built by Nix.

• Enter nix-shell
• Build with cabal new-build

Without Nix

Haskell dependencies will be built by Cabal.

• Build with cabal new-build

Usage

• nixfmt < input.nix – reads Nix code from stdin, formats it, and outputs to stdout
• nixfmt file.nix – format the file in place

With the pre-commit tool

If you have Nix files in a Git repo and you want to make sure that they’re formatted with nixfmt, then you can use the pre-commit tool from pre-commit.com:

1. Make sure that you have the pre-commit command:

   $ pre-commit --version
   pre-commit 3.7.1

2. Make sure that you’re in your Git repo:

   $ cd <path-to-git-repo>

3. Make sure that the pre-commit tool is installed as a Git pre-commit hook:

   $ pre-commit install
   pre-commit installed at .git/hooks/pre-commit

4. If you don’t already have one, then create a .pre-commit-config.yaml file.

5. Add an entry for the nixfmt hook to your .pre-commit-config.yaml file:

   repos:
       - repo: https://github.com/NixOS/nixfmt
         rev: <version>
         hooks:
               - id: nixfmt
   

   If you want to use a stable version of nixfmt, then replace <version> with a tag from this repo. If you want to use an unstable version of nixfmt, then replace <version> with a commit hash from this repo.

6. Try to commit a badly formatted Nix file in order to make sure that everything works.

Warning

nixfmt’s integration with the pre-commit tool is relatively new. At the moment, none of the stable releases of nixfmt can be used with the pre-commit tool. You’ll have to use an unstable version for the time being.

About Serokell

nixfmt is maintained and funded with ❤️ by Serokell. The names and logo for Serokell are trademark of Serokell OÜ.

We love open source software! See our other projects or hire us to design, develop and grow your idea!