File: Range.pm

package info (click to toggle)
libnet-amazon-s3-perl 0.991-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,620 kB
  • sloc: perl: 9,906; makefile: 20
file content (120 lines) | stat: -rw-r--r-- 2,202 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
package Net::Amazon::S3::Client::Object::Range;
# ABSTRACT: Object extension allowing to fetch part of an object
$Net::Amazon::S3::Client::Object::Range::VERSION = '0.991';
use Moose 0.85;
use MooseX::StrictConstructor 0.16;

has 'object'
	=> is       => 'ro'
	=> isa      => 'Net::Amazon::S3::Client::Object'
	=> required => 1
	;

has 'range'
	=> is       => 'ro'
	=> isa      => 'Str'
	=> required => 1
	;

sub _get {
	my ($self, %args) = shift;

	my $response = $self->object->_perform_operation (
		'Net::Amazon::S3::Operation::Object::Fetch',

		%args,

		method => 'GET',
		range  => $self->range,
	);

	return $response;
}

sub get {
	my $self = shift;
	return $self->_get->content;
}

sub get_decoded {
	my $self = shift;
	return $self->_get->decoded_content(@_);
}

sub get_callback {
	my ($self, $callback) = @_;

	return $self->_get (filename => $callback)->http_response;
}

sub get_filename {
	my ($self, $filename) = @_;

	return $self->_get (filename => $filename)->http_response;
}


1;

__END__

=pod

=encoding UTF-8

=head1 NAME

Net::Amazon::S3::Client::Object::Range - Object extension allowing to fetch part of an object

=head1 VERSION

version 0.991

=head1 SYNOPSIS

	my $value = $object->range ("bytes=1024-10240")->get;

=head1 DESCRIPTION

Simple implementation dowloads, see L<use-byte-range-fetches|https://docs.aws.amazon.com/whitepapers/latest/s3-optimizing-performance-best-practices/use-byte-range-fetches.html>.

=head1 METHODS

Provides same get methods as L<Net::Amazon::S3::Client::Object>

=over

=item get

=item get_decoded

=item get_callback

=item get_filename

=back

=head1 SEE ALSO

L<Net::Amazon::S3::Client::Object>

=head1 AUTHOR

Branislav Zahradník <barney@cpan.org> - since v0.99

=head1 COPYRIGHT AND LICENSE

This module is a part of L<Net::Amazon::S3> distribution.

=head1 AUTHOR

Branislav Zahradník <barney@cpan.org>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by Amazon Digital Services, Leon Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav Zahradník.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=cut