Sample usage errors out with missing package_name argument

[seanhoughton]

The required package_name argument of the cpan class is not documented. Using the provided sample config results in the following error:

Class[Cpan]: expects a value for parameter 'package_name'

The source code references this in the cpan::install class which is only mentioned in the docs as "Handles package installation".

What is the correct way to use this module?

[seanhoughton]

Setting the package_name property to the package results in an error

  class {'::cpan':
    manage_package => true,
    package_ensure => 'present',
    package_name   => 'JSON',
    config_hash    => { 'build_requires_install_policy' => 'no' },
  }

Server Error: Evaluation Error: Missing title. The title expression resulted in undef at /opt/puppetlabs/puppet/modules/cpan/manifests/config.pp:15:12

[faxm0dem]

I'm sorry the documentation didn't help you.
If you want to install a cpan package, you want to use the cpan resource, not the class:

cpan { 'JSON':
  ensure => 'present',
}

The cpan class's package_name parameter refers to the name of the cpan package itself, e.g. perl-cpan on RedHat