Functions
bool	check_requires_python (Optional[str] requires_python, Tuple[int,...] version_info)

Requirement	get_requirement (str req_string)

NormalizedExtra	safe_extra (str extra)

Variables
	NormalizedExtra = NewType("NormalizedExtra", str)

	logger = logging.getLogger(__name__)

Function Documentation

◆ check_requires_python()

bool check_requires_python	(	Optional[str]	requires_python,
		Tuple[int, ...]	version_info
	)

Check if the given Python version matches a "Requires-Python" specifier.

:param version_info: A 3-tuple of ints representing a Python
    major-minor-micro version to check (e.g. `sys.version_info[:3]`).

:return: `True` if the given Python version satisfies the requirement.
    Otherwise, return `False`.

:raises InvalidSpecifier: If `requires_python` has an invalid format.

Definition at line 14 of file packaging.py.

) -> bool:
    """
    Check if the given Python version matches a "Requires-Python" specifier.
 
    :param version_info: A 3-tuple of ints representing a Python
        major-minor-micro version to check (e.g. `sys.version_info[:3]`).
 
    :return: `True` if the given Python version satisfies the requirement.
        Otherwise, return `False`.
 
    :raises InvalidSpecifier: If `requires_python` has an invalid format.
    """
    if requires_python is None:
        # The package provides no information
        return True
    requires_python_specifier = specifiers.SpecifierSet(requires_python)
 
    python_version = version.parse(".".join(map(str, version_info)))
    return python_version in requires_python_specifier
 
 
@functools.lru_cache(maxsize=512)

References i.

◆ get_requirement()

Requirement get_requirement ( str req_string )

Construct a packaging.Requirement object with caching

Definition at line 38 of file packaging.py.

def get_requirement(req_string: str) -> Requirement:
    """Construct a packaging.Requirement object with caching"""
    # Parsing requirement strings is expensive, and is also expected to happen
    # with a low diversity of different arguments (at least relative the number
    # constructed). This method adds a cache to requirement object creation to
    # minimize repeated parsing of the same string to construct equivalent
    # Requirement objects.
    return Requirement(req_string)
 
 

◆ safe_extra()

NormalizedExtra safe_extra ( str extra )

Convert an arbitrary string to a standard 'extra' name

Any runs of non-alphanumeric characters are replaced with a single '_',
and the result is always lowercased.

This function is duplicated from ``pkg_resources``. Note that this is not
the same to either ``canonicalize_name`` or ``_egg_link_name``.

Definition at line 48 of file packaging.py.

def safe_extra(extra: str) -> NormalizedExtra:
    """Convert an arbitrary string to a standard 'extra' name
 
    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
 
    This function is duplicated from ``pkg_resources``. Note that this is not
    the same to either ``canonicalize_name`` or ``_egg_link_name``.
    """
    return cast(NormalizedExtra, re.sub("[^A-Za-z0-9.-]+", "_", extra).lower())

References i.

Variable Documentation

◆ logger

logger = logging.getLogger(__name__)

Definition at line 11 of file packaging.py.

◆ NormalizedExtra

NormalizedExtra = NewType("NormalizedExtra", str)

Definition at line 9 of file packaging.py.

Functions