Escrever expressões regulares densas manualmente e de cabeça frequentemente introduz defeitos sutis — como pontos sem escape (. correspondendo a qualquer caractere em vez do ponto literal .), ausência de âncoras de início/fim ou bugs de zero à esquerda. Usando a composição visual de tokens, suponha que você precise de um validador estrito de Versionamento Semântico 2.0.0 (SemVer) que aceite um prefixo opcional v e extraia os identificadores de metadados major, minor, patch, prerelease e build.
Cada regra estrutural mapeia de forma limpa para uma sequência explícita de blocos de tokens:
{
"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 (?)"
}
]
}
Observe como 0|[1-9]\d* aplica a Seção 2 do SemVer 2.0.0 permitindo 0 enquanto rejeita zeros à esquerda como 01, e como os agrupamentos de não captura (?:...)? protegem os delimitadores - e + sem criar grupos numerados extras. Validar contra casos de teste positivos e negativos e exportar código multilíngue produz declarações precisas para cada motor automaticamente:
# Padrão sintetizado para 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-]+)*))?$
# Casos de teste positivos (Correspondem)
1.0.0
v2.14.3-rc.1+build.5114f85
# Casos de teste negativos (Rejeitados: zero à esquerda no núcleo numérico da versão)
v01.2.0
1.02.3
# Python (raw string re.compile + sintaxe de grupo nomeado (?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 (literal bruto com crases RE2 regexp.MustCompile + sintaxe (?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-]+)*))?$`)
Como o gerador evita retroreferências (backreferences) e lookarounds nas receitas padrão, a expressão exportada compila sem modificações tanto em motores RE2 de tempo linear (Go e Rust) quanto em motores baseados em backtracking (JavaScript e Python).