diff --git a/.github/BOTMETA.yml b/.github/BOTMETA.yml index 62b094da754..b7d5740bd7a 100644 --- a/.github/BOTMETA.yml +++ b/.github/BOTMETA.yml @@ -1425,6 +1425,11 @@ files: ignore: matze labels: zypper maintainers: $team_suse + $modules/zypper_repository_info.py: + labels: zypper + maintainers: $team_suse tobiaszeuch181 + $plugin_utils/ansible_type.py: + maintainers: vbotka $plugin_utils/keys_filter.py: maintainers: vbotka $plugin_utils/unsafe.py: diff --git a/plugins/modules/zypper_repository_info.py b/plugins/modules/zypper_repository_info.py new file mode 100644 index 00000000000..2daca801974 --- /dev/null +++ b/plugins/modules/zypper_repository_info.py @@ -0,0 +1,144 @@ +#!/usr/bin/python +# -*- coding: utf-8 -*- + +# Copyright (c) 2024, Tobias Zeuch +# +# 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 absolute_import, division, print_function +__metaclass__ = type + + +DOCUMENTATION = ''' +--- +module: zypper_repository_info +author: "Tobias Zeuch (@TobiasZeuch181)" +version_added: 9.4.0 +short_description: List Zypper repositories +description: + - List Zypper repositories on SUSE and openSUSE. +extends_documentation_fragment: + - community.general.attributes + - community.general.attributes.info_module + +requirements: + - "zypper >= 1.0 (included in openSUSE >= 11.1 or SUSE Linux Enterprise Server/Desktop >= 11.0)" + - python-xml +notes: + - "For info about packages, use the module M(ansible.builtin.package_facts)." +''' + +EXAMPLES = ''' +- name: List registered repositories and store in variable repositories + community.general.zypper_repository_info: + register: repodatalist +''' + +RETURN = ''' +repodatalist: + description: + - A list of repository descriptions like it is returned by the command C(zypper repos). + type: list + elements: dictionary + contains: + alias: + description: The alias of the repository. + type: str + autorefresh: + description: indicates, if autorefresh is enabled on the repository + type: int + enabled: + description: indicates, if the repository is enabled + type: int + gpgcheck: + description: indicates, if the GPG signature of the repository meta data is checked + type: int + name: + description: the name of the repository + type: str + priority: + description: the priority of the repository + type: int + url: + description: the url of the repository on the internet + type: str + sample: + [ + { + "alias": "SLE-Product-SLES", + "autorefresh": "1", + "enabled": "1", + "gpgcheck": "1", + "name": "SLE-Product-SLES", + "priority": "99", + "url": "http://repo:50000/repo/SUSE/Products/SLE-Product-SLES/15-SP2/x86_64/product" + } + ] +''' + + +import traceback + +XML_IMP_ERR = None +try: + from xml.dom.minidom import parseString as parseXML + HAS_XML = True +except ImportError: + XML_IMP_ERR = traceback.format_exc() + HAS_XML = False + +from ansible.module_utils.basic import AnsibleModule, missing_required_lib + +from ansible_collections.community.general.plugins.module_utils.version import LooseVersion + +REPO_OPTS = ['alias', 'name', 'priority', 'enabled', 'autorefresh', 'gpgcheck'] + + +def _get_cmd(module, *args): + """Combines the non-interactive zypper command with arguments/subcommands""" + cmd = [module.get_bin_path('zypper', required=True), '--quiet', '--non-interactive'] + cmd.extend(args) + + return cmd + + +def _parse_repos(module): + """parses the output of zypper --xmlout repos and return a parse repo dictionary""" + cmd = _get_cmd(module, '--xmlout', 'repos') + + if not HAS_XML: + module.fail_json(msg=missing_required_lib("python-xml"), exception=XML_IMP_ERR) + rc, stdout, stderr = module.run_command(cmd, check_rc=False) + if rc == 0: + repos = [] + dom = parseXML(stdout) + repo_list = dom.getElementsByTagName('repo') + for repo in repo_list: + opts = {} + for o in REPO_OPTS: + opts[o] = repo.getAttribute(o) + opts['url'] = repo.getElementsByTagName('url')[0].firstChild.data + # A repo can be uniquely identified by an alias + url + repos.append(opts) + return repos + # exit code 6 is ZYPPER_EXIT_NO_REPOS (no repositories defined) + elif rc == 6: + return [] + else: + module.fail_json(msg='Failed to execute "%s"' % " ".join(cmd), rc=rc, stdout=stdout, stderr=stderr) + + +def main(): + module = AnsibleModule( + argument_spec=dict( + ), + supports_check_mode=False, + ) + + repodatalist = _parse_repos(module) + module.exit_json(changed=False, repodatalist=repodatalist) + + +if __name__ == '__main__': + main() diff --git a/tests/integration/targets/zypper_repository/tasks/test.yml b/tests/integration/targets/zypper_repository/tasks/test.yml index 739b4c26423..e81c3ceb1dd 100644 --- a/tests/integration/targets/zypper_repository/tasks/test.yml +++ b/tests/integration/targets/zypper_repository/tasks/test.yml @@ -38,3 +38,11 @@ - name: ensure zypper ref still works command: zypper -n ref + +- block: + - include_tasks: 'zypper_repository.yml' + always: + - name: remove repositories added during test + community.general.zypper_repository: + name: "test" + state: absent \ No newline at end of file diff --git a/tests/integration/targets/zypper_repository/tasks/zypper_repository_info.yml b/tests/integration/targets/zypper_repository/tasks/zypper_repository_info.yml new file mode 100644 index 00000000000..2b96056e3a2 --- /dev/null +++ b/tests/integration/targets/zypper_repository/tasks/zypper_repository_info.yml @@ -0,0 +1,26 @@ +--- +# Copyright (c) Ansible Project +# 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 + +- name: Add test repo + community.general.zypper_repository: + name: test + state: present + repo: http://dl.google.com/linux/chrome/rpm/stable/x86_64 + register: zypper_result + +- name: read repositories with zypper_repository_info + community.general.zypper_repository_info: + register: repositories + +- name: verify, that test-repo is returned by the repodatalist + assert: + that: + - "{{ 'test' in repositories.repodatalist|map(attribute='name') | list }}" + +- name: Cleanup - Delete test repo + community.general.zypper_repository: + name: test + state: absent + register: zypper_result