Settings

line_width

Type integer
Default 100

Specifies the maximum number of columns per line. Longer lines are broken where they can be.

indent_style

Type "space" | "tab"
Default "space"

Specifies the character to use for indentation.

indent_width

Type integer
Default 4
Range 1 ~ 255

Specifies the number of columns per indentation level.

When indenting with tabs, each tab counts as this many columns toward the line width.

line_ending

Type "lf" | "crlf" | "auto"
Default "auto"

Specifies the line ending. With "auto", it follows the first line ending in the file.

Line endings inside strings and attribute blocks are kept as written, regardless of this setting.

commas

Type "none" | "inline" | "always" | "trailing"
Default "inline"

Specifies where commas go between the items of lists, records, and the like.

[1 2 3]

[
    "src/main.nu"
    "tests/main.nu"
]

[1, 2, 3]

[
    "src/main.nu"
    "tests/main.nu"
]

[1, 2, 3]

[
    "src/main.nu",
    "tests/main.nu"
]

[1, 2, 3]

[
    "src/main.nu",
    "tests/main.nu",
]

include

Type string[]
Default ["*.nu", "*.nuon"]

Specifies the files to format, as glob patterns. A file given directly is formatted even if it does not match.

Patterns are relative to the directory of the config file. A pattern without / matches file names at any depth.

exclude

Type string[]
Default []

Specifies the files and directories to leave out, as glob patterns. This applies to files given directly too.

Patterns are relative to the directory of the config file. A pattern without / matches file and directory names at any depth.

respect_gitignore

Type boolean
Default true

Specifies whether to skip files listed in .gitignore and the like.

overrides

Type { include: string[], exclude?: string[], line_width?, indent_style?, indent_width?, line_ending?, commas? }[]
Default []

Changes the settings for some files only. Each element has the following fields.

{
    overrides: [
        { include: ["tests/**/*.nu"], line_width: 120 }
    ]
}

When several elements match a file, they apply in order, and the later one wins for a setting they both set.