Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration

Fatou is configured with a TOML file named fatou.toml. All keys are optional; omitting a key uses its default. Unknown keys are rejected with an error, so a typo never silently falls back to a default.

Discovery

For a given file, Fatou looks for fatou.toml by walking up from the file’s directory through its ancestors, stopping at the first fatou.toml it finds.

On the command line:

  • --config <PATH> loads an explicit file and skips discovery.
  • --no-config ignores any discovered file and uses the built-in defaults.

[format]

KeyTypeDefaultDescription
line_widthinteger92The width the formatter tries to keep lines within.
indent_widthinteger4Number of spaces per indentation level.

Defaults follow common Julia conventions. Both keys can be overridden per run with the --line-width/--indent-width flags on fatou format.

[format]
line_width = 92
indent_width = 4

[lint]

KeyTypeDefaultDescription
selectarray of stringsunsetIf set, only these rule IDs run.
ignorearray of strings[]Rule IDs to disable.

Note: no lint rules ship yet, so [lint] is scaffolding today. The keys are accepted so a fatou.toml can be prepared ahead of the first rules landing.

[lint]
select = ["some-rule"]
ignore = ["another-rule"]