Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bestpractical/module-versions-report


https://github.com/bestpractical/module-versions-report

Last synced: 11 days ago
JSON representation

Awesome Lists containing this project

README

        

README for Module::Report::Versions
Time-stamp: "2003-06-21 23:18:00 AHDT"

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).

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.

AUTHOR
Sean M. Burke,

PREREQUISITES

This suite requires Perl 5.

INSTALLATION

You install Module::Versions::Report, as you would install any Perl module
distribution, by running these commands:

perl Makefile.PL
make
make test
make install

If you want to install a private copy of Module::Versions::Report in
your home directory, then you should try to produce the initial Makefile
with something like this command:

perl Makefile.PL LIB=~/perl

See perldoc perlmodinstall for more information.

DOCUMENTATION

See the pod in Module::Versions::Report.

SUPPORT

Questions, bug reports, useful code bits, and suggestions for
Worms should be sent to me at [email protected]

AVAILABILITY

The latest version of Module::Versions::Report is available from the
Comprehensive Perl Archive Network (CPAN). Visit
to find a CPAN site near you.

COPYRIGHT

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

AUTHOR

Sean M. Burke