1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-02-04 07:51:50 +00:00
community.general/plugins/modules/zypper_repository_info.py
2025-11-01 13:46:53 +01:00

126 lines
3.7 KiB
Python

#!/usr/bin/python
# Copyright (c) 2024, Tobias Zeuch <tobias.zeuch@sap.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
DOCUMENTATION = r"""
module: zypper_repository_info
author: "Tobias Zeuch (@TobiasZeuch181)"
version_added: 10.0.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 = r"""
- name: List registered repositories and store in variable repositories
community.general.zypper_repository_info: {}
register: repodatalist
"""
RETURN = r"""
repodatalist:
description:
- A list of repository descriptions like it is returned by the command C(zypper repos).
type: list
returned: always
elements: dict
contains:
alias:
description: The alias of the repository.
type: str
sample: "SLE-Product-SLES"
autorefresh:
description: Indicates, if autorefresh is enabled on the repository.
type: int
sample: "1"
enabled:
description: Indicates, if the repository is enabled.
type: int
sample: "1"
gpgcheck:
description: Indicates, if the GPG signature of the repository meta data is checked.
type: int
sample: "1"
name:
description: The name of the repository.
type: str
sample: "SLE-Product-SLES"
priority:
description: The priority of the repository.
type: int
sample: "99"
url:
description: The URL of the repository on the internet.
type: str
sample: "http://repo:50000/repo/SUSE/Products/SLE-Product-SLES/15-SP2/x86_64/product"
"""
from ansible_collections.community.general.plugins.module_utils import deps
with deps.declare("parseXML"):
from xml.dom.minidom import parseString as parseXML
from ansible.module_utils.basic import AnsibleModule
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")
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=f'Failed to execute "{" ".join(cmd)}"', rc=rc, stdout=stdout, stderr=stderr)
def main():
module = AnsibleModule(argument_spec=dict(), supports_check_mode=True)
deps.validate(parseXML)
repodatalist = _parse_repos(module)
module.exit_json(changed=False, repodatalist=repodatalist)
if __name__ == "__main__":
main()