[BACK]Return to OpenAMD.pm CVS log [TXT][DIR] Up to [local] / HOPE / Net-OpenAMD / lib / Net

Diff for /HOPE/Net-OpenAMD/lib/Net/OpenAMD.pm between version 1.8 and 1.19

version 1.8, 2010/06/27 04:23:27 version 1.19, 2010/07/14 06:21:23
Line 1 
Line 1 
 package Net::OpenAMD;  package Net::OpenAMD;
   
 # $AFresh1: OpenAMD.pm,v 1.7 2010/06/27 03:11:22 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.1');  use version; our $VERSION = qv('0.1.0');
   my $BASE_URI = 'https://api.hope.net/api/';
   
 my $BASE_URL = 'https://api.hope.net/api/';  
   
 use Scalar::Util qw( refaddr );  use Scalar::Util qw( refaddr );
 *_ident = \&refaddr;  *_ident = \&refaddr;
   
 use LWP::UserAgent;  use LWP::UserAgent;
 use URI;  use URI;
 use Net::OAuth;  use Net::OAuth;
 use JSON::Any;  use JSON;
   
 {  {
   
     my @attr_refs = \( my %base_url_of, my %ua_of, my %auth_of, );      my @attr_refs = \(
           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 ) = @_;
         my $self = bless do { \my $x }, $class;          my $self = bless do { \my $x }, $class;
         my $ident = _ident($self);          my $ident = _ident($self);
   
         $options //= {};          $options ||= {};
   
         croak 'Options should be a hashref' if ref $options ne 'HASH';          croak 'Options should be a hashref' if ref $options ne 'HASH';
   
         $base_url_of{$ident} = $options->{base_url} || $BASE_URL;          $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();
           $json_of{$ident}     = $options->{json}     || JSON->new();
           $actions_of{$ident}  = $options->{actions}
               || [qw( location speakers talks interests users )];
   
           foreach my $action ( @{ $actions_of{$ident} } ) {
               ## no critic
               no strict 'refs';
               *{$action} = sub { shift->get( $action, @_ ) };
           }
   
         # XXX Authenticate          # XXX Authenticate
   
         return $self;          return $self;
Line 43 
Line 55 
         my ( $self, $action, $query ) = @_;          my ( $self, $action, $query ) = @_;
         my $ident = _ident($self);          my $ident = _ident($self);
   
         my $uri = URI->new( $base_url_of{$ident} . '/' . $action );          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;
   
         if ( !$response->is_success ) {          my $data;
             croak $response->status_line;          eval {
         }              $data = $json_of{$ident}->decode( $response->decoded_content );
           };
           croak "Invalid JSON from [$uri]" if $@;
   
         return JSON::Any->jsonToObj( $response->decoded_content );          return $data;
     }      }
   
     sub location  { my $self = shift; return $self->get( 'location',  @_ ) }  
     sub speakers  { my $self = shift; return $self->get( 'speakers',  @_ ) }  
     sub talks     { my $self = shift; return $self->get( 'talks',     @_ ) }  
     sub interests { my $self = shift; return $self->get( 'interests', @_ ) }  
     sub users     { my $self = shift; return $self->get( 'users',     @_ ) }  
     sub stats { croak 'Unused feature' }      sub stats { croak 'Unused feature' }
   
     sub DESTROY {      sub DESTROY {
Line 85 
Line 95 
   
 =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
Line 124 
Line 134 
   
 =over  =over
   
 =item base_url  =item base_uri
   
 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
   are having 404 errors you don't expect.
   
 =item ua  =item ua
   
 Should be a pre-configured LWP::UserAgent or similar that returns a  Should be a pre-configured LWP::UserAgent or similar that returns a
Line 167 
Line 180 
   
 =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.
   
 =head1 DIAGNOSTICS  =head1 DIAGNOSTICS
   
 All methods should croak when an error occours.  All methods should croak when an error occurs.
 If the remote API returns a successful response that contains valid JSON, that  If the remote API returns a successful response that contains valid JSON, that
 will be decoded and returned.  will be decoded and returned.
   
Legend:
Removed from v.1.8  
changed lines
  Added in v.1.19
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>