Function _parse_requirement

scripts/check_min_deps.py:83–114

Split a PEP 508 requirement into its canonical name and whether it dev-pins its floor. Uses ``packaging`` to parse the requirement and its version specifiers rather than ad hoc string handling, so name normalization, extras, markers and PEP 440 version semantics are all handled by the s

(requirement: str)

def _parse_requirement(requirement: str) -> tuple[str, bool]:
    """Split a PEP 508 requirement into its canonical name and whether it dev-pins its floor.

    Uses ``packaging`` to parse the requirement and its version specifiers rather than ad hoc
    string handling, so name normalization, extras, markers and PEP 440 version semantics are
    all handled by the standard implementation.

    Args:
        requirement: A dependency string such as ``"reflex-base >= 0.9.5.dev1"``.

    Returns:
        A ``(canonical_name, is_dev_pinned)`` tuple. ``is_dev_pinned`` is ``True`` only when a
        development release (unpublished by convention) appears as a lower bound — under a
        ``>=``, ``>``, ``==``, ``===`` or ``~=`` operator. A dev release in an upper-bound or
        ``!=`` clause (e.g. ``reflex-base >=1.0,!=2.0.dev1``) stays resolvable from PyPI and
        does not count. An unparsable requirement is reported as ``("", False)``.
    """
    try:
        parsed = Requirement(requirement)
    except InvalidRequirement:
        return "", False
    name = canonicalize_name(parsed.name)
    for specifier in parsed.specifier:
        if specifier.operator not in _LOWER_BOUND_OPERATORS:
            continue
        try:
            if Version(specifier.version).is_devrelease:
                return name, True
        except InvalidVersion:
            # A prefix match such as ``==1.2.*`` has no concrete version to inspect.
            continue
    return name, False


@dataclass(frozen=True)