pm_which(1p) [debian man page]

PM_WHICH(1p)						User Contributed Perl Documentation					      PM_WHICH(1p)

NAME

       pm_which - find installed modules

SYNOPSIS

	   pm_which [ options ] module(s)

	   Returns the path to the given module(s)

   OPTIONS
	   -q, --quiet	   Just print paths
	   -p, --paths	   Just convert the module name into a relative path
	   -a, --all	   Print all paths, not just the first one found
	   -n, --namespace Print all modules in the given namespace
	   -m		   Only print module names, not paths
	   -V		   Show module version
	   -I libpath	   Add a path to search (like perl -I)
	   -d, --dump	   Dump paths that would be searched (@INC by default)
	   -h, --help	   Print this message
	   -v, --version   Print version information
	   -		   Read modules from stdin, one per line

DESCRIPTION

       This tool reports the locations of installed perl modules.

       By default it lists the location of each specified module that would be loaded by require.

OPTION DETAILS

   quiet
       Under quiet mode, module names are suppressed and missing modules are not reported.

       Normal output:

	   $ pm_which Module::One Module::Two Missing::Module
	   Module::One	   - /path/to/Module/One.pm
	   Module::Two	   - /path/to/Module/Two.pm
	   Missing::Module - not found

       Under --quiet:

	   $ pm_which -q Module::One Module::Two Missing::Module
	   /path/to/Module/One.pm
	   /path/to/Module/Two.pm

   paths
       In "paths" mode, each module is simply converted into a relative file path. This is possible even when the module is not installed.

	   $ pm_which -p Missing::Module
	   Missing/Module.pm

   all
       When the "all" switch is specified, all installed modules will be reported, not just the first one. This is useful for determining when
       there is a module installed in multiple locations.

	   $ pm_which -a MyModule
	   /path/to/MyModule.pm
	   /home/me/perl/MyModule.pm

   namespace
       Arguments are taken as namespaces to search under.

	   $ pm_which -n MyModule
	   MyModule	       - /path/to/MyModule.pm
	   MyModule::Foo       - /path/to/MyModule/Foo.pm
	   MyModule::Foo::Bar  - /path/to/MyModule/Foo/Bar.pm

   -m
       Disables printing of module paths. This is only really useful in conjunction with --namespace.

	   $ pm_which -nm MyModule
	   MyModule
	   MyModule::Foo
	   MyModule::Foo::Bar

   -V
       Prints the version of each module, according to ExtUtils::MakeMaker.

	   $ pm_which -V MyModule
	   MyModule - /path/to/MyModule.pm [ 1.00 ]

	   $ pm_which -Vnm MyModule
	   MyModule [ 1.00 ]
	   MyModule::Foo [ 0.01 ]
	   MyModule::Foo::Bar [ undef ]

   dump
       Dumps the paths that would be searched and exits. This is @INC modified by any -I switches.

	   $ pm_which --dump
	   /usr/lib/perl5/site_perl/5.8.6
	   /usr/lib/perl5/vendor_perl/5.8.6
	   ...

	   $ pm_which -I lib --dump -I blib/lib
	   lib
	   blib/lib
	   /usr/lib/perl5/site_perl/5.8.6
	   ...

   version
       Prints the version number of the script, plus the version and path of Module::Util that was loaded.

EXIT CODES

       o   0 - Everything was OK

       o   1 - Initialisation failed (bad switches?)

       o   2 - Some modules were not installed

SEE ALSO

       This utility comes with Module::Util.

AUTHOR

       Matt Lawrence <mattlaw@cpan.org>

perl v5.14.2							    2012-06-08							      PM_WHICH(1p)

Check Out this Related Man Page

Test::File::ShareDir(3pm)				User Contributed Perl Documentation				 Test::File::ShareDir(3pm)

NAME

       Test::File::ShareDir - Create a Fake ShareDir for your modules for testing.

VERSION

       version 0.3.1

SYNOPSIS

	   use Test::More;

	   # use FindBin; optional

	   use Test::File::ShareDir
	       # -root => "$FindBin::Bin/../" # optional,
	       -share => {
		   -module => { 'My::Module' => 'share/MyModule' }
		   -dist   => { 'My-Dist'    => 'share/somefolder' }
	       };

	   use My::Module;

	   use File::ShareDir qw( module_dir dist_dir );

	   module_dir( 'My::Module' ) # dir with files from $dist/share/MyModule

	   dist_dir( 'My-Dist' ) # dir with files from $dist/share/somefolder

DESCRIPTION

       This module only has support for creating 'new' style share dirs and are NOT compatible with old File::ShareDirs.

       For this reason, unless you have File::ShareDir 1.00 or later installed, this module will not be usable by you.

IMPORTING

   -root
       This parameter is the prefix the other paths are relative to.

       If this parameter is not specified, it defaults to the Current Working Directory ( "CWD" ).

       In versions prior to 0.3.0, this value was mandatory.

       The rationale behind using "CWD" as the default value is as follows.

       o   Most users of this module are likely to be using it to test distributions

       o   Most users of this module will be using it in "$project/t/" to load files from "$project/share/"

       o   Most "CPAN" tools run tests with "CWD" = $project

       Therefor, defaulting to "CWD" is a reasonably sane default for most people, but where it is not it can still be overridden.

	 -root => "$FindBin::Bin/../" # resolves to project root from t/ regardless of Cwd.

   -share
       This parameter is mandatory, and contains a "hashref" containing the data that explains what directories you want shared.

	 -share =>  { ..... }

       -module

       "-module" contains a "hashref" mapping Module names to path names for module_dir style share dirs.

	 -share => {
	   -module => { 'My::Module' => 'share/mymodule/', }
	 }

	 ...

	 module_dir('My::Module')

       Notedly, it is a "hashref", which means there is a limitation of one share dir per module. This is simply because having more than one
       share dir per module makes no sense at all.

       -dist

       "-dist" contains a "hashref" mapping Distribution names to path names for dist_dir style share dirs. The same limitation applied to
       "-module" applies here.

	 -share => {
	   -dist => { 'My-Dist' => 'share/mydist' }
	 }
	 ...
	 dist_dir('My-Dist')

AUTHOR

       Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Kent Fredric <kentnl@cpan.org>.

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

perl v5.14.2							    2012-06-24						 Test::File::ShareDir(3pm)

Linux and UNIX Man Pages

pm_which(1p) [debian man page]

Check Out this Related Man Page