NAME

WWW::Bleep - Perl interface to Bleep.com

VERSION

Version 0.92

SYNOPSIS

use WWW::Bleep;

my $bleep = WWW::Bleep->new();

my @tracks = WWW::Bleep->tracks( artist => 'Aphex Twin' );

DESCRIPTION

A Perl interface to Bleep.com. Specfically for searching artist, album, and label data. Current purpose is the help with cataloging your personal (physical) album collection.

This has no shopping cart capability and it isn't planned. (Less there is some dire need for it.)

FUNCTIONS

new

    Create a new WWW::Bleep object.

    Currently has no arguments.

error

    Returns an error description or ''.

    Doesn't take or require any arguments.

    For the sake of your own sanity, check this ne '' after every call.
    The most you'd generally get from other routines as far as errors are
    concerned would be a null response.

album

    Gathers album data based on the arguments given.

    Requires one of the following arguments:

        cat
        (eventually title)

    Returns a hash containing relevant album and track data.
    Specifically artist, date, label, title, and tracks. artist,
    date, label, and title are all scalars.  date may always be
    returned.

   tracks contains the following array

        track_number => {
            'time'  => length_in_standard_time,
            'title' => track_title,
            'valid' => 1_=_downloadable__0_=_not
        }
        next_track_number => {
            'time'  => length_in_standard_time,
            'title' => track_title,
            'valid' => 1_=_downloadable__0_=_not
        }
        ...

artists

    Returns an array of artists from Bleep.com.  An optional argument
    must be a valid record label name.

        # Returns all artists (Be careful with this one,
        #                      the list is very large!)
        @artists = $bleep->artists();  

        # Returns only artists on Warp
        @artists = $bleep->artists( 'Warp' );
        
        # Returns null (not a valid record label)
        @artists = $bleep->artists( 'foo1234' );

    Due to the size of the artist list, it may take a minute to
    populate.

tracks

    Gathers the tracks based on the arguments given.  

    Requires one or of the following arguments:

        artist
        label
        album*

    Returns an array of hashes of track names, track numbers and album
    catalog numbers.  *Currently, 'album' dies off, as it uses a 
    different method that hasn't been configured.

SEE ALSO

http://www.bleep.com

AUTHOR

Clif Bratcher, <snevine@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2006 - 2009 by Clif Bratcher

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.