cpan resource

Use the cpan Chef InSpec audit resource to test Perl modules that are installed by system packages or the CPAN installer.

Availability

This resource is distributed with Chef InSpec and is automatically available for use.

This resource first became available in v1.43.5 of InSpec.

A cpan resource block declares a package and (optionally) a package version:

describe cpan('package_name') do
  it { should be_installed }
end

where

This resource uses package names and perl library paths as resource parameters.

describe cpan('DBD:Pg') do
  it { should be_installed }
end

describe cpan('DBD::Pg') do
  it { should be_installed }
  its('version') { should eq '3.7.0' }
end

Hint: You can pass multiple paths separated with a colon /path/to/perl5/lib:/usr/share/perl5/vendor_perl/lib/perl5

describe cpan('DBD::Pg', '/home/username/perl5/lib/perl5') do
  it { should be_installed }
end

The following examples show how to use this Chef InSpec audit resource.

The version property tests if the named package version is on the system:

its('version') { should eq '1.2.3' }

For a full list of available matchers, see our Universal Matchers page.

This resource has the following special matchers.

The be_installed matcher tests if the named package is installed on the system:

it { should be_installed }