NAME

Net::FS::Flickr - store and retrieve files on Flickr

SYNOPSIS

    my $fs = Net::FS::Flickr->new( key => $key, secret => $secret );

    $fs->set_auth($auth_key); # see API KEYS AND AUTH KEY section
    $fs->store("file.txt");
    $fs->store("piccy.jpg", "renamed_piccy.jpg");

    open (FILE, ">output.jpg") || die "Couldn't write to file: $!\n";
    binmode (FILE);
    print FILE $fs->retrieve("renamed_piccy.jpg");
    close (FILE);

API KEYS AND AUTH KEY

You will need to sign up for an API key and then get the corresponding secret key. You can do that from here

http://www.flickr.com/services/api/key.gne

Finally you will need to get an auth key. As described here

http://www.flickr.com/services/api/auth.howto.desktop.html

the helper script "flickrfs" supplied with this distribution can help with that.

METHODS

new

Takes a valid API key and a valid secret key

files [nsid, email or username]

Get a list of all the files on the system

Given an nsid, username or email, use that. Otherwise use the nsid from the auth token.

versions <filename> [nsid, email or username]

Returns a list of all the versions of a file

Each item on the list is a hashref containing the date the file was saved and the id of that version using the keys timestamp and id respectively.

The list is sorted, latest version first.

Because of the way Flickr stores sets, timestamp will always be 0;

Given an nsid, username or email, use that. Otherwise use the nsid from the auth token.

retrieve <filename> [version]

Get <filename> from Flickr.

If the file has multiple versions then you can pass in a version number to get version - 1 being the oldest. If you don't pass in a version then you get the latest.

store <filename> [as]

Store the file <filename> on Flickr. If a second filename is given then use that as the name on Flickr

This works by stashing the data in the least significant bits of as many images as is need. by default an, err, default image is used. But you can set alternative images using the "image_pool()" method.

image_pool [image[s]]

With no arguments, returns an array of all the images in the current image pool.

If you pass in one or more filenames or Imager objects then those are set as the current pool.

set_auth <auth key>

Set the app authorisation key.