ffmt

A fast, configurable Fortran formatter with support for Fypp, Doxygen, and OpenACC/OpenMP directives. Written in Rust. Installable via pip.

Installation

pip install ffmt

Or via Cargo:

cargo install ffmt

Usage

ffmt src/                        # format in-place
ffmt --check src/                # CI mode (exit 1 if changes needed)
ffmt --diff src/                 # show colored diff
ffmt -j 8 src/                   # parallel
cat file.fpp | ffmt -            # stdin/stdout
ffmt --range 10:50 file.fpp      # format only lines 10-50

What it does

• Indentation -- scope-based indentation for all Fortran constructs
• Whitespace -- consistent spacing around operators, commas, colons, parentheses
• Keywords -- case normalization (IF -> if, ENDDO -> end do)
• Continuation lines -- normalized with proportional re-indentation
• Preprocessor -- Fypp (#:if, #:for), OpenACC (!$acc), OpenMP (!$omp) handled correctly

Configuration

Create ffmt.toml or add [tool.ffmt] to pyproject.toml. All options have sensible defaults -- most projects need no config file at all.

General

Whitespace

The [whitespace] section controls spacing around specific operators:

Files

Example

indent-width = 4
line-length = 132
keyword-case = "lower"
normalize-keywords = true

[whitespace]
relational = true
logical = true
plusminus = true
multdiv = false
power = false
assignment = true
declaration = true
comma = true

Preserved as-is

• String literals and inline expressions (${...}$, @{...}@)
• Comment contents and Doxygen alignment (!<, !>, !!)
• Continuation line structure across #ifdef/#:if preprocessor blocks
• #ifdef/#endif blocks (no indentation change)
• Fypp/Python code inside $: and @: macro invocations

Editor integration

ffmt includes a built-in LSP server for real-time format-on-save:

ffmt --lsp

VS Code

{
    "fortran.formatting.formatter": "ffmt",
    "fortran.formatting.args": ["--stdin-filepath", "${file}", "-"]
}

Vim/Neovim

autocmd BufWritePost *.fpp,*.f90 silent !ffmt %
" Or: set formatprg=ffmt\ -

Neovim (LSP)

vim.lsp.start({
    name = "ffmt",
    cmd = { "ffmt", "--lsp" },
    root_dir = vim.fs.dirname(vim.fs.find({ "ffmt.toml", "pyproject.toml" }, { upward = true })[1]),
})

CI integration

GitHub Actions

- uses: sbryngelson/ffmt@latest
  with:
    args: "--check src/"

pre-commit

repos:
  - repo: https://github.com/sbryngelson/ffmt
    rev: v0.2.1
    hooks:
      - id: ffmt

To auto-update to the latest version, run:

pre-commit autoupdate

Or use pre-commit.ci to update hooks automatically via pull requests.

Other Fortran Formatters

License

MIT