Source code for insights.parsers.dnf_module

"""
dnf module commands
===================

Parsers provided in this module includes:

DnfModuleList - command ``dnf module list``
-------------------------------------------

DnfModuleInfo - command ``dnf module info *``
---------------------------------------------
"""
from insights.core import CommandParser
from insights.core.exceptions import SkipException
from insights.core.plugins import parser
from insights.parsers import parse_fixed_table
from insights.specs import Specs


[docs]class DnfModuleBrief(object): """ An object for the dnf modules listed by ``dnf module list`` command Attributes: name (str): Name of the dnf module stream (str): Stream of the dnf module profiles (list): List of profiles of the dnf module summary (str): Summary of the dnf module """ def __init__(self, data=None): data = {} if data is None else data self.name = data.get('Name', '') self.stream = data.get('Stream', '') self.profiles = list(filter(None, [i.strip() for i in data.get('Profiles', '').split(',')])) self.summary = data.get('Summary', '')
[docs]class DnfModuleDetail(DnfModuleBrief): """ An object for the dnf modules listed by ``dnf module info`` command Attributes: name (str): Name of the dnf module stream (str): Stream of the dnf module version (str): Version of the dnf module context (str): Context of the dnf module profiles (list): List of profiles of the dnf module default_profiles (str): Default profile of the dnf module repo (str): Repo of the dnf module summary (str): Summary of the dnf module description (str): Description of the dnf module artifacts (list): List of the artifacts of the dnf module """ def __init__(self, data=None): super(DnfModuleDetail, self).__init__(data) self.version = data.get('Version', '') self.context = data.get('Context', '') self.default_profiles = data.get('Default profiles', '') self.repo = data.get('Repo', '') self.description = data.get('Description', '') self.artifacts = data.get('Artifacts', '').split()
[docs]@parser(Specs.dnf_module_list) class DnfModuleList(CommandParser, dict): """ Class to parse the output of command `dnf module list` Typical output of the command is:: Updating Subscription Management repositories. Name Stream Profiles Summary 389-ds 1.4 389 Directory Server (base) ant 1.10 [d] common [d] Java build tool Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled Examples: >>> len(dnf_module_list) 2 >>> dnf_module_list.get("389-ds").stream '1.4' >>> dnf_module_list.get("389-ds").profiles [] >>> dnf_module_list.get("ant").stream '1.10 [d]' """ def __init__(self, *args, **kwargs): super(DnfModuleList, self).__init__(*args, **kwargs)
[docs] def parse_content(self, content): data = parse_fixed_table(content, heading_ignore=['Name '], trailing_ignore=['Hint:', 'Error:']) if not data: raise SkipException('Nothing need to parse.') for m in data: self.update({m['Name']: DnfModuleBrief(m)})
@property def modules(self): """Returns a list of modules name""" return sorted(self.keys())
[docs]@parser(Specs.dnf_module_info) class DnfModuleInfo(CommandParser, dict): """ Class to parse the output of command `dnf module info XX, YY` Typical output of the command is:: Updating Subscription Management repositories. Last metadata expiration check: 0:31:25 ago on Thu 25 Jul 2019 12:19:22 PM CST. Name : 389-ds Stream : 1.4 Version : 8000020190424152135 Context : ab753183 Repo : rhel-8-for-x86_64-appstream-rpms Summary : 389 Directory Server (base) Description : 389 Directory Server is an LDAPv3 compliant server. The base package includes the LDAP server and command line utilities for server administration. Artifacts : 389-ds-base-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.src : 389-ds-base-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-debuginfo-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-debugsource-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-devel-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-legacy-tools-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-legacy-tools-debuginfo-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-libs-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-libs-debuginfo-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-snmp-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : 389-ds-base-snmp-debuginfo-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.x86_64 : python3-lib389-0:1.4.0.20-10.module+el8.0.0+3096+101825d5.noarch Name : 389-ds Stream : 1.4 Version : 820190201170147 Context : 1fc8b219 Repo : rhel-8-for-x86_64-appstream-rpms Summary : 389 Directory Server (base) Description : 389 Directory Server is an LDAPv3 compliant server. The base package includes the LDAP server and command line utilities for server administration. Artifacts : 389-ds-base-0:1.4.0.20-7.module+el8+2750+1f4079fb.x86_64 : 389-ds-base-devel-0:1.4.0.20-7.module+el8+2750+1f4079fb.x86_64 : 389-ds-base-legacy-tools-0:1.4.0.20-7.module+el8+2750+1f4079fb.x86_64 : 389-ds-base-libs-0:1.4.0.20-7.module+el8+2750+1f4079fb.x86_64 : 389-ds-base-snmp-0:1.4.0.20-7.module+el8+2750+1f4079fb.x86_64 : python3-lib389-0:1.4.0.20-7.module+el8+2750+1f4079fb.noarch Name : ant Stream : 1.10 [d][a] Version : 820181213135032 Context : 5ea3b708 Profiles : common [d] Default profiles : common Repo : rhel-8-for-x86_64-appstream-rpms Summary : Java build tool Description : Apache Ant is a Java library and command-line tool whose mission is to drive processes described in build files as targets and extension points dependent upon each other. The main known usage of Ant is the build of Java applications. Ant supplies a number of built-in tasks allowing to compile, assemble, test and run Java applications. Ant can also be used effectively to build non Java applications, for instance C or C++ applications. More generally, Ant can be used to pilot any type of process which can be described in terms of targets and tasks. Artifacts : ant-0:1.10.5-1.module+el8+2438+c99a8a1e.noarch : ant-lib-0:1.10.5-1.module+el8+2438+c99a8a1e.noarch Name : httpd Stream : 2.4 [d][e][a] Version : 820190206142837 Context : 9edba152 Profiles : common [d] [i], devel, minimal Default profiles : common Repo : rhel-8-for-x86_64-appstream-rpms Summary : Apache HTTP Server Description : Apache httpd is a powerful, efficient, and extensible HTTP server. Artifacts : httpd-0:2.4.37-10.module+el8+2764+7127e69e.x86_64 : httpd-devel-0:2.4.37-10.module+el8+2764+7127e69e.x86_64 : httpd-filesystem-0:2.4.37-10.module+el8+2764+7127e69e.noarch : httpd-manual-0:2.4.37-10.module+el8+2764+7127e69e.noarch : httpd-tools-0:2.4.37-10.module+el8+2764+7127e69e.x86_64 : mod_http2-0:1.11.3-1.module+el8+2443+605475b7.x86_64 : mod_ldap-0:2.4.37-10.module+el8+2764+7127e69e.x86_64 : mod_md-0:2.4.37-10.module+el8+2764+7127e69e.x86_64 : mod_proxy_html-1:2.4.37-10.module+el8+2764+7127e69e.x86_64 : mod_session-0:2.4.37-10.module+el8+2764+7127e69e.x86_64 : mod_ssl-1:2.4.37-10.module+el8+2764+7127e69e.x86_64 Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled, [a]ctive] The modules information is wrapped in this object like a dictionary, with the module name as the key and the list of the :class:`DnfModuleDetail` as the value. Examples: >>> type(dnf_module_info) <class 'insights.parsers.dnf_module.DnfModuleInfo'> >>> len(dnf_module_info) 3 >>> dnf_module_info.modules ['389-ds', 'ant', 'httpd'] >>> "389-ds" in dnf_module_info True >>> len(dnf_module_info.get("389-ds")) 2 >>> type(dnf_module_info.get("389-ds")[0]) <class 'insights.parsers.dnf_module.DnfModuleDetail'> >>> dnf_module_info['389-ds'][0].name '389-ds' >>> dnf_module_info["389-ds"][0].profiles [] >>> dnf_module_info["389-ds"][0].default_profiles '' >>> dnf_module_info['389-ds'][1].name '389-ds' >>> dnf_module_info['389-ds'][1].context '1fc8b219' >>> "ant" in dnf_module_info True >>> len(dnf_module_info.get("ant")) 1 >>> type(dnf_module_info.get("ant")[0]) <class 'insights.parsers.dnf_module.DnfModuleDetail'> >>> dnf_module_info['ant'][0].name 'ant' >>> dnf_module_info['ant'][0].context '5ea3b708' >>> dnf_module_info["ant"][0].version '820181213135032' >>> dnf_module_info['ant'][0].profiles ['common [d]'] >>> dnf_module_info['ant'][0].default_profiles 'common' >>> dnf_module_info["httpd"][0].profiles ['common [d] [i]', 'devel', 'minimal'] >>> dnf_module_info["httpd"][0].default_profiles 'common' """ def __init__(self, *args, **kwargs): super(DnfModuleInfo, self).__init__(*args, **kwargs)
[docs] def parse_content(self, content): def _update_value(k, v): if k not in self: self[k] = [] self[k].append(v) mod_dict = {} key_prev = '' for line in content: if " : " in line: k, v = [s.strip() for s in line.split(' : ', 1)] k = key_prev if not k and key_prev else k if k in mod_dict: mod_dict[k] = '{0}\r{1}'.format(mod_dict[k], v) else: mod_dict[k] = v key_prev = k elif not line.strip() and mod_dict: mod_info = DnfModuleDetail(mod_dict) _update_value(mod_info.name, mod_info) mod_dict = {} if mod_dict: mod_info = DnfModuleDetail(mod_dict) _update_value(mod_info.name, mod_info) if self.__len__() == 0: raise SkipException('Nothing need to parse.')
@property def modules(self): """Returns a list of modules name""" return sorted(self.keys())