Amazon/S3.pm

filter: Statementstmt 27.9% 229 / 820 Branchbran 22.0% 72 / 326 Conditioncond 13.4% 39 / 291 MC/DCmcdc 5.5% 10 / 181 Subroutinesub 40.2% 39 / 97 Podpod 63.8% 23 / 36 totaltotal 23.5% 412 / 1751 CC 285 SCAR 56.1
CC
285
Cov
24%
empty_bucket
1722.0
list_bucket
600.0
_canonical_string
306.0
CRAP 272.8
↑ Summary Amazon/S3/Bucket.pm »
1 package Amazon::S3;
2  
3 12 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 12 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5  
6 12 ▶use Amazon::S3::Bucket;
Subroutine BEGIN: called CC=1 SCAR=0.0
7 12 ▶use Amazon::S3::BucketV2;
Subroutine BEGIN: called CC=1 SCAR=0.0
8 12 ▶use Amazon::S3::Constants qw(:all);
Subroutine BEGIN: called CC=1 SCAR=0.0
9  
10 12 ▶use Amazon::S3::Util qw(
Subroutine BEGIN: called CC=1 SCAR=0.0
11 set_md5_header
12 urlencode
13 get_parameters
14 create_xml_request
15 create_api_uri
16 create_query_string
17 12 );
18  
19 12 ▶use Amazon::S3::Logger;
Subroutine BEGIN: called CC=1 SCAR=0.0
20 12 ▶use Amazon::S3::Signature::V4;
Subroutine BEGIN: called CC=1 SCAR=0.0
21  
22 12 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
23 12 ▶use Data::Dumper;
Subroutine BEGIN: called CC=1 SCAR=0.0
24 12 ▶use Digest::HMAC_SHA1;
Subroutine BEGIN: called CC=1 SCAR=0.0
25 12 ▶use Digest::MD5 qw(md5_hex);
Subroutine BEGIN: called CC=1 SCAR=0.0
26 12 ▶use English qw(-no_match_vars);
Subroutine BEGIN: called CC=1 SCAR=0.0
27 12 ▶use HTTP::Date;
Subroutine BEGIN: called CC=1 SCAR=0.0
28 12 ▶use LWP::UserAgent::Determined;
Subroutine BEGIN: called CC=1 SCAR=0.0
29 12 ▶use List::Util qw( any pairs none );
Subroutine BEGIN: called CC=1 SCAR=0.0
30 12 ▶use MIME::Base64 qw(encode_base64 decode_base64);
Subroutine BEGIN: called CC=1 SCAR=0.0
31 12 ▶use Module::Load;
Subroutine BEGIN: called CC=1 SCAR=0.0
32 12 ▶use Scalar::Util qw( reftype blessed );
Subroutine BEGIN: called CC=1 SCAR=0.0
33 12 ▶use URI;
Subroutine BEGIN: called CC=1 SCAR=0.0
34 12 ▶use XML::Simple;
Subroutine BEGIN: called CC=1 SCAR=0.0
35  
36 12 ▶use parent qw(Class::Accessor::Fast Exporter);
Subroutine BEGIN: called CC=1 SCAR=0.0
37  
38 12 __PACKAGE__->mk_accessors(
39 qw(
40 aws_access_key_id
41 aws_secret_access_key
42 token
43 buffer_size
44 cache_signer
45 checksum_types
46 checksum_algorithm
47 credentials
48 dns_bucket_names
49 digest
50 endpoint_url
51 err
52 errstr
53 error
54 express
55 host
56 last_request
57 last_response
58 logger
59 log_level
60 raise_error
61 retry
62 _region
63 secure
64 _signer
65 timeout
66 ua
67 verify_checksums
68 ),
69 );
70  
71 12 our $VERSION = '2.1.4'; ## no critic (RequireInterpolation)
72  
73 12 our @EXPORT_OK = qw(is_domain_bucket);
74  
75 ########################################################################
76 25 ▶sub new {
Subroutine new: called CC=28 SCAR=41.3
Pod documented
77 ########################################################################
78 25 my ( $class, @args ) = @_;
79  
80 25 ▶ my %options = ref $args[0] ? %{ $args[0] } : @args;
Branch: 1 branch
BranchTrueFalseTotal
ref $args[0] ? : 19 6 25
81  
82 25 ▶ $options{timeout} //= $DEFAULT_TIMEOUT;
Condition33%1/3
$options{"timeout"} //= $Amazon::S3::DEFAULT_TIMEOUT
l!l&&r!l&&!r
0250
MC/DC0%0/2
$options{"timeout"} //= $Amazon::S3::DEFAULT_TIMEOUT
$options{"timeout"} $Amazon::S3::DEFAULT_TIMEOUT
Truth table33%1/3
A //= B
A= $options{"timeout"}B= $Amazon::S3::DEFAULT_TIMEOUT
ABresult
1X1
011
000
83 25 ▶ $options{cache_signer} //= $FALSE;
Condition33%1/3
$options{"cache_signer"} //= $Amazon::S3::FALSE
l!l&&r!l&&!r
0250
MC/DC0%0/2
$options{"cache_signer"} //= $Amazon::S3::FALSE
$options{"cache_signer"} $Amazon::S3::FALSE
Truth table33%1/3
A //= B
A= $options{"cache_signer"}B= $Amazon::S3::FALSE
ABresult
1X1
011
000
84 25 ▶ $options{retry} //= $FALSE;
Condition33%1/3
$options{"retry"} //= $Amazon::S3::FALSE
l!l&&r!l&&!r
0250
MC/DC0%0/2
$options{"retry"} //= $Amazon::S3::FALSE
$options{"retry"} $Amazon::S3::FALSE
Truth table33%1/3
A //= B
A= $options{"retry"}B= $Amazon::S3::FALSE
ABresult
1X1
011
000
85 25 ▶ $options{express} //= $FALSE;
Condition33%1/3
$options{"express"} //= $Amazon::S3::FALSE
l!l&&r!l&&!r
0250
MC/DC0%0/2
$options{"express"} //= $Amazon::S3::FALSE
$options{"express"} $Amazon::S3::FALSE
Truth table33%1/3
A //= B
A= $options{"express"}B= $Amazon::S3::FALSE
ABresult
1X1
011
000
86 25 ▶ $options{verify_checksums} //= $TRUE;
Condition66%2/3
$options{"verify_checksums"} //= $Amazon::S3::TRUE
l!l&&r!l&&!r
1240
MC/DC0%0/2
$options{"verify_checksums"} //= $Amazon::S3::TRUE
$options{"verify_checksums"} $Amazon::S3::TRUE
Truth table66%2/3
A //= B
A= $options{"verify_checksums"}B= $Amazon::S3::TRUE
ABresult
1X1
011
000
87 25 ▶ $options{checksum_algorithm} //= 'crc64nvme';
Condition50%1/2
$options{"checksum_algorithm"} //= "crc64nvme"
l!l
025
MC/DC0%0/1
$options{"checksum_algorithm"} //= "crc64nvme"
$options{"checksum_algorithm"}
Truth table50%1/2
A
A= $options{"checksum_algorithm"}
Aresult
11
00
88 25 ▶ $options{raise_error} //= $FALSE;
Condition33%1/3
$options{"raise_error"} //= $Amazon::S3::FALSE
l!l&&r!l&&!r
0250
MC/DC0%0/2
$options{"raise_error"} //= $Amazon::S3::FALSE
$options{"raise_error"} $Amazon::S3::FALSE
Truth table33%1/3
A //= B
A= $options{"raise_error"}B= $Amazon::S3::FALSE
ABresult
1X1
011
000
89  
90 croak "ERROR: pass endpoint_url or host but not both\n"
91 25 ▶ if $options{endpoint_url} && $options{host};
Branch: 1 branch
BranchTrueFalseTotal
if $options{"endpoint_url"} and $options{"host"} 1 24 25
Condition100%3/3
$options{"endpoint_url"} and $options{"host"}
!ll&&!rl&&r
2311
MC/DC100%2/2
$options{"endpoint_url"} and $options{"host"}
$options{"endpoint_url"} $options{"host"}
Truth table100%3/3
A and B
A= $options{"endpoint_url"}B= $options{"host"}
ABresult
0X0
100
111
92  
93 24 ▶ if ( my $endpoint_url = $options{endpoint_url} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (my $endpoint_url = $options{'endpoint_url'}) { } 1 23 24
elsif ($options{'host'}) { } 3 20 23
94 1 @options{qw(secure host)} = _parse_endpoint($endpoint_url);
95 }
96 elsif ( $options{host} ) {
97 3 ▶ if ( $options{host} =~ m{\Ahttps?://}xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($options{'host'} =~ m[\Ahttps?://]msx) { } 3 0 3
98 3 warn "host containing a URL is deprecated; use endpoint_url instead\n";
99  
100 3 @options{qw(secure host)} = _parse_endpoint( $options{host} );
101 }
102 else {
103 0 ▶ $options{secure} //= $TRUE;
Condition0%0/3
$options{"secure"} //= $Amazon::S3::TRUE
l!l&&r!l&&!r
000
MC/DC0%0/2
$options{"secure"} //= $Amazon::S3::TRUE
$options{"secure"} $Amazon::S3::TRUE
Truth table0%0/3
A //= B
A= $options{"secure"}B= $Amazon::S3::TRUE
ABresult
1X1
011
000
104 }
105 }
106 else {
107 20 $options{secure} = $TRUE;
108 20 $options{host} = $DEFAULT_HOST;
109 }
110  
111 24 ▶ $options{dns_bucket_names} //= $TRUE;
Condition33%1/3
$options{"dns_bucket_names"} //= $Amazon::S3::TRUE
l!l&&r!l&&!r
0240
MC/DC0%0/2
$options{"dns_bucket_names"} //= $Amazon::S3::TRUE
$options{"dns_bucket_names"} $Amazon::S3::TRUE
Truth table33%1/3
A //= B
A= $options{"dns_bucket_names"}B= $Amazon::S3::TRUE
ABresult
1X1
011
000
112  
113 croak sprintf "ERROR: invalid checksum_algorithm: '%s'\nMust be one of: %s\n", $options{checksum_algorithm}, join q{,},
114 @AWS_CHECKSUM_TYPES
115 24 ▶ if none { $options{checksum_algorithm} eq $_ } @AWS_CHECKSUM_TYPES;
Subroutine __ANON__: called CC=1 SCAR=0.2
Branch: 1 branch
BranchTrueFalseTotal
if &none(sub { $options{"checksum_algorithm"} eq $_; } , @Amazon::S3::AWS_CHECKSUM_TYPES) 0 24 24
116  
117 24 $options{_region} = delete $options{region};
118 24 $options{_signer} = delete $options{signer};
119  
120 # convenience for level => 'debug' & for consistency with
121 # Amazon::Credentials only do this if we are using internal logger,
122 # call should NOT use debug flag but rather use their own logger's
123 # level to turn on higher levels of logging...
124  
125 24 ▶ if ( !$options{logger} ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($options{"logger"}) 24 0 24
126 24 ▶ if ( delete $options{debug} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (delete $options{"debug"}) 0 24 24
127 0 $options{level} = 'debug';
128 }
129  
130 24 $options{log_level} = delete $options{level};
131 24 ▶ $options{log_level} //= $DEFAULT_LOG_LEVEL;
Condition33%1/3
$options{"log_level"} //= $Amazon::S3::DEFAULT_LOG_LEVEL
l!l&&r!l&&!r
0240
MC/DC0%0/2
$options{"log_level"} //= $Amazon::S3::DEFAULT_LOG_LEVEL
$options{"log_level"} $Amazon::S3::DEFAULT_LOG_LEVEL
Truth table33%1/3
A //= B
A= $options{"log_level"}B= $Amazon::S3::DEFAULT_LOG_LEVEL
ABresult
1X1
011
000
132  
133 $options{logger}
134 24 = Amazon::S3::Logger->new( log_level => $options{log_level} );
135 }
136  
137 24 my $self = $class->SUPER::new( \%options );
138  
139 # setup logger internal logging
140  
141 $self->get_logger->debug(
142 0 ▶ sub {
Subroutine __ANON__: not called CC=2 SCAR=17.9
143 0 my %safe_options = %options;
144  
145 0 ▶ if ( $safe_options{aws_secret_access_key} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($safe_options{"aws_secret_access_key"}) 0 0 0
146 0 $safe_options{aws_secret_access_key} = '****';
147 0 $safe_options{aws_access_key_id} = '****';
148 }
149  
150 0 return Dumper( [ options => \%safe_options ] );
151 },
152 24 );
153  
154 24 ▶ if ( !$self->credentials ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->credentials) 24 0 24
155  
156 24 ▶ croak 'No aws_access_key_id'
Branch: 1 branch
BranchTrueFalseTotal
unless $self->aws_access_key_id 0 24 24
157 if !$self->aws_access_key_id;
158  
159 24 ▶ croak 'No aws_secret_access_key'
Branch: 1 branch
BranchTrueFalseTotal
unless $self->aws_secret_access_key 0 24 24
160 if !$self->aws_secret_access_key;
161  
162 # encrypt credentials
163 24 $self->aws_access_key_id( _encrypt( $self->aws_access_key_id ) );
164 24 $self->aws_secret_access_key( _encrypt( $self->aws_secret_access_key ) );
165 24 $self->token( _encrypt( $self->token ) );
166 }
167  
168 24 my $ua;
169  
170 24 ▶ if ( $self->retry ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->retry) { } 0 24 24
171 0 $ua = LWP::UserAgent::Determined->new(
172 keep_alive => $KEEP_ALIVE_CACHESIZE,
173 requests_redirectable => [qw(GET HEAD DELETE)],
174 );
175  
176 0 $ua->timing( join $COMMA, map { 2**$_ } 0 .. $MAX_RETRIES );
177 }
178 else {
179 24 $ua = LWP::UserAgent->new(
180 keep_alive => $KEEP_ALIVE_CACHESIZE,
181 requests_redirectable => [qw(GET HEAD DELETE)],
182 );
183 }
184  
185 24 $ua->timeout( $self->timeout );
186 24 $ua->env_proxy;
187 24 $self->ua($ua);
188  
189 24 ▶ $self->region( $self->_region // $DEFAULT_REGION );
Condition100%3/3
$self->_region // $Amazon::S3::DEFAULT_REGION
l!l&&r!l&&!r
2175
MC/DC100%2/2
$self->_region // $Amazon::S3::DEFAULT_REGION
$self->_region $Amazon::S3::DEFAULT_REGION
Truth table100%3/3
A // B
A= $self->_regionB= $Amazon::S3::DEFAULT_REGION
ABresult
1X1
011
000
190  
191 24 ▶ if ( !$self->_signer && $self->cache_signer ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $self->_signer and $self->cache_signer) 0 24 24
Condition33%1/3
not $self->_signer and $self->cache_signer
!ll&&!rl&&r
0240
MC/DC0%0/2
not $self->_signer and $self->cache_signer
not $self->_signer $self->cache_signer
Truth table33%1/3
not(A) and B
A= not $self->_signerB= $self->cache_signer
ABresult
0X0
100
111
192 0 $self->_signer( $self->signer );
193 }
194  
195 24 ▶ if ( $self->express ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->express) 0 24 24
196 0 $self->use_express_one_zone();
197 }
198  
199 24 $self->turn_on_special_retry();
200  
201 24 $self->_init_checksum_types;
202  
203 24 return $self;
204 }
205  
206 ########################################################################
207 4 ▶sub _parse_endpoint {
Subroutine _parse_endpoint: called CC=11 SCAR=28.4
208 ########################################################################
209 4 my ($endpoint_url) = @_;
210  
211 4 my $uri = URI->new($endpoint_url);
212  
213 4 my $scheme = $uri->scheme;
214  
215 4 ▶ croak "ERROR: endpoint_url must include a host\n"
Branch: 1 branch
BranchTrueFalseTotal
unless defined $uri->host and length $uri->host 0 4 4
Condition33%1/3
defined $uri->host and length $uri->host
!ll&&!rl&&r
004
MC/DC0%0/2
defined $uri->host and length $uri->host
defined $uri->host length $uri->host
Truth table33%1/3
A and B
A= defined $uri->hostB= length $uri->host
ABresult
0X0
100
111
216 if !defined $uri->host || !length $uri->host;
217  
218 4 ▶ croak "ERROR: endpoint_url must use http or https\n"
Branch: 1 branch
BranchTrueFalseTotal
if not defined $scheme or $scheme ne "http" and $scheme ne "https" 0 4 4
Condition50%3/6
not defined $scheme or $scheme ne "http" and $scheme ne "https"
l!l&&r!l&&!r
004
$scheme ne "http" and $scheme ne "https"
!ll&&!rl&&r
220
MC/DC0%0/3
not defined $scheme or $scheme ne "http" and $scheme ne "https"
not defined $scheme $scheme ne "http" $scheme ne "https"
Truth table50%2/4
not(A) or B and C
A= not defined $schemeB= $scheme ne "http"C= $scheme ne "https"
ABCresult
1XX1
0111
00X0
0100
219 if !defined $scheme || ( $scheme ne 'http' && $scheme ne 'https' );
220  
221 4 ▶ croak "ERROR: endpoint_url must not contain a query or fragment\n"
Branch: 1 branch
BranchTrueFalseTotal
if defined $uri->query or defined $uri->fragment 0 4 4
Condition33%1/3
defined $uri->query or defined $uri->fragment
l!l&&r!l&&!r
004
MC/DC0%0/2
defined $uri->query or defined $uri->fragment
defined $uri->query defined $uri->fragment
Truth table33%1/3
A or B
A= defined $uri->queryB= defined $uri->fragment
ABresult
1X1
011
000
222 if defined $uri->query || defined $uri->fragment;
223  
224 4 ▶ croak "ERROR: endpoint_url must not contain a path\n"
Branch: 1 branch
BranchTrueFalseTotal
if $uri->path and $uri->path ne $Amazon::S3::SLASH 0 4 4
Condition33%1/3
$uri->path and $uri->path ne $Amazon::S3::SLASH
!ll&&!rl&&r
400
MC/DC0%0/2
$uri->path and $uri->path ne $Amazon::S3::SLASH
$uri->path $uri->path ne $Amazon::S3::SLASH
Truth table33%1/3
A and B
A= $uri->pathB= $uri->path ne $Amazon::S3::SLASH
ABresult
0X0
100
111
225 if $uri->path && $uri->path ne $SLASH;
226  
227 4 ▶ my $secure = $scheme eq 'https' ? $TRUE : $FALSE;
Branch: 1 branch
BranchTrueFalseTotal
$scheme eq 'https' ? : 2 2 4
228 4 my $host = $uri->host_port;
229  
230 4 return ( $secure, $host );
231 }
232  
233 ########################################################################
234 24 ▶sub _init_checksum_types {
Subroutine _init_checksum_types: called CC=4 SCAR=13.9
235 ########################################################################
236 24 my ($self) = @_;
237  
238 24 my %checksum_types;
239 24 $self->checksum_types( \%checksum_types );
240  
241 24 foreach my $algorithm (@AWS_CHECKSUM_TYPES) {
242 next
243 240 ▶ if !exists $CHECKSUM_TYPES{$algorithm};
Branch: 1 branch
BranchTrueFalseTotal
unless exists $Amazon::S3::CHECKSUM_TYPES{$algorithm} 72 168 240
244  
245 168 my $checksum_type = $CHECKSUM_TYPES{$algorithm};
246 168 my $module = $checksum_type->{module};
247  
248 168 my $loaded = eval {
249 168 load $module;
250 144 return $TRUE;
251 };
252  
253 next
254 168 ▶ if !$loaded;
Branch: 1 branch
BranchTrueFalseTotal
unless $loaded 24 144 168
255  
256 # since our module has already been loaded we only need the code
257 # ref to the implementation
258 144 $checksum_types{$algorithm} = $checksum_type->{digest};
259 }
260  
261 24 return $self;
262 }
263  
264 ########################################################################
265 0 ▶sub use_express_one_zone {
Subroutine use_express_one_zone: not called CC=1 SCAR=6.9
Pod undocumented
266 ########################################################################
267 0 my ($self) = @_;
268  
269 0 my $express = $self->express;
270  
271 0 $self->express($TRUE);
272  
273 0 $self->host( sprintf 's3express-control.%s.amazonaws.com', $self->region );
274 0 $self->secure($TRUE);
275 0 $self->dns_bucket_names($FALSE);
276  
277 0 return $express;
278 }
279  
280 ########################################################################
281 {
282 12 my $encryption_key;
283  
284 ########################################################################
285 72 ▶ sub _encrypt {
Subroutine _encrypt: called CC=6 SCAR=22.4
286 ########################################################################
287 72 my ($text) = @_;
288  
289 72 ▶ return $text if !$text;
Branch: 1 branch
BranchTrueFalseTotal
unless $text 24 48 72
290  
291 48 ▶ if ( !defined $encryption_key ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $encryption_key) 48 0 48
292 48 $encryption_key = eval {
293 48 ▶ if ( !defined $encryption_key ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $encryption_key) 48 0 48
294 48 require Crypt::Blowfish;
295 0 require Crypt::CBC;
296  
297 0 return md5_hex( rand $PID );
298 }
299 };
300  
301 48 ▶ return $text if $EVAL_ERROR;
Branch: 1 branch
BranchTrueFalseTotal
if $Amazon::S3::EVAL_ERROR 48 0 48
302 }
303  
304 0 ▶ return $text if !$encryption_key;
Branch: 1 branch
BranchTrueFalseTotal
unless $encryption_key 0 0 0
305  
306 0 my $cipher = Crypt::CBC->new(
307 -pass => $encryption_key,
308 -key => $encryption_key,
309 -cipher => 'Crypt::Blowfish',
310 -nodeprecate => $TRUE,
311 );
312  
313 0 return $cipher->encrypt($text);
314 }
315  
316 ########################################################################
317 0 ▶ sub _decrypt {
Subroutine _decrypt: not called CC=3 SCAR=24.8
318 ########################################################################
319 0 my ($secret) = @_;
320  
321 0 ▶ return $secret
Branch: 1 branch
BranchTrueFalseTotal
unless $secret and $encryption_key 0 0 0
Condition0%0/3
$secret and $encryption_key
!ll&&!rl&&r
000
MC/DC0%0/2
$secret and $encryption_key
$secret $encryption_key
Truth table0%0/3
A and B
A= $secretB= $encryption_key
ABresult
0X0
100
111
322 if !$secret || !$encryption_key;
323  
324 0 my $cipher = Crypt::CBC->new(
325 -pass => $encryption_key,
326 -key => $encryption_key,
327 -cipher => 'Crypt::Blowfish',
328 );
329  
330 0 return $cipher->decrypt($secret);
331 }
332  
333 }
334  
335 ########################################################################
336 12 ▶sub get_bucket_location {
Subroutine get_bucket_location: not called CC=4 SCAR=28.2
Pod documented
337 ########################################################################
338 0 my ( $self, $bucket ) = @_;
339  
340 0 my $region;
341  
342 0 ▶ if ( !ref $bucket || ref $bucket !~ /Amazon::S3::Bucket/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not ref $bucket or ref !($bucket =~ /Amazon::S3::Bucket/msx)) 0 0 0
Condition0%0/3
not ref $bucket or ref !($bucket =~ /Amazon::S3::Bucket/msx)
l!l&&r!l&&!r
000
MC/DC0%0/2
not ref $bucket or ref !($bucket =~ /Amazon::S3::Bucket/msx)
not ref $bucket ref !($bucket =~ /Amazon::S3::Bucket/msx)
Truth table0%0/3
not(A) or not(B)
A= not ref $bucketB= ref !($bucket =~ /Amazon::S3::Bucket/msx)
ABresult
1X1
011
000
343 0 $bucket = Amazon::S3::Bucket->new( bucket => $bucket, account => $self );
344 }
345  
346 0 ▶ return $bucket->get_location_constraint // $DEFAULT_REGION;
Condition0%0/3
$bucket->get_location_constraint // $Amazon::S3::DEFAULT_REGION
l!l&&r!l&&!r
000
MC/DC0%0/2
$bucket->get_location_constraint // $Amazon::S3::DEFAULT_REGION
$bucket->get_location_constraint $Amazon::S3::DEFAULT_REGION
Truth table0%0/3
A // B
A= $bucket->get_location_constraintB= $Amazon::S3::DEFAULT_REGION
ABresult
1X1
011
000
347 }
348  
349 ########################################################################
350 0 ▶sub get_default_region {
Subroutine get_default_region: not called CC=7 SCAR=40.3
Pod documented
351 ########################################################################
352 0 my ($self) = @_;
353  
354 0 ▶ my $region = $ENV{AWS_REGION} || $ENV{AWS_DEFAULT_REGION};
Condition0%0/3
$ENV{'AWS_REGION'} || $ENV{'AWS_DEFAULT_REGION'}
l!l&&r!l&&!r
000
MC/DC0%0/2
$ENV{'AWS_REGION'} || $ENV{'AWS_DEFAULT_REGION'}
$ENV{'AWS_REGION'} $ENV{'AWS_DEFAULT_REGION'}
Truth table0%0/3
A || B
A= $ENV{'AWS_REGION'}B= $ENV{'AWS_DEFAULT_REGION'}
ABresult
1X1
011
000
355  
356 0 ▶ return $region
Branch: 1 branch
BranchTrueFalseTotal
if $region 0 0 0
357 if $region;
358  
359 0 my $url = $AWS_METADATA_BASE_URL . 'placement/availability-zone';
360  
361 0 my $request = HTTP::Request->new( 'GET', $url );
362  
363 0 my $ua = LWP::UserAgent->new;
364 0 $ua->timeout(0);
365  
366 0 my $response = eval { return $ua->request($request); };
367  
368 0 ▶ if ( $response && $response->is_success ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($response and $response->is_success) 0 0 0
Condition0%0/3
$response and $response->is_success
!ll&&!rl&&r
000
MC/DC0%0/2
$response and $response->is_success
$response $response->is_success
Truth table0%0/3
A and B
A= $responseB= $response->is_success
ABresult
0X0
100
111
369 0 ▶ if ( $response->content =~ /\A([[:lower:]]+[-][[:lower:]]+[-]\d+)/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($response->content =~ /\A([[:lower:]]+[-][[:lower:]]+[-]\d+)/msx) 0 0 0
370 0 $region = $1;
371 }
372 }
373  
374 0 ▶ return $region || $DEFAULT_REGION;
Condition0%0/3
$region || $Amazon::S3::DEFAULT_REGION
l!l&&r!l&&!r
000
MC/DC0%0/2
$region || $Amazon::S3::DEFAULT_REGION
$region $Amazon::S3::DEFAULT_REGION
Truth table0%0/3
A || B
A= $regionB= $Amazon::S3::DEFAULT_REGION
ABresult
1X1
011
000
375 }
376  
377 # Amazon::Credentials compatibility methods
378 ########################################################################
379 0 ▶sub get_aws_access_key_id {
Subroutine get_aws_access_key_id: not called CC=1 SCAR=6.9
Pod undocumented
380 ########################################################################
381 0 my ($self) = @_;
382  
383 0 return _decrypt( $self->aws_access_key_id );
384 }
385  
386 ########################################################################
387 0 ▶sub get_aws_secret_access_key {
Subroutine get_aws_secret_access_key: not called CC=1 SCAR=6.9
Pod undocumented
388 ########################################################################
389 0 my ($self) = @_;
390  
391 0 return _decrypt( $self->aws_secret_access_key );
392 }
393  
394 ########################################################################
395 0 ▶sub get_token {
Subroutine get_token: not called CC=1 SCAR=6.9
Pod undocumented
396 ########################################################################
397 0 my ($self) = @_;
398  
399 0 return _decrypt( $self->token );
400 }
401  
402 ########################################################################
403 24 ▶sub turn_on_special_retry {
Subroutine turn_on_special_retry: called CC=2 SCAR=10.1
Pod documented
404 ########################################################################
405 24 my ($self) = @_;
406  
407 return
408 24 ▶ if !$self->retry;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->retry 24 0 24
409  
410 # In the field we are seeing issue of Amazon returning with a 400
411 # code in the case of timeout. From AWS S3 logs: REST.PUT.PART
412 # Backups/2017-05-04/<account>.tar.gz "PUT
413 # /Backups<path>?partNumber=27&uploadId=<id> - HTTP/1.1" 400
414 # RequestTimeout 360 20971520 20478 - "-" "libwww-perl/6.15"
415 0 my $http_codes_hr = $self->ua->codes_to_determinate();
416 0 $http_codes_hr->{$HTTP_BAD_REQUEST} = $TRUE;
417  
418 0 return;
419 }
420  
421 ########################################################################
422 0 ▶sub turn_off_special_retry {
Subroutine turn_off_special_retry: not called CC=2 SCAR=17.9
Pod documented
423 ########################################################################
424 0 my ($self) = @_;
425  
426 return
427 0 ▶ if !$self->retry;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->retry 0 0 0
428  
429 # In the field we are seeing issue with Amazon returning a 400
430 # code in the case of timeout. From AWS S3 logs: REST.PUT.PART
431 # Backups/2017-05-04/<account>.tar.gz "PUT
432 # /Backups<path>?partNumber=27&uploadId=<id> - HTTP/1.1" 400
433 # RequestTimeout 360 20971520 20478 - "-" "libwww-perl/6.15"
434 0 my $http_codes_hr = $self->ua->codes_to_determinate();
435 0 delete $http_codes_hr->{$HTTP_BAD_REQUEST};
436  
437 0 return;
438 }
439  
440 ########################################################################
441 41 ▶sub region {
Subroutine region: called CC=5 SCAR=16.8
Pod documented
442 ########################################################################
443 41 my ( $self, @args ) = @_;
444  
445 41 ▶ if (@args) {
Branch: 1 branch
BranchTrueFalseTotal
if (@args) 25 16 41
446 25 $self->_region( $args[0] );
447 }
448  
449 0 ▶ $self->get_logger->debug( sub { return 'region: ' . ( $self->_region // $EMPTY ) } );
Subroutine __ANON__: not called CC=2 SCAR=14.0
Condition0%0/3
$self->_region // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$self->_region // $Amazon::S3::EMPTY
$self->_region $Amazon::S3::EMPTY
Truth table0%0/3
A // B
A= $self->_regionB= $Amazon::S3::EMPTY
ABresult
1X1
011
000
450  
451 41 ▶ if ( $self->_region ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_region) 41 0 41
452 41 my $host = $self->host;
453 0 ▶ $self->get_logger->debug( sub { return 'host: ' . $self->host } );
Subroutine __ANON__: not called CC=1 SCAR=1.2
454  
455 # only add region if host was not populated from endpoint_url
456 41 ▶ if ( !$self->endpoint_url && $host =~ /\As3[.](.*)?amazonaws/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $self->endpoint_url and $host =~ /\As3[.](.*)?amazonaws/msx) 39 2 41
Condition100%3/3
not $self->endpoint_url and $host =~ /\As3[.](.*)?amazonaws/msx
!ll&&!rl&&r
1139
MC/DC100%2/2
not $self->endpoint_url and $host =~ /\As3[.](.*)?amazonaws/msx
not $self->endpoint_url $host =~ /\As3[.](.*)?amazonaws/msx
Truth table100%3/3
not(A) and B
A= not $self->endpoint_urlB= $host =~ /\As3[.](.*)?amazonaws/msx
ABresult
0X0
100
111
457 39 $self->host( sprintf 's3.%s.amazonaws.com', $self->_region );
458 }
459 }
460  
461 41 return $self->_region;
462 }
463  
464 ########################################################################
465 0 ▶sub buckets {
Subroutine buckets: not called CC=8 SCAR=42.8
Pod documented
466 ########################################################################
467 0 my ( $self, $verify_region ) = @_;
468  
469 # The "default" region for Amazon is us-east-1
470 # This is the region to set it to for listing buckets
471 # You may need to reset the signer's endpoint to 'us-east-1'
472  
473 # temporarily cache signer
474 0 my $region = $self->_region;
475 0 my $bucket_list;
476  
477 0 $self->reset_signer_region($DEFAULT_REGION); # default region for buckets op
478  
479 0 my $r = $self->send_request(
480 { method => 'GET',
481 path => $EMPTY,
482 headers => {},
483 region => $DEFAULT_REGION,
484 },
485 );
486  
487 0 ▶ return $bucket_list
Branch: 1 branch
BranchTrueFalseTotal
if not $r or $self->errstr 0 0 0
Condition0%0/3
not $r or $self->errstr
l!l&&r!l&&!r
000
MC/DC0%0/2
not $r or $self->errstr
not $r $self->errstr
Truth table0%0/3
not(A) or B
A= not $rB= $self->errstr
ABresult
1X1
011
000
488 if !$r || $self->errstr;
489  
490 0 my $owner_id = $r->{Owner}{ID};
491 0 my $owner_displayname = $r->{Owner}{DisplayName};
492  
493 0 my @buckets;
494  
495 0 ▶ if ( ref $r->{Buckets} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $r->{"Buckets"}) 0 0 0
496 0 my $buckets = $r->{Buckets}{Bucket};
497  
498 0 ▶ if ( !ref $buckets || reftype($buckets) ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not ref $buckets or builtin::reftype($buckets) ne "ARRAY") 0 0 0
Condition0%0/3
not ref $buckets or builtin::reftype($buckets) ne "ARRAY"
l!l&&r!l&&!r
000
MC/DC0%0/2
not ref $buckets or builtin::reftype($buckets) ne "ARRAY"
not ref $buckets builtin::reftype($buckets) ne "ARRAY"
Truth table0%0/3
not(A) or B
A= not ref $bucketsB= builtin::reftype($buckets) ne "ARRAY"
ABresult
1X1
011
000
499 0 $buckets = [$buckets];
500 }
501  
502 0 foreach my $node ( @{$buckets} ) {
503 push @buckets,
504 Amazon::S3::Bucket->new(
505 { bucket => $node->{Name},
506 creation_date => $node->{CreationDate},
507 0 ▶ account => $self,
Condition0%0/3
$verify_region // $Amazon::S3::FALSE
l!l&&r!l&&!r
000
MC/DC0%0/2
$verify_region // $Amazon::S3::FALSE
$verify_region $Amazon::S3::FALSE
Truth table0%0/3
A // B
A= $verify_regionB= $Amazon::S3::FALSE
ABresult
1X1
011
000
508 buffer_size => $self->buffer_size,
509 verify_region => $verify_region // $FALSE,
510 },
511 );
512  
513 }
514 }
515  
516 0 $self->reset_signer_region($region); # restore original region
517  
518 0 $bucket_list = {
519 owner_id => $owner_id,
520 owner_displayname => $owner_displayname,
521 buckets => \@buckets,
522 };
523  
524 0 return $bucket_list;
525 }
526  
527 ########################################################################
528 0 ▶sub reset_signer_region {
Subroutine reset_signer_region: not called CC=5 SCAR=34.0
Pod undocumented
529 ########################################################################
530 0 my ( $self, $region ) = @_;
531  
532 # reset signer's region, if the region wasn't us-east-1...note this
533 # is probably not needed anymore since bucket operations now send
534 # the region of the bucket to the signer
535 0 ▶ if ( $self->cache_signer ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->cache_signer) { } 0 0 0
536 0 ▶ if ( $self->region && $self->region ne $DEFAULT_REGION ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->region and $self->region ne $Amazon::S3::DEFAULT_REGION) 0 0 0
Condition0%0/3
$self->region and $self->region ne $Amazon::S3::DEFAULT_REGION
!ll&&!rl&&r
000
MC/DC0%0/2
$self->region and $self->region ne $Amazon::S3::DEFAULT_REGION
$self->region $self->region ne $Amazon::S3::DEFAULT_REGION
Truth table0%0/3
A and B
A= $self->regionB= $self->region ne $Amazon::S3::DEFAULT_REGION
ABresult
0X0
100
111
537 0 ▶ if ( $self->signer->can('region') ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->signer->can("region")) 0 0 0
538 0 $self->signer->region($region);
539 }
540 }
541 }
542 else {
543 0 $self->region($region);
544 }
545  
546 0 return $self->region;
547 }
548  
549 ########################################################################
550 0 ▶sub add_bucket {
Subroutine add_bucket: not called CC=10 SCAR=47.0
Pod documented
551 ########################################################################
552 0 my ( $self, $conf ) = @_;
553  
554 0 my $bucket = $conf->{bucket};
555  
556 0 ▶ croak 'must specify bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket 0 0 0
557 if !$bucket;
558  
559 0 ▶ my $headers = $conf->{headers} // {};
Condition0%0/2
$conf->{"headers"} // {}
l!l
00
MC/DC0%0/1
$conf->{"headers"} // {}
$conf->{"headers"}
Truth table0%0/2
A
A= $conf->{"headers"}
Aresult
11
00
560  
561 0 ▶ if ( $conf->{acl_short} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($conf->{"acl_short"}) 0 0 0
562 0 $self->_validate_acl_short( $conf->{acl_short} );
563  
564 0 ▶ $headers->{'x-amz-acl'} //= $conf->{acl_short};
Condition0%0/3
$headers->{"x-amz-acl"} //= $conf->{"acl_short"}
l!l&&r!l&&!r
000
MC/DC0%0/2
$headers->{"x-amz-acl"} //= $conf->{"acl_short"}
$headers->{"x-amz-acl"} $conf->{"acl_short"}
Truth table0%0/3
A //= B
A= $headers->{"x-amz-acl"}B= $conf->{"acl_short"}
ABresult
1X1
011
000
565 0 ▶ $headers->{'x-amz-object-ownership'} //= 'ObjectWriter';
Condition0%0/2
$headers->{"x-amz-object-ownership"} //= "ObjectWriter"
l!l
00
MC/DC0%0/1
$headers->{"x-amz-object-ownership"} //= "ObjectWriter"
$headers->{"x-amz-object-ownership"}
Truth table0%0/2
A
A= $headers->{"x-amz-object-ownership"}
Aresult
11
00
566 }
567  
568 0 ▶ my $region = $conf->{location_constraint} // $conf->{region};
Condition0%0/3
$conf->{"location_constraint"} // $conf->{"region"}
l!l&&r!l&&!r
000
MC/DC0%0/2
$conf->{"location_constraint"} // $conf->{"region"}
$conf->{"location_constraint"} $conf->{"region"}
Truth table0%0/3
A // B
A= $conf->{"location_constraint"}B= $conf->{"region"}
ABresult
1X1
011
000
569  
570 0 ▶ $region //= $self->region;
Condition0%0/3
$region //= $self->region
l!l&&r!l&&!r
000
MC/DC0%0/2
$region //= $self->region
$region $self->region
Truth table0%0/3
A //= B
A= $regionB= $self->region
ABresult
1X1
011
000
571  
572 0 ▶ if ( $region && $region eq $DEFAULT_REGION ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($region and $region eq $Amazon::S3::DEFAULT_REGION) 0 0 0
Condition0%0/3
$region and $region eq $Amazon::S3::DEFAULT_REGION
!ll&&!rl&&r
000
MC/DC0%0/2
$region and $region eq $Amazon::S3::DEFAULT_REGION
$region $region eq $Amazon::S3::DEFAULT_REGION
Truth table0%0/3
A and B
A= $regionB= $region eq $Amazon::S3::DEFAULT_REGION
ABresult
0X0
100
111
573 0 undef $region;
574 }
575  
576 return $self->_add_bucket(
577 { headers => $headers,
578 bucket => $conf->{bucket},
579 region => $region,
580 availability_zone => $conf->{availability_zone},
581 }
582 0 );
583 }
584  
585 ########################################################################
586 0 ▶sub _add_bucket {
Subroutine _add_bucket: not called CC=7 SCAR=40.3
587 ########################################################################
588 0 my ( $self, @args ) = @_;
589  
590 0 my $parameters = get_parameters(@args);
591  
592 my ( $bucket, $headers, $region, $availability_zone )
593 0 = @{$parameters}{qw(bucket headers region availability_zone)};
594  
595 0 ▶ $region //= $EMPTY;
Condition0%0/3
$region //= $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$region //= $Amazon::S3::EMPTY
$region $Amazon::S3::EMPTY
Truth table0%0/3
A //= B
A= $regionB= $Amazon::S3::EMPTY
ABresult
1X1
011
000
596 0 ▶ $headers //= {};
Condition0%0/2
$headers //= {}
l!l
00
MC/DC0%0/1
$headers //= {}
$headers
Truth table0%0/2
A
A= $headers
Aresult
11
00
597  
598 0 my $request = { CreateBucketConfiguration => { LocationConstraint => $region, } };
599  
600 0 ▶ if ($availability_zone) {
Branch: 1 branch
BranchTrueFalseTotal
if ($availability_zone) 0 0 0
601 $request->{CreateBucketConfiguration}->{Location} = {
602 0 Name => $availability_zone,
603 Type => 'AvailabilityZone',
604 };
605  
606 $request->{CreateBucketConfiguration}->{Bucket} = {
607 0 DataRedundancy => 'SingleAvailabilityZone',
608 Type => 'Directory',
609 };
610  
611 0 delete $request->{CreateBucketConfiguration}->{LocationConstraint};
612 }
613  
614 0 $self->dns_bucket_names(0);
615  
616 0 ▶ my $data
Branch: 1 branch
BranchTrueFalseTotal
$region || $availability_zone ? : 0 0 0
Condition0%0/3
$region or $availability_zone
l!l&&r!l&&!r
000
MC/DC0%0/2
$region or $availability_zone
$region $availability_zone
Truth table0%0/3
A or B
A= $regionB= $availability_zone
ABresult
1X1
011
000
617 = ( $region || $availability_zone )
618 ? create_xml_request($request)
619 : $EMPTY;
620  
621 0 $headers->{'Content-Length'} = length $data;
622  
623 0 my $retval = $self->send_request_expect_nothing(
624 { method => 'PUT',
625 path => "$bucket/",
626 headers => $headers,
627 data => $data,
628 region => $region,
629 },
630 );
631  
632 0 ▶ my $bucket_obj = $retval ? $self->bucket($bucket) : undef;
Branch: 1 branch
BranchTrueFalseTotal
$retval ? : 0 0 0
633  
634 0 return $bucket_obj;
635 }
636  
637 ########################################################################
638 13 ▶sub bucket {
Subroutine bucket: called CC=5 SCAR=19.3
Pod documented
639 ########################################################################
640 13 my ( $self, @args ) = @_;
641  
642 13 my ( $bucketname, $region, $verify_region );
643  
644 13 ▶ if ( ref $args[0] && reftype( $args[0] ) eq 'HASH' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $args[0] and builtin::reftype($args[0]) eq 'HASH') { } 0 13 13
Condition33%1/3
ref $args[0] and builtin::reftype($args[0]) eq "HASH"
!ll&&!rl&&r
1300
MC/DC0%0/2
ref $args[0] and builtin::reftype($args[0]) eq "HASH"
ref $args[0] builtin::reftype($args[0]) eq "HASH"
Truth table33%1/3
A and B
A= ref $args[0]B= builtin::reftype($args[0]) eq "HASH"
ABresult
0X0
100
111
645 ( $bucketname, $region, $verify_region )
646 0 = @{ $args[0] }{qw(bucket region verify_region)};
647 }
648 else {
649 13 ( $bucketname, $region ) = @args;
650 }
651  
652 # only set to default region if a region wasn't passed or region
653 # verification not requested
654 13 ▶ if ( !$region && !$verify_region ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($region or $verify_region) 13 0 13
Condition33%1/3
$region or $verify_region
l!l&&r!l&&!r
0013
MC/DC0%0/2
$region or $verify_region
$region $verify_region
Truth table33%1/3
A or B
A= $regionB= $verify_region
ABresult
1X1
011
000
655 13 $region = $self->region;
656 }
657  
658 13 return Amazon::S3::Bucket->new(
659 { bucket => $bucketname,
660 account => $self,
661 region => $region,
662 verify_region => $verify_region,
663 },
664 );
665 }
666  
667 ########################################################################
668 0 ▶sub delete_bucket {
Subroutine delete_bucket: not called CC=5 SCAR=34.0
Pod documented
669 ########################################################################
670 0 my ( $self, $conf ) = @_;
671  
672 0 my $bucket;
673 my $region;
674 0 my $headers;
675  
676 0 ▶ if ( eval { return $conf->isa('Amazon::S3::Bucket'); } ) {
Branch: 1 branch
BranchTrueFalseTotal
if (eval { do { return $conf->isa('Amazon::S3::Bucket') } }) { } 0 0 0
677 0 $bucket = $conf->bucket;
678 0 $region = $conf->region;
679 }
680 else {
681 0 $bucket = $conf->{bucket};
682 0 ▶ $region = $conf->{region} || $self->get_bucket_location($bucket);
Condition0%0/3
$conf->{'region'} || $self->get_bucket_location($bucket)
l!l&&r!l&&!r
000
MC/DC0%0/2
$conf->{'region'} || $self->get_bucket_location($bucket)
$conf->{'region'} $self->get_bucket_location($bucket)
Truth table0%0/3
A || B
A= $conf->{'region'}B= $self->get_bucket_location($bucket)
ABresult
1X1
011
000
683 0 $headers = $conf->{headers};
684 }
685  
686 0 ▶ croak 'must specify bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket 0 0 0
687 if !$bucket;
688  
689 0 ▶ return $self->send_request_expect_nothing(
Condition0%0/2
$headers // {}
l!l
00
MC/DC0%0/1
$headers // {}
$headers
Truth table0%0/2
A
A= $headers
Aresult
11
00
690 { method => 'DELETE',
691 path => $bucket . $SLASH,
692 headers => $headers // {},
693 region => $region,
694 },
695 );
696 }
697  
698 ########################################################################
699 0 ▶sub list_directory_buckets {
Subroutine list_directory_buckets: not called CC=2 SCAR=17.9
Pod documented
700 ########################################################################
701 0 my ( $self, @args ) = @_;
702  
703 0 my $parameters = get_parameters(@args);
704  
705 0 my $express = $self->use_express_one_zone;
706  
707 my $result = $self->send_request(
708 { method => 'GET',
709 headers => {},
710 path => $SLASH,
711 uri_params => $parameters->{uri_params} // {},
712 0 ▶ region => $self->region,
Condition0%0/2
$parameters->{"uri_params"} // {}
l!l
00
MC/DC0%0/1
$parameters->{"uri_params"} // {}
$parameters->{"uri_params"}
Truth table0%0/2
A
A= $parameters->{"uri_params"}
Aresult
11
00
713 }
714 );
715  
716 0 $self->express($express);
717  
718 0 return $result;
719 }
720  
721 ########################################################################
722 0 ▶sub list_bucket_v2 {
Subroutine list_bucket_v2: not called CC=1 SCAR=6.9
Pod documented
723 ########################################################################
724 0 my ( $self, $conf ) = @_;
725  
726 0 $conf->{'list-type'} = '2';
727  
728 0 goto &list_bucket;
729 }
730  
731 ########################################################################
732 0 ▶sub list_bucket {
Subroutine list_bucket: not called CC=24 SCAR=64.0
Pod documented
733 ########################################################################
734 0 my ( $self, $conf ) = @_;
735  
736 0 my $bucket = delete $conf->{bucket};
737  
738 0 ▶ croak 'must specify bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket 0 0 0
739 if !$bucket;
740  
741 0 ▶ $conf //= {};
Condition0%0/2
$conf //= {}
l!l
00
MC/DC0%0/1
$conf //= {}
$conf
Truth table0%0/2
A
A= $conf
Aresult
11
00
742  
743 0 my $bucket_list; # return this
744 0 my $path = $bucket . $SLASH;
745  
746 0 my $headers = delete $conf->{headers};
747  
748 0 ▶ my $list_type = $conf->{'list-type'} // '1';
Condition0%0/2
$conf->{"list-type"} // 1
l!l
00
MC/DC0%0/1
$conf->{"list-type"} // 1
$conf->{"list-type"}
Truth table0%0/2
A
A= $conf->{"list-type"}
Aresult
11
00
749  
750 my ( $marker, $next_marker, $query_next )
751 0 = @{ $LIST_OBJECT_MARKERS{$list_type} };
752  
753 0 ▶ if ( $conf->{marker} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($conf->{"marker"}) 0 0 0
754 0 $conf->{$query_next} = delete $conf->{marker};
755 }
756  
757 0 ▶ if ( %{$conf} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (%{$conf;}) 0 0 0
758  
759 0 my @vars = keys %{$conf};
760  
761 # remove undefined elements
762 0 foreach (@vars) {
763 0 ▶ next if defined $conf->{$_};
Branch: 1 branch
BranchTrueFalseTotal
if defined $conf->{$_} 0 0 0
764  
765 0 delete $conf->{$_};
766 }
767  
768 0 my $query_string = $QUESTION_MARK . join $AMPERSAND, map { $_ . $EQUAL_SIGN . urlencode( $conf->{$_} ) }
769 0 keys %{$conf};
770  
771 0 $path .= $query_string;
772 }
773  
774 0 $self->get_logger->debug( sprintf 'PATH: %s', $path );
775  
776 0 ▶ my $r = $self->send_request(
Condition0%0/2
$headers // {}
l!l
00
MC/DC0%0/1
$headers // {}
$headers
Truth table0%0/2
A
A= $headers
Aresult
11
00
777 { method => 'GET',
778 path => $path,
779 headers => $headers // {}, # { 'Content-Length' => 0 },
780 region => $self->region,
781 },
782 );
783  
784 0 $self->get_logger->trace(
785 Dumper(
786 [ r => $r,
787 errstr => $self->errstr,
788 ]
789 )
790 );
791  
792 0 ▶ return $bucket_list
Branch: 1 branch
BranchTrueFalseTotal
if not $r or $self->errstr 0 0 0
Condition0%0/3
not $r or $self->errstr
l!l&&r!l&&!r
000
MC/DC0%0/2
not $r or $self->errstr
not $r $self->errstr
Truth table0%0/3
not(A) or B
A= not $rB= $self->errstr
ABresult
1X1
011
000
793 if !$r || $self->errstr;
794  
795 $self->get_logger->trace(
796 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
797 0 return Dumper(
798 [ marker => $marker,
799 next_marker => $next_marker,
800 response => $r,
801 ],
802 );
803 },
804 0 );
805  
806 $bucket_list = {
807 bucket => $r->{Name},
808 prefix => $r->{Prefix} // $EMPTY,
809 marker => $r->{$marker} // $EMPTY,
810 next_marker => $r->{$next_marker} // $EMPTY,
811 max_keys => $r->{MaxKeys},
812 is_truncated => (
813 0 ▶ ( defined $r->{IsTruncated} && scalar $r->{IsTruncated} eq 'true' )
Branch: 1 branch
BranchTrueFalseTotal
defined $r->{'IsTruncated'} && scalar $r->{'IsTruncated'} eq 'true' ? : 0 0 0
Condition0%0/12
$r->{"Prefix"} // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
$r->{$marker} // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
$r->{$next_marker} // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
defined $r->{"IsTruncated"} and scalar $r->{"IsTruncated"} eq "true"
!ll&&!rl&&r
000
MC/DC0%0/2
$r->{"Prefix"} // $Amazon::S3::EMPTY
$r->{"Prefix"} $Amazon::S3::EMPTY
MC/DC0%0/2
$r->{$marker} // $Amazon::S3::EMPTY
$r->{$marker} $Amazon::S3::EMPTY
MC/DC0%0/2
$r->{$next_marker} // $Amazon::S3::EMPTY
$r->{$next_marker} $Amazon::S3::EMPTY
MC/DC0%0/2
defined $r->{"IsTruncated"} and scalar $r->{"IsTruncated"} eq "true"
defined $r->{"IsTruncated"} scalar $r->{"IsTruncated"} eq "true"
Truth table0%0/3
A // B
A= $r->{"Prefix"}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
Truth table0%0/3
A // B
A= $r->{$marker}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
Truth table0%0/3
A // B
A= $r->{$next_marker}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
Truth table0%0/3
A and B
A= defined $r->{"IsTruncated"}B= scalar $r->{"IsTruncated"} eq "true"
ABresult
0X0
100
111
814 ? $TRUE
815 : $FALSE
816 ),
817 };
818  
819 0 my @keys;
820  
821 0 foreach my $node ( @{ $r->{Contents} } ) {
822 0 my $etag = $node->{ETag};
823  
824 0 ▶ if ( defined $etag ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $etag) 0 0 0
825 0 $etag =~ s{(^"|"$)}{}gxsm;
826 }
827  
828 push @keys,
829 {
830 key => $node->{Key},
831 last_modified => $node->{LastModified},
832 etag => $etag,
833 size => $node->{Size},
834 storage_class => $node->{StorageClass},
835 owner_id => $node->{Owner}{ID},
836 owner_displayname => $node->{Owner}{DisplayName},
837 0 };
838 }
839  
840 0 $bucket_list->{keys} = \@keys;
841  
842 0 ▶ if ( $conf->{delimiter} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($conf->{"delimiter"}) 0 0 0
843 0 my @common_prefixes;
844 0 my $strip_delim = qr/$conf->{delimiter}$/xsm;
845  
846 0 foreach my $node ( $r->{CommonPrefixes} ) {
847 0 ▶ if ( ref $node ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $node ne "ARRAY") 0 0 0
848 0 $node = [$node];
849 }
850  
851 0 foreach my $n ( @{$node} ) {
852 0 ▶ next if !exists $n->{Prefix};
Branch: 1 branch
BranchTrueFalseTotal
unless exists $n->{"Prefix"} 0 0 0
853 0 my $prefix = $n->{Prefix};
854  
855 # strip delimiter from end of prefix
856 0 ▶ if ($prefix) {
Branch: 1 branch
BranchTrueFalseTotal
if ($prefix) 0 0 0
857 0 $prefix =~ s/$strip_delim//xsm;
858 }
859  
860 0 push @common_prefixes, $prefix;
861 }
862 }
863  
864 0 $bucket_list->{common_prefixes} = \@common_prefixes;
865 }
866  
867 0 $self->get_logger->trace( Dumper( [ bucket_list => $bucket_list ] ) );
868  
869 0 return $bucket_list;
870 }
871  
872 ########################################################################
873 0 ▶sub list_bucket_all_v2 {
Subroutine list_bucket_all_v2: not called CC=2 SCAR=17.9
Pod documented
874 ########################################################################
875 0 my ( $self, $conf ) = @_;
876 0 ▶ $conf ||= {};
Condition0%0/2
$conf ||= {}
l!l
00
MC/DC0%0/1
$conf ||= {}
$conf
Truth table0%0/2
A
A= $conf
Aresult
11
00
877  
878 0 $conf->{'list-type'} = '2';
879  
880 0 return $self->list_bucket_all($conf);
881 }
882  
883 ########################################################################
884 0 ▶sub empty_bucket {
Subroutine empty_bucket: not called CC=41 SCAR=74.5
Pod documented
885 ########################################################################
886 0 my ( $self, $bucket_name, $options ) = @_;
887  
888 0 ▶ croak 'must specify bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket_name 0 0 0
889 if !$bucket_name;
890  
891 0 ▶ $options //= {};
Condition0%0/2
$options //= {}
l!l
00
MC/DC0%0/1
$options //= {}
$options
Truth table0%0/2
A
A= $options
Aresult
11
00
892  
893 0 my $headers = $options->{headers};
894 0 my $report = $options->{report};
895  
896 0 ▶ croak 'report must be a code reference'
Branch: 1 branch
BranchTrueFalseTotal
if defined $report and !ref($report) || builtin::reftype($report) ne "CODE" 0 0 0
Condition0%0/6
defined $report and !ref($report) || builtin::reftype($report) ne "CODE"
!ll&&!rl&&r
000
not ref $report or builtin::reftype($report) ne "CODE"
l!l&&r!l&&!r
000
MC/DC0%0/3
defined $report and !ref($report) || builtin::reftype($report) ne "CODE"
defined $report not ref $report builtin::reftype($report) ne "CODE"
Truth table0%0/4
A and not(B) or C
A= defined $reportB= not ref $reportC= builtin::reftype($report) ne "CODE"
ABCresult
0XX0
1000
11X1
1011
897 if defined $report && ( !ref $report || reftype($report) ne 'CODE' );
898  
899 0 my $bucket = $self->bucketv2( bucket => $bucket_name );
900  
901 0 my $raise_error = $self->raise_error;
902  
903 0 my $result = {
904 versions_deleted => 0,
905 delete_markers_deleted => 0,
906 multipart_uploads_aborted => 0,
907 total => 0,
908 };
909  
910 0 $self->raise_error($TRUE);
911  
912 0 eval {
913  
914 # Delete object versions and delete markers.
915 0 ▶ while ($TRUE) {
Branch: 1 branch
BranchTrueFalseTotal
if ($Amazon::S3::TRUE) 0 0 0
916 0 my $response = $bucket->ListObjectVersions(
917 headers => $headers,
918 uri_param => { 'max-keys' => 1000, },
919 );
920  
921 0 ▶ my $versions = $response->{Version} // [];
Condition0%0/2
$response->{"Version"} // []
l!l
00
MC/DC0%0/1
$response->{"Version"} // []
$response->{"Version"}
Truth table0%0/2
A
A= $response->{"Version"}
Aresult
11
00
922 0 ▶ my $markers = $response->{DeleteMarker} // [];
Condition0%0/2
$response->{"DeleteMarker"} // []
l!l
00
MC/DC0%0/1
$response->{"DeleteMarker"} // []
$response->{"DeleteMarker"}
Truth table0%0/2
A
A= $response->{"DeleteMarker"}
Aresult
11
00
923  
924 0 ▶ if ( ref $versions && reftype($versions) ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $versions and builtin::reftype($versions) ne "ARRAY") 0 0 0
Condition0%0/3
ref $versions and builtin::reftype($versions) ne "ARRAY"
!ll&&!rl&&r
000
MC/DC0%0/2
ref $versions and builtin::reftype($versions) ne "ARRAY"
ref $versions builtin::reftype($versions) ne "ARRAY"
Truth table0%0/3
A and B
A= ref $versionsB= builtin::reftype($versions) ne "ARRAY"
ABresult
0X0
100
111
925 0 $versions = [$versions];
926 }
927  
928 0 ▶ if ( ref $markers && reftype($markers) ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $markers and builtin::reftype($markers) ne "ARRAY") 0 0 0
Condition0%0/3
ref $markers and builtin::reftype($markers) ne "ARRAY"
!ll&&!rl&&r
000
MC/DC0%0/2
ref $markers and builtin::reftype($markers) ne "ARRAY"
ref $markers builtin::reftype($markers) ne "ARRAY"
Truth table0%0/3
A and B
A= ref $markersB= builtin::reftype($markers) ne "ARRAY"
ABresult
0X0
100
111
929 0 $markers = [$markers];
930 }
931  
932 0 my @objects;
933 my %object_type;
934  
935 0 foreach my $version ( @{$versions} ) {
936 my $object = {
937 Key => $version->{Key},
938 VersionId => $version->{VersionId},
939 0 };
940  
941 0 push @objects, $object;
942  
943 0 my $id = join "\0", $object->{Key}, $object->{VersionId};
944 0 $object_type{$id} = 'version';
945 }
946  
947 0 foreach my $marker ( @{$markers} ) {
948 my $object = {
949 Key => $marker->{Key},
950 VersionId => $marker->{VersionId},
951 0 };
952  
953 0 push @objects, $object;
954  
955 0 my $id = join "\0", $object->{Key}, $object->{VersionId};
956 0 $object_type{$id} = 'delete_marker';
957 }
958  
959 last
960 0 ▶ if !@objects;
Branch: 1 branch
BranchTrueFalseTotal
unless @objects 0 0 0
961  
962 0 my $delete_response = $bucket->DeleteObjects(
963 headers => $headers,
964 body => { Delete => { Object => \@objects, }, },
965 );
966  
967 0 ▶ my $deleted = $delete_response->{Deleted} // [];
Condition0%0/2
$delete_response->{"Deleted"} // []
l!l
00
MC/DC0%0/1
$delete_response->{"Deleted"} // []
$delete_response->{"Deleted"}
Truth table0%0/2
A
A= $delete_response->{"Deleted"}
Aresult
11
00
968 0 ▶ my $errors = $delete_response->{Error} // [];
Condition0%0/2
$delete_response->{"Error"} // []
l!l
00
MC/DC0%0/1
$delete_response->{"Error"} // []
$delete_response->{"Error"}
Truth table0%0/2
A
A= $delete_response->{"Error"}
Aresult
11
00
969  
970 0 ▶ if ( ref $deleted && reftype($deleted) ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $deleted and builtin::reftype($deleted) ne "ARRAY") 0 0 0
Condition0%0/3
ref $deleted and builtin::reftype($deleted) ne "ARRAY"
!ll&&!rl&&r
000
MC/DC0%0/2
ref $deleted and builtin::reftype($deleted) ne "ARRAY"
ref $deleted builtin::reftype($deleted) ne "ARRAY"
Truth table0%0/3
A and B
A= ref $deletedB= builtin::reftype($deleted) ne "ARRAY"
ABresult
0X0
100
111
971 0 $deleted = [$deleted];
972 }
973  
974 0 ▶ if ( ref $errors && reftype($errors) ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $errors and builtin::reftype($errors) ne "ARRAY") 0 0 0
Condition0%0/3
ref $errors and builtin::reftype($errors) ne "ARRAY"
!ll&&!rl&&r
000
MC/DC0%0/2
ref $errors and builtin::reftype($errors) ne "ARRAY"
ref $errors builtin::reftype($errors) ne "ARRAY"
Truth table0%0/3
A and B
A= ref $errorsB= builtin::reftype($errors) ne "ARRAY"
ABresult
0X0
100
111
975 0 $errors = [$errors];
976 }
977  
978 0 my %failed;
979  
980 0 foreach my $error ( @{$errors} ) {
981 0 ▶ my $id = join "\0", $error->{Key}, $error->{VersionId} // $EMPTY;
Condition0%0/3
$error->{"VersionId"} // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$error->{"VersionId"} // $Amazon::S3::EMPTY
$error->{"VersionId"} $Amazon::S3::EMPTY
Truth table0%0/3
A // B
A= $error->{"VersionId"}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
982  
983 0 $failed{$id} = $TRUE;
984 }
985  
986 0 foreach my $object (@objects) {
987 0 my $id = join "\0", $object->{Key}, $object->{VersionId};
988  
989 0 ▶ next if $failed{$id};
Branch: 1 branch
BranchTrueFalseTotal
if $failed{$id} 0 0 0
990  
991 0 my $type = $object_type{$id};
992  
993 0 ▶ if ( $type eq 'version' ) {
Branch: 2 branches
BranchTrueFalseTotal
if ($type eq 'version') { } 0 0 0
elsif ($type eq 'delete_marker') { } 0 0 0
994 0 ++$result->{versions_deleted};
995 }
996 elsif ( $type eq 'delete_marker' ) {
997 0 ++$result->{delete_markers_deleted};
998 }
999  
1000 0 ++$result->{total};
1001  
1002 0 ▶ if ($report) {
Branch: 1 branch
BranchTrueFalseTotal
if ($report) 0 0 0
1003 $report->(
1004 { type => $type,
1005 key => $object->{Key},
1006 version_id => $object->{VersionId},
1007 }
1008 0 );
1009 }
1010 }
1011  
1012 0 ▶ if ( @{$errors} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (@{$errors;}) 0 0 0
1013 0 my $error = $errors->[0];
1014  
1015 croak sprintf 'failed to delete %s version %s: %s - %s',
1016 $error->{Key},
1017 $error->{VersionId} // $EMPTY,
1018 $error->{Code} // 'unknown error',
1019 0 ▶ $error->{Message} // $EMPTY;
Condition0%0/8
$error->{"VersionId"} // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
$error->{"Code"} // "unknown error"
l!l
00
$error->{"Message"} // $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$error->{"VersionId"} // $Amazon::S3::EMPTY
$error->{"VersionId"} $Amazon::S3::EMPTY
MC/DC0%0/1
$error->{"Code"} // "unknown error"
$error->{"Code"}
MC/DC0%0/2
$error->{"Message"} // $Amazon::S3::EMPTY
$error->{"Message"} $Amazon::S3::EMPTY
Truth table0%0/3
A // B
A= $error->{"VersionId"}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
Truth table0%0/2
A
A= $error->{"Code"}
Aresult
11
00
Truth table0%0/3
A // B
A= $error->{"Message"}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
1020 }
1021 }
1022  
1023 # Abort incomplete multipart uploads.
1024 0 ▶ while ($TRUE) {
Branch: 1 branch
BranchTrueFalseTotal
if ($Amazon::S3::TRUE) 0 0 0
1025 0 my $response = $bucket->ListMultipartUploads(
1026 headers => $headers,
1027 uri_param => { 'max-uploads' => 1000, },
1028 );
1029  
1030 0 ▶ my $uploads = $response->{Upload} // [];
Condition0%0/2
$response->{"Upload"} // []
l!l
00
MC/DC0%0/1
$response->{"Upload"} // []
$response->{"Upload"}
Truth table0%0/2
A
A= $response->{"Upload"}
Aresult
11
00
1031  
1032 0 ▶ if ( ref $uploads && reftype($uploads) ne 'ARRAY' ) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $uploads and builtin::reftype($uploads) ne "ARRAY") 0 0 0
Condition0%0/3
ref $uploads and builtin::reftype($uploads) ne "ARRAY"
!ll&&!rl&&r
000
MC/DC0%0/2
ref $uploads and builtin::reftype($uploads) ne "ARRAY"
ref $uploads builtin::reftype($uploads) ne "ARRAY"
Truth table0%0/3
A and B
A= ref $uploadsB= builtin::reftype($uploads) ne "ARRAY"
ABresult
0X0
100
111
1033 0 $uploads = [$uploads];
1034 }
1035  
1036 last
1037 0 ▶ if !@{$uploads};
Branch: 1 branch
BranchTrueFalseTotal
unless @{$uploads;} 0 0 0
1038  
1039 0 foreach my $upload ( @{$uploads} ) {
1040 $bucket->AbortMultipartUpload(
1041 key => $upload->{Key},
1042 headers => $headers,
1043 uri_param => { uploadId => $upload->{UploadId}, },
1044 0 );
1045  
1046 0 ++$result->{multipart_uploads_aborted};
1047 0 ++$result->{total};
1048  
1049 0 ▶ if ($report) {
Branch: 1 branch
BranchTrueFalseTotal
if ($report) 0 0 0
1050 $report->(
1051 { type => 'multipart_upload',
1052 key => $upload->{Key},
1053 upload_id => $upload->{UploadId},
1054 }
1055 0 );
1056 }
1057 }
1058 }
1059  
1060 0 return $TRUE;
1061 };
1062  
1063 0 my $error = $EVAL_ERROR;
1064  
1065 0 $self->raise_error($raise_error);
1066  
1067 0 ▶ if ($error) {
Branch: 1 branch
BranchTrueFalseTotal
if ($error) 0 0 0
1068 0 chomp $error;
1069  
1070 0 die sprintf "%s\n%d items removed\n", $error, $result->{total};
1071 }
1072  
1073 0 return $result;
1074 }
1075  
1076 ########################################################################
1077 0 ▶sub list_bucket_all {
Subroutine list_bucket_all: not called CC=9 SCAR=45.0
Pod documented
1078 ########################################################################
1079 0 my ( $self, $conf ) = @_;
1080 0 ▶ $conf ||= {};
Condition0%0/2
$conf ||= {}
l!l
00
MC/DC0%0/1
$conf ||= {}
$conf
Truth table0%0/2
A
A= $conf
Aresult
11
00
1081  
1082 0 my $bucket_name = $conf->{bucket};
1083  
1084 0 ▶ croak 'must specify bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket_name 0 0 0
1085 if !$bucket_name;
1086  
1087 0 my $response = $self->list_bucket($conf);
1088  
1089 0 ▶ croak $EVAL_ERROR
Branch: 1 branch
BranchTrueFalseTotal
unless $response 0 0 0
1090 if !$response;
1091  
1092 return $response
1093 0 ▶ if !$response->{is_truncated};
Branch: 1 branch
BranchTrueFalseTotal
unless $response->{"is_truncated"} 0 0 0
1094  
1095 0 my $all = $response;
1096  
1097 0 ▶ while ($TRUE) {
Branch: 1 branch
BranchTrueFalseTotal
if ($Amazon::S3::TRUE) 0 0 0
1098 my $next_marker = $response->{next_marker}
1099 0 ▶ || $response->{keys}->[-1]->{key};
Condition0%0/3
$response->{'next_marker'} || $response->{'keys'}[-1]{'key'}
l!l&&r!l&&!r
000
MC/DC0%0/2
$response->{'next_marker'} || $response->{'keys'}[-1]{'key'}
$response->{'next_marker'} $response->{'keys'}[-1]{'key'}
Truth table0%0/3
A || B
A= $response->{'next_marker'}B= $response->{'keys'}[-1]{'key'}
ABresult
1X1
011
000
1100  
1101 0 $conf->{marker} = $next_marker;
1102 0 $conf->{bucket} = $bucket_name;
1103  
1104 0 $response = $self->list_bucket($conf);
1105  
1106 0 ▶ croak $EVAL_ERROR
Branch: 1 branch
BranchTrueFalseTotal
unless $response 0 0 0
1107 if !$response;
1108  
1109 0 push @{ $all->{keys} }, @{ $response->{keys} };
1110  
1111 0 ▶ last if !$response->{is_truncated};
Branch: 1 branch
BranchTrueFalseTotal
unless $response->{"is_truncated"} 0 0 0
1112 }
1113  
1114 0 delete $all->{is_truncated};
1115 0 delete $all->{next_marker};
1116  
1117 0 return $all;
1118 }
1119  
1120 ########################################################################
1121 # API: ListObjectVersions
1122 #########################################################################
1123 # Documentation:
1124 # https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectVersions.html
1125 #
1126 # Request:
1127 # GET /?versions
1128 # HOST: Bucket.s3.amazonaws.com
1129 # x-amz-expected-bucket-owner: ExpectedBucketOwner
1130 # x-amz-request-payer: RequestPayer
1131 # x-amz-optional-object-attributes: OptionalObjectAtttributes
1132 #
1133 # Parameters:
1134 # delimiter => Delimiter
1135 # encoding-type => EncodingType
1136 # key-marker => KeyMarker
1137 # max-keys => MaxKeys
1138 # prefix => Prefix
1139 # version-id-marker => VersionIdMarker
1140 #
1141 # Response
1142  
1143 ########################################################################
1144 0 ▶sub list_object_versions {
Subroutine list_object_versions: not called CC=11 SCAR=48.8
Pod documented
1145 ########################################################################
1146 0 my ( $self, $conf ) = @_;
1147  
1148 0 my $bucket = delete $conf->{bucket};
1149  
1150 0 ▶ die 'no bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket 0 0 0
1151 if !$bucket;
1152  
1153 0 my $headers = delete $conf->{headers};
1154  
1155 0 ▶ croak 'must specify bucket'
Branch: 1 branch
BranchTrueFalseTotal
unless $bucket 0 0 0
1156 if !$bucket;
1157  
1158 0 ▶ $conf ||= {};
Condition0%0/2
$conf ||= {}
l!l
00
MC/DC0%0/1
$conf ||= {}
$conf
Truth table0%0/2
A
A= $conf
Aresult
11
00
1159  
1160 my ( $marker, $next_marker, $query_next )
1161 0 = @{ $LIST_OBJECT_MARKERS{'3'} };
1162  
1163 0 ▶ if ( $conf->{'key-marker'} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($conf->{"key-marker"}) 0 0 0
1164 0 $conf->{$query_next} = delete $conf->{'key-marker'};
1165 }
1166  
1167 0 ▶ if ( %{$conf} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (%{$conf;}) 0 0 0
1168  
1169 # remove undefined elements
1170 0 foreach ( keys %{$conf} ) {
1171 0 ▶ next if defined $conf->{$_};
Branch: 1 branch
BranchTrueFalseTotal
if defined $conf->{$_} 0 0 0
1172  
1173 0 delete $conf->{$_};
1174 }
1175 }
1176  
1177 0 my $path = create_api_uri( path => "$bucket/", api => 'versions', %{$conf} );
1178  
1179 0 ▶ my $r = $self->send_request(
Condition0%0/2
$headers // {}
l!l
00
MC/DC0%0/1
$headers // {}
$headers
Truth table0%0/2
A
A= $headers
Aresult
11
00
1180 { method => 'GET',
1181 path => $path,
1182 headers => $headers // {},
1183 region => $self->region,
1184 },
1185 );
1186  
1187 return
1188 0 ▶ if !$r || $self->errstr;
Branch: 1 branch
BranchTrueFalseTotal
if not $r or $self->errstr 0 0 0
Condition0%0/3
not $r or $self->errstr
l!l&&r!l&&!r
000
MC/DC0%0/2
not $r or $self->errstr
not $r $self->errstr
Truth table0%0/3
not(A) or B
A= not $rB= $self->errstr
ABresult
1X1
011
000
1189  
1190 $self->get_logger->debug(
1191 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1192 0 return Dumper(
1193 [ marker => $marker,
1194 next_marker => $next_marker,
1195 response => $r,
1196 ],
1197 );
1198 },
1199 0 );
1200  
1201 0 return $r;
1202 }
1203  
1204 ########################################################################
1205 0 ▶sub get_credentials {
Subroutine get_credentials: not called CC=2 SCAR=17.9
Pod documented
1206 ########################################################################
1207 0 my ($self) = @_;
1208  
1209 0 my $aws_access_key_id;
1210 my $aws_secret_access_key;
1211 0 my $token;
1212  
1213 0 ▶ if ( $self->credentials ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->credentials) { } 0 0 0
1214 0 $aws_access_key_id = $self->credentials->get_aws_access_key_id;
1215 0 $aws_secret_access_key = $self->credentials->get_aws_secret_access_key;
1216 0 $token = $self->credentials->get_token;
1217 }
1218 else {
1219 0 $aws_access_key_id = $self->aws_access_key_id;
1220 0 $aws_secret_access_key = $self->aws_secret_access_key;
1221 0 $token = $self->token;
1222 }
1223  
1224 0 return ( $aws_access_key_id, $aws_secret_access_key, $token );
1225 }
1226  
1227 # Log::Log4perl compatibility routines
1228 ########################################################################
1229 208 ▶sub get_logger {
Subroutine get_logger: called CC=1 SCAR=0.0
Pod documented
1230 ########################################################################
1231 208 my ($self) = @_;
1232  
1233 208 return $self->logger;
1234 }
1235  
1236 ########################################################################
1237 17 ▶sub level {
Subroutine level: called CC=2 SCAR=6.9
Pod documented
1238 ########################################################################
1239 17 my ( $self, @args ) = @_;
1240  
1241 17 ▶ if (@args) {
Branch: 1 branch
BranchTrueFalseTotal
if (@args) 6 11 17
1242 6 $self->log_level( $args[0] );
1243  
1244 6 $self->get_logger->level( uc $args[0] );
1245 }
1246  
1247 17 return $self->get_logger->level;
1248 }
1249  
1250 ########################################################################
1251 0 ▶sub signer {
Subroutine signer: not called CC=6 SCAR=37.4
Pod documented
1252 ########################################################################
1253 0 my ($self) = @_;
1254  
1255 0 ▶ return $self->_signer
Branch: 1 branch
BranchTrueFalseTotal
if $self->_signer 0 0 0
1256 if $self->_signer;
1257  
1258 0 ▶ my $creds = $self->credentials ? $self->credentials : $self;
Branch: 1 branch
BranchTrueFalseTotal
$self->credentials ? : 0 0 0
1259 0 my $express = $self->express;
1260  
1261 0 ▶ my $signer = Amazon::S3::Signature::V4->new(
Branch: 1 branch
BranchTrueFalseTotal
$express ? : 0 0 0
Condition0%0/3
$self->region || $self->get_default_region
l!l&&r!l&&!r
000
MC/DC0%0/2
$self->region || $self->get_default_region
$self->region $self->get_default_region
Truth table0%0/3
A || B
A= $self->regionB= $self->get_default_region
ABresult
1X1
011
000
1262 { access_key_id => $creds->get_aws_access_key_id,
1263 secret => $creds->get_aws_secret_access_key,
1264 region => $self->region || $self->get_default_region,
1265 service => $express ? 's3express' : 's3',
1266 security_token => $creds->get_token,
1267 },
1268 );
1269  
1270 0 ▶ if ( $self->cache_signer ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->cache_signer) 0 0 0
1271 0 $self->_signer($signer);
1272 }
1273  
1274 0 return $signer;
1275 }
1276  
1277 ########################################################################
1278 0 ▶sub _validate_acl_short {
Subroutine _validate_acl_short: not called CC=2 SCAR=17.9
1279 ########################################################################
1280 0 my ( $self, $policy_name ) = @_;
1281  
1282 croak sprintf '%s is not a supported canned access policy', $policy_name
1283 0 ▶ if none { $policy_name eq $_ } qw(private public-read public-read-write authenticated-read);
Subroutine __ANON__: not called CC=1 SCAR=6.9
Branch: 1 branch
BranchTrueFalseTotal
if &none(sub { $policy_name eq $_; } , "private", "public-read", "public-read-write", "authenticated-read") 0 0 0
1284  
1285 0 return;
1286 }
1287  
1288 ########################################################################
1289 # Determine if a bucket can used as subdomain for the host
1290 # Specifying the bucket in the URL path is being deprecated
1291 # So, if the bucket name is suitable, we need to use it
1292 # as a subdomain in the host name instead.
1293 #
1294 # Currently buckets with periods in their names cannot be handled in
1295 # that manner due to SSL certificate issues, they will have to remain
1296 # in the url path instead.
1297 #
1298 ########################################################################
1299 0 ▶sub is_domain_bucket { goto &_can_bucket_be_subdomain; }
Subroutine is_domain_bucket: not called CC=1 SCAR=6.9
Pod undocumented
1300 ########################################################################
1301  
1302 ########################################################################
1303 0 ▶sub _can_bucket_be_subdomain {
Subroutine _can_bucket_be_subdomain: not called CC=5 SCAR=34.0
1304 ########################################################################
1305 0 my ($bucketname) = @_;
1306  
1307 0 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
if length $bucketname > $Amazon::S3::MAX_BUCKET_NAME_LENGTH - 1 0 0 0
1308 if length $bucketname > $MAX_BUCKET_NAME_LENGTH - 1;
1309  
1310 0 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
if length $bucketname < $Amazon::S3::MIN_BUCKET_NAME_LENGTH 0 0 0
1311 if length $bucketname < $MIN_BUCKET_NAME_LENGTH;
1312  
1313 0 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
unless $bucketname =~ /\A[[:lower:]][[:lower:]\d-]*\z/msx 0 0 0
1314 if $bucketname !~ m{\A[[:lower:]][[:lower:]\d-]*\z}xsm;
1315  
1316 0 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
unless $bucketname =~ /[[:lower:]\d]\z/msx 0 0 0
1317 if $bucketname !~ m{[[:lower:]\d]\z}xsm;
1318  
1319 0 return $TRUE;
1320 }
1321  
1322 ########################################################################
1323 0 ▶sub _make_request {
Subroutine _make_request: not called CC=16 SCAR=56.1
1324 ########################################################################
1325 0 my ( $self, @args ) = @_;
1326  
1327 0 my $parameters = get_parameters(@args);
1328  
1329 my ( $method, $path, $headers, $data, $metadata, $region )
1330 0 = @{$parameters}{qw(method path headers data metadata region)};
1331  
1332 # reset region on every call...every bucket can have it's own region
1333 0 ▶ $self->region( $region // $self->_region );
Condition0%0/3
$region // $self->_region
l!l&&r!l&&!r
000
MC/DC0%0/2
$region // $self->_region
$region $self->_region
Truth table0%0/3
A // B
A= $regionB= $self->_region
ABresult
1X1
011
000
1334  
1335 0 ▶ croak 'must specify method'
Branch: 1 branch
BranchTrueFalseTotal
unless $method 0 0 0
1336 if !$method;
1337  
1338 0 ▶ croak 'must specify path'
Branch: 1 branch
BranchTrueFalseTotal
unless defined $path 0 0 0
1339 if !defined $path;
1340  
1341 0 ▶ $headers //= {};
Condition0%0/2
$headers //= {}
l!l
00
MC/DC0%0/1
$headers //= {}
$headers
Truth table0%0/2
A
A= $headers
Aresult
11
00
1342  
1343 0 ▶ $metadata //= {};
Condition0%0/2
$metadata //= {}
l!l
00
MC/DC0%0/1
$metadata //= {}
$metadata
Truth table0%0/2
A
A= $metadata
Aresult
11
00
1344  
1345 0 ▶ $data //= $EMPTY;
Condition0%0/3
$data //= $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$data //= $Amazon::S3::EMPTY
$data $Amazon::S3::EMPTY
Truth table0%0/3
A //= B
A= $dataB= $Amazon::S3::EMPTY
ABresult
1X1
011
000
1346 0 ▶ $headers->{'Content-Length'} //= length $data;
Condition0%0/3
$headers->{"Content-Length"} //= length $data
l!l&&r!l&&!r
000
MC/DC0%0/2
$headers->{"Content-Length"} //= length $data
$headers->{"Content-Length"} length $data
Truth table0%0/3
A //= B
A= $headers->{"Content-Length"}B= length $data
ABresult
1X1
011
000
1347  
1348 0 my $http_headers = $self->_merge_meta( $headers, $metadata );
1349  
1350 0 ▶ my $protocol = $self->secure ? 'https' : 'http';
Branch: 1 branch
BranchTrueFalseTotal
$self->secure ? : 0 0 0
1351  
1352 0 my $host = $self->host;
1353  
1354 0 $path =~ s/\A\///xsm;
1355 0 my $url = sprintf '%s://%s/%s', $protocol, $host, $path;
1356  
1357 # if ( $path =~ m{\A([^/?]+)([^?]+)(.*)}xsm
1358 0 ▶ if ( $path =~ /\A([^\/?]+)([^?]+)(.*)/xsm
Branch: 1 branch
BranchTrueFalseTotal
if ($path =~ m[\A([^/?]+)([^?]+)(.*)]msx and $self->dns_bucket_names and is_domain_bucket($1)) 0 0 0
Condition0%0/6
$path =~ m[\A([^/?]+)([^?]+)(.*)]msx and $self->dns_bucket_names and is_domain_bucket($1)
!ll&&!rl&&r
000
$path =~ m[\A([^/?]+)([^?]+)(.*)]msx and $self->dns_bucket_names
!ll&&!rl&&r
000
MC/DC0%0/3
$path =~ m[\A([^/?]+)([^?]+)(.*)]msx and $self->dns_bucket_names and is_domain_bucket($1)
$path =~ m[\A([^/?]+)([^?]+)(.*)]msx $self->dns_bucket_names is_domain_bucket($1)
Truth table0%0/4
A and B and C
A= $path =~ m[\A([^/?]+)([^?]+)(.*)]msxB= $self->dns_bucket_namesC= is_domain_bucket($1)
ABCresult
0XX0
10X0
1100
1111
1359 && $self->dns_bucket_names
1360 && is_domain_bucket($1) ) {
1361  
1362 0 my $bucket = $1;
1363 0 $path = $2;
1364  
1365 0 my $query_string = $3;
1366  
1367 $self->logger->debug(
1368 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1369 0 return Dumper(
1370 [ bucket => $bucket,
1371 path => $path,
1372 query_string => $query_string,
1373 ]
1374 );
1375 }
1376 0 );
1377  
1378 0 ▶ if ( $host =~ /([^:]+):([^:]\d+)$/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($host =~ /([^:]+):([^:]\d+)$/msx) { } 0 0 0
1379  
1380 0 my $port;
1381  
1382 0 $url = eval {
1383 0 $port = $2;
1384 0 $host = $1;
1385  
1386 0 my $uri = URI->new;
1387  
1388 0 $uri->scheme('http');
1389 0 $uri->host("$bucket.$host");
1390 0 $uri->port($port);
1391 0 $uri->path($path);
1392  
1393 0 return $uri . $query_string;
1394 };
1395  
1396 0 ▶ die sprintf
Branch: 1 branch
BranchTrueFalseTotal
if not $url or $Amazon::S3::EVAL_ERROR 0 0 0
Condition0%0/3
not $url or $Amazon::S3::EVAL_ERROR
l!l&&r!l&&!r
000
MC/DC0%0/2
not $url or $Amazon::S3::EVAL_ERROR
not $url $Amazon::S3::EVAL_ERROR
Truth table0%0/3
not(A) or B
A= not $urlB= $Amazon::S3::EVAL_ERROR
ABresult
1X1
011
000
1397 "error creating uri for bucket: [%s], host: [%s], path: [%s], port: [%s]\n%s",
1398 $bucket, $host, $path, $port, $EVAL_ERROR
1399  
1400 if !$url || $EVAL_ERROR;
1401 }
1402 else {
1403 0 $url = sprintf '%s://%s.%s%s%s', $protocol, $bucket, $host, $path, $query_string;
1404 }
1405 }
1406  
1407 0 my $request = HTTP::Request->new( $method, $url, $http_headers );
1408  
1409 0 $self->last_request($request);
1410  
1411 0 ▶ if ($data) {
Branch: 1 branch
BranchTrueFalseTotal
if ($data) 0 0 0
1412 0 $request->content($data);
1413 }
1414  
1415 0 $self->signer->region($region); # always set regional endpoint for signing
1416  
1417 0 $self->signer->sign($request);
1418  
1419 0 return $request;
1420 }
1421  
1422 ########################################################################
1423 0 ▶sub send_request {
Subroutine send_request: not called CC=6 SCAR=37.4
Pod undocumented
1424 ########################################################################
1425 0 my ( $self, @args ) = @_;
1426  
1427 0 my $logger = $self->get_logger;
1428  
1429 $logger->trace(
1430 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1431 0 return Dumper( [ args => \@args ] );
1432 },
1433 0 );
1434  
1435 0 my $keep_root = $FALSE;
1436  
1437 0 my $request = eval {
1438 0 ▶ return $args[0]
Branch: 1 branch
BranchTrueFalseTotal
if ref($args[0]) =~ /HTTP::Request/msx 0 0 0
1439 if ref( $args[0] ) =~ /HTTP::Request/xsm;
1440  
1441 0 ▶ return {@args}
Branch: 1 branch
BranchTrueFalseTotal
if @args > 1 and !@args % 2 0 0 0
Condition0%0/3
@args > 1 and !@args % 2
!ll&&!rl&&r
000
MC/DC0%0/2
@args > 1 and !@args % 2
@args > 1 !@args % 2
Truth table0%0/3
A and not(B)
A= @args > 1B= !@args % 2
ABresult
0X0
100
111
1442 if @args > 1 && !@args % 2;
1443  
1444 0 ▶ return $args[0]
Branch: 1 branch
BranchTrueFalseTotal
if ref $args[0] 0 0 0
1445 if ref $args[0];
1446  
1447 0 croak 'invalid argument to send_request';
1448 };
1449  
1450 0 ▶ if ( ref($request) !~ /HTTP::Request/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (ref($request) =~ /HTTP::Request/msx) 0 0 0
1451 0 $keep_root = delete $request->{keep_root};
1452  
1453 0 $request = $self->_make_request($request);
1454 }
1455  
1456 0 my $response = $self->_do_http($request);
1457  
1458 0 $self->last_response($response);
1459  
1460 $logger->debug(
1461 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1462 0 return Dumper( [ response => $response ] );
1463 }
1464 0 );
1465  
1466 0 return $self->_decode_response( $response, $keep_root );
1467 }
1468  
1469 ########################################################################
1470 4 ▶sub is_json_response {
Subroutine is_json_response: called CC=5 SCAR=17.0
Pod undocumented
1471 ########################################################################
1472 4 my ($rsp) = @_;
1473  
1474 4 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
unless $rsp->content 0 4 4
1475 if !$rsp->content;
1476  
1477 4 ▶ my $content_type = $rsp->content_type // $EMPTY;
Condition33%1/3
$rsp->content_type // $Amazon::S3::EMPTY
l!l&&r!l&&!r
400
MC/DC0%0/2
$rsp->content_type // $Amazon::S3::EMPTY
$rsp->content_type $Amazon::S3::EMPTY
Truth table33%1/3
A // B
A= $rsp->content_typeB= $Amazon::S3::EMPTY
ABresult
1X1
011
000
1478  
1479 4 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $content_type eq "application/json" 1 3 4
1480 if $content_type eq 'application/json';
1481  
1482 3 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $content_type =~ m[\Aapplication/[^/]+\+json\z]msx 0 3 3
1483 if $content_type =~ m{\Aapplication/[^/]+\+json\z}xsm;
1484  
1485 3 return $FALSE;
1486 }
1487  
1488 ########################################################################
1489 7 ▶sub _decode_response {
Subroutine _decode_response: called CC=10 SCAR=23.0
1490 ########################################################################
1491 7 my ( $self, $response, $keep_root ) = @_;
1492  
1493 7 ▶ if ( $response->code !~ /\A2\d{2}\z/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($response->code =~ /\A2\d{2}\z/msx) 1 6 7
1494 1 $self->_handle_response_error($response);
1495 1 return;
1496 }
1497  
1498 return
1499 6 ▶ if !$response->content;
Branch: 1 branch
BranchTrueFalseTotal
unless $response->content 1 5 6
1500  
1501 5 my $content;
1502  
1503 5 ▶ if ( is_xml_response($response) && $response->content =~ /\A\s*</xsm ) {
Branch: 2 branches
BranchTrueFalseTotal
if (is_xml_response($response) and $response->content =~ /\A\s*</msx) { } 1 4 5
elsif (is_json_response($response)) { } 1 3 4
Condition100%3/3
is_xml_response($response) and $response->content =~ /\A\s*</msx
!ll&&!rl&&r
311
MC/DC100%2/2
is_xml_response($response) and $response->content =~ /\A\s*</msx
is_xml_response($response) $response->content =~ /\A\s*</msx
Truth table100%3/3
A and B
A= is_xml_response($response)B= $response->content =~ /\A\s*</msx
ABresult
0X0
100
111
1504 1 $content = eval { return $self->_xpc_of_content( $response->content, $keep_root, ); };
1505 }
1506 elsif ( is_json_response($response) ) {
1507 1 $content = eval { return JSON::PP->new->decode( $response->content ); };
1508 }
1509  
1510 5 ▶ if ( !defined $content || $EVAL_ERROR ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $content or $Amazon::S3::EVAL_ERROR) 3 2 5
Condition66%2/3
not defined $content or $Amazon::S3::EVAL_ERROR
l!l&&r!l&&!r
302
MC/DC50%1/2
not defined $content or $Amazon::S3::EVAL_ERROR
not defined $content $Amazon::S3::EVAL_ERROR
Truth table66%2/3
not(A) or B
A= not defined $contentB= $Amazon::S3::EVAL_ERROR
ABresult
1X1
011
000
1511 3 $content = eval { return JSON::PP->new->decode( $response->content ); };
1512 }
1513  
1514 5 ▶ return $response->content
Branch: 1 branch
BranchTrueFalseTotal
if not defined $content or $Amazon::S3::EVAL_ERROR 1 4 5
Condition66%2/3
not defined $content or $Amazon::S3::EVAL_ERROR
l!l&&r!l&&!r
104
MC/DC50%1/2
not defined $content or $Amazon::S3::EVAL_ERROR
not defined $content $Amazon::S3::EVAL_ERROR
Truth table66%2/3
not(A) or B
A= not defined $contentB= $Amazon::S3::EVAL_ERROR
ABresult
1X1
011
000
1515 if !defined $content || $EVAL_ERROR;
1516  
1517 4 return $content;
1518 }
1519  
1520 ########################################################################
1521 5 ▶sub is_xml_response {
Subroutine is_xml_response: called CC=4 SCAR=14.1
Pod undocumented
1522 ########################################################################
1523 5 my ($rsp) = @_;
1524  
1525 5 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
unless $rsp->content 0 5 5
1526 if !$rsp->content;
1527  
1528 5 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $rsp->content_type eq "application/xml" 2 3 5
1529 if $rsp->content_type eq 'application/xml';
1530  
1531 3 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $rsp->content =~ /\A\s*<[?]xml/msx 0 3 3
1532 if $rsp->content =~ /\A\s*<[?]xml/xsm;
1533  
1534 3 return $FALSE;
1535 }
1536  
1537 #
1538 # This is the necessary to find the region for a specific bucket
1539 # and set the signer object to use that region when signing requests
1540 ########################################################################
1541 0 ▶sub adjust_region {
Subroutine adjust_region: not called CC=8 SCAR=42.8
Pod undocumented
1542 ########################################################################
1543 0 my ( $self, $bucket, $called_from_redirect ) = @_;
1544  
1545 0 my $url = sprintf 'https://%s.%s', $bucket, $self->host;
1546  
1547 0 my $request = HTTP::Request->new( GET => $url );
1548  
1549 0 $self->{'signer'}->sign($request);
1550  
1551 # We have to turn off our special retry since this will deliberately
1552 # trigger that code
1553 0 $self->turn_off_special_retry();
1554  
1555 # If the bucket name has a period in it, the certificate validation
1556 # will fail since it will expect a certificate for a subdomain.
1557 # Setting it to verify against the expected host guards against
1558 # that while still being secure since we will have verified
1559 # the response as coming from the expected server.
1560 0 $self->ua->ssl_opts( SSL_verifycn_name => $self->host );
1561  
1562 0 my $response = $self->_do_http($request);
1563  
1564 # Turn this off, since all other requests have the bucket after
1565 # the host in the URL, and the host may change depending on the region
1566 0 $self->ua->ssl_opts( SSL_verifycn_name => undef );
1567  
1568 0 $self->turn_on_special_retry();
1569  
1570 # If No error, then nothing to do
1571 0 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $response->is_success 0 0 0
1572 if $response->is_success();
1573  
1574 # If the error is due to the wrong region, then we will get
1575 # back a block of XML with the details
1576 0 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
unless is_xml_response($response) 0 0 0
1577 if !is_xml_response($response);
1578  
1579 0 my $error_hash = $self->_xpc_of_content( $response->content );
1580  
1581 my ( $endpoint, $code, $region, $message )
1582 0 = @{$error_hash}{qw(Endpoint Code Region Message)};
1583  
1584 0 my $condition = eval {
1585 0 ▶ return 'PermanentRedirect'
Branch: 1 branch
BranchTrueFalseTotal
if $code eq "PermanentRedirect" and $endpoint 0 0 0
Condition0%0/3
$code eq "PermanentRedirect" and $endpoint
!ll&&!rl&&r
000
MC/DC0%0/2
$code eq "PermanentRedirect" and $endpoint
$code eq "PermanentRedirect" $endpoint
Truth table0%0/3
A and B
A= $code eq "PermanentRedirect"B= $endpoint
ABresult
0X0
100
111
1586 if $code eq 'PermanentRedirect' && $endpoint;
1587  
1588 0 ▶ return 'AuthorizationHeaderMalformed'
Branch: 1 branch
BranchTrueFalseTotal
if $code eq "AuthorizationHeaderMalformed" and $region 0 0 0
Condition0%0/3
$code eq "AuthorizationHeaderMalformed" and $region
!ll&&!rl&&r
000
MC/DC0%0/2
$code eq "AuthorizationHeaderMalformed" and $region
$code eq "AuthorizationHeaderMalformed" $region
Truth table0%0/3
A and B
A= $code eq "AuthorizationHeaderMalformed"B= $region
ABresult
0X0
100
111
1589 if $code eq 'AuthorizationHeaderMalformed' && $region;
1590  
1591 0 ▶ return 'IllegalLocationConstraintException'
Branch: 1 branch
BranchTrueFalseTotal
if $code eq "IllegalLocationConstraintException" 0 0 0
1592 if $code eq 'IllegalLocationConstraintException';
1593  
1594 0 return 'Other';
1595 };
1596  
1597 my %error_handlers = (
1598 0 ▶ PermanentRedirect => sub {
Subroutine __ANON__: not called CC=2 SCAR=17.9
1599 # Don't recurse through multiple redirects
1600 0 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
if $called_from_redirect 0 0 0
1601 if $called_from_redirect;
1602  
1603 # With a permanent redirect error, they are telling us the explicit
1604 # host to use. The endpoint will be in the form of bucket.host
1605 0 my $host = $endpoint;
1606  
1607 # Remove the bucket name from the front of the host name
1608 # All the requests will need to be of the form https://host/bucket
1609 0 $host =~ s/\A$bucket[.]//xsm;
1610 0 $self->host($host);
1611  
1612 # We will need to call ourselves again in order to trigger the
1613 # AuthorizationHeaderMalformed error in order to get the region
1614 0 return $self->adjust_region( $bucket, $TRUE );
1615 },
1616 0 ▶ AuthorizationHeaderMalformed => sub {
Subroutine __ANON__: not called CC=2 SCAR=17.9
1617 # Set the signer to use the correct reader evermore
1618 0 $self->{signer}->{endpoint} = $region;
1619  
1620 # Only change the host if we haven't been called as a redirect
1621 # where an exact host has been given
1622 0 ▶ if ( !$called_from_redirect ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($called_from_redirect) 0 0 0
1623 0 $self->host( sprintf 's3-%s-amazonaws.com', $region );
1624 }
1625  
1626 0 return $TRUE;
1627 },
1628 0 ▶ IllegalLocationConstraintException => sub {
Subroutine __ANON__: not called CC=2 SCAR=17.9
1629 # This is hackish; but in this case the region name only appears in the message
1630 0 ▶ if ( $message =~ /The (\S+) location/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($message =~ /The (\S+) location/msx) 0 0 0
1631 0 my $new_region = $1;
1632  
1633 # Correct the region for the signer
1634 0 $self->{signer}->{endpoint} = $new_region;
1635  
1636 # Set the proper host for the region
1637 0 $self->host( sprintf 's3.%s.amazonaws.com', $new_region );
1638  
1639 0 return $TRUE;
1640 }
1641 },
1642 0 ▶ 'Other' => sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1643 # Some other error
1644 0 $self->_remember_errors( $response->content, 1 );
1645 0 return $FALSE;
1646 },
1647 0 );
1648  
1649 0 return $error_handlers{$condition}->();
1650 }
1651  
1652 ########################################################################
1653 0 ▶sub reset_errors {
Subroutine reset_errors: not called CC=1 SCAR=6.9
Pod undocumented
1654 ########################################################################
1655 0 my ($self) = @_;
1656  
1657 0 $self->err(undef);
1658 0 $self->errstr(undef);
1659 0 $self->error(undef);
1660  
1661 0 return $self;
1662 }
1663  
1664 ########################################################################
1665 0 ▶sub _do_http {
Subroutine _do_http: not called CC=3 SCAR=24.8
1666 ########################################################################
1667 0 my ( $self, $request, $filename ) = @_;
1668  
1669 # convenient time to reset any error conditions
1670 0 $self->reset_errors;
1671  
1672 0 my $response = $self->ua->request( $request, $filename );
1673  
1674 # For new buckets at non-standard locations, amazon will sometimes
1675 # respond with a temporary redirect. In this case it is necessary
1676 # to try again with the new URL
1677 0 my $location = $response->header('Location');
1678  
1679 0 ▶ if ( $response->code =~ /\A3/xsm and defined $location ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($response->code =~ /\A3/msx and defined $location) 0 0 0
Condition0%0/3
$response->code =~ /\A3/msx and defined $location
!ll&&!rl&&r
000
MC/DC0%0/2
$response->code =~ /\A3/msx and defined $location
$response->code =~ /\A3/msx defined $location
Truth table0%0/3
A and B
A= $response->code =~ /\A3/msxB= defined $location
ABresult
0X0
100
111
1680  
1681 $self->get_logger->debug(
1682 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1683 0 return { sprintf 'Redirecting to: %s', $location };
1684 }
1685 0 );
1686  
1687 0 $request->uri($location);
1688 0 $response = $self->ua->request( $request, $filename );
1689 }
1690  
1691 0 ▶ $self->get_logger->debug( sub { return Dumper( [$response] ) } );
Subroutine __ANON__: not called CC=1 SCAR=6.9
1692  
1693 0 $self->last_response($response);
1694  
1695 0 return $response;
1696 }
1697  
1698 # Call this if handling any temporary redirect issues
1699 # (Like needing to probe with a HEAD request when file handle are involved)
1700  
1701 ########################################################################
1702 0 ▶sub _do_http_no_redirect {
Subroutine _do_http_no_redirect: not called CC=1 SCAR=6.9
1703 ########################################################################
1704 0 my ( $self, $request, $filename ) = @_;
1705  
1706 # convenient time to reset any error conditions
1707 0 $self->reset_errors;
1708  
1709 0 my $response = $self->ua->request( $request, $filename );
1710  
1711 0 ▶ $self->get_logger->debug( sub { return Dumper( [$response] ) } );
Subroutine __ANON__: not called CC=1 SCAR=6.9
1712  
1713 0 $self->last_response($response);
1714  
1715 0 return $response;
1716 }
1717  
1718 ########################################################################
1719 0 ▶sub send_request_expect_nothing {
Subroutine send_request_expect_nothing: not called CC=2 SCAR=17.9
Pod undocumented
1720 ########################################################################
1721 0 my ( $self, @args ) = @_;
1722  
1723 0 my $request = $self->_make_request(@args);
1724  
1725 0 my $response = $self->_do_http($request);
1726  
1727 0 my $content = $response->content;
1728  
1729 0 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $response->code =~ /^2\d\d$/msx 0 0 0
1730 if $response->code =~ /^2\d\d$/xsm;
1731  
1732 # anything else is a failure, and we save the parsed result
1733 0 $self->_handle_response_error($response);
1734  
1735 0 return $FALSE;
1736 }
1737  
1738 # Send a HEAD request first, to find out if we'll be hit with a 307 redirect.
1739 # Since currently LWP does not have true support for 100 Continue, it simply
1740 # slams the PUT body into the socket without waiting for any possible redirect.
1741 # Thus when we're reading from a filehandle, when LWP goes to reissue the request
1742 # having followed the redirect, the filehandle's already been closed from the
1743 # first time we used it. Thus, we need to probe first to find out what's going on,
1744 # before we start sending any actual data.
1745 ########################################################################
1746 0 ▶sub send_request_expect_nothing_probed {
Subroutine send_request_expect_nothing_probed: not called CC=6 SCAR=37.4
Pod undocumented
1747 ########################################################################
1748 0 my ( $self, @args ) = @_;
1749  
1750 0 my $parameters = get_parameters(@args);
1751  
1752 my ( $method, $path, $conf, $value, $region )
1753 0 = @{$parameters}{qw(method path headers data region)};
1754  
1755 0 ▶ $region = $region // $self->region;
Condition0%0/3
$region // $self->region
l!l&&r!l&&!r
000
MC/DC0%0/2
$region // $self->region
$region $self->region
Truth table0%0/3
A // B
A= $regionB= $self->region
ABresult
1X1
011
000
1756  
1757 0 my $request = $self->_make_request(
1758 { method => 'HEAD',
1759 path => $path,
1760 region => $region,
1761 },
1762 );
1763  
1764 0 my $override_uri;
1765  
1766 0 my $old_redirectable = $self->ua->requests_redirectable;
1767 0 $self->ua->requests_redirectable( [] );
1768  
1769 0 my $response = $self->_do_http_no_redirect($request);
1770  
1771 0 ▶ if ( $response->code =~ /^3/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($response->code =~ /^3/msx) 0 0 0
1772 0 ▶ if ( defined $response->header('Location') ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $response->header('Location')) { } 0 0 0
1773 0 $override_uri = $response->header('Location');
1774 }
1775 else {
1776 0 $self->_handle_response_error( $response, $TRUE );
1777 }
1778  
1779 $self->get_logger->debug(
1780 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1781 0 return sprintf 'setting override URI: [%s]', $override_uri;
1782 }
1783 0 );
1784 }
1785  
1786 0 $request = $self->_make_request(
1787 { method => $method,
1788 path => $path,
1789 headers => $conf,
1790 data => $value,
1791 region => $region,
1792 },
1793 );
1794  
1795 0 ▶ if ( defined $override_uri ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $override_uri) 0 0 0
1796 0 $request->uri($override_uri);
1797 }
1798  
1799 0 $response = $self->_do_http_no_redirect($request);
1800  
1801 0 $self->ua->requests_redirectable($old_redirectable);
1802  
1803 0 my $content = $response->content;
1804  
1805 0 ▶ return $TRUE
Branch: 1 branch
BranchTrueFalseTotal
if $response->code =~ /^2\d\d$/msx 0 0 0
1806 if $response->code =~ /^2\d\d$/xsm;
1807  
1808 # anything else is a failure, and we save the parsed result
1809 0 $self->_handle_response_error($response);
1810  
1811 0 return $FALSE;
1812 }
1813  
1814 ########################################################################
1815 6 ▶sub _croak_if_response_error {
Subroutine _croak_if_response_error: called CC=2 SCAR=8.1
1816 ########################################################################
1817 6 my ( $self, $response ) = @_;
1818  
1819 return
1820 6 ▶ if $response->code =~ /^2\d{2}$/xsm;
Branch: 1 branch
BranchTrueFalseTotal
if $response->code =~ /^2\d{2}$/msx 6 0 6
1821  
1822 0 return $self->_handle_response_error( $response, $TRUE );
1823 }
1824  
1825 ########################################################################
1826 4 ▶sub _xpc_of_content {
Subroutine _xpc_of_content: called CC=3 SCAR=12.3
1827 ########################################################################
1828 4 my ( $self, $src, $keep_root ) = @_;
1829  
1830 my $xml_hr
1831 4 = eval { XMLin( $src, SuppressEmpty => $EMPTY, ForceArray => ['Contents'], KeepRoot => $keep_root, NoAttr => $TRUE, ); };
1832  
1833 4 ▶ if ( !$xml_hr && $EVAL_ERROR ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $xml_hr and $Amazon::S3::EVAL_ERROR) 0 4 4
Condition33%1/3
not $xml_hr and $Amazon::S3::EVAL_ERROR
!ll&&!rl&&r
400
MC/DC0%0/2
not $xml_hr and $Amazon::S3::EVAL_ERROR
not $xml_hr $Amazon::S3::EVAL_ERROR
Truth table33%1/3
not(A) and B
A= not $xml_hrB= $Amazon::S3::EVAL_ERROR
ABresult
0X0
100
111
1834 0 confess "Error parsing $src: $EVAL_ERROR";
1835 }
1836  
1837 4 return $xml_hr;
1838 }
1839  
1840 ########################################################################
1841 1 ▶sub _handle_response_error {
Subroutine _handle_response_error: called CC=4 SCAR=16.8
1842 ########################################################################
1843 1 my ( $self, $response, $force_raise ) = @_;
1844  
1845 1 my $remembered = eval { return $self->_remember_errors( $response->content, $TRUE ); };
1846  
1847 1 ▶ if ( !$remembered ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($remembered) 0 1 1
1848 0 $self->err('network_error');
1849 0 $self->errstr( $response->status_line );
1850 }
1851  
1852 1 ▶ if ( $self->raise_error || $force_raise ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->raise_error or $force_raise) 0 1 1
Condition33%1/3
$self->raise_error or $force_raise
l!l&&r!l&&!r
001
MC/DC0%0/2
$self->raise_error or $force_raise
$self->raise_error $force_raise
Truth table33%1/3
A or B
A= $self->raise_errorB= $force_raise
ABresult
1X1
011
000
1853 0 croak sprintf '%s - %s: %s', $response->status_line, $self->err, $self->errstr;
1854 }
1855  
1856 1 return $TRUE;
1857 }
1858 # returns 1 if errors were found
1859 ########################################################################
1860 1 ▶sub _remember_errors {
Subroutine _remember_errors: called CC=7 SCAR=22.4
1861 ########################################################################
1862 1 my ( $self, $src, $keep_root ) = @_;
1863  
1864 return
1865 1 ▶ if !$src;
Branch: 1 branch
BranchTrueFalseTotal
unless $src 0 1 1
1866  
1867 1 ▶ if ( !ref $src && $src !~ /^[[:space:]]*</xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (ref $src or $src =~ /^[[:space:]]*</msx) 0 1 1
Condition33%1/3
ref $src or $src =~ /^[[:space:]]*</msx
l!l&&r!l&&!r
010
MC/DC0%0/2
ref $src or $src =~ /^[[:space:]]*</msx
ref $src $src =~ /^[[:space:]]*</msx
Truth table33%1/3
A or B
A= ref $srcB= $src =~ /^[[:space:]]*</msx
ABresult
1X1
011
000
1868 0 ( my $code = $src ) =~ s/^[[:space:]]*[(]([\d]*)[)].*$/$1/xsm;
1869  
1870 0 $self->err($code);
1871 0 $self->errstr($src);
1872  
1873 0 return $TRUE;
1874 }
1875  
1876 1 ▶ my $r = ref $src ? $src : $self->_xpc_of_content( $src, $keep_root );
Branch: 1 branch
BranchTrueFalseTotal
ref $src ? : 0 1 1
1877  
1878 1 $self->error($r);
1879  
1880 # apparently buckets() does not keep_root
1881 1 ▶ if ( $r->{Error} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($r->{"Error"}) 1 0 1
1882 1 $r = $r->{Error};
1883 }
1884  
1885 1 my ( $code, $message ) = @{$r}{qw(Code Message)};
1886  
1887 1 ▶ return $FALSE
Branch: 1 branch
BranchTrueFalseTotal
unless $code 0 1 1
1888 if !$code;
1889  
1890 1 $self->err($code);
1891 1 $self->errstr($message);
1892  
1893 1 return $TRUE;
1894 }
1895  
1896 # Deprecated - this adds a header for the old V2 auth signatures
1897 ########################################################################
1898 0 ▶sub _add_auth_header { ## no critic (ProhibitUnusedPrivateSubroutines)
Subroutine _add_auth_header: not called CC=3 SCAR=24.8
1899 ########################################################################
1900 0 my ( $self, $headers, $method, $path ) = @_;
1901  
1902 0 my ( $aws_access_key_id, $aws_secret_access_key, $token ) = $self->get_credentials;
1903  
1904 0 ▶ if ( not $headers->header('Date') ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($headers->header("Date")) 0 0 0
1905 0 $headers->header( Date => time2str(time) );
1906 }
1907  
1908 0 ▶ if ($token) {
Branch: 1 branch
BranchTrueFalseTotal
if ($token) 0 0 0
1909 0 $headers->header( $AMAZON_HEADER_PREFIX . 'security-token' => $token );
1910 }
1911  
1912 0 my $canonical_string = $self->_canonical_string( $method, $path, $headers );
1913  
1914 $self->get_logger->trace(
1915 0 ▶ sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
1916 0 return Dumper(
1917 [ headers => $headers,
1918 canonincal_sring => $canonical_string,
1919 ]
1920 );
1921 }
1922 0 );
1923  
1924 0 my $encoded_canonical = $self->_encode( $aws_secret_access_key, $canonical_string );
1925  
1926 0 $headers->header(
1927 Authorization => sprintf 'AWS %s:%s',
1928 $aws_access_key_id, $encoded_canonical
1929 );
1930  
1931 0 return;
1932 }
1933  
1934 # generates an HTTP::Headers objects given one hash that represents http
1935 # headers to set and another hash that represents an object's metadata.
1936 ########################################################################
1937 0 ▶sub _merge_meta {
Subroutine _merge_meta: not called CC=5 SCAR=34.0
1938 ########################################################################
1939 0 my ( $self, $headers, $metadata ) = @_;
1940  
1941 0 ▶ $headers //= {};
Condition0%0/2
$headers //= {}
l!l
00
MC/DC0%0/1
$headers //= {}
$headers
Truth table0%0/2
A
A= $headers
Aresult
11
00
1942 0 ▶ $metadata //= {};
Condition0%0/2
$metadata //= {}
l!l
00
MC/DC0%0/1
$metadata //= {}
$metadata
Truth table0%0/2
A
A= $metadata
Aresult
11
00
1943  
1944 0 my $http_header = HTTP::Headers->new;
1945  
1946 0 foreach my $p ( pairs %{$headers} ) {
1947 0 my ( $k, $v ) = @{$p};
1948 0 $http_header->header( $k => $v );
1949 }
1950  
1951 0 foreach my $p ( pairs %{$metadata} ) {
1952 0 my ( $k, $v ) = @{$p};
1953 0 $http_header->header( "$METADATA_PREFIX$k" => $v );
1954 }
1955  
1956 0 return $http_header;
1957 }
1958  
1959 # generate a canonical string for the given parameters. expires is optional and is
1960 # only used by query string authentication.
1961 ########################################################################
1962 0 ▶sub _canonical_string {
Subroutine _canonical_string: not called CC=17 SCAR=57.2
1963 ########################################################################
1964 0 my ( $self, $method, $path, $headers, $expires ) = @_;
1965  
1966 # initial / meant to force host/bucket-name instead of DNS based name
1967 0 $path =~ s/^\///xsm;
1968  
1969 0 my %interesting_headers = ();
1970  
1971 0 foreach my $p ( pairs %{$headers} ) {
1972 0 my ( $key, $value ) = @{$p};
1973 0 my $lk = lc $key;
1974  
1975 0 ▶ if ( $lk eq 'content-md5'
Branch: 1 branch
BranchTrueFalseTotal
if ($lk eq "content-md5" or $lk eq "content-type" or $lk eq "date" or $lk =~ /^$Amazon::S3::AMAZON_HEADER_PREFIX/msx) 0 0 0
Condition0%0/9
$lk eq "content-md5" or $lk eq "content-type" or $lk eq "date" or $lk =~ /^$Amazon::S3::AMAZON_HEADER_PREFIX/msx
l!l&&r!l&&!r
000
$lk eq "content-md5" or $lk eq "content-type" or $lk eq "date"
l!l&&r!l&&!r
000
$lk eq "content-md5" or $lk eq "content-type"
l!l&&r!l&&!r
000
MC/DC0%0/4
$lk eq "content-md5" or $lk eq "content-type" or $lk eq "date" or $lk =~ /^$Amazon::S3::AMAZON_HEADER_PREFIX/msx
$lk eq "content-md5" $lk eq "content-type" $lk eq "date" $lk =~ /^$Amazon::S3::AMAZON_HEADER_PREFIX/msx
Truth table0%0/5
A or B or C or D
A= $lk eq "content-md5"B= $lk eq "content-type"C= $lk eq "date"D= $lk =~ /^$Amazon::S3::AMAZON_HEADER_PREFIX/msx
ABCDresult
1XXX1
01XX1
001X1
00011
00000
1976 or $lk eq 'content-type'
1977 or $lk eq 'date'
1978 or $lk =~ /^$AMAZON_HEADER_PREFIX/xsm ) {
1979 0 $interesting_headers{$lk} = $self->_trim($value);
1980 }
1981 }
1982  
1983 # these keys get empty strings if they don't exist
1984 0 ▶ $interesting_headers{'content-type'} ||= $EMPTY;
Condition0%0/3
$interesting_headers{"content-type"} ||= $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$interesting_headers{"content-type"} ||= $Amazon::S3::EMPTY
$interesting_headers{"content-type"} $Amazon::S3::EMPTY
Truth table0%0/3
A ||= B
A= $interesting_headers{"content-type"}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
1985 0 ▶ $interesting_headers{'content-md5'} ||= $EMPTY;
Condition0%0/3
$interesting_headers{"content-md5"} ||= $Amazon::S3::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$interesting_headers{"content-md5"} ||= $Amazon::S3::EMPTY
$interesting_headers{"content-md5"} $Amazon::S3::EMPTY
Truth table0%0/3
A ||= B
A= $interesting_headers{"content-md5"}B= $Amazon::S3::EMPTY
ABresult
1X1
011
000
1986  
1987 # just in case someone used this. it's not necessary in this lib.
1988 0 ▶ if ( $interesting_headers{'x-amz-date'} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($interesting_headers{"x-amz-date"}) 0 0 0
1989 0 $interesting_headers{'date'} = $EMPTY;
1990 }
1991  
1992 # if you're using expires for query string auth, then it trumps date
1993 # (and x-amz-date)
1994 0 ▶ if ($expires) {
Branch: 1 branch
BranchTrueFalseTotal
if ($expires) 0 0 0
1995 0 $interesting_headers{'date'} = $expires;
1996 }
1997  
1998 0 my $buf = "$method\n";
1999  
2000 0 foreach my $key ( sort keys %interesting_headers ) {
2001 0 ▶ if ( $key =~ /^$AMAZON_HEADER_PREFIX/xsm ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($key =~ /^$Amazon::S3::AMAZON_HEADER_PREFIX/msx) { } 0 0 0
2002 0 $buf .= "$key:$interesting_headers{$key}\n";
2003 }
2004 else {
2005 0 $buf .= "$interesting_headers{$key}\n";
2006 }
2007 }
2008  
2009 # don't include anything after the first ? in the resource...
2010 # $path =~ /^([^?]*)/xsm;
2011 # $buf .= "/$1";
2012 0 $path =~ /\A([^?]*)/xsm;
2013 0 $buf .= "/$1";
2014  
2015 # ...unless there any parameters we're interested in...
2016 0 ▶ if ( $path =~ /[&?](acl|torrent|location|uploads|delete)([=&]|$)/xsm ) {
Branch: 2 branches
BranchTrueFalseTotal
if ($path =~ /[&?](acl|torrent|location|uploads|delete)([=&]|$)/msx) { } 0 0 0
elsif (my(%query_params) = 'URI'->new($path)->query_form) { } 0 0 0
2017 # if ( $path =~ /[&?](acl|torrent|location|uploads|delete)([=&])?/xsm ) {
2018 0 $buf .= "?$1";
2019 }
2020 elsif ( my %query_params = URI->new($path)->query_form ) {
2021 # see if the remaining parsed query string provides us with any
2022 # query string or upload id
2023  
2024 0 ▶ if ( $query_params{partNumber} && $query_params{uploadId} ) {
Branch: 2 branches
BranchTrueFalseTotal
if ($query_params{'partNumber'} and $query_params{'uploadId'}) { } 0 0 0
elsif ($query_params{'uploadId'}) { } 0 0 0
Condition0%0/3
$query_params{"partNumber"} and $query_params{"uploadId"}
!ll&&!rl&&r
000
MC/DC0%0/2
$query_params{"partNumber"} and $query_params{"uploadId"}
$query_params{"partNumber"} $query_params{"uploadId"}
Truth table0%0/3
A and B
A= $query_params{"partNumber"}B= $query_params{"uploadId"}
ABresult
0X0
100
111
2025 # re-evaluate query string, the order of the params is important
2026 # for request signing, so we can't depend on URI to do the right
2027 # thing
2028 0 $buf .= sprintf '?partNumber=%s&uploadId=%s', $query_params{partNumber}, $query_params{uploadId};
2029 }
2030 elsif ( $query_params{uploadId} ) {
2031 0 $buf .= sprintf '?uploadId=%s', $query_params{uploadId};
2032 }
2033 }
2034  
2035 0 return $buf;
2036 }
2037  
2038 ########################################################################
2039 0 ▶sub _trim {
Subroutine _trim: not called CC=1 SCAR=6.9
2040 ########################################################################
2041 0 my ( $self, $value ) = @_;
2042  
2043 0 $value =~ s/^\s+//xsm;
2044 0 $value =~ s/\s+$//xsm;
2045  
2046 0 return $value;
2047 }
2048  
2049 # finds the hmac-sha1 hash of the canonical string and the aws secret access key and then
2050 # base64 encodes the result (optionally urlencoding after that).
2051 ########################################################################
2052 0 ▶sub _encode {
Subroutine _encode: not called CC=2 SCAR=17.9
2053 ########################################################################
2054 0 my ( $self, $aws_secret_access_key, $str, $urlencode ) = @_;
2055  
2056 0 my $hmac = Digest::HMAC_SHA1->new($aws_secret_access_key);
2057 0 $hmac->add($str);
2058  
2059 0 my $b64 = encode_base64( $hmac->digest, $EMPTY );
2060  
2061 0 ▶ return $urlencode ? urlencode($b64) : return $b64;
Branch: 1 branch
BranchTrueFalseTotal
$urlencode ? : 0 0 0
2062 }
2063  
2064 ########################################################################
2065 0 ▶sub bucketv2 {
Subroutine bucketv2: not called CC=3 SCAR=24.8
Pod documented
2066 ########################################################################
2067 0 my ( $self, @args ) = @_;
2068  
2069 0 my $parameters = get_parameters(@args);
2070  
2071 my ( $bucketname, $region, $verify_region )
2072 0 = @{$parameters}{qw(bucket region verify_region)};
2073  
2074 # only set to default region if a region wasn't passed or region
2075 # verification not requested
2076 0 ▶ if ( !$region && !$verify_region ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($region or $verify_region) 0 0 0
Condition0%0/3
$region or $verify_region
l!l&&r!l&&!r
000
MC/DC0%0/2
$region or $verify_region
$region $verify_region
Truth table0%0/3
A or B
A= $regionB= $verify_region
ABresult
1X1
011
000
2077 0 $region = $self->region;
2078 }
2079  
2080 0 return Amazon::S3::BucketV2->new(
2081 { bucket => $bucketname,
2082 account => $self,
2083 region => $region,
2084 verify_region => $verify_region,
2085 },
2086 );
2087 }
2088  
2089 ########################################################################
2090 0 ▶sub delete_public_access_block {
Subroutine delete_public_access_block: not called CC=1 SCAR=6.9
Pod documented
2091 ########################################################################
2092 0 my ( $self, $bucket ) = @_;
2093  
2094 0 my $bucketv2 = bless $bucket, 'Amazon::S3::BucketV2';
2095  
2096 0 return $bucketv2->DeletePublicAccessBlock;
2097 }
2098  
2099 12 1;
2100  
2101 __END__
↑ Summary Amazon/S3/Bucket.pm »