flickr::api::response(3pm) [debian man page]

Flickr::API::Response(3pm)				User Contributed Perl Documentation				Flickr::API::Response(3pm)

NAME

       Flickr::API::Response - A response from the flickr API.

SYNOPSIS

	 use Flickr::API;
	 use Flickr::API::Response;

	 my $api = new Flickr::API({'key' => 'your_api_key'});

	 my $response = $api->execute_method('flickr.test.echo', {
		       'foo' => 'bar',
		       'baz' => 'quux',
	       });

	 print "Success: $response->{success}
";

DESCRIPTION

       This object encapsulates a response from the Flickr API. It's a subclass of "HTTP::Response" with the following additional keys:

	 {
	       'success' => 1,
	       'tree' => XML::Parser::Lite::Tree,
	       'error_code' => 0,
	       'error_message' => '',
	 }

       The "_request" key contains the request object that this response was generated from. This request will be a "Flickr::API::Request" object,
       which is a subclass of "HTTP:Request".

       The "sucess" key contains 1 or 0, indicating whether the request suceeded. If it failed, "error_code" and "error_message" explain what went
       wrong. If it suceeded, "tree" contains an "XML::Parser::Lite::Tree" object of the response XML.

AUTHOR

       Copyright (C) 2004, Cal Henderson, <cal@iamcal.com>

SEE ALSO

       Flickr::API, XML::Parser::Lite

perl v5.14.2							    2008-09-29						Flickr::API::Response(3pm)

XML::Parser::Lite::Tree(3pm)				User Contributed Perl Documentation			      XML::Parser::Lite::Tree(3pm)

NAME

       XML::Parser::Lite::Tree - Lightweight XML tree builder

SYNOPSIS

	 use XML::Parser::Lite::Tree;

	 my $tree_parser = XML::Parser::Lite::Tree::instance();
	 my $tree = $tree_parser->parse($xml_data);

	   OR

	 my $tree = XML::Parser::Lite::Tree::instance()->parse($xml_data);

DESCRIPTION

       This is a singleton class for parsing XML into a tree structure. How does this differ from other XML tree generators? By using
       XML::Parser::Lite, which is a pure perl XML parser. Using this module you can tree-ify simple XML without having to compile any C.

       For example, the following XML:

	 <foo woo="yay"><bar a="b" c="d" />hoopla</foo>

       Parses into the following tree:

		 'children' => [
				 {
				   'children' => [
						   {
						     'children' => [],
						     'attributes' => {
								       'a' => 'b',
								       'c' => 'd'
								     },
						     'type' => 'element',
						     'name' => 'bar'
						   },
						   {
						     'content' => 'hoopla',
						     'type' => 'text'
						   }
						 ],
				   'attributes' => {
						     'woo' => 'yay'
						   },
				   'type' => 'element',
				   'name' => 'foo'
				 }
			       ],
		 'type' => 'root'
	       };

       Each node contains a "type" key, one of "root", "element" and "text". "root" is the document root, and only contains an array ref
       "children". "element" represents a normal tag, and contains an array ref "children", a hash ref "attributes" and a string "name".  "text"
       nodes contain only a "content" string.

METHODS

       "instance()"
	   Returns an instance of the tree parser.

       "new( options... )"
	   Creates a new parser. Valid options include "process_ns" to process namespaces.

       "parse($xml)"
	   Parses the xml in $xml and returns the tree as a hash ref.

AUTHOR

       Copyright (C) 2004-2008, Cal Henderson, <cal@iamcal.com>

SEE ALSO

       XML::Parser::Lite.

perl v5.12.3							    2011-06-04					      XML::Parser::Lite::Tree(3pm)