Menulis ungkapan biasa yang padat secara manual daripada ingatan sering menimbulkan kecacatan halus—seperti titik tanpa lepasan (. yang memadankan sebarang aksara dan bukannya titik literal .), sauh mula/tamat yang tertinggal, atau pepijat sifar pendahulu (leading zero). Menggunakan penggubahan token visual, andaikan anda memerlukan pengesah Semantic Versioning 2.0.0 (SemVer) yang ketat yang menerima awalan pilihan v dan mengekstrak pengecam metadata major, minor, patch, prerelease serta build.
Setiap peraturan struktur dipetakan dengan kemas kepada urutan blok token yang eksplisit:
{
"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 (?)"
}
]
}
Perhatikan bagaimana 0|[1-9]\d* menguatkuasakan SemVer 2.0.0 Seksyen 2 dengan membenarkan 0 sambil menolak sifar pendahulu seperti 01, dan bagaimana pembalut bukan penangkap (?:...)? mengawal pembatas - dan + tanpa mencipta kumpulan bernombor tambahan. Mengesahkan terhadap fixture positif dan negatif serta mengeksport kod pelbagai bahasa akan menghasilkan pengisytiharan tepat mengikut enjin secara automatik:
# Corak ECMAScript / Rust yang Disintesis
^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-]+)*))?$
# Fixture Positif (Padan)
1.0.0
v2.14.3-rc.1+build.5114f85
# Fixture Negatif (Tolak: sifar pendahulu dalam teras versi angka)
v01.2.0
1.02.3
# Python (rentetan mentah re.compile + sintaks kumpulan bernama (?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 mentah backtick RE2 regexp.MustCompile + sintaks (?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-]+)*))?$`)
Memandangkan penjana ini mengelakkan rujukan balik (backreferences) dan tinjauan keliling (lookarounds) dalam resipi standard, ungkapan yang dieksport dapat dikompil tanpa pengubahsuaian dalam masa jalan RE2 masa linear (Go dan Rust) serta enjin jejak balik (JavaScript dan Python).