App::Module::Lister - List the Perl modules in @INC
# run the .pm file prompt> perl Lister.pm ---OR--- # rename this file to something your webserver will treat as a # CGI script and upload it. Run it to see the module list prompt> cp Lister.pm lister.cgi ... modify the shebang line if you must prompt> ftp www.example.com ... upload file prompt> wget http://www.example.com/cgi-bin/lister.cgi
This is a program to list all of the Perl modules it finds in
@INC for a no-shell web hosting account. It has these explicit design goals:
If you have a shell account, you should just use
CPAN.pm's autobundle feature.
You do not need to install this module. You just need the
.pm file. The rest of the distribution is there to help me give it to other people and test it.
You might have to modify the shebang line (the first line in the file) to point to Perl. Your web hoster probably has instructions on what that should be. As shipped, this program uses the
env trick described in perlrun. If that doesn't work for you, you'll probably see an error like:
/usr/bin/env: bad interpreter: No such file or directory
That's similar to the error you'll see if you have the wrong path to
The program searches each entry in
@INC individually and outputs modules as it finds them.
Do the magic, sending the output to
FILEHANDLE. By default, it sends the output to
Returns three closures to find, report, and clear a list of modules. See their use in
FILENAME and return its value. The entire statement in the file must be on a single line with nothing else (just like for the PAUSE indexer). If the version is undefined, it returns the string
parse_version_safely to evaluate the
$VERSION line and return a number.
STATEMENT is the single statement containing the assignment to
SIGIL may be either a
$ (for a scalar) or a
* for a typeglob.
VAR is the variable identifier.
PATH into a Perl module name, ignoring the
@INC directory specified in
@INCdirectories, this program shows the wrong thing.
For example, I have in
@INC the directory
/usr/local/lib/perl5/5.8.8. Inside that directory, I expect to find something like
/usr/local/lib/perl5/5.8.8/Foo/Bar.pm, which translates in the module
Foo::Bar. If I find a directory like
/usr/local/lib/perl5/5.8.8/lib/Foo/Bar.pm, where I created the extra
lib by hand, this program guesses the module name is
lib::Foo::Bar. That's not a great tradegy, but I don't have a simple way around that right now.
This source is part of a SourceForge project which always has the latest sources in CVS, as well as all of the previous releases.
If, for some reason, I disappear from the world, one of the other members of the project can shepherd this module appropriately.
brian d foy,
The idea and some of the testing came from Adam Wohld.
Some bits stolen from
mldistwatch in the PAUSE code, by Andreas König.
Copyright (c) 2007-2013, brian d foy, All Rights Reserved.
You may redistribute this under the same terms as Perl itself.