module::versions::report(3pm) [debian man page]

Module::Versions::Report(3pm)				User Contributed Perl Documentation			     Module::Versions::Report(3pm)

NAME

       Module::Versions::Report -- report versions of all modules in memory

SYNOPSIS

	 use Module::Versions::Report;

	 ...and any code you want...

       This will run all your code normally, but then as the Perl interpreter is about to exit, it will print something like:

	 Perl v5.6.1 under MSWin32.
	  Modules in memory:
	   attributes;
	   AutoLoader v5.58;
	   Carp;
	   Config;
	   DynaLoader v1.04;
	   Exporter v5.562;
	   Module::Versions::Report v1.01;
	   HTML::Entities v1.22;
	   HTML::HeadParser v2.15;
	   HTML::Parser v3.25;
	   [... and whatever other modules were loaded that session...]

       Consider its use from the command line:

	 % perl -MModule::Versions::Report -MLWP -e 1

	 Perl v5.6.1 under MSWin32.
	  Modules in memory:
	   attributes;
	   AutoLoader v5.58;
	   [...]

DESCRIPTION

       I often get email from someone reporting a bug in a module I've written.  I email back, asking what version of the module it is, what
       version of Perl on what OS, and sometimes what version of some relevent third library (like XML::Parser).  They reply, saying "Perl 5".	I
       say "I need the exact version, as reported by "perl -v"".  They tell me.  And I say "I, uh, also asked about the version of my module and
       XML::Parser [or whatever]".  They say "Oh yeah.	It's 2.27".  "Is that my module or XML::Parser?"  "XML::Parser."  "OK, and what about my
       module's version?"  "Ohyeah.  That's 3.11."  By this time, days have passed, and what should have been a simple operation -- reporting the
       version of Perl and relevent modules, has been needlessly complicated.

       This module is for simplifying that task.  If you add "use Module::Versions::Report;" to a program (especially handy if your program is one
       that demonstrates a bug in some module), then when the program has finished running, you well get a report detailing the all modules in
       memory, and noting the version of each (for modules that defined a $VERSION, at least).

USING

   Importing
       If this package is imported then END block is set, and report printed to stdout on a program exit, so use "use Module::Versions::Report;"
       if you need a report on exit or "use Module::Versions::Report ();" otherwise and call report or print_report functions yourself.

   report and print_report functions
       The first one returns preformatted report as a string, the latter outputs a report to stdout.

COPYRIGHT AND DISCLAIMER

       Copyright 2001-2003 Sean M. Burke. This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself.

       This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of
       merchantability or fitness for a particular purpose.

MAINTAINER

       Ruslan U. Zakirov <ruz@bestpractical.com>

AUTHOR

       Sean M. Burke, <sburke@cpan.org>

perl v5.10.0							    2008-10-21					     Module::Versions::Report(3pm)

Check Out this Related Man Page

Module::Loaded(3pm)					 Perl Programmers Reference Guide				       Module::Loaded(3pm)

NAME

       Module::Loaded - mark modules as loaded or unloaded

SYNOPSIS

	   use Module::Loaded;

	   $bool = mark_as_loaded('Foo');   # Foo.pm is now marked as loaded
	   $loc  = is_loaded('Foo');	    # location of Foo.pm set to the
					    # loaders location
	   eval "require 'Foo'";	    # is now a no-op

	   $bool = mark_as_unloaded('Foo'); # Foo.pm no longer marked as loaded
	   eval "require 'Foo'";	    # Will try to find Foo.pm in @INC

DESCRIPTION

       When testing applications, often you find yourself needing to provide functionality in your test environment that would usually be provided
       by external modules. Rather than munging the %INC by hand to mark these external modules as loaded, so they are not attempted to be loaded
       by perl, this module offers you a very simple way to mark modules as loaded and/or unloaded.

FUNCTIONS

   $bool = mark_as_loaded( PACKAGE );
       Marks the package as loaded to perl. "PACKAGE" can be a bareword or string.

       If the module is already loaded, "mark_as_loaded" will carp about this and tell you from where the "PACKAGE" has been loaded already.

   $bool = mark_as_unloaded( PACKAGE );
       Marks the package as unloaded to perl, which is the exact opposite of "mark_as_loaded". "PACKAGE" can be a bareword or string.

       If the module is already unloaded, "mark_as_unloaded" will carp about this and tell you the "PACKAGE" has been unloaded already.

   $loc = is_loaded( PACKAGE );
       "is_loaded" tells you if "PACKAGE" has been marked as loaded yet.  "PACKAGE" can be a bareword or string.

       It returns falls if "PACKAGE" has not been loaded yet and the location from where it is said to be loaded on success.

BUG REPORTS

       Please report bugs or other issues to <bug-module-loaded@rt.cpan.org<gt>.

AUTHOR

       This module by Jos Boumans <kane@cpan.org>.

COPYRIGHT

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

perl v5.12.1							    2010-04-26						       Module::Loaded(3pm)

Linux and UNIX Man Pages

module::versions::report(3pm) [debian man page]

Check Out this Related Man Page