Vh+ddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z m Z ddlmZGdd eZd Zed k(reyy) )absolute_importdivisionprint_functiona module: cpanm short_description: Manages Perl library dependencies description: - Manage Perl library dependencies using cpanminus. extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: none diff_mode: support: none options: name: type: str description: - The Perl library to install. Valid values change according to the O(mode), see notes for more details. - Note that for installing from a local path the parameter O(from_path) should be used. aliases: [pkg] from_path: type: path description: - The local directory or C(tar.gz) file to install from. notest: description: - Do not run unit tests. type: bool default: false locallib: description: - Specify the install base to install modules. type: path mirror: description: - Specifies the base URL for the CPAN mirror to use. type: str mirror_only: description: - Use the mirror's index file instead of the CPAN Meta DB. type: bool default: false installdeps: description: - Only install dependencies. type: bool default: false install_recommendations: description: - If V(true), installs dependencies declared as recommends per META spec. - If V(false), it ensures the dependencies declared as recommends are not installed, overriding any decision made earlier in E(PERL_CPANM_OPT). - If parameter is not set, C(cpanm) will use its existing defaults. - When these dependencies fail to install, cpanm continues the installation, since they are just recommendation. type: bool version_added: 10.3.0 install_suggestions: description: - If V(true), installs dependencies declared as suggests per META spec. - If V(false), it ensures the dependencies declared as suggests are not installed, overriding any decision made earlier in E(PERL_CPANM_OPT). - If parameter is not set, C(cpanm) will use its existing defaults. - When these dependencies fail to install, cpanm continues the installation, since they are just suggestion. type: bool version_added: 10.3.0 version: description: - Version specification for the perl module. When O(mode) is V(new), C(cpanm) version operators are accepted. type: str executable: description: - Override the path to the cpanm executable. type: path mode: description: - Controls the module behavior. See notes below for more details. - The default changed from V(compatibility) to V(new) in community.general 9.0.0. type: str choices: [compatibility, new] default: new version_added: 3.0.0 name_check: description: - When O(mode=new), this parameter can be used to check if there is a module O(name) installed (at O(version), when specified). type: str version_added: 3.0.0 notes: - Please note that U(http://search.cpan.org/dist/App-cpanminus/bin/cpanm, cpanm) must be installed on the remote host. - 'This module now comes with a choice of execution O(mode): V(compatibility) or V(new).' - 'O(mode=compatibility): When using V(compatibility) mode, the module will keep backward compatibility. This was the default mode before community.general 9.0.0. O(name) must be either a module name or a distribution file. If the perl module given by O(name) is installed (at the exact O(version) when specified), then nothing happens. Otherwise, it will be installed using the C(cpanm) executable. O(name) cannot be an URL, or a git URL. C(cpanm) version specifiers do not work in this mode.' - 'O(mode=new): When using V(new) mode, the module will behave differently. The O(name) parameter may refer to a module name, a distribution file, a HTTP URL or a git repository URL as described in C(cpanminus) documentation. C(cpanm) version specifiers are recognized. This is the default mode from community.general 9.0.0 onwards.' seealso: - name: C(cpanm) command manual page description: Manual page for the command. link: https://metacpan.org/dist/App-cpanminus/view/bin/cpanm author: - "Franck Cuny (@fcuny)" - "Alexei Znamensky (@russoz)" aI - name: Install Dancer perl package community.general.cpanm: name: Dancer - name: Install version 0.99_05 of the Plack perl package community.general.cpanm: name: MIYAGAWA/Plack-0.99_05.tar.gz - name: Install Dancer into the specified locallib community.general.cpanm: name: Dancer locallib: /srv/webapps/my_app/extlib - name: Install perl dependencies from local directory community.general.cpanm: from_path: /srv/webapps/my_app/src/ - name: Install Dancer perl package without running the unit tests in indicated locallib community.general.cpanm: name: Dancer notest: true locallib: /srv/webapps/my_app/extlib - name: Install Dancer perl package from a specific mirror community.general.cpanm: name: Dancer mirror: 'http://cpan.cpantesters.org/' - name: Install Dancer perl package into the system root path become: true community.general.cpanm: name: Dancer - name: Install Dancer if it is not already installed OR the installed version is older than version 1.0 community.general.cpanm: name: Dancer version: '1.0' z cpanm_version: description: Version of CPANMinus. type: str returned: always sample: "1.7047" version_added: 10.0.0 N) CmdRunnercmd_runner_fmt) ModuleHelperceZdZddgZeeeddgedededd edededd edd ededededd d d g ed dgZdZeejdejdejdejdejdejdddejdddejejd Z d Z dZd Zd!Zd"Zy#)$ CPANMinusnameversionstrpkg)typealiases)rpathboolF)rdefaultnew compatibility)rrchoices) r r from_pathnotestlocallibmirror mirror_only installdepsinstall_recommendationsinstall_suggestions executablemode name_check)r r) argument_specrequired_one_ofcpanmz--notestz --local-libz--mirrorz --mirror-onlyz --installdepsz--with-recommendsz--without-recommendsT) ignore_nonez--with-suggestsz--without-suggestsz --version) rrrrrrrpkg_spec cpanm_versionc|j}|jdk(r|jr;|jdn)|jr|j r|jd|j r |j n |j|_t|j|j|jd|_ |jj|j_ |jd5}|j\}}}|jdd}tj d |}|s |jd j#||j%d |j_dddy#1swYyxYw) Nrz3Parameter name_check can only be used with mode=newzHParameters 'name' and 'from_path' are mutually exclusive when 'mode=new'T)check_rcr' rzversion\s+([\d\.]+)\s+z=Failed to determine version number. First line of output: {0})varsr r!do_raiser rrcommandrmodulecommand_args_formatsrunnerbinaryrunsplitresearchformatgroupr')selfvctxrcouterrlinematchs k/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/cpanm.py__init_module__zCPANMinus.__init_module__s II 66_ $|| STvv!++ hi'(||q||  T\\4;T;T_cd ;;--  [[ ) 5S779LBS99T?1%DII7>E ]ddeijk&+kk!nDII #  5 5 5s 4BE>>Fc(d}||jdry|dnd|z}|rdd|zini}t|jdd gd tjid| }|d | 5}|j d ||dcdddS#1swYyxYw)Nc |dk(S)Nr)r<r=r>s rAprocessz0CPANMinus._is_package_installed..processs 7N.tar.gzF PERL5LIBz %s/lib/perl5perlz-lemod)r)environ_updateoutput_processzuse ;)rM)endswithrr/ras_listr3)r9r rr rFenvr1r;s rA_is_package_installedzCPANMinus._is_package_installeds  <4==3"S7]9Az>H45r4;;%AWAWAY9Zej{~ E' 2 >c77dG<7= > > >s &BBcv||S|jdr|jdtjj |r|jd|jdr@|j dr|jd|j dr|nd|z}||zS|d d vrd|z}||zS) NrHz@parameter 'version' must not be used when installing from a file)msgzEparameter 'version' must not be used when installing from a directoryz.git~zQoperator '~' not allowed in version parameter when installing from git repository@r)rYrX)rRr-osrisdir startswith)r9r&r s rAsanitize_pkg_spec_versionz#CPANMinus.sanitize_pkg_spec_versions ?O   Y ' MM`M a 77== " MMeM f   V $!!#& "u v!(!3!3C!8gcGmG'!!QZz )GmG'!!rGcfd}j}|jrdnd}|jdk(r8j|j|j |j ry||}na|jr1j|j|j |j nd}|ryj|||j }jgd|5}|j|_ dddy#1swYyxYw) Ncjjdk(r,|dk7r'j|jjd|vxrd|vS)Nrr)rWcmdz is up to date)r,r r-cmd_args)r<r=r>r9s rArFz"CPANMinus.__run__..processsHyy~~0R1W #499+=+= >"#-L/2L LrGrr rF)rrrrrrrr&rO)r&) r,rr rUr rr r!r]r1r3changed)r9rFr: pkg_paramr& installedr;s` rA__run__zCPANMinus.__run__s M II#$;;KF 66_ $))!&&!**aiiH|H[\[g[g221<<QYYWmrI55a lAIINH [[  " # 6'*77H75DL 6 6 6s DD N)__name__ __module__ __qualname__ output_paramsdictr/r.ras_bool as_opt_valrSas_fixedr0use_old_vardictrBrUr]rerErGrAr r sjY'M 55'2e$'VU3v&U#&%8&%8$(f$5 $& 1(5%/59QR' //!F&G%~%%j1***=9(~((4*N**?;*N**?; 6 6 67JLbpt u2N223DFZhlm''')-n--k: O5* > "6rGr c,tjy)N)r executerErGrAmainrq"s rG__main__) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrZr5Eansible_collections.community.general.plugins.module_utils.cmd_runnerrrHansible_collections.community.general.plugins.module_utils.module_helperrr rqrfrErGrArzsaA@ f P& P  kaq6 q6h zFrG