ryl config presets¶

Applying a preset¶

ryl's TOML config (recommended) is the single, explicit source of a file's rules: it has no preset or extends key, inherits nothing, and merges nothing, so what it enables is the file's whole ruleset, with no default-on rules.

ryl resolves one config per file by searching upward from the file. A TOML config (.ryl.toml, ryl.toml, .config/.ryl.toml, .config/ryl.toml, or pyproject.toml [tool.ryl], in that precedence order) found anywhere up the tree is preferred over a .yamllint, even a nearer one; among configs of the same kind the nearest wins. A monorepo can therefore hold many ryl.toml files, one per subtree, each governing its own files. If the upward search finds no project config, ryl falls back to a single user-global config; see the quick start.

Presets are starting points for that config, not something ryl inherits behind the scenes:

• TOML config (recommended): there is no preset or extends key. The tables below are the presets, so copy the one you want into your .ryl.toml (or ryl.toml) and customise from there. That copy is then your one explicit config.
• YAML config (yamllint parity): a yamllint-style config may extends: a built-in preset (default, relaxed, empty) or another config file, and ryl merges the inherited settings in (with overrides under rules:). This inheritance is the yamllint behaviour the recommended TOML format omits by design.

These TOML presets mirror the built-in YAML presets in ryl (default, relaxed, empty) from src/conf/mod.rs.

default (TOML equivalent)¶

[files]
yaml = [
    "*.yaml",
    "*.yml",
    ".yamllint",
]

[rules]
anchors = "enable"
braces = "enable"
brackets = "enable"
colons = "enable"
commas = "enable"
document-end = "disable"
empty-lines = "enable"
empty-values = "disable"
float-values = "disable"
hyphens = "enable"
indentation = "enable"
key-duplicates = "enable"
key-ordering = "disable"
line-length = "enable"
new-line-at-end-of-file = "enable"
new-lines = "enable"
octal-values = "disable"
quoted-strings = "disable"
trailing-spaces = "enable"

[rules.comments]
level = "warning"

[rules.comments-indentation]
level = "warning"

[rules.document-start]
level = "warning"

[rules.truthy]
level = "warning"

relaxed (TOML equivalent, fully expanded)¶

[files]
yaml = [
    "*.yaml",
    "*.yml",
    ".yamllint",
]

[rules]
anchors = "enable"
comments = "disable"
comments-indentation = "disable"
document-end = "disable"
document-start = "disable"
empty-values = "disable"
float-values = "disable"
key-duplicates = "enable"
key-ordering = "disable"
new-line-at-end-of-file = "enable"
new-lines = "enable"
octal-values = "disable"
quoted-strings = "disable"
trailing-spaces = "enable"
truthy = "disable"

[rules.braces]
level = "warning"
max-spaces-inside = 1

[rules.brackets]
level = "warning"
max-spaces-inside = 1

[rules.colons]
level = "warning"

[rules.commas]
level = "warning"

[rules.empty-lines]
level = "warning"

[rules.hyphens]
level = "warning"

[rules.indentation]
level = "warning"
indent-sequences = "consistent"

[rules.line-length]
level = "warning"
allow-non-breakable-inline-mappings = true

empty¶

There is no usable TOML equivalent: ryl requires at least one rule to be enabled, so an empty [rules] table is rejected with "configuration enables no rules". The empty preset survives only as a base to extends: in YAML config; in TOML, list the rules you want under [rules] directly.