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
|
use strict;
use warnings;
package Email::Folder::Reader;
{
$Email::Folder::Reader::VERSION = '0.860';
}
# ABSTRACT: reads raw RFC822 mails from a box
use Carp;
sub new {
my $class = shift;
my $file = shift || croak "You must pass a filename";
bless { eval { $class->defaults },
@_,
_file => $file }, $class;
}
sub next_message {
}
sub messages {
my $self = shift;
my @messages;
while (my $message = $self->next_message) {
push @messages, $message;
}
return @messages;
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Email::Folder::Reader - reads raw RFC822 mails from a box
=head1 VERSION
version 0.860
=head1 SYNOPSIS
use Email::Folder::Reader;
my $box = Email::Folder::Reader->new('somebox');
print $box->messages;
or, as an iterator
use Email::Folder::Reader;
my $box = Email::Folder::Reader->new('somebox');
while ( my $mail = $box->next_message ) {
print $mail;
}
=head1 METHODS
=head2 new($filename, %options)
your standard class-method constructor
=head2 ->next_message
returns the next message from the box, or false if there are no more
=head2 ->messages
Returns all the messages in a box
=head1 AUTHORS
=over 4
=item *
Simon Wistow <simon@thegestalt.org>
=item *
Richard Clamp <richardc@unixbeard.net>
=item *
Pali <pali@cpan.org>
=back
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2006 by Simon Wistow.
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
|
