/usr/share/perl5/Flickr/API/Response.pm is in libflickr-api-perl 1.01-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | package Flickr::API::Response;
use strict;
use warnings;
use HTTP::Response;
our @ISA = qw(HTTP::Response);
our $VERSION = '0.02';
sub new {
my $class = shift;
my $self = new HTTP::Response;
my $options = shift;
bless $self, $class;
return $self;
}
sub init_flickr {
my ($self, $options) = @_;
$self->{tree} = undef;
$self->{success} = 0;
$self->{error_code} = 0;
$self->{error_message} = '';
}
sub set_fail {
my ($self, $code, $message) = @_;
$self->{success} = 0;
$self->{error_code} = $code;
$self->{error_message} = $message;
}
sub set_ok {
my ($self, $tree) = @_;
$self->{success} = 1;
$self->{tree} = $tree;
}
1;
__END__
=head1 NAME
Flickr::API::Response - A response from the flickr API.
=head1 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}\n";
=head1 DESCRIPTION
This object encapsulates a response from the Flickr API. It's
a subclass of C<HTTP::Response> with the following additional
keys:
{
'success' => 1,
'tree' => XML::Parser::Lite::Tree,
'error_code' => 0,
'error_message' => '',
}
The C<_request> key contains the request object that this response
was generated from. This request will be a C<Flickr::API::Request>
object, which is a subclass of C<HTTP:Request>.
The C<sucess> key contains 1 or 0, indicating
whether the request suceeded. If it failed, C<error_code> and
C<error_message> explain what went wrong. If it suceeded, C<tree>
contains an C<XML::Parser::Lite::Tree> object of the response XML.
=head1 AUTHOR
Copyright (C) 2004, Cal Henderson, E<lt>cal@iamcal.comE<gt>
=head1 SEE ALSO
L<Flickr::API>,
L<XML::Parser::Lite>
=cut
|