a )gF@sddlmZmZmZeZdZdZdZddl Z ddl m Z m Z ddl mZmZddlmZdd lmZdd lmZmZmZdd lmZmZmZGd d d eZGdddeZGdddeZGdddeZGdddeZ GdddeZ!GdddeZ"ddZ#e$dkre#dS))absolute_importdivisionprint_functiona8 module: package_facts short_description: Package information as facts description: - Return information about installed packages as facts. options: manager: description: - The package manager used by the system so we can query the package information. - Since 2.8 this is a list and can support multiple package managers per system. - The 'portage' and 'pkg' options were added in version 2.8. - The 'apk' option was added in version 2.11. - The 'pkg_info' option was added in version 2.13. default: ['auto'] choices: ['auto', 'rpm', 'apt', 'portage', 'pkg', 'pacman', 'apk', 'pkg_info'] type: list elements: str strategy: description: - This option controls how the module queries the package managers on the system. C(first) means it will return only information for the first supported package manager available. C(all) will return information for all supported and available package managers on the system. choices: ['first', 'all'] default: 'first' type: str version_added: "2.8" version_added: "2.5" requirements: - For 'portage' support it requires the C(qlist) utility, which is part of 'app-portage/portage-utils'. - For Debian-based systems C(python-apt) package must be installed on targeted hosts. - For SUSE-based systems C(python3-rpm) package must be installed on targeted hosts. This package is required because SUSE does not include RPM Python bindings by default. author: - Matthew Jones (@matburt) - Brian Coca (@bcoca) - Adam Miller (@maxamillion) extends_documentation_fragment: - action_common_attributes - action_common_attributes.facts attributes: check_mode: support: full diff_mode: support: none facts: support: full platform: platforms: posix a - name: Gather the package facts ansible.builtin.package_facts: manager: auto - name: Print the package facts ansible.builtin.debug: var: ansible_facts.packages - name: Check whether a package called foobar is installed ansible.builtin.debug: msg: "{{ ansible_facts.packages['foobar'] | length }} versions of foobar are installed!" when: "'foobar' in ansible_facts.packages" a ansible_facts: description: Facts to add to ansible_facts. returned: always type: complex contains: packages: description: - Maps the package name to a non-empty list of dicts with package information. - Every dict in the list corresponds to one installed version of the package. - The fields described below are present for all package managers. Depending on the package manager, there might be more fields for a package. returned: when operating system level package manager is specified or auto detected manager type: dict contains: name: description: The package's name. returned: always type: str version: description: The package's version. returned: always type: str source: description: Where information on the package came from. returned: always type: str sample: |- { "packages": { "kernel": [ { "name": "kernel", "source": "rpm", "version": "3.10.0", ... }, { "name": "kernel", "source": "rpm", "version": "3.10.0", ... }, ... ], "kernel-tools": [ { "name": "kernel-tools", "source": "rpm", "version": "3.10.0", ... } ], ... } } # Sample rpm { "packages": { "kernel": [ { "arch": "x86_64", "epoch": null, "name": "kernel", "release": "514.26.2.el7", "source": "rpm", "version": "3.10.0" }, { "arch": "x86_64", "epoch": null, "name": "kernel", "release": "514.16.1.el7", "source": "rpm", "version": "3.10.0" }, { "arch": "x86_64", "epoch": null, "name": "kernel", "release": "514.10.2.el7", "source": "rpm", "version": "3.10.0" }, { "arch": "x86_64", "epoch": null, "name": "kernel", "release": "514.21.1.el7", "source": "rpm", "version": "3.10.0" }, { "arch": "x86_64", "epoch": null, "name": "kernel", "release": "693.2.2.el7", "source": "rpm", "version": "3.10.0" } ], "kernel-tools": [ { "arch": "x86_64", "epoch": null, "name": "kernel-tools", "release": "693.2.2.el7", "source": "rpm", "version": "3.10.0" } ], "kernel-tools-libs": [ { "arch": "x86_64", "epoch": null, "name": "kernel-tools-libs", "release": "693.2.2.el7", "source": "rpm", "version": "3.10.0" } ], } } # Sample deb { "packages": { "libbz2-1.0": [ { "version": "1.0.6-5", "source": "apt", "arch": "amd64", "name": "libbz2-1.0" } ], "patch": [ { "version": "2.7.1-4ubuntu1", "source": "apt", "arch": "amd64", "name": "patch" } ], } } # Sample pkg_info { "packages": { "curl": [ { "name": "curl", "source": "pkg_info", "version": "7.79.0" } ], "intel-firmware": [ { "name": "intel-firmware", "source": "pkg_info", "version": "20210608v0" } ], } } N) to_nativeto_text) AnsibleModulemissing_required_lib)get_best_parsable_locale) get_bin_path) has_respawnedprobe_interpreters_for_modulerespawn_module)LibMgrCLIMgrget_all_pkg_managerscs0eZdZdZddZddZfddZZS)RPMrpmcCs|jSN)_libZTransactionSetZdbMatchselfrA/usr/lib/python3.9/site-packages/ansible/modules/package_facts.pylist_installedszRPM.list_installedcCs:t||jj||jj||jj||jj||jjdS)N)nameversionreleaseZepocharch)dictrZ RPMTAG_NAMEZRPMTAG_VERSIONZRPMTAG_RELEASEZ RPMTAG_EPOCHZ RPMTAG_ARCHrpackagerrrget_package_detailss      zRPM.get_package_detailscsttt|}zNtd|sBtsBgd}t||j}|rBt||sZt dt |jWnt ynYn0|S)zh we expect the python bindings installed, but this gives warning if they are missing and we have rpm clir)z/usr/libexec/platform-python/usr/bin/python3/usr/bin/python2zFound "rpm" but %s) superr is_availabler r r LIBr modulewarnr ValueError)r we_have_lib interpretersinterpreter_path __class__rrr% s   zRPM.is_available)__name__ __module__ __qualname__r&rr!r% __classcell__rrr-rrsrcsHeZdZdZfddZeddZfddZdd Zd d Z Z S) APTaptcsd|_tt|dSr)_cacher$r3__init__rr-rrr6&sz APT.__init__cCs"|jdur|jS|j|_|jSr)r5rZCacherrrr pkg_cache*s  z APT.pkg_cachec stt|}|sdD]h}z t|Wnty<YqYq0tsdddg}t||j}|rdt|t d|t dfqq|S)zi we expect the python bindings installed, but if there is apt/apt-get give warning about missing bindings)r4zapt-getZaptituder"r#zFound "%s" but %sr4) r$r3r%r r)r r r&r r'r(r)rr*Zexer+r,r-rrr%2s"    zAPT.is_availablecs|jfddDS)Ncsg|]}|jr|qSr)Z is_installed).0Zpkcacherr Mz&APT.list_installed..)r7keysrrr9rrJszAPT.list_installedcCs,|j|j}t||j|j|j|jdjdS)Nr)rrrcategoryorigin)r7 installedrrZ architecturesectionZoriginsr?)rr Zac_pkgrrrr!Os zAPT.get_package_details) r/r0r1r&r6propertyr7r%rr!r2rrr-rr3"s   r3c@s eZdZdZddZddZdS)PACMANZpacmancCsVtt}tj|jdgt|dd\}}}|dks4|rDtd||f|dddS)Nz-Qi)LC_ALL)Zenviron_updater"Unable to list packages rc=%s : %sz )r r' run_command_clir Exceptionsplit)rlocalercouterrrrrrXs   zPACMAN.list_installedcCsi}d}|D]F}td|}|r>|d}|d||<q||d|||<qd}|ddkrdd|ddD}|d |d |d |d S) Nz([\w ]*[\w]) +: (.*)z ZProvidesNonecSsg|]}|ddqS)=r)rJ)r8prrrr;nsz.PACMAN.get_package_details..NameZVersionZ Architecture)rrrprovides) splitlinesrematchgrouplstriprJ)rr raw_pkg_detailsZ last_detaillinemrUrrrr!_s$     zPACMAN.get_package_detailsNr/r0r1CLIrr!rrrrrCTsrCc@s(eZdZdZgdZddZddZdS)PKGpkg) rrr?r@ automaticrr>prefixvitalc CsJt|jdddgdg\}}}|dks2|rBtd||f|S)Nqueryz%%%sz %) nvRtaqorSVrrE)r'rGrHjoinrIrVrrLrMrNrrrrs& zPKG.list_installedcCstt|j|d}d|vrLz|ddd|d<WntyJYn0d|vrhtt|d|d<d|vr|dddd |d<d |vrd |d vr|d d d\|d <|d <nd |d <d |d vr|d d d\|d <|d<nd|d<d|vrtt|d|d<|S)N r:rPrbr>/rOrr,Z port_epoch_Zrevision0rd)rzipatomsrJ IndexErrorboolint)rr rarrrr!s(    zPKG.get_package_detailsNr/r0r1r_rwrr!rrrrr`{sr`c@s(eZdZdZgdZddZddZdS)PORTAGEZqlist)r>rrZebuild_revisionslotsprefixesZsufixesc CsNtjd|jddddddgdd \}}}|d krFtd |t|f|S) N z-Iv|Zxargsz-nZ1024ZqatomT)Zuse_unsafe_shellrrE)r'rGrnrH RuntimeErrorrrVrorrrrs*zPORTAGE.list_installedcCstt|j|Sr)rrvrwrJrrrrr!szPORTAGE.get_package_detailsNr{rrrrr|sr|c@s eZdZdZddZddZdS)APKZapkcCs<t|jddg\}}}|dks$|r4td||f|S)Ninfoz-vrrEr'rGrHrIrVrorrrrs zAPK.list_installedcCsN|ddd}|dd}z|d|d|ddWStyH|YS0dS)N)rrr-rPrrO)rsplitrx)rr r[Znvrrrrr!s   zAPK.get_package_detailsNr^rrrrrsrc@s eZdZdZddZddZdS)PKG_INFOZpkg_infocCs:t|jdg\}}}|dks"|r2td||f|S)Nz-arrErrorrrrs zPKG_INFO.list_installedcCsT|dd}|jdddjddd}z|d|ddWStyN|YS0dS)Nr)rrrO)maxsplitrr)rJrrx)rr r[detailsrrrr!s  zPKG_INFO.get_package_detailsNr^rrrrrsrc Cst}dd|D}ttdddgdddgdd d d d ai}d ii}ddtjdD}tjd}d|vr|||dt| |}|rdtjdvrd}ndd |}tj |dd}t} |D]} |r|dkrq| | vrq| | zz.|| } | r.|d7}|| WnZty} z@| tjdvrhtd| t| fWYd} ~ WqWYd} ~ n d} ~ 00Wqty} z2| tjdvrtd| t| fWYd} ~ qd} ~ 00q|dkrd|}tj |d||d d<tjfi|dS)NcSsg|] }|qSrlowerr8xrrrr;r<zmain..liststrauto)typeelementsdefaultfirstall)choicesr)managerstrategyT)Z argument_specZsupports_check_modeZ ansible_factscSsg|] }|qSrrrrrrr;r<rrzKCould not auto detect a usable package manager, check warnings for details.z*Unsupported package managers requested: %sz, )msgrrOz>Requested package manager %s was not usable by this module: %sz'Failed to retrieve packages with %s: %szCould not detect a supported package manager from the following list: %s, or the required Python library is not installed. Check warnings for details.packages)rr=rrr'paramsextendremoveset differencernZ fail_jsonaddr%updateZ get_packagesrIr(rZ exit_json) Z PKG_MANAGERSZPKG_MANAGER_NAMESrresultsZmanagersrZ unsupportedrfoundseenZpkgmgrrerrrmains`          (.   r__main__)%Z __future__rrrrZ __metaclass__Z DOCUMENTATIONZEXAMPLESZRETURNrWZansible.module_utils._textrrZansible.module_utils.basicrrZ"ansible.module_utils.common.localer Z#ansible.module_utils.common.processr Z#ansible.module_utils.common.respawnr r r Z#ansible.module_utils.facts.packagesrrrrr3rCr`r|rrrr/rrrrs,2&  '2',E