Module-Which version 0.0206

'Module::Which' is the basis of the script 'which_pm' intented to show which version of a Perl module is installed (if it is there at all).

Modules are searched by name (like 'YAML') or by subcategories ('DBD::' means all modules under the DBD subdirectories of your Perl installation, matching both 'DBD::Oracle' and 'DBD::ODBC::Changes').

This module is very simple and most won't need it. But it has been instructive for the author to see how many broken modules one can find under your Perl installation (some which don't accept even a 'require' statement), modules with no version number and documentation files (named '.pm') which do not return a true value.

To find out modules under subcategories, L<Module::Find> by Christian Renz was used.

Well, all that said, this module is no more than automating:

perl -MInteresting::Module -e 'print $Interesting::Module::VERSION'

or better the one-liner

perl -e '$pm = shift; eval "require $pm"; print ${"${pm}::VERSION"}' DBI

INSTALLATION

To install this module type the following:

perl Makefile.PL
make
make test
make install

DEPENDENCIES

This module requires these other modules and libraries:

GetOpt::Long
Pod::Usage
Test::More
File::Spec::Unix
File::Glob
File::Find
ExtUtils::MakeMaker

and recommends

Test::Pod

TO DO

• needs a more comprehensive test suite.
• implement more options on which() behavior

  return => 'ARRAY' | 'HASH' | 'HASH(FIRST)' | 'HASH(MULT)' | 'HASH(LIST)' verbose => 0 | 1

  include => @INC method => 'REQUIRE' | 'EXTRACT' info => @fields

• finish documentation of Data::Hash::Transform
• stuff Data::Hash::Transform into its own distribution
• fix bug in --help option
• introduce more options to control C<which_pm> behavior: C<--include>, C<--method>, etc.
• always update "META.yml" before releasing (this is not being done automatically because MakeMaker overwrite keys like 'license' and 'recommends')
• which_pm should produce nice output for narrow terminal window sizes.
• which_pm should be able to report the version of perl (and other Perl scripts)
• a more complete implementation of --version for which_pm (copyright and license included)
• support the pattern '' as a shortcut to show all installed modules in include directories
• finish documentation of Module::Which::List

COPYRIGHT AND LICENCE

Copyright (C) 2005-2007 by Adriano R. Ferreira

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.