keep-unique

Prevents duplicate entries in a list — allowlists, registered IDs, route names.

Syntax

Attribute	Value	Default
keep-unique	empty, or a regex whose (?P<value>…) group is compared	whole line

Unlike keep-sorted, the regex goes directly in the attribute value — there is no separate keep-unique-pattern.

Example

# <block keep-unique>
"user_1",
"user_2",
"user_3",
# </block>

Uniqueness by regex

Compare only part of each line:

ids = [
    # <block keep-unique="^ID:(?P<value>\d+)">
    "ID:1 Alice",
    "ID:2 Bob",
    "ID:1 Carol",  # Violation: ID:1 is already used
    # </block>
]

Without a value group the whole match is compared. Lines that do not match are skipped.

Notes

• Blank lines are ignored.
• Comparison is on the trimmed line, so indentation does not create false uniqueness.
• Commonly combined with keep-sorted on the same block.

---

← Validators · README