OutputScan class

Compares the generated outputs on disk against the canonical source, and reports orphan keys: keys that exist in a generated file but not in dialect/source.

An orphan means someone edited a generated file by hand. Regenerating deletes it, which is the trap that silently lost 7 live keys the first time Dialect ran on a real project — so sync refuses on it, and check reports it.

Both commands read the same scan on purpose. check used to look only at dialect/source + dialect/translations, so it stayed green on a repo where sync was guaranteed to refuse: the prescribed first command could not answer "is this repo in a state where sync can run?". One scanner, two consumers, one answer.

Properties

adoptable → Map<String, ArbEntry>
Keys --adopt can recover into the source, mapped to the entry it would write.
no setter
completeKeys → Set<String>
Orphans that came back from adoptable already carrying both a namespace and a description, so adopting them needs no follow-up.
no setter
hashCode → int
The hash code for this object.
no setterinherited
isEmpty → bool
no setter
isNotEmpty → bool
no setter
keys → Set<String>
no setter
keysNeedingMetadata → Set<String>
Adoptable orphans still missing namespace and/or description.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
translationValues → Map<String, Map<String, String>>
Translated values that live only in a translation output, keyed by locale. --adopt restores these alongside the source entry.
no setter
unadoptableKeys → Set<String>
Orphans with no source-locale value — --adopt can't recover these.
no setter

Methods

filesFor(String key) → Set<String>
Output files carrying key, as recorded during the scan.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

run(DialectProject project, {List<PlatformConfig>? platforms}) → OutputScan
Scan the on-disk outputs of platforms (default: every configured platform) for orphan keys.