import re
from .base import Unit, unit_type
from ..attr import pulp_attrib
from ..common import schemaless_init
from ... import compat_attr as attr
from ..convert import (
frozenlist_or_none_converter,
frozenlist_or_none_sorted_converter,
frozendict_or_none_converter,
)
from ..validate import optional_list_of, optional_frozendict
[docs]@attr.s(kw_only=True, frozen=True)
class ModulemdDependency(object):
"""
A module dependency entry within :meth:`~ModulemdUnit.dependencies`.
"""
name = pulp_attrib(type=str, default=None)
"""
The name of this dependency.
"""
stream = pulp_attrib(type=str, default=None)
"""
The stream of this dependency.
"""
@classmethod
def _from_data(cls, data):
# Convert from raw list/dict as provided in Pulp responses into model.
if isinstance(data, list):
raw_data = []
for item in data:
for key, value in item.items():
# skip key == "platform", not usable as dependency
if key != "platform":
# value list might be empty
if value:
for stream in value:
raw_data.append({"name": key, "stream": stream})
else:
raw_data.append({"name": key})
return [cls._from_data(elem) for elem in raw_data]
return schemaless_init(cls, data)
[docs]@unit_type("modulemd")
@attr.s(kw_only=True, frozen=True)
class ModulemdUnit(Unit):
"""A :class:`~pubtools.pulplib.Unit` representing a modulemd document.
.. versionadded:: 1.5.0
"""
name = pulp_attrib(type=str, pulp_field="name", unit_key=True)
"""The name of this module.
Example: the name of javapackages-tools:201801:20180813043155:dca7b4a4:aarch64
is "javapackages-tools".
"""
stream = pulp_attrib(type=str, pulp_field="stream", unit_key=True)
"""The stream of this module.
Example: the stream of javapackages-tools:201801:20180813043155:dca7b4a4:aarch64
is "201801".
"""
version = pulp_attrib(type=int, pulp_field="version", converter=int, unit_key=True)
"""The version of this module.
Example: the version of javapackages-tools:201801:20180813043155:dca7b4a4:aarch64
is 20180813043155.
"""
context = pulp_attrib(type=str, pulp_field="context", unit_key=True)
"""The context of this module.
Example: the context of javapackages-tools:201801:20180813043155:dca7b4a4:aarch64
is "dca7b4a4".
"""
arch = pulp_attrib(type=str, pulp_field="arch", unit_key=True)
"""The architecture of this module.
Example: the arch of javapackages-tools:201801:20180813043155:dca7b4a4:aarch64
is "aarch64.
"""
content_type_id = pulp_attrib(
default="modulemd", type=str, pulp_field="_content_type_id"
)
repository_memberships = pulp_attrib(
default=None,
type=list,
converter=frozenlist_or_none_sorted_converter,
pulp_field="repository_memberships",
)
"""IDs of repositories containing the unit, or ``None`` if this information is unavailable.
.. versionadded:: 2.6.0
"""
unit_id = pulp_attrib(type=str, pulp_field="_id", default=None)
"""The unique ID of this unit, if known.
.. versionadded:: 2.20.0
"""
artifacts = pulp_attrib(
default=None,
type=list,
converter=frozenlist_or_none_converter,
pulp_field="artifacts",
)
"""List of artifacts included in the module.
Typically a list of RPM NEVRAs (no '.rpm' extension) including binary, debug
and source RPMs.
Example:
.. code-block:: python
["perl-version-7:0.99.24-441.module+el8.3.0+6718+7f269185.src",
"perl-version-7:0.99.24-441.module+el8.3.0+6718+7f269185.x86_64"]
"""
profiles = pulp_attrib(
type=dict,
pulp_field="profiles",
default=None,
validator=optional_frozendict,
converter=frozendict_or_none_converter,
)
"""The profiles of this modulemd unit."""
dependencies = pulp_attrib(
default=None,
type=list,
converter=frozenlist_or_none_converter,
pulp_field="dependencies",
validator=optional_list_of(ModulemdDependency),
pulp_py_converter=ModulemdDependency._from_data,
)
"""
List of dependencies that this modulemd requires for runtime or ``None`` if this information is unavailable.
"""
@property
def artifacts_filenames(self):
"""
RPM filenames for artifacts in this module (as opposed to the RPM
NEVRAs returned by :meth:`artifacts`).
Returns:
List[str]
Artifact RPM filenames.
"""
regex = r"\d+:"
reg = re.compile(regex)
out = set()
for rpm_nevra in self.artifacts or []:
out.add(reg.sub("", rpm_nevra, count=1) + ".rpm")
return out
@property
def nsvca(self):
"""
Returns nsvca string of this module.
Example: "virt:av:8040020210622174547:522a0ee4:arch"
"""
return ":".join(
(self.name, self.stream, str(self.version), self.context, self.arch)
)
