JuliaFormatter.jl

Build Status

Width-sensitive formatter for Julia code. Inspired by gofmt, refmt, black, and prettier. Built with CSTParser.

  • Sane defaults out of the box with options to customize.
  • Supports YAS and Blue style guides.
  • JuliaFormatter.toml configuration file to store options.

Installation

]add JuliaFormatter

Quick Start

julia> using JuliaFormatter

# Recursively formats all Julia files in the current directory
julia> format(".")

# Formats an individual file
julia> format_file("foo.jl")

# Formats a string (contents of a Julia file)
julia> format_text(str)

# Formats all files in the package directory of a `Module`
julia> format(FooPackage)

Usage

JuliaFormatter exports format, format_file, format_text, and format_md.

format_md has the same API as format_text but differ in that format_md expects the text content to be a Markdown document.

See format_text docstring for formatting options at the text level and format_file docstring for formatting options at the file level.

JuliaFormatter should work on any valid Julia and Markdown files. If JuliaFormatter cannot parse the code for any reason, it will throw an error pointing to the line that could not be parsed. If running format on multiple files, you may want to set verbose = true to print information about which file is being formatted.