Back
+30 XP
Concept

Semantic Version (SemVer) Parser & Comparator

Dependency resolvers calculate upgrade paths using Semantic Versioning 2.0.0 (`MAJOR.MINOR.PATCH-PRERELEASE`). Numeric triplets determine standard precedence, while the SemVer specification mandates that a version with a pre-release tag has lower precedence than the normal release (`1.0.0-rc.1` < `1.0.0`) 📦🏷️⚖️.

python
import re

SEMVER = re.compile(r"^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9.-]+))?")

def parse_ver(text):
    m = SEMVER.match(text)
    maj, min_, pat = int(m[1]), int(m[2]), int(m[3])
    pre = m[4]
    # None pre-release outranks any pre-release tag
    return (maj, min_, pat, 1 if pre is None else 0, pre or "")

print("1.0.0-rc1 < 1.0.0:", parse_ver("1.0.0-rc1") < parse_ver("1.0.0"))

# 13. Semantic Version (SemVer) Parser & Comparator Every packaging tool, Docker tag validator, and CI/CD promotion gate compares release strings. A common bug is treating version numbers like simple floats (`1.10 < 1.9` mathematically, but version `1.10.0` is vastly newer than `1.9.0`!) 🛑. ```python # Semantic Versioning 2.0.0 Specification: # Format: MAJOR.MINOR.PATCH[-PRERELEASE][+BUILDMETADATA] # Examples: # 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0 ``` ### Precedence Invariants 1. **Numeric Component Dominance**: First compare `major`, then `minor`, then `patch`. 2. **The Pre-Release Inversion**: If `(1, 2, 4)` matches, the version *without* a pre-release is the finalized production build and takes higher precedence than any `-beta` or `-rc` candidate! 3. **Build Metadata Exclusion**: Metadata following `+` (e.g. `+build.1042`) is ignored when determining version precedence 📦🏷️⚖️. --- ### Interactive Pop-Quiz 🧠 #### Under the SemVer 2.0.0 specification, which version has higher precedence between `1.2.0-beta` and `1.2.0`? - [ ] `1.2.0` (A normal release has strictly higher precedence than its associated pre-release) 📦 - [ ] `1.2.0-beta` - [ ] They are identical in precedence - [ ] Precedence cannot be computed without a Git commit hash --- ### Practical Challenge 🎯 Implement `SemVer` with classmethod `parse(version_str: str) -> SemVer` and rich comparison operators `__lt__` and `__eq__`. Extract `major`, `minor`, `patch` (as ints) and optional `prerelease` string. Enforce that a version without a pre-release tag outranks a version with one when major, minor, and patch are equal. Verify `'1.2.3' < '1.2.4-rc.1' < '1.2.4'`, assert comparisons, and print results. <details> <summary>Solution</summary> ```python import re SEMVER_REGEX = re.compile( r"^v?(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(?:-(?P<prerelease>[0-9A-Za-z.-]+))?" ) class SemVer: def __init__(self, major: int, minor: int, patch: int, prerelease: str = None): self.major = major self.minor = minor self.patch = patch self.prerelease = prerelease @classmethod def parse(cls, version_str: str) -> "SemVer": m = SEMVER_REGEX.match(version_str.strip()) if not m: raise ValueError(f"Invalid SemVer: {version_str}") d = m.groupdict() return cls(int(d["major"]), int(d["minor"]), int(d["patch"]), d["prerelease"]) def _sort_key(self): # Normal release (has_no_pre=1) outranks pre-release (has_no_pre=0) has_no_pre = 1 if self.prerelease is None else 0 return (self.major, self.minor, self.patch, has_no_pre, self.prerelease or "") def __lt__(self, other): return self._sort_key() < other._sort_key() def __eq__(self, other): return self._sort_key() == other._sort_key() v1 = SemVer.parse("1.2.3") v2 = SemVer.parse("1.2.4") v3 = SemVer.parse("1.2.4-rc.1") assert v1 < v2 assert v3 < v2 # 1.2.4-rc.1 is strictly less than 1.2.4! assert v1 < v3 print(f"SemVer verified: {v1.major}.{v1.minor}.{v1.patch} < {v3.prerelease} < {v2.patch}") ``` </details>

Checkpoint

Under the SemVer 2.0.0 specification, which version has higher precedence between `1.2.0-beta` and `1.2.0`? 🧠

Practice

Implement `SemVer` with classmethod `parse(version_str: str) -> SemVer` and rich comparison operators `__lt__` and `__eq__`. Extract `major`, `minor`, `patch` (as ints) and optional `prerelease` string. Enforce that a version without a pre-release tag outranks a version with one when major, minor, and patch are equal. Verify `'1.2.3' < '1.2.4-rc.1' < '1.2.4'`, assert comparisons, and print results. 🎯

Terminal
01
Tap code blocks below to assemble
Available Blocks