community.general.cpanm (1.3.11) — module

Manages Perl library dependencies.

Authors: Franck Cuny (@fcuny)

Install collection

Install with ansible-galaxy collection install community.general:==1.3.11


Add to requirements.yml

  collections:
    - name: community.general
      version: 1.3.11

Description

Manage Perl library dependencies.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Install Dancer perl package
  community.general.cpanm:
    name: Dancer
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Install version 0.99_05 of the Plack perl package
  community.general.cpanm:
    name: MIYAGAWA/Plack-0.99_05.tar.gz
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Install Dancer into the specified locallib
  community.general.cpanm:
    name: Dancer
    locallib: /srv/webapps/my_app/extlib
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Install perl dependencies from local directory
  community.general.cpanm:
    from_path: /srv/webapps/my_app/src/
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Install Dancer perl package from a specific mirror
  community.general.cpanm:
    name: Dancer
    mirror: 'http://cpan.cpantesters.org/'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Install Dancer perl package into the system root path
  community.general.cpanm:
    name: Dancer
    system_lib: yes
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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'

Inputs

    
name:
    aliases:
    - pkg
    description:
    - The name of the Perl library to install. You may use the "full distribution path",
      e.g.  MIYAGAWA/Plack-0.99_05.tar.gz
    type: str

mirror:
    description:
    - Specifies the base URL for the CPAN mirror to use
    type: str

notest:
    default: false
    description:
    - Do not run unit tests
    type: bool

version:
    description:
    - minimum version of perl module to consider acceptable
    type: str

locallib:
    description:
    - Specify the install base to install modules
    type: path

from_path:
    description:
    - The local directory from where to install
    type: path

executable:
    description:
    - Override the path to the cpanm executable
    type: path

system_lib:
    aliases:
    - use_sudo
    default: false
    description:
    - Use this if you want to install modules to the system perl include path. You must
      be root or have "passwordless" sudo for this to work.
    - This uses the cpanm commandline option '--sudo', which has nothing to do with ansible
      privilege escalation.
    type: bool

installdeps:
    default: false
    description:
    - Only install dependencies
    type: bool

mirror_only:
    default: false
    description:
    - Use the mirror's index file instead of the CPAN Meta DB
    type: bool