NAME

BackPAN::Version::Discover - Figure out exactly which dist versions you have installed

VERSION

Version 0.01

SYNOPSIS

Please note: this module's interface is HIGHLY ALPHA, mainly because I want input from users on how they think it should work. Therefore, this is all subject to change, if only you *tell me what you want* :)

    use BackPAN::Version::Discover;
    
    my $bvd = BackPAN::Version::Discover->new();
    
    # exclude relative dirs and anything under $HOME
    my @dirs = grep { ! /^$ENV{HOME}|^[^\/]/ } @INC;
    
    # this may take some time and use lots of ram and/or CPU
    my $results = $bvd->scan( dirs => \@dirs );
    
    # please let me know if the separate results object is good or bad.
    my @releases = $results->release_paths();
    my 

SUBROUTINES/METHODS

new

Creates a new BackPAN::Version::Discover object with the given parameters.

Currently ignores all parameters.

scan

Scans for installed, loadable modules and tries to determine exactly which CPAN/BackPAN distribution release each may have come from. If the dirs option is specified, the scan will be restricted to the given array of directories. Otherwise, it will default to searching all directories currently specified in @INC.

Options:

dirs

An arrayref containing the directories to scan.

AUTHOR

Stephen R. Scaffidi, <sscaffidi at cpan.org>

BUGS

Please report any bugs or feature requests to bug-backpan-version-discover at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=BackPAN-Version-Discover. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc BackPAN::Version::Discover

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2010 Stephen R. Scaffidi.

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.