mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-10-23 20:44:00 -07:00
8f8a0e1d7c
Some checks are pending
EOL CI / EOL Sanity (Ⓐ2.17) (push) Waiting to run
EOL CI / EOL Units (Ⓐ2.17+py3.10) (push) Waiting to run
EOL CI / EOL Units (Ⓐ2.17+py3.12) (push) Waiting to run
EOL CI / EOL Units (Ⓐ2.17+py3.7) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/1/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/2/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/3/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/1/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/2/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/3/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/1/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/2/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/3/) (push) Waiting to run
nox / Run extra sanity tests (push) Waiting to run
* Adjust all __future__ imports: for i in $(grep -REl "__future__.*absolute_import" plugins/ tests/); do sed -e 's/from __future__ import .*/from __future__ import annotations/g' -i $i; done * Remove all UTF-8 encoding specifications for Python source files: for i in $(grep -REl '[-][*]- coding: utf-8 -[*]-' plugins/ tests/); do sed -e '/^# -\*- coding: utf-8 -\*-/d' -i $i; done * Remove __metaclass__ = type: for i in $(grep -REl '__metaclass__ = type' plugins/ tests/); do sed -e '/^__metaclass__ = type/d' -i $i; done
73 lines
2.4 KiB
Python
73 lines
2.4 KiB
Python
# Copyright (c) 2025, Alexei Znamensky <russoz@gmail.com>
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import annotations
|
|
|
|
from ansible.module_utils.six import raise_from
|
|
|
|
from ansible_collections.community.general.plugins.module_utils import deps
|
|
|
|
|
|
with deps.declare("packaging"):
|
|
from packaging.requirements import Requirement
|
|
from packaging.version import parse as parse_version, InvalidVersion
|
|
|
|
|
|
class PackageRequirement:
|
|
def __init__(self, module, name):
|
|
self.module = module
|
|
self.parsed_name, self.requirement = self._parse_spec(name)
|
|
|
|
def _parse_spec(self, name):
|
|
"""
|
|
Parse a package name that may include version specifiers using PEP 508.
|
|
Returns a tuple of (name, requirement) where requirement is of type packaging.requirements.Requirement and it may be None.
|
|
|
|
Example inputs:
|
|
"package"
|
|
"package>=1.0"
|
|
"package>=1.0,<2.0"
|
|
"package[extra]>=1.0"
|
|
"package[foo,bar]>=1.0,!=1.5"
|
|
|
|
:param name: Package name with optional version specifiers and extras
|
|
:return: Tuple of (name, requirement)
|
|
:raises ValueError: If the package specification is invalid
|
|
"""
|
|
if not name:
|
|
return name, None
|
|
|
|
# Quick check for simple package names
|
|
if not any(c in name for c in '>=<!~[]'):
|
|
return name.strip(), None
|
|
|
|
deps.validate(self.module, "packaging")
|
|
|
|
try:
|
|
req = Requirement(name)
|
|
return req.name, req
|
|
|
|
except Exception as e:
|
|
raise_from(ValueError("Invalid package specification for '{0}': {1}".format(name, e)), e)
|
|
|
|
def matches_version(self, version):
|
|
"""
|
|
Check if a version string fulfills a version specifier.
|
|
|
|
:param version: Version string to check
|
|
:return: True if version fulfills the requirement, False otherwise
|
|
:raises ValueError: If version is invalid
|
|
"""
|
|
# If no spec provided, any version is valid
|
|
if not self.requirement:
|
|
return True
|
|
|
|
try:
|
|
# Parse version string
|
|
ver = parse_version(version)
|
|
|
|
return ver in self.requirement.specifier
|
|
|
|
except InvalidVersion as e:
|
|
raise_from(ValueError("Invalid version '{0}': {1}".format(version, e)))
|