Skip to main content

Module normalize

Module normalize 

Source
Expand description

Deterministic rule forms.

canonical is what pull writes: volatile fields removed and keys sorted. comparable is what diff compares: canonical plus server defaults. They remain separate so pull does not write defaults the author omitted.

Functionsยง

canonical
The on-disk form.
canonical_item
The on-disk form of an exception item.
canonical_list
The on-disk form of an exception-list container.
comparable
The comparison form.
fill_defaults
Add fields the server fills on create without overwriting explicit values.
sort_items
Sort exception items for stable file output and diff reports. Items with unreadable identities sort last.
sort_lists
Sort exception-list containers for stable file output and diff reports. Lists with unreadable list_id values sort last.
sort_rules
Sort rules for stable file output and diff reports. Rules with unreadable rule_id values sort last.
strip_exception_ids
Remove the volatile pointer from every exception reference.
strip_volatile
Remove the server-owned fields that change on every write.