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
|
# This code is part of Perl distribution Mail-Box version 4.01.
# The POD got stripped from this file by OODoc version 3.05.
# For contributors see file ChangeLog.
# This software is copyright (c) 2001-2025 by Mark Overmeer.
# This is free software; you can redistribute it and/or modify it under
# the same terms as the Perl 5 programming language system itself.
# SPDX-License-Identifier: Artistic-1.0-Perl OR GPL-1.0-or-later
package Mail::Box::Dir;{
our $VERSION = '4.01';
}
use parent 'Mail::Box';
use strict;
use warnings;
use Log::Report 'mail-box', import => [ qw/__x error warning/ ];
use Mail::Box::Dir::Message ();
use Mail::Message::Body::Lines ();
use Mail::Message::Body::File ();
use Mail::Message::Body::Delayed ();
use Mail::Message::Body::Multipart ();
use Mail::Message::Head ();
use Mail::Message::Head::Delayed ();
use File::Spec::Functions qw/rel2abs/;
#--------------------
sub init($)
{ my ($self, $args) = @_;
$args->{body_type} //= sub { 'Mail::Message::Body::Lines' };
$self->SUPER::init($args);
my $class = ref $self;
my $directory = $self->{MBD_directory} = $args->{directory} || $self->directory;
if(-d $directory) {;}
elsif($args->{create} && $class->create($directory, %$args)) { ;}
else
{ error __x"no directory {dir} for folder of type.", dir => $directory, type => $class;
}
# About locking
my $lf = $args->{lock_file} // '.lock';
$self->locker->filename(rel2abs $lf, $directory);
# Check if we can write to the folder, if we need to.
{ # filetest 'access' is slower, but works correctly if we have a
# filesystem with ACLs
use filetest 'access';
if($self->writable && -e $directory && ! -w $directory)
{ warning __x"folder directory {dir} is write-protected.", dir => $directory;
$self->{MB_access} = 'r';
}
}
$self;
}
#--------------------
sub organization() { 'DIRECTORY' }
#--------------------
sub directory()
{ my $self = shift;
$self->{MBD_directory} ||= $self->folderToDirectory($self->name, $self->folderdir);
}
sub nameOfSubFolder($;$)
{ my ($thing, $name) = (shift, shift);
my $parent = @_ ? shift : ref $thing ? $thing->directory : undef;
defined $parent ? "$parent/$name" : $name;
}
#--------------------
sub folderToDirectory($$)
{ my ($class, $name, $folderdir) = @_;
my $dir = ($name =~ m#^=\/?(.*)# ? "$folderdir/$1" : $name);
$dir =~ s!/$!!r;
}
sub storeMessage($)
{ my ($self, $message) = @_;
$self->SUPER::storeMessage($message);
my $fn = $message->filename or return $message;
$self->{MBD_by_fn}{$fn} = $message;
}
sub messageInFile($) { $_[0]->{MBD_by_fn}{$_[1]} }
sub readMessageFilenames() { $_[0]->notImplemented }
1;
|