blib/lib/WWW/BBB/API.pm untested

filter: Statementstmt 0.0% 0 / 138 Branchbran 0.0% 0 / 30 Conditioncond 0.0% 0 / 3 MC/DCmcdc 0.0% 0 / 2 Subroutinesub 0.0% 0 / 26 Podpod 0.0% 0 / 19 totaltotal 0.0% 0 / 218 CC 16 SCAR 18.1
CC
16
Cov
0%
new
20.0
create
6.0
getMeetings
6.0
CRAP 6.1
1 package WWW::BBB::API;
2  
3 use 5.008008;
4 use strict;
5 use warnings;
6  
7 use URI;
8 use Digest::SHA qw(sha1_hex);
9 use XML::Simple;
10 use LWP::Simple;
11  
12 our $VERSION = '0.02';
13  
14 my %fields = (
15 salt => undef,
16 host => undef,
17 path => 'bigbluebutton/api/',
18 );
19  
20 my %api = (
21 'join' => [qw/fullName meetingID password/],
22 'create' => [qw/name meetingID attendeePW moderatorPW/],
23 );
24  
25 sub new {
26 my ($proto,%options) = @_;
27 my $class = ref($proto) || $proto;
28 my $self = {%fields};
29 while (my ($key,$value) = each(%options)) {
30 if (exists($fields{$key})) {
31 $self->{$key} = $value if (defined $value);
32 } else {
33 die ref($class) . "::new: invalid option '$key'\n";
34 }
35 }
36 foreach (keys(%fields)) {
37 die ref($class) . "::new: must specify value for $_"
38 if (!defined $self->{$_});
39 }
40 bless $self, $class;
41 return $self;
42 }
43  
44 sub join {
45 my $self = shift;
46 $self->cmd(&_subName);
47 my %form;
48 foreach (@{$api{$self->cmd}}) {
49 $form{$_} = $self->$_;
50 }
51 my $uri = $self->_newUri;
52 $uri->query_form(\%form);
53 $form{checksum} = $self->_checksum($uri->query);
54 $uri->query_form(\%form);
55 return $uri->as_string;
56 }
57  
58 sub create {
59 my $self = shift;
60 $self->cmd(&_subName);
61 my %form;
62 foreach (@{$api{$self->cmd}}) {
63 $form{$_} = $self->$_;
64 }
65 # a bug in 0.71 disable audio conference unless voiceBridge
66 # is not set
67 $form{voiceBridge} = '00000' unless exists($form{voiceBridge});
68 my $uri = $self->_newUri;
69 $uri->query_form(\%form);
70 $form{checksum} = $self->_checksum($uri->query);
71 $uri->query_form(\%form);
72 return $uri->as_string;
73 }
74  
75 sub getMeetings {
76 my $self = shift;
77 $self->cmd(&_subName);
78 my %form = (random => $self->_random_string(12));
79 my $apiUrl = $self->_apiUrl(%form);
80 my $xml = get($apiUrl);
81 croak("Unable to fetch getMeetings api at " . $self->{host}) unless($xml);
82 my $obj = XMLin($xml);
83 return $obj;
84 }
85  
86 sub _apiUrl {
87 my $self = shift;
88 my %form = @_;
89 my $uri = $self->_newUri;
90 $uri->query_form(\%form);
91 $form{checksum} = $self->_checksum($uri->query);
92 $uri->query_form(\%form);
93 return $uri->as_string;
94 }
95  
96 sub _newUri {
97 my $self = shift;
98 my $uri = new URI();
99 $uri->scheme('http');
100 $uri->host($self->host);
101 $uri->path($self->path . $self->cmd);
102 return $uri;
103 }
104  
105 sub _checksum {
106 my $self = shift;
107 my $qs = shift;
108  
109 my $salt = $self->salt;
110 my $cmd = $self->cmd;
111  
112 my $checksum_string = $cmd . $qs . $salt;
113 return sha1_hex($checksum_string);
114 }
115  
116 sub _subName { (split(/::/,(caller(1))[3]))[-1] }
117  
118 sub _random_string {
119 my $self = shift;
120 my $length = shift;
121 my @chars=('a'..'z','A'..'Z','0'..'9');
122 my $random_string;
123 foreach (1..$length) {
124 $random_string.=$chars[rand @chars];
125 }
126 return $random_string;
127 }
128  
129 sub cmd { my $s = shift; if (@_) { $s->{cmd} = shift; } return $s->{cmd}; }
130 sub salt { my $s = shift; if (@_) { $s->{salt} = shift; } return $s->{salt}; }
131 sub host { my $s = shift; if (@_) { $s->{host} = shift; } return $s->{host}; }
132 sub path { my $s = shift; if (@_) { $s->{path} = shift; } return $s->{path}; }
133 sub fullName { my $s = shift; if (@_) { $s->{fullName} = shift; } return $s->{fullName}; }
134 sub meetingID { my $s = shift; if (@_) { $s->{meetingID} = shift; } return $s->{meetingID}; }
135 sub password { my $s = shift; if (@_) { $s->{password} = shift; } return $s->{password}; }
136 sub name { my $s = shift; if (@_) { $s->{name} = shift; } return $s->{name}; }
137 sub attendeePW { my $s = shift; if (@_) { $s->{attendeePW} = shift; } return $s->{attendeePW}; }
138 sub moderatorPW { my $s = shift; if (@_) { $s->{moderatorPW} = shift; } return $s->{moderatorPW}; }
139  
140 1;
141 __END__