Nuno Filipe Monteiro Nunes > Flickr-Tools-0.02 > Flickr::API::Utils

Download:
Flickr-Tools-0.02.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  7
Open  1
View/Report Bugs
Module Version: 0.01   Source  

NAME ^

Flickr::API::Utils - Provides helpfull functions for dealing with the Flickr API.

VERSION ^

Version 0.01

SYNOPSIS ^

This module provides functions that may be used to "clean up" the response from a Flickr::API call, test results and so on.

Usage example:

    use Flickr::Utils;

    my $toolbox = Flickr::Utils->new();

    my $prettystruct = $toolbox->clean($response_from_flickr_api_call);

FUNCTIONS ^

new

clean

Takes a structure generated by a Flickr::API call and cleans it up for your Perl code to enjoy.

The response from that class is a hash created by a XML parser which is rather difficult to parse.

This module gets that response and creates a rather more "perlish" structure with the same information.

This cleaning up is done on a fully automated manner so it may still not be what you want. Some rather more usefull modules are Flickr::API::Photos, Flickr::API::People, etc which use this as a first pass at getting a decent response.

test_return

Checks to see if the response of the Flickr API was successfull or not.

If it was successfull fill in the return->success field in the object that was passed on to us, otherwise fill in this field and the other two relevant ones: result->error_code and result->error_message.

auto_parse

Parses a piece of the XML structure (an ARRAY) that the Flickr::API returns according to some rules laid out by the user.

get_attributes

Gets the attributes for a given node of the XML tree.

get_simple_content

Gets the content for a given node of the XML tree. It is assumed that this node has a single element with content.

AUTHOR ^

Nuno Nunes, <nfmnunes@cpan.org>

BUGS ^

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

ACKNOWLEDGEMENTS ^

COPYRIGHT & LICENSE ^

Copyright 2005 Nuno Nunes, 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: