# salt.modules.cpan

Manage Perl modules using CPAN

Added in version 2015.5.0.

salt.modules.cpan.install(module)

  Install a Perl module from CPAN

  CLI Example:

      salt '*' cpan.install Template::Alloy

salt.modules.cpan.list_()

  List installed Perl modules, and the version installed

  CLI Example:

      salt '*' cpan.list

salt.modules.cpan.remove(module, details=False)

  Attempt to remove a Perl module that was installed from CPAN. Because the `cpan` command doesn't actually support "uninstall"-like functionality, this function will attempt to do what it can, with what it has from CPAN.

  Until this function is declared stable, USE AT YOUR OWN RISK!

  CLI Example:

      salt '*' cpan.remove Old::Package

salt.modules.cpan.show(module)

  Show information about a specific Perl module

  CLI Example:

      salt '*' cpan.show Template::Alloy

salt.modules.cpan.show_config()

  Return a dict of CPAN configuration values

  CLI Example:

      salt '*' cpan.show_config