Markus Holzer > AudioFile-Find > AudioFile::Find

Download:
AudioFile-Find-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

NAME ^

AudioFile::Find - Find Audiofiles located on your harddisk. Supports MP3, WMA and Ogg Vorbis files.

VERSION ^

Version 0.01

SYNOPSIS ^

    use AudioFile::Find;

    my $finder = AudioFile::Find->new( 'some/dir' );
    
        # find everything
        my @audiofiles = $finder->search();
        
        # specify a search directory
        my @audiofiles = $finder->search( 'some/other/dir' );
        
        #same for genre, title, track, artist and album
        my @audiofiles = $finder->search( artist => 'Seeed' ); 
        
        #search using a regex
        my @audiofiles = $finder->search( 'some/other/dir', title => qr/Ding/ ); 
        
        # anonymous subroutine that returns true or false
        my @audiofiles = $finder->search( 'some/other/dir', track => sub { return shift > 10; } ); 

METHODS ^

new

Creates an object of this class. Takes an optional single argument which is the directory to search in.

new

Sets and returns the directory to search.

search

Starts the search and returns a hash of filenames as keys and AudioFile::Info-Objects as values. You may specify a search directory as the first argument and also pass a hash with search criteria. See the synopsis for details.

pass

Checks wether a given AudioFile::Info-Object meets given criteria. First argument is the Info-Object, second argument is a reference to the criteria hash.

AUTHOR ^

Markus, <holli.holzer at googlemail.com>

BUGS ^

Please report any bugs or feature requests to bug-audiofile-find at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=AudioFile-Find. 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 AudioFile::Find

You can also look for information at:

ACKNOWLEDGEMENTS ^

COPYRIGHT & LICENSE ^

Copyright 2008 Markus 'holli' Holzer, all rights reserved.

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

syntax highlighting: