perl Cookbook

Provides resources to install Perl and maintain modules from CPAN.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

• Debian/Ubuntu/Mint
• RHEL/CentOS Stream/Amazon/Oracle/Rocky/AlmaLinux
• Fedora
• Windows

Chef

• Chef 15.3+

Cookbooks

• none

Migration

This cookbook no longer ships recipes or attributes. See migration.md for details on moving from perl::default and node['perl'] attributes to custom resources.

Resources

perl_install

Installs Perl and cpanminus. See documentation/perl_install.md.

perl_install 'default'

cpan_module

Installs or uninstalls CPAN modules with cpanminus. See documentation/perl_cpan_module.md.

Actions

• :install - install the module (default action)
• :uninstall - uninstall the module

Properties

• module_name - The name of the module if it's different than the name of the resource property
• force - To force the install within cpanm (default: false)
• test - To do a test install (default: false)
• version - Any version string cpanm would find acceptable
• cwd - A path to change into before running cpanm
• cpanm_path - Path to the cpanminus executable

Examples

To install a module from CPAN:

cpan_module 'App::Munchies'

Optionally, installation can forced with the 'force' parameter.

cpan_module 'App::Munchies' do
  force true
end

You can also use cpanm's version mechanism to grab a specific version, or glob a version.

Exactly version 1.01 of App::Munchies will be installed:

cpan_module 'App::Munchies' do
  version '== 1.01'
end

At least version 1.01 of App::Munchies will be installed:

cpan_module 'App::Munchies' do
  version '1.01'
end

At least version 1.01 will be installed, but not version 2:

cpan_module 'App::Munchies' do
  version '>= 1.01, < 2.0'
end

Additionally, you can use cpan_module to delete a given package using cpanm's --uninstall param.

cpan_module 'App::Munchies' do
  action :uninstall
end

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.