[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.7 and 1.17

version 1.7, 2010/06/27 04:11:22 version 1.17, 2010/07/13 01:13:22
Line 1 
Line 1 
 package Net::OpenAMD;  package Net::OpenAMD;
   
 # $AFresh1: OpenAMD.pm,v 1.6 2010/06/27 00:52:33 andrew Exp $  # $AFresh1: OpenAMD.pm,v 1.16 2010/07/09 22:04: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.0.4');
   my $BASE_URI = 'https://api.hope.net/api/';
   
 my $BASE_URL = 'https://api.hope.net/api/';  use Scalar::Util qw( refaddr );
   *_ident = \&refaddr;
   
 use Class::Std::Utils;  
   
 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 anon_scalar(), $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 40 
Line 53 
   
     sub get {      sub get {
         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 {
         my ($self) = @_;          my ($self) = @_;
         my $ident = ident $self;          my $ident = _ident $self;
   
         foreach my $attr_ref (@attr_refs) {          foreach my $attr_ref (@attr_refs) {
             delete $attr_ref->{$ident};              delete $attr_ref->{$ident};
Line 76 
Line 87 
   
 1;    # Magic true value required at end of module  1;    # Magic true value required at end of module
 __END__  __END__
   
 =head1 NAME  =head1 NAME
   
 Net::OpenAMD - Perl interface to the OpenAMD API  Net::OpenAMD - Perl interface to the OpenAMD API
Line 83 
Line 95 
   
 =head1 VERSION  =head1 VERSION
   
 This document describes Net::OpenAMD version 0.0.1  This document describes Net::OpenAMD version 0.0.4
   
   
 =head1 SYNOPSIS  =head1 SYNOPSIS
Line 122 
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 165 
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.7  
changed lines
  Added in v.1.17
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>