Ръчното писане на сложни регулярни изрази по памет често води до трудно забележими грешки – например неекранирани точки (. съвпада с произволен символ вместо с литерална точка .), липсващи начална и крайна котва или допускане на водещи нули. Чрез визуално композиране на токени да приемем, че ви е необходим стриктен валидатор за Semantic Versioning 2.0.0 (SemVer), който приема незадължителен префикс v и извлича идентификаторите major, minor, patch, prerelease и build.
Всяко структурно правило се преобразува ясно в изрична последователност от токен блокове:
{
"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 (?)"
}
]
}
Обърнете внимание как 0|[1-9]\d* налага изискванията на Раздел 2 от SemVer 2.0.0, като позволява единична 0, но отхвърля водещи нули като 01, и как неприхващащите обвивки (?:...)? обграждат разделителите - и +, без да създават излишни номерирани групи. Валидирането спрямо положителни и отрицателни тестови примери и експортирането на код за множество езици генерира автоматично точни декларации за съответния двигател:
# Синтезиран шаблон за 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-]+)*))?$
# Положителни примери (Съвпадат)
1.0.0
v2.14.3-rc.1+build.5114f85
# Отрицателни примери (Отхвърлят се: водеща нула в числовото ядро на версията)
v01.2.0
1.02.3
# Python (re.compile суров низ + синтаксис (?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 (RE2 regexp.MustCompile суров литерал с обратни кавички + синтаксис (?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-]+)*))?$`)
Тъй като генераторът избягва обратни препратки (backreferences) и проверки на обкръжението (lookarounds) в стандартните шаблони, експортираният израз се компилира без промени както в среди с линейно време на изпълнение като RE2 (Go и Rust), така и в двигатели с връщане назад (JavaScript и Python).