File ignores¶

Excluding files and paths¶

Per-line ignores suppress rules on lines matching a pattern. This page covers the coarser layer: skipping whole files, or switching off chosen rules for a path.

Three mechanisms, narrowing from left to right:

ignore¶

A top-level ignore lists paths ryl skips entirely. No rule runs against them and they produce no diagnostics.

[rules.document-start]
present = true

ignore = """
vendor/**
generated/**
"""

The same key works in yamllint-compatible YAML config:

rules:
  document-start:
    present: true
ignore: |
  vendor/**
  generated/**

ignore-from-file reads the same patterns from a file instead, so a project can reuse its .gitignore:

[rules.document-start]
present = true

ignore-from-file = ".gitignore"

Glob semantics¶

Patterns are gitignore-style: ** crosses directory boundaries, a bare *.yaml matches at any depth, and a leading ! negates an earlier pattern.

[rules.document-start]
present = true

ignore = """
*.generated.yaml
!schema.generated.yaml
"""

ignore also excludes files named on the command line¶

Unlike a shell glob, ignore is not just a directory-walk filter: a path matching it is skipped even when passed explicitly, so ryl check vendor/a.yaml reports nothing if vendor/** is ignored. This is the equivalent of ruff's force-exclude, always on. See YAML in Markdown for how it interacts with a pre-commit hook that passes filenames.

per-file-ignores¶

per-file-ignores keeps linting a file but switches off the rules named for it. Use it where a file legitimately breaks one rule and should still be checked for everything else — a Helm values file with no document start, a workflow file whose on: key trips truthy.

[rules.document-start]
present = true

[rules.truthy]

[per-file-ignores]
"**/values.yaml" = ["document-start"]
".github/workflows/*" = ["truthy"]

Each key is a path glob with the same semantics as ignore, including ! negation. Each value is a list of rule IDs.

per-file-ignores is ryl-only and configured in TOML only (yamllint has no equivalent); it is rejected in yamllint-compatible YAML config. Unlike per-line-ignores, it accepts rule IDs only — there is no "ALL" shorthand for every rule. To skip a file outright, use ignore.

Per-rule ignore¶

Every rule accepts its own ignore, scoping that one rule to a subset of the tree. Other rules still run against the excluded paths.

[rules.line-length]
max = 80
ignore = """
docs/**
"""

[rules.colons]

Here docs/** is exempt from line-length but still checked by colons.

Choosing between them¶

Related¶

• Per-line ignores — suppress rules on lines matching a regex or path.
• Inline directives — in-file suppression with # ryl disable / disable-line.
• Migrating from yamllint — how ignore and ignore-from-file resolve relative paths per config source.