NAME
    App::whichpm - locate a Perl module and it's version

SYNOPSIS
            use App::whichpm 'which_pm';
            my ($filename, $version) = which_pm('App::whichpm');
            my $filename = App::whichpm::find('App::whichpm');

    from shell:

            whichpm App::whichpm
            whichpm Universe::ObservableUniverse::Filament::SuperCluster::Cluster::Group::Galaxy::Arm::Bubble::InterstellarCloud::SolarSystem::Earth

DESCRIPTION
    Locates a given module and reports its path and version without loading
    it.

    The similar function can be achieved via:

            perldoc -l Some::Module
            perl -MSome::Module -le 'print $INC{"Some/Module.pm"}'
            perl -MSome::Module -le 'print Some::Module->VERSION'
            pmpath Some::Module
            pmvers Some::Module

EXPORTS
  which_pm
    same as "find" only exported under "which_pm" name.

FUNCTIONS
  find($module_name)
    Locates $module_name without loading it.

    In scalar context returns filename corresponding to $module_name. In
    array context returns filename and version.

    $module_name can be either "Some::Module::Name" or "Some/Module/Name.pm"

SEE ALSO
    <http://perlmonks.org/?node=whichpm>, pmpath
    <http://search.cpan.org/perldoc?pmpath>, Module::Path, Module::Metadata,
    Module::InstalledVersion, Module::Info

AUTHOR
    Jozef Kutej

CONTRIBUTORS
    The following people have contributed to the App::whichpm by committing
    their code, sending patches, reporting bugs, asking questions,
    suggesting useful advises, nitpicking, chatting on IRC or commenting on
    my blog (in no particular order):

            Jerrad Pierce
            Skye Shaw
            Andreas Hadjiprocopis

LICENSE AND COPYRIGHT
    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.