NAME

       perl-depends - rough indicator of Perl module dependencies

SYNOPSIS

         perl-depends [options] FILE [FILE ...]

DESCRIPTION

       An utility to show roughly what modules a program uses. Perl evaluates "use" commands at
       compile time, storing the information about loaded modules in the %INC variable. Comparing
       that list with the standard Perl modules gives an estimate of the external module
       dependencies.

       The dependency information can be used to determine what external modules have to be
       installed before the program can be used.

       The target FILE have to be instrumented with the dependency checking code. The resulting
       "binary" is then stored in a temporary file which the user runs.

       This program does not run the instrumented files because it cannot know what possible
       options need to be passed for programs to trigger "no behavior". That is, something that
       doesn't actually involve executing the "binary" in real. Such options passed would include
       --version, --dry-run, invalid options like --generate-syntax-error-now, or invalid files
       etc to make program stop on error. The user can know better the details of running the
       intrumented files.

       An example of output: the external module depends here is 'Regexp::Common' and the rest of
       them can be ignored.

           Regexp::Common                 Regexp/Common.pm
           Regexp::Common::CC             Regexp/Common/CC.pm
           ...

OPTIONS

       -e, --extension=EXT
           Use extension EXT for instrumented files. The default is ".tmp".

       -h, --help
           Print text help

       --help-html
           Print help in HTML format.

       --help-man
           Print help in manual page man(1) format.

       -v, --verbose LEVEL
           Print informational messages. Increase numeric LEVEL for more verbosity.

       -V, --version
           Print contact and version information.

EXAMPLES

       Instrument a file, run it to see results and delete instrumentation:

           perl-depends file.pl
           perl file.pl.tmp --version
           rm *.tmp

TROUBLESHOOTING

       None.

ENVIRONMENT

       None.

FILES

       None.

EXIT STATUS

       This program's exit status is not defined.

       The instrumented programs exit status is 1 in case external modules are displayed and 0 if
       no external modules are found.

DEPENDENCIES

       Uses standard Perl modules.

BUGS AND LIMITATIONS

       None.

SEE ALSO

       cpan(1)

AVAILABILITY

       http://freecode.com/projects/perl-depends

AUTHOR

       Jari Aalto <jari.aalto@cante.net>

LICENSE

       Copyright (C) 2009-2011 Jari Aalto <jari.aalto@cante.net>

       This program is free software; you can redistribute and/or modify program under the terms
       of GNU General Public license either version 2 of the License, or (at your option) any
       later version. See <http://www.gnu.org/licenses/>.