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
|
package Data::Stream::Bulk::FileHandle;
BEGIN {
$Data::Stream::Bulk::FileHandle::AUTHORITY = 'cpan:NUFFIN';
}
{
$Data::Stream::Bulk::FileHandle::VERSION = '0.11';
}
use Moose;
# ABSTRACT: read lines from a filehandle
use namespace::clean -except => 'meta';
use IO::Handle;
with 'Data::Stream::Bulk::DoneFlag';
has filehandle => (
is => 'ro',
isa => 'FileHandle',
required => 1,
);
sub get_more {
my $self = shift;
my $line = $self->filehandle->getline;
return unless defined $line;
return [ $line ];
}
__PACKAGE__->meta->make_immutable;
1;
__END__
=pod
=head1 NAME
Data::Stream::Bulk::FileHandle - read lines from a filehandle
=head1 VERSION
version 0.11
=head1 SYNOPSIS
use Data::Stream::Bulk::FileHandle;
use Path::Class;
my $s = Data::Stream::Bulk::FileHandle->new(
filehandle => file('foo.txt')->openr,
);
=head1 DESCRIPTION
This provides a stream API for reading lines from a file.
=head1 ATTRIBUTES
=over 4
=item filehandle
A file handle that has been opened for reading. The stream will return lines
from this file, one by one.
=back
=head1 METHODS
=over 4
=item get_more
See L<Data::Stream::Bulk::DoneFlag>.
Returns the next line from the file, if it exists.
=back
=head1 AUTHOR
Yuval Kogman <nothingmuch@woobling.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Yuval Kogman.
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
|
