ripbi.toml

Found in the working directory or its nearest ancestor; relative paths resolve against the file's own directory. Flags override the file; the file overrides discovery. Unknown keys are errors, so a misspelled setting cannot silently change a scan.

target = "samples/AdventureWorks Sales.SemanticModel"  # used when no PATH is given
reports = ["samples/AdventureWorks Sales.Report"]      # extra roots when discovery finds none
queries_from = "exports/semantic-model-logs.csv"        # logged queries as consumers (scan and deps)
queries_item = "AdventureWorks Sales"                   # the log's model, when its name differs

[scan]
ignore = ["'*Time Intelligence'[*]", "*Legacy*"]       # object-name globs, never reported unused
stats_from = "exports/AdventureWorks Sales.abf"        # sizes for a PBIP/TMDL model, or "none"
external_consumers = "none"                            # nothing outside these reports reads the model

target and reports feed the input ladder every command shares: see inputs and pairing. --model disables target, and passing --report replaces reports.

stats_from is the config form of --stats-from (see Storage sizes): a path resolved against the file's directory, or none to turn off .pbi/cache.abf auto-detection. The flag replaces it. It is ignored when the scanned model carries its own storage catalog (a PBIX or .abf).

external_consumers = "none" says nothing outside the scanned reports reads the model — no thin reports in other workspaces, Analyze in Excel, or XMLA clients — and drops the check-before-removing hint a scan with findings prints under its verdict. It changes no finding and no exit code. none is the only value.

queries_from is the config form of --queries-from, resolved against the file's directory; it sits at the top level because deps reads it too. queries_item picks the log's model by name or ItemId GUID. The flags replace both (see Logged queries).

ignore patterns are case-insensitive globs where * matches any run of characters and ? exactly one; everything else (quotes and brackets included — they appear in display ids) is literal. A pattern matches a finding when it matches the full display id ('Sales'[Draft Amount]) or the bare object name; for a broken binding it matches the written reference whole ('Sales'[Color] — a binding has no bare name of its own). For a stale bookmark, both forms use its author-facing displayName when present, falling back to its source object name. Suppressed findings are excluded from the output and the exit code, and counted in summary.ignored. The suppression applies before type selection: an object matched by both is simply gone. The auto date/time machinery can be silenced wholesale this way — see the recipe at the end of Human output. For an object that is unused on purpose, prefer a ripbi_keep annotation. deps never applies ignore: a dependency view shows what the graph says, ignored or not.