Stephen R. Scaffidi > BackPAN-Version-Discover-0.01 > BackPAN::Version::Discover

Download:
BackPAN-Version-Discover-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

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.

syntax highlighting: