Ręczne pisanie złożonych wyrażeń regularnych z pamięci często wprowadza subtelne błędy — takie jak niezescapowane kropki (. dopasowujące dowolny znak zamiast dosłownej kropki .), brakujące kotwice początku/końca czy błędy związane z wiodącymi zerami. Korzystając z wizualnej kompozycji tokenów, załóżmy, że potrzebujesz ścisłego walidatora Semantic Versioning 2.0.0 (SemVer), który akceptuje opcjonalny prefiks v i wyodrębnia identyfikatory major, minor, patch, prerelease oraz metadane build.
Każda reguła strukturalna przekłada się bezpośrednio na czytelną sekwencję bloków tokenów:
{
"anchoring": "exact_line (^...$)",
"blocks": [
{ "type": "literal", "value": "v", "quantifier": "optional (?)" },
{ "type": "named_capture", "name": "major", "pattern": "0|[1-9]\\d*" },
{ "type": "literal", "value": "." },
{ "type": "named_capture", "name": "minor", "pattern": "0|[1-9]\\d*" },
{ "type": "literal", "value": "." },
{ "type": "named_capture", "name": "patch", "pattern": "0|[1-9]\\d*" },
{
"type": "non_capturing",
"pattern": "-(?<prerelease>[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)",
"quantifier": "optional (?)"
},
{
"type": "non_capturing",
"pattern": "\\+(?<build>[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)",
"quantifier": "optional (?)"
}
]
}
Zwróć uwagę, jak 0|[1-9]\d* egzekwuje Sekcję 2 specyfikacji SemVer 2.0.0, zezwalając na 0, ale odrzucając wiodące zera takie jak 01, oraz jak nieprzechwytujące opakowania (?:...)? chronią separatory - i + bez tworzenia dodatkowych grup numerowanych. Walidacja na pozytywnych i negatywnych zestawach danych testowych oraz eksport kodu wielojęzycznego automatycznie generują deklaracje zgodne z docelowym silnikiem:
# Zsyntetyzowany wzorzec ECMAScript / Rust
^v?(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<prerelease>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+(?<build>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$
# Przypadki pozytywne (Dopasowanie)
1.0.0
v2.14.3-rc.1+build.5114f85
# Przypadki negatywne (Odrzucenie: wiodące zero w numerycznym rdzeniu wersji)
v01.2.0
1.02.3
# Python (surowy ciąg re.compile + składnia nazwanych grup (?P<name>...))
SEMVER_RE = re.compile(r"^v?(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+(?P<build>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$")
# Go (surowy literał w grawisach RE2 regexp.MustCompile + składnia (?P<name>...))
var semverRe = regexp.MustCompile(`^v?(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+(?P<build>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$`)
Ponieważ generator unika referencji wstecznych (backreferences) i asercji rozglądania (lookarounds) w standardowych szablonach, wyeksportowane wyrażenie kompiluje się bez modyfikacji zarówno w środowiskach wykonawczych RE2 o czasie liniowym (Go i Rust), jak i w silnikach z nawrotami (JavaScript i Python).