Programming Perl, 4th Edition

Naming Modules

A good name is one of the most important parts of creating a module. Once you choose a name and people start using your module, you have to live with that name virtually forever as your users refuse to update their code. If you are uploading your module to CPAN, you want people to be able to find it easily, too. You can read some naming guidelines at PAUSE.

Module names should be capitalized unless they’re functioning as pragmas. Pragmas (see Chapter 29) are in effect compiler directives (hints for the compiler), so we reserve the lowercase pragma names for future use.

If you want to make a private module whose name should never conflict with a module in the Standard Library or on CPAN, you can use the Local namespace. It’s not forbidden from CPAN, but by convention it’s not used.