version 1.14, 2010/06/30 19:45:42 |
version 1.19, 2010/07/14 06:21:23 |
|
|
package Net::OpenAMD; |
package Net::OpenAMD; |
|
|
# $AFresh1: OpenAMD.pm,v 1.13 2010/06/30 05:30:17 andrew Exp $ |
# $AFresh1: OpenAMD.pm,v 1.18 2010/07/13 00:14:21 andrew Exp $ |
|
|
use warnings; |
use warnings; |
use strict; |
use strict; |
use Carp; |
use Carp; |
|
|
use version; our $VERSION = qv('0.0.3'); |
use version; our $VERSION = qv('0.1.0'); |
my $BASE_URI = 'https://api.hope.net/api/'; |
my $BASE_URI = 'https://api.hope.net/api/'; |
|
|
use Scalar::Util qw( refaddr ); |
use Scalar::Util qw( refaddr ); |
|
|
use LWP::UserAgent; |
use LWP::UserAgent; |
use URI; |
use URI; |
use Net::OAuth; |
use Net::OAuth; |
use JSON qw/ from_json /; |
use JSON; |
|
|
{ |
{ |
|
|
my @attr_refs |
my @attr_refs = \( |
= \( my %base_uri_of, my %ua_of, my %auth_of, my %helpers_of ); |
my %base_uri_of, |
|
my %ua_of, my %auth_of, my %actions_of, |
|
my %json_of, |
|
); |
|
|
sub new { |
sub new { |
my ( $class, $options ) = @_; |
my ( $class, $options ) = @_; |
|
|
|
|
$base_uri_of{$ident} = $options->{base_uri} || $BASE_URI; |
$base_uri_of{$ident} = $options->{base_uri} || $BASE_URI; |
$ua_of{$ident} = $options->{ua} || LWP::UserAgent->new(); |
$ua_of{$ident} = $options->{ua} || LWP::UserAgent->new(); |
$helpers_of{$ident} = $options->{helpers} |
$json_of{$ident} = $options->{json} || JSON->new(); |
|
$actions_of{$ident} = $options->{actions} |
|| [qw( location speakers talks interests users )]; |
|| [qw( location speakers talks interests users )]; |
|
|
foreach my $helper ( @{ $helpers_of{$ident} } ) { |
foreach my $action ( @{ $actions_of{$ident} } ) { |
## no critic |
## no critic |
no strict 'refs'; |
no strict 'refs'; |
*{$helper} = sub { shift->get( $helper, @_ ) }; |
*{$action} = sub { shift->get( $action, @_ ) }; |
} |
} |
|
|
# XXX Authenticate |
# XXX Authenticate |
|
|
my ( $self, $action, $query ) = @_; |
my ( $self, $action, $query ) = @_; |
my $ident = _ident($self); |
my $ident = _ident($self); |
|
|
my $uri = URI->new_abs( $action, $base_uri_of{$ident} ); |
my $uri = URI->new_abs( $action . '/', $base_uri_of{$ident} ); |
$uri->query($query); |
$uri->query_form($query); |
|
|
my $response = $ua_of{$ident}->get($uri); |
my $response = $ua_of{$ident}->get($uri); |
croak $response->status_line if !$response->is_success; |
croak $response->status_line if !$response->is_success; |
|
|
my @data = map { from_json($_) } split /\r?\n/xms, |
my $data; |
$response->decoded_content; |
eval { |
|
$data = $json_of{$ident}->decode( $response->decoded_content ); |
|
}; |
|
croak "Invalid JSON from [$uri]" if $@; |
|
|
return @data == 1 ? $data[0] : \@data; |
return $data; |
} |
} |
|
|
sub stats { croak 'Unused feature' } |
sub stats { croak 'Unused feature' } |
|
|
|
|
=head1 VERSION |
=head1 VERSION |
|
|
This document describes Net::OpenAMD version 0.0.1 |
This document describes Net::OpenAMD version 0.0.3 |
|
|
|
|
=head1 SYNOPSIS |
=head1 SYNOPSIS |
|
|
A URL to the API, currently defaults to https://api.hope.net/api/ |
A URL to the API, currently defaults to https://api.hope.net/api/ |
|
|
Most likely it should end with a / to make URI happy, so notice that if you |
Most likely it should end with a / to make URI happy, so notice that if you |
having 404 errors you don't expect. |
are having 404 errors you don't expect. |
|
|
=item ua |
=item ua |
|
|
|
|
|
|
=back |
=back |
|
|
Unless specified, there is nothing different about any of the helper methods |
Unless specified, there is nothing different about any of the action methods |
than just calling get($action) instead. Depending on API changes, this may |
than just calling get($action) instead. Depending on API changes, this may |
not always be the case. |
not always be the case. |
|
|