Mail/Make/Headers.pm

filter: Statementstmt 77.9% 409 / 525 Branchbran 55.6% 129 / 232 Conditioncond 44.7% 51 / 114 MC/DCmcdc 6.5% 4 / 61 Subroutinesub 87.8% 58 / 66 Podpod 100% 26 / 26 totaltotal 66.1% 677 / 1024 CC 165 SCAR 30.1
CC
165
Cov
68%
message_id
146.4
_validate_message_id_value
56.0
date
20.6
CRAP 20.3
« Mail/Make/Stream/QuotedPrint.pm ↑ Summary Mail/Make/Headers/Generic.pm »
1 ##----------------------------------------------------------------------------
2 ## MIME Email Builder - ~/lib/Mail/Make/Headers.pm
3 ## Version v0.9.1
4 ## Copyright(c) 2026 DEGUEST Pte. Ltd.
5 ## Author: Jacques Deguest <jack@deguest.jp>
6 ## Created 2026/03/02
7 ## Modified 2026/05/11
8 ## All rights reserved
9 ##
10 ##
11 ## This program is free software; you can redistribute it and/or modify it
12 ## under the same terms as Perl itself.
13 ##----------------------------------------------------------------------------
14 package Mail::Make::Headers;
15 BEGIN
16 9 ▶{
Subroutine BEGIN: called CC=1 SCAR=0.0
17 9 ▶ use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
18 9 ▶ use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 9 warnings::register_categories( 'Mail::Make' );
20 9 ▶ use parent qw( Module::Generic );
Subroutine BEGIN: called CC=1 SCAR=0.0
21 9 ▶ use vars qw( $VERSION $EXCEPTION_CLASS $SUPPORTED $CRLF );
Subroutine BEGIN: called CC=1 SCAR=0.0
22 9 ▶ use Mail::Make::Exception;
Subroutine BEGIN: called CC=1 SCAR=0.0
23 9 ▶ use Mail::Make::Headers::ContentDisposition;
Subroutine BEGIN: called CC=1 SCAR=0.0
24 9 ▶ use Mail::Make::Headers::ContentTransferEncoding;
Subroutine BEGIN: called CC=1 SCAR=0.0
25 9 ▶ use Mail::Make::Headers::ContentType;
Subroutine BEGIN: called CC=1 SCAR=0.0
26 9 ▶ use Mail::Make::Headers::Generic;
Subroutine BEGIN: called CC=1 SCAR=0.0
27 9 ▶ use Mail::Make::Headers::MessageID;
Subroutine BEGIN: called CC=1 SCAR=0.0
28 9 ▶ use Mail::Make::Headers::Subject;
Subroutine BEGIN: called CC=1 SCAR=0.0
29 9 ▶ use MM::Table ();
Subroutine BEGIN: called CC=1 SCAR=0.0
30 9 ▶ use MM::Const qw( :table );
Subroutine BEGIN: called CC=1 SCAR=0.0
31 # use Wanted;
32 9 our $CRLF = "\015\012";
33 9 our $EXCEPTION_CLASS = 'Mail::Make::Exception';
34 # Maps normalised header name (lowercase, no hyphens) to typed class
35 9 our $SUPPORTED =
36 {
37 contentdisposition => 'Mail::Make::Headers::ContentDisposition',
38 contenttransferencoding => 'Mail::Make::Headers::ContentTransferEncoding',
39 contenttype => 'Mail::Make::Headers::ContentType',
40 messageid => 'Mail::Make::Headers::MessageID',
41 subject => 'Mail::Make::Headers::Subject',
42 };
43 9 our $VERSION = 'v0.9.1';
44 };
45  
46 9 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
47 9 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
48  
49 9 my $header_fields_canonical =
50 {
51 'from' => 'From',
52 'to' => 'To',
53 'cc' => 'Cc',
54 'bcc' => 'Bcc',
55 'reply-to' => 'Reply-To',
56 'sender' => 'Sender',
57 'subject' => 'Subject',
58 'date' => 'Date',
59 'message-id' => 'Message-ID',
60 'in-reply-to' => 'In-Reply-To',
61 'references' => 'References',
62 'return-path' => 'Return-Path',
63 'received' => 'Received',
64 'mime-version' => 'MIME-Version',
65 'content-type' => 'Content-Type',
66 'content-transfer-encoding' => 'Content-Transfer-Encoding',
67 'content-disposition' => 'Content-Disposition',
68 'content-id' => 'Content-ID',
69 'content-description' => 'Content-Description',
70 };
71  
72 9 my $header_fields_order =
73 {
74 'return-path' => 10,
75 'received' => 20,
76 'date' => 30,
77 'from' => 40,
78 'sender' => 50,
79 'reply-to' => 60,
80 'to' => 70,
81 'cc' => 80,
82 'bcc' => 90,
83 'message-id' => 100,
84 'in-reply-to' => 110,
85 'references' => 120,
86 'subject' => 130,
87 'mime-version' => 200,
88 'content-type' => 210,
89 'content-transfer-encoding' => 220,
90 'content-disposition' => 230,
91 'content-id' => 240,
92 'content-description' => 250,
93 };
94 9 my $fqdn_re = qr/\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/;
95 9 my %valid_encoding = map{ $_ => 1 } qw( 7bit 8bit binary base64 quoted-printable );
96  
97 sub init
98 286 ▶{
Subroutine init: called CC=8 SCAR=22.8
Pod documented
99 286 my $self = shift( @_ );
100 # Internal ordered list of [ $name, $value ] pairs to preserve order
101 286 $self->{_headers} = [];
102 286 $self->{_exception_class} = $EXCEPTION_CLASS;
103 286 $self->{_init_strict_use_sub} = 1;
104 286 $self->{_t} = MM::Table->make;
105 286 ▶ if( @_ )
Branch: 1 branch
BranchTrueFalseTotal
if (@_) 1 285 286
106 {
107 1 ▶ if( @_ % 2 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ % 2) 0 1 1
108 {
109 0 return( $self->error( "new() needs an even number of arguments" ) );
110 }
111 # We need to preserve the order in which the header field names were provided.
112 1 ▶ for( my $i = 0; $i < scalar( @_ ); $i += 2 )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < scalar @_) 3 1 4
113 {
114 3 ▶ if( defined( $_[$i] ) && $_[$i] eq 'debug' )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $_[$i] and $_[$i] eq "debug") 0 3 3
Condition33%1/3
defined $_[$i] and $_[$i] eq "debug"
!ll&&!rl&&r
030
MC/DC0%0/2
defined $_[$i] and $_[$i] eq "debug"
defined $_[$i] $_[$i] eq "debug"
Truth table33%1/3
A and B
A= defined $_[$i]B= $_[$i] eq "debug"
ABresult
0X0
100
111
115 {
116 0 $self->debug( $_[$i + 1] );
117 0 next;
118 }
119 3 ▶ $self->push_header( $_[$i] => $_[$i + 1] ) ||
Branch: 1 branch
BranchTrueFalseTotal
$self->push_header($_[$i], $_[$i + 1]) or return $self->pass_error 3 0 3
120 return( $self->pass_error );
121 }
122 }
123 286 ▶ $self->SUPER::init() || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->SUPER::init or return $self->pass_error 286 0 286
124 286 return( $self );
125 }
126  
127 # instead of aliasing it, we redirect so it shows up in a stack trace.
128 0 ▶sub add { return( shift->push_header( @_ ) ); }
Subroutine add: not called CC=1 SCAR=6.9
Pod documented
129  
130 # Returns the string representation of all headers, CRLF-terminated,
131 # ready to be written to a message (without the trailing blank line).
132 sub as_string
133 68 ▶{
Subroutine as_string: called CC=9 SCAR=22.2
Pod documented
134 68 my $self = shift( @_ );
135 68 ▶ my $eol = @_ ? shift( @_ ) : $CRLF;
Branch: 1 branch
BranchTrueFalseTotal
@_ ? : 1 67 68
136 68 ▶ my $max = @_ ? shift( @_ ) : 78;
Branch: 1 branch
BranchTrueFalseTotal
@_ ? : 0 68 68
137 68 ▶ if( $self->{_cache_value} &&
Branch: 1 branch
BranchTrueFalseTotal
if ($self->{"_cache_value"} and $self->{"_cache_value"}[0] eq $eol and $self->{"_cache_value"}[1] == $max and $self->{"_cache_value"}[2] and not CORE::length $self->{"_reset"}) 2 66 68
Condition66%8/12
$self->{"_cache_value"} and $self->{"_cache_value"}[0] eq $eol and $self->{"_cache_value"}[1] == $max and $self->{"_cache_value"}[2] and not CORE::length $self->{"_reset"}
!ll&&!rl&&r
6602
$self->{"_cache_value"} and $self->{"_cache_value"}[0] eq $eol and $self->{"_cache_value"}[1] == $max and $self->{"_cache_value"}[2]
!ll&&!rl&&r
6602
$self->{"_cache_value"} and $self->{"_cache_value"}[0] eq $eol and $self->{"_cache_value"}[1] == $max
!ll&&!rl&&r
6602
$self->{"_cache_value"} and $self->{"_cache_value"}[0] eq $eol
!ll&&!rl&&r
6602
MC/DC20%1/5
$self->{"_cache_value"} and $self->{"_cache_value"}[0] eq $eol and $self->{"_cache_value"}[1] == $max and $self->{"_cache_value"}[2] and not CORE::length $self->{"_reset"}
$self->{"_cache_value"} $self->{"_cache_value"}[0] eq $eol $self->{"_cache_value"}[1] == $max $self->{"_cache_value"}[2] not CORE::length $self->{"_reset"}
Truth table33%2/6
A and B and C and D and not(E)
A= $self->{"_cache_value"}B= $self->{"_cache_value"}[0] eq $eolC= $self->{"_cache_value"}[1] == $maxD= $self->{"_cache_value"}[2]E= not CORE::length $self->{"_reset"}
ABCDEresult
0XXXX0
10XXX0
110XX0
1110X0
111100
111111
138 $self->{_cache_value}->[0] eq $eol &&
139 $self->{_cache_value}->[1] == $max &&
140 $self->{_cache_value}->[2] &&
141 !CORE::length( $self->{_reset} ) )
142 {
143 2 return( $self->{_cache_value}->[2] );
144 }
145  
146 # WARNING: sorting email headers can be semantically risky (e.g. Received:).
147 66 my @pairs;
148 $self->{_t}->do(sub
149 339 ▶ {
Subroutine __ANON__: called CC=1 SCAR=0.0
150 339 my( $k, $v ) = @_;
151 339 push( @pairs, [ $k, $v ] );
152 339 return(1);
153 66 });
154  
155 @pairs = sort
156 {
157 66 $self->_mail_header_order( $a->[0] ) <=> $self->_mail_header_order( $b->[0] )
158 } @pairs;
159  
160 66 my $out = '';
161 66 ▶ for( my $i = 0; $i < @pairs; $i++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @pairs) 339 66 405
162 {
163 339 my $line = $self->_display_name( $pairs[ $i ]->[0] ) . ': ' . $pairs[ $i ]->[1];
164  
165 339 $out .= $self->_fold_header_line( $line, $eol, $max ) . $eol;
166 }
167  
168 66 $self->{_cache_value} = [$eol, $max, $out];
169 66 CORE::delete( $self->{_reset} );
170 66 return( $out );
171 }
172  
173 sub as_string_without_sort
174 1 ▶{
Subroutine as_string_without_sort: called CC=2 SCAR=7.0
Pod documented
175 1 my $self = shift( @_ );
176 1 ▶ my $eol = @_ ? shift( @_ ) : $CRLF;
Branch: 1 branch
BranchTrueFalseTotal
@_ ? : 1 0 1
177  
178 1 my $out = '';
179 $self->{_t}->do(sub
180 3 ▶ {
Subroutine __ANON__: called CC=1 SCAR=0.0
181 3 my( $k, $v ) = @_;
182 3 $out .= $k . ': ' . $v . $eol;
183 3 return(1);
184 1 });
185  
186 1 return( $out );
187 }
188  
189 sub clear
190 1 ▶{
Subroutine clear: called CC=1 SCAR=0.0
Pod documented
191 1 my $self = shift( @_ );
192 1 $self->{_t}->clear();
193 1 return( $self );
194 }
195  
196 sub clone
197 1 ▶{
Subroutine clone: called CC=1 SCAR=0.0
Pod documented
198 1 my $self = shift( @_ );
199  
200 1 my $c = ref( $self )->new();
201 1 $c->{_t} = $self->{_t}->copy( undef );
202  
203 1 return( $c );
204 }
205  
206 # content_disposition is a convenience typed accessor
207 sub content_disposition
208 0 ▶{
Subroutine content_disposition: not called CC=3 SCAR=24.8
Pod documented
209 0 my $self = shift( @_ );
210 0 ▶ if( @_ )
Branch: 1 branch
BranchTrueFalseTotal
if (@_) 0 0 0
211 {
212 0 my $val = shift( @_ );
213 0 ▶ $val = "$val" if( ref( $val ) );
Branch: 1 branch
BranchTrueFalseTotal
if ref $val 0 0 0
214 0 $self->reset(1);
215 0 return( $self->set( 'Content-Disposition', $val ) );
216 }
217 0 return( $self->new_field( 'Content-Disposition' ) );
218 }
219  
220 # content_id is a convenience accessor for Content-ID
221 sub content_id
222 3 ▶{
Subroutine content_id: called CC=3 SCAR=11.1
Pod documented
223 3 my $self = shift( @_ );
224 3 ▶ if( @_ )
Branch: 1 branch
BranchTrueFalseTotal
if (@_) 3 0 3
225 {
226 3 my $cid = shift( @_ );
227 # Normalise: strip surrounding angle brackets if present, then re-add
228 3 $cid =~ s/^<//;
229 3 $cid =~ s/>$//;
230 3 ▶ if( $cid =~ /[\x00-\x1F\x7F]/ )
Branch: 1 branch
BranchTrueFalseTotal
if ($cid =~ /[\x00-\x1F\x7F]/) 1 2 3
231 {
232 1 return( $self->error( "Invalid Content-ID value '$cid': contains illegal characters." ) );
233 }
234 2 $self->reset(1);
235 2 return( $self->set( 'Content-ID', "<${cid}>" ) );
236 }
237 0 return( $self->get( 'Content-ID' ) );
238 }
239  
240 # content_transfer_encoding is a convenience accessor
241 sub content_transfer_encoding
242 57 ▶{
Subroutine content_transfer_encoding: called CC=3 SCAR=11.0
Pod documented
243 57 my $self = shift( @_ );
244 57 ▶ if( @_ )
Branch: 1 branch
BranchTrueFalseTotal
if (@_) 7 50 57
245 {
246 7 my $enc = lc( shift( @_ ) );
247 7 ▶ unless( exists( $valid_encoding{ $enc } ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (exists $valid_encoding{$enc}) 1 6 7
248 {
249 1 return( $self->error( "Unknown Content-Transfer-Encoding '$enc'." ) );
250 }
251 6 $self->reset(1);
252 6 return( $self->set( 'Content-Transfer-Encoding', $enc ) );
253 }
254 50 return( $self->get( 'Content-Transfer-Encoding' ) );
255 }
256  
257 # content_type is a convenience typed accessor
258 sub content_type
259 2 ▶{
Subroutine content_type: called CC=3 SCAR=11.0
Pod documented
260 2 my $self = shift( @_ );
261 2 ▶ if( @_ )
Branch: 1 branch
BranchTrueFalseTotal
if (@_) 1 1 2
262 {
263 1 my $val = shift( @_ );
264 1 ▶ $val = "$val" if( ref( $val ) );
Branch: 1 branch
BranchTrueFalseTotal
if ref $val 0 1 1
265 1 $self->reset(1);
266 1 return( $self->set( 'Content-Type', $val ) );
267 }
268 1 return( $self->new_field( 'Content-Type' ) );
269 }
270  
271 # $hdr->date( $my_date );
272 # $hdr->date( $my_date, { strict => 1 } );
273 sub date
274 2 ▶{
Subroutine date: called CC=12 SCAR=30.3
Pod documented
275 2 my $self = shift( @_ );
276 2 ▶ my $has_args = scalar( @_ ) ? 1 : 0;
Branch: 1 branch
BranchTrueFalseTotal
scalar @_ ? : 2 0 2
277 2 my $opts = {};
278 2 ▶ $opts = pop( @_ ) if( scalar( @_ ) && ref( $_[-1] ) eq 'HASH' );
Branch: 1 branch
BranchTrueFalseTotal
if scalar @_ and ref $_[-1] eq "HASH" 0 2 2
Condition33%1/3
scalar @_ and ref $_[-1] eq "HASH"
!ll&&!rl&&r
020
MC/DC0%0/2
scalar @_ and ref $_[-1] eq "HASH"
scalar @_ ref $_[-1] eq "HASH"
Truth table33%1/3
A and B
A= scalar @_B= ref $_[-1] eq "HASH"
ABresult
0X0
100
111
279  
280 # Accessor mode
281 2 ▶ if( @_ == 0 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ == 0) 0 2 2
282 {
283 0 ▶ if( $has_args )
Branch: 1 branch
BranchTrueFalseTotal
if ($has_args) 0 0 0
284 {
285 0 return( $self->error( "No date was provided." ) );
286 }
287 0 return( $self->header( 'Date' ) );
288 }
289  
290 # Mutator mode
291 2 my $v = shift( @_ );
292  
293 2 ▶ if( defined( $v ) && !ref( $v ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $v and not ref $v) 2 0 2
Condition33%1/3
defined $v and not ref $v
!ll&&!rl&&r
002
MC/DC0%0/2
defined $v and not ref $v
defined $v not ref $v
Truth table33%1/3
A and not(B)
A= defined $vB= not ref $v
ABresult
0X0
100
111
294 {
295 # epoch seconds -> RFC 5322 date-time
296 2 ▶ if( $v =~ /^[[:blank:]]*-?\d+[[:blank:]]*$/ )
Branch: 2 branches
BranchTrueFalseTotal
if ($v =~ /^[[:blank:]]*-?\d+[[:blank:]]*$/) { } 1 1 2
elsif ($opts->{'strict'}) { } 0 1 1
297 {
298 1 my $epoch = $v;
299 1 $epoch =~ s/^[[:blank:]]+//;
300 1 $epoch =~ s/[[:blank:]]+$//;
301
302 1 ▶ my $date = $self->_format_rfc5322_date( $epoch ) ||
Condition50%1/2
$self->_format_rfc5322_date($epoch) || (return $self->pass_error)
l!l
10
MC/DC0%0/1
$self->_format_rfc5322_date($epoch) || (return $self->pass_error)
$self->_format_rfc5322_date($epoch)
Truth table50%1/2
A
A= $self->_format_rfc5322_date($epoch)
Aresult
11
00
303 return( $self->pass_error );
304
305 1 $self->header( 'Date' => $date );
306 1 $self->reset(1);
307 1 return( $self );
308 }
309 # Non-numeric: accept as-is, but optionally validate
310 elsif( $opts->{strict} )
311 {
312 0 ▶ $self->_validate_date_value( $v ) ||
Branch: 1 branch
BranchTrueFalseTotal
$self->_validate_date_value($v) or return $self->pass_error 0 0 0
313 return( $self->pass_error );
314 }
315 # else, anything goes...
316 }
317  
318 1 $self->reset(1);
319 1 $self->header( 'Date' => $v );
320 # We return the current instance for chaining.
321 1 return( $self );
322 }
323  
324 sub exists
325 82 ▶{
Subroutine exists: called CC=4 SCAR=14.5
Pod documented
326 82 my $self = shift( @_ );
327  
328 82 ▶ if( @_ != 1 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ != 1) 0 82 82
329 {
330 0 return( $self->error( "exists expects exactly one argument" ) );
331 }
332  
333 82 ▶ my $cname = $self->_canon_name( $_[0] ) || return( $self->pass_error );
Condition50%1/2
$self->_canon_name($_[0]) || (return $self->pass_error)
l!l
820
MC/DC0%0/1
$self->_canon_name($_[0]) || (return $self->pass_error)
$self->_canon_name($_[0])
Truth table50%1/2
A
A= $self->_canon_name($_[0])
Aresult
11
00
334  
335 82 my $v = $self->{_t}->get( $cname );
336  
337 82 ▶ return( defined( $v ) ? 1 : 0 );
Branch: 1 branch
BranchTrueFalseTotal
defined $v ? : 15 67 82
338 }
339  
340 # get( $name ) returns the raw string value of the first matching header
341 sub get
342 290 ▶{
Subroutine get: called CC=2 SCAR=7.6
Pod documented
343 290 my $self = shift( @_ );
344  
345 290 ▶ if( @_ != 1 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ != 1) 0 290 290
346 {
347 0 return( $self->error( "get expects exactly one argument" ) );
348 }
349  
350 290 return( $self->header( $_[0] ) );
351 }
352  
353 # has( $name ) is a boolean existence check
354 {
355 9 ▶ no warnings 'once';
Subroutine BEGIN: called CC=1 SCAR=0.0
356 # NOTE: sub has aliased to 'has'
357 9 *has = \&exists;
358 }
359  
360 sub header
361 493 ▶{
Subroutine header: called CC=12 SCAR=25.4
Pod documented
362 493 my $self = shift( @_ );
363  
364 493 ▶ if( @_ == 0 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ == 0) 0 493 493
365 {
366 0 return( $self->error( "header called with no arguments" ) );
367 }
368  
369 # Getter
370 493 ▶ if( @_ == 1 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ == 1) 425 68 493
371 {
372 425 my $name = $_[0];
373 425 ▶ my $cname = $self->_canon_name( $name ) || return( $self->pass_error );
Condition50%1/2
$self->_canon_name($name) || (return $self->pass_error)
l!l
4250
MC/DC0%0/1
$self->_canon_name($name) || (return $self->pass_error)
$self->_canon_name($name)
Truth table50%1/2
A
A= $self->_canon_name($name)
Aresult
11
00
374  
375 425 my @vals = $self->{_t}->get( $cname );
376  
377 425 ▶ if( !@vals )
Branch: 1 branch
BranchTrueFalseTotal
unless (@vals) 208 217 425
378 {
379 208 return;
380 }
381  
382 217 ▶ return( wantarray() ? @vals : join( ', ', @vals ) );
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 2 215 217
383 }
384  
385 # Setter
386 68 ▶ if( @_ % 2 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ % 2) 0 68 68
387 {
388 0 return( $self->error( "header() needs one or an even number of arguments" ) );
389 }
390  
391 68 my %cleared;
392 68 ▶ for( my $i = 0; $i < @_; $i += 2 )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @_) 68 68 136
393 {
394 68 my $name = $_[$i];
395 68 my $val = $_[$i + 1];
396  
397 68 ▶ my $cname = $self->_canon_name( $name ) || return( $self->pass_error );
Condition50%1/2
$self->_canon_name($name) || (return $self->pass_error)
l!l
680
MC/DC0%0/1
$self->_canon_name($name) || (return $self->pass_error)
$self->_canon_name($name)
Truth table50%1/2
A
A= $self->_canon_name($name)
Aresult
11
00
398  
399 68 my $lkey = lc( $cname );
400 68 $lkey =~ tr/_/-/;
401  
402 68 ▶ if( !$cleared{ $lkey }++ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($cleared{$lkey}++) 68 0 68
403 {
404 68 $self->{_t}->unset( $cname );
405 }
406  
407 # We get back an array reference
408 68 ▶ my $vals = $self->_coerce_values( $val ) || return( $self->pass_error );
Condition50%1/2
$self->_coerce_values($val) || (return $self->pass_error)
l!l
680
MC/DC0%0/1
$self->_coerce_values($val) || (return $self->pass_error)
$self->_coerce_values($val)
Truth table50%1/2
A
A= $self->_coerce_values($val)
Aresult
11
00
409  
410 68 ▶ for( my $j = 0; $j < @$vals; $j++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($j < @$vals) 68 68 136
411 {
412 68 $self->{_t}->add( $cname => $vals->[ $j ] );
413 }
414 }
415 68 $self->reset(1);
416  
417 # We return the current instance for chaining
418 68 return( $self );
419 }
420  
421 sub header_field_names
422 0 ▶{
Subroutine header_field_names: not called CC=2 SCAR=17.9
Pod documented
423 0 my $self = shift( @_ );
424  
425 0 my %seen;
426 my @out;
427  
428 $self->{_t}->do(sub
429 0 ▶ {
Subroutine __ANON__: not called CC=3 SCAR=24.8
430 0 my( $k, $v ) = @_;
431  
432 0 my $lkey = lc( $k );
433 0 $lkey =~ tr/_/-/;
434  
435 0 ▶ if( !$seen{ $lkey }++ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($seen{$lkey}++) 0 0 0
436 {
437 0 ▶ my $name = $self->_display_name( $k ) || return( $self->pass_error );
Condition0%0/2
$self->_display_name($k) || (return $self->pass_error)
l!l
00
MC/DC0%0/1
$self->_display_name($k) || (return $self->pass_error)
$self->_display_name($k)
Truth table0%0/2
A
A= $self->_display_name($k)
Aresult
11
00
438 0 push( @out, $name );
439 }
440 0 return(1);
441 0 });
442  
443 0 ▶ return( wantarray() ? @out : \@out );
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 0 0 0
444 }
445  
446 sub init_header
447 549 ▶{
Subroutine init_header: called CC=6 SCAR=18.3
Pod documented
448 549 my $self = shift( @_ );
449  
450 549 ▶ if( @_ % 2 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ % 2) 0 549 549
451 {
452 0 return( $self->error( "init_header() needs an even number of arguments" ) );
453 }
454  
455 549 ▶ for( my $i = 0; $i < @_; $i += 2 )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @_) 549 549 1098
456 {
457 549 my $name = $_[$i];
458 549 my $val = $_[$i + 1];
459  
460 549 ▶ my $cname = $self->_canon_name( $name ) ||
Condition50%1/2
$self->_canon_name($name) || (return $self->pass_error)
l!l
5490
MC/DC0%0/1
$self->_canon_name($name) || (return $self->pass_error)
$self->_canon_name($name)
Truth table50%1/2
A
A= $self->_canon_name($name)
Aresult
11
00
461 return( $self->pass_error );
462  
463 549 my @existing = $self->{_t}->get( $cname );
464 549 ▶ next if( @existing );
Branch: 1 branch
BranchTrueFalseTotal
if @existing 71 478 549
465  
466 478 ▶ $self->push_header( $cname => $val ) ||
Branch: 1 branch
BranchTrueFalseTotal
$self->push_header($cname, $val) or return $self->pass_error 478 0 478
467 return( $self->pass_error );
468 }
469 549 $self->reset(1);
470 549 return( $self );
471 }
472  
473 # length()
474 # Returns the total number of header field entries currently stored,
475 # counting each value separately for multi-valued fields.
476 # Returns 0 when no headers have been set.
477 sub length
478 0 ▶{
Subroutine length: not called CC=1 SCAR=6.9
Pod documented
479 0 my $self = shift( @_ );
480 0 my $st = $self->{_t}->_state();
481 0 return( scalar( @{$st->{_entries}} ) );
482 }
483  
484 # $hdr->message_id( undef ); # remove
485 # $hdr->message_id( undef, { strict => 1 } ); # same: remove
486 sub message_id
487 65 ▶{
Subroutine message_id: called CC=19 SCAR=49.9
Pod documented
488 65 my $self = shift( @_ );
489 65 ▶ my $has_args = scalar( @_ ) ? 1 : 0;
Branch: 1 branch
BranchTrueFalseTotal
scalar @_ ? : 65 0 65
490 65 my $opts = {};
491 65 ▶ $opts = pop( @_ ) if( scalar( @_ ) && ref( $_[-1] ) eq 'HASH' );
Branch: 1 branch
BranchTrueFalseTotal
if scalar @_ and ref $_[-1] eq "HASH" 65 0 65
Condition33%1/3
scalar @_ and ref $_[-1] eq "HASH"
!ll&&!rl&&r
0065
MC/DC0%0/2
scalar @_ and ref $_[-1] eq "HASH"
scalar @_ ref $_[-1] eq "HASH"
Truth table33%1/3
A and B
A= scalar @_B= ref $_[-1] eq "HASH"
ABresult
0X0
100
111
492  
493 # Generate mode
494 # Allow: $hdr->message_id( { generate => 1, domain => 'example.com' } )
495 65 ▶ if( $opts->{generate} )
Branch: 1 branch
BranchTrueFalseTotal
if ($opts->{"generate"}) 65 0 65
496 {
497 65 my $domain = $opts->{domain};
498 65 ▶ if( !defined( $domain ) || $domain eq '' )
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $domain or $domain eq "") 0 65 65
Condition33%1/3
not defined $domain or $domain eq ""
l!l&&r!l&&!r
0065
MC/DC0%0/2
not defined $domain or $domain eq ""
not defined $domain $domain eq ""
Truth table33%1/3
not(A) or B
A= not defined $domainB= $domain eq ""
ABresult
1X1
011
000
499 {
500 # Sys::Hostname is a core module, so it is guaranteed to be available.
501 0 ▶ $self->_load_class( 'Sys::Hostname' ) ||
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Sys::Hostname") or return $self->pass_error 0 0 0
502 return( $self->pass_error );
503 0 local $@;
504 # Sys::Hostname::hostname() croaks, so we need to catch that.
505 eval
506 0 {
507 0 $domain = Sys::Hostname::hostname();
508 };
509 }
510  
511 # Need to check the user-provided value against rfc1123 and rfc952 using regular expression
512 # Validate domain: require dot + RFC-ish hostname
513 65 ▶ if( !defined( $domain ) ||
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $domain or index($domain, ".") == -1 or not $domain =~ /$fqdn_re/) 0 65 65
Condition33%2/6
not defined $domain or index($domain, ".") == -1 or not $domain =~ /$fqdn_re/
l!l&&r!l&&!r
0065
not defined $domain or index($domain, ".") == -1
l!l&&r!l&&!r
0065
MC/DC0%0/3
not defined $domain or index($domain, ".") == -1 or not $domain =~ /$fqdn_re/
not defined $domain index($domain, ".") == -1 not $domain =~ /$fqdn_re/
Truth table25%1/4
not(A) or B or not(C)
A= not defined $domainB= index($domain, ".") == -1C= not $domain =~ /$fqdn_re/
ABCresult
1XX1
01X1
0011
0000
514 # Better than using a regular expression, and we check it first, before executing the following complexe regular expression.
515 index( $domain, '.' ) == -1 ||
516 # We use a pre-compiled regular expression
517 $domain !~ $fqdn_re )
518 {
519 # Let's be clear, and tell the user what is wrong so he does not need to go looking in the code to understand.
520 0 return( $self->error( "Invalid Message-ID domain '$domain'. You need to specify a domain with the option 'domain'." ) );
521 }
522  
523 65 ▶ my $mid = $self->_generate_message_id( $domain ) ||
Condition50%1/2
$self->_generate_message_id($domain) || (return $self->pass_error)
l!l
650
MC/DC0%0/1
$self->_generate_message_id($domain) || (return $self->pass_error)
$self->_generate_message_id($domain)
Truth table50%1/2
A
A= $self->_generate_message_id($domain)
Aresult
11
00
524 return( $self->pass_error );
525  
526 65 $self->reset(1);
527 65 $self->header( 'Message-ID' => $mid );
528 65 return( $mid );
529 }
530  
531 # Accessor mode
532 0 ▶ if( @_ == 0 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ == 0) 0 0 0
533 {
534 0 ▶ if( $has_args )
Branch: 1 branch
BranchTrueFalseTotal
if ($has_args) 0 0 0
535 {
536 0 return( $self->error( "No Message-ID value was provided." ) );
537 }
538 0 return( $self->header( 'Message-ID' ) );
539 }
540  
541 0 my $v = shift( @_ );
542  
543 # undef => remove
544 0 ▶ if( !defined( $v ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $v) 0 0 0
545 {
546 0 $self->reset(1);
547 0 $self->remove_header( 'Message-ID' );
548 0 return( $self );
549 }
550  
551 0 ▶ if( ref( $v ) )
Branch: 1 branch
BranchTrueFalseTotal
if (ref $v) 0 0 0
552 {
553 0 ▶ if( !$self->_can_overload( $v => '""' ) )
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->_can_overload($v, "\"\"")) 0 0 0
554 {
555 0 return( $self->error( "Invalid Message-ID value (", $self->_str_val( $v ), ")." ) );
556 }
557 0 $v = "$v";
558 }
559  
560 0 ▶ if( $opts->{strict} )
Branch: 1 branch
BranchTrueFalseTotal
if ($opts->{"strict"}) 0 0 0
561 {
562 0 ▶ $self->_validate_message_id_value( $v ) ||
Branch: 1 branch
BranchTrueFalseTotal
$self->_validate_message_id_value($v) or return $self->pass_error 0 0 0
563 return( $self->pass_error );
564 }
565  
566 0 $self->reset(1);
567 0 $self->header( 'Message-ID' => $v );
568 # We return the current instance for chaining
569 0 return( $self );
570 }
571  
572 # new_field( $name, $value ) is a factory returning a typed object or Generic
573 # e.g. $headers->new_field( 'Content-Type' )
574 sub new_field
575 3 ▶{
Subroutine new_field: called CC=9 SCAR=24.6
Pod documented
576 3 my $self = shift( @_ );
577 3 ▶ my $name = shift( @_ ) || return( $self->error( "No field name provided." ) );
Condition50%1/2
shift @_ || (return $self->error('No field name provided.'))
l!l
30
MC/DC0%0/1
shift @_ || (return $self->error('No field name provided.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
578 3 my $value = shift( @_ );
579 3 ▶ my $key = $self->_normalise_name( $name ) || return( $self->pass_error );
Condition50%1/2
$self->_normalise_name($name) || (return $self->pass_error)
l!l
30
MC/DC0%0/1
$self->_normalise_name($name) || (return $self->pass_error)
$self->_normalise_name($name)
Truth table50%1/2
A
A= $self->_normalise_name($name)
Aresult
11
00
580 3 ▶ my $class = $SUPPORTED->{ $key } || 'Mail::Make::Headers::Generic';
Condition50%1/2
$Mail::Make::Headers::SUPPORTED->{$key} || 'Mail::Make::Headers::Generic'
l!l
30
MC/DC0%0/1
$Mail::Make::Headers::SUPPORTED->{$key} || 'Mail::Make::Headers::Generic'
$Mail::Make::Headers::SUPPORTED->{$key}
Truth table50%1/2
A
A= $Mail::Make::Headers::SUPPORTED->{$key}
Aresult
11
00
581 3 ▶ $self->_load_class( $class ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class($class) or return $self->pass_error 3 0 3
582 3 ▶ if( defined( $value ) && CORE::length( $value ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value and CORE::length $value) 2 1 3
Condition66%2/3
defined $value and CORE::length $value
!ll&&!rl&&r
102
MC/DC50%1/2
defined $value and CORE::length $value
defined $value CORE::length $value
Truth table66%2/3
A and B
A= defined $valueB= CORE::length $value
ABresult
0X0
100
111
583 {
584 2 ▶ return( $class->new( $value ) || $self->pass_error( $class->error ) );
Condition33%1/3
$class->new($value) || $self->pass_error($class->error)
l!l&&r!l&&!r
200
MC/DC0%0/2
$class->new($value) || $self->pass_error($class->error)
$class->new($value) $self->pass_error($class->error)
Truth table33%1/3
A || B
A= $class->new($value)B= $self->pass_error($class->error)
ABresult
1X1
011
000
585 }
586 1 ▶ return( $class->new || $self->pass_error( $class->error ) );
Condition33%1/3
$class->new || $self->pass_error($class->error)
l!l&&r!l&&!r
100
MC/DC0%0/2
$class->new || $self->pass_error($class->error)
$class->new $self->pass_error($class->error)
Truth table33%1/3
A || B
A= $class->newB= $self->pass_error($class->error)
ABresult
1X1
011
000
587 }
588  
589 # print( $fh ) writes all headers + blank line to filehandle
590 sub print
591 0 ▶{
Subroutine print: not called CC=4 SCAR=30.0
Pod documented
592 0 my $self = shift( @_ );
593 0 my $fh = shift( @_ );
594 0 ▶ my $eol = @_ ? $_[0] : $CRLF;
Branch: 1 branch
BranchTrueFalseTotal
@_ ? : 0 0 0
595 0 ▶ $fh->print( $self->as_string( @_ ) ) ||
Branch: 1 branch
BranchTrueFalseTotal
$fh->print($self->as_string(@_)) or return $self->error("Unable to print headers: $!") 0 0 0
596 return( $self->error( "Unable to print headers: $!" ) );
597 0 ▶ $fh->print( $eol ) ||
Branch: 1 branch
BranchTrueFalseTotal
$fh->print($eol) or return $self->error("Unable to print blank line after headers: $!") 0 0 0
598 return( $self->error( "Unable to print blank line after headers: $!" ) );
599 0 return( $self );
600 }
601  
602 sub push_header
603 500 ▶{
Subroutine push_header: called CC=6 SCAR=18.3
Pod documented
604 500 my $self = shift( @_ );
605  
606 500 ▶ if( @_ % 2 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ % 2) 0 500 500
607 {
608 0 return( $self->error( "push_header() needs an even number of arguments" ) );
609 }
610  
611 500 ▶ for( my $i = 0; $i < @_; $i += 2 )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @_) 500 500 1000
612 {
613 500 my $name = $_[$i];
614 500 my $val = $_[$i + 1];
615  
616 500 ▶ my $cname = $self->_canon_name( $name ) ||
Condition50%1/2
$self->_canon_name($name) || (return $self->pass_error)
l!l
5000
MC/DC0%0/1
$self->_canon_name($name) || (return $self->pass_error)
$self->_canon_name($name)
Truth table50%1/2
A
A= $self->_canon_name($name)
Aresult
11
00
617 return( $self->pass_error );
618  
619 # We get back an array reference
620 500 ▶ my $vals = $self->_coerce_values( $val ) ||
Condition50%1/2
$self->_coerce_values($val) || (return $self->pass_error)
l!l
5000
MC/DC0%0/1
$self->_coerce_values($val) || (return $self->pass_error)
$self->_coerce_values($val)
Truth table50%1/2
A
A= $self->_coerce_values($val)
Aresult
11
00
621 return( $self->pass_error );
622  
623 500 ▶ for( my $j = 0; $j < @$vals; $j++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($j < @$vals) 502 500 1002
624 {
625 502 $self->{_t}->add( $cname => $vals->[ $j ] );
626 }
627 }
628 500 $self->reset(1);
629  
630 500 return( $self );
631 }
632  
633 # remove( $name ) removes all headers with the given name
634 {
635 9 ▶ no warnings 'once';
Subroutine BEGIN: called CC=1 SCAR=0.0
636 # NOTE: sub remove is aliased to remove_header()
637 9 *remove = \&remove_header;
638 }
639  
640 sub remove_header
641 14 ▶{
Subroutine remove_header: called CC=8 SCAR=20.9
Pod documented
642 14 my $self = shift( @_ );
643 14 ▶ if( @_ == 0 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ == 0) 0 14 14
644 {
645 0 return( $self->error( "remove_header() called with no arguments" ) );
646 }
647  
648 14 my @removed_all;
649  
650 14 ▶ for( my $i = 0; $i < @_; $i++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @_) 15 14 29
651 {
652 15 my $name = $_[$i];
653 15 ▶ my $cname = $self->_canon_name( $name ) ||
Condition50%1/2
$self->_canon_name($name) || (return $self->pass_error)
l!l
150
MC/DC0%0/1
$self->_canon_name($name) || (return $self->pass_error)
$self->_canon_name($name)
Truth table50%1/2
A
A= $self->_canon_name($name)
Aresult
11
00
654 return( $self->pass_error );
655  
656 15 my @vals = $self->{_t}->get( $cname );
657 15 ▶ push( @removed_all, @vals ) if( @vals );
Branch: 1 branch
BranchTrueFalseTotal
if @vals 6 9 15
658  
659 15 $self->{_t}->unset( $cname );
660 }
661 14 ▶ $self->reset(1) if( scalar( @removed_all ) );
Branch: 1 branch
BranchTrueFalseTotal
if scalar @removed_all 5 9 14
662  
663 14 ▶ return( wantarray() ? @removed_all : ( scalar( @removed_all ) ? $removed_all[-1] : 0 ) );
Branch: 2 branches
BranchTrueFalseTotal
wantarray ? : 1 13 14
scalar @removed_all ? : 4 9 13
664 }
665  
666 {
667 9 ▶ no warnings 'once';
Subroutine BEGIN: called CC=1 SCAR=0.0
668 # NOTE: sub replace is aliased to replace_header()
669 9 *replace = \&replace_header;
670 }
671  
672 sub replace_header
673 603 ▶{
Subroutine replace_header: called CC=9 SCAR=22.6
Pod documented
674 603 my $self = shift( @_ );
675  
676 603 ▶ if( @_ == 0 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ == 0) 0 603 603
677 {
678 0 return( $self->error( "replace_header() called with no arguments" ) );
679 }
680  
681 603 ▶ if( @_ % 2 )
Branch: 1 branch
BranchTrueFalseTotal
if (@_ % 2) 0 603 603
682 {
683 0 return( $self->error( "replace_header() needs an even number of arguments" ) );
684 }
685  
686 603 my %cleared;
687 603 ▶ for( my $i = 0; $i < @_; $i += 2 )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @_) 603 601 1204
688 {
689 603 my $name = $_[$i];
690 603 my $val = $_[$i + 1];
691  
692 603 ▶ my $cname = $self->_canon_name( $name ) ||
Condition100%2/2
$self->_canon_name($name) || (return $self->pass_error)
l!l
6012
MC/DC100%1/1
$self->_canon_name($name) || (return $self->pass_error)
$self->_canon_name($name)
Truth table100%2/2
A
A= $self->_canon_name($name)
Aresult
11
00
693 return( $self->pass_error );
694  
695 601 my $lkey = lc( $cname );
696 601 $lkey =~ tr/_/-/;
697  
698 601 ▶ if( !$cleared{ $lkey }++ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($cleared{$lkey}++) 601 0 601
699 {
700 601 $self->{_t}->unset( $cname );
701 }
702  
703 # undef => remove header (no re-add)
704 601 ▶ next if( !defined( $val ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $val 0 601 601
705  
706 # We get back an array reference
707 601 ▶ my $vals = $self->_coerce_values( $val ) || return( $self->pass_error );
Condition50%1/2
$self->_coerce_values($val) || (return $self->pass_error)
l!l
6010
MC/DC0%0/1
$self->_coerce_values($val) || (return $self->pass_error)
$self->_coerce_values($val)
Truth table50%1/2
A
A= $self->_coerce_values($val)
Aresult
11
00
708 601 ▶ for( my $j = 0; $j < @$vals; $j++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($j < @$vals) 601 601 1202
709 {
710 601 $self->{_t}->add( $cname => $vals->[ $j ] );
711 }
712 }
713 601 $self->reset(1);
714  
715 # We return the current instance for chaining.
716 601 return( $self );
717 }
718  
719 sub reset
720 1799 ▶{
Subroutine reset: called CC=3 SCAR=11.0
Pod documented
721 1799 my $self = shift( @_ );
722 1799 ▶ $self->{_reset} = scalar( @_ ) if( !CORE::length( $self->{_reset} ) && scalar( @_ ) );
Branch: 1 branch
BranchTrueFalseTotal
if not CORE::length $self->{"_reset"} and scalar @_ 272 1527 1799
Condition100%2/2
not CORE::length $self->{"_reset"} and scalar @_
!ll
1527272
MC/DC100%1/1
not CORE::length $self->{"_reset"} and scalar @_
not CORE::length $self->{"_reset"}
Truth table100%2/2
not(A)
A= not CORE::length $self->{"_reset"}
Aresult
00
11
723 1799 return( $self );
724 }
725  
726 sub scan
727 78 ▶{
Subroutine scan: called CC=3 SCAR=11.3
Pod documented
728 78 my $self = shift( @_ );
729 78 ▶ my $cb = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No callback was provided.'))
l!l
780
MC/DC0%0/1
shift @_ || (return $self->error('No callback was provided.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
730 return( $self->error( "No callback was provided." ) );
731  
732 78 ▶ if( ref( $cb ) ne 'CODE' )
Branch: 1 branch
BranchTrueFalseTotal
if (ref $cb ne "CODE") 0 78 78
733 {
734 0 return( $self->error( "scan expects a CODE reference" ) );
735 }
736  
737 $self->{_t}->do(sub
738 392 ▶ {
Subroutine __ANON__: called CC=1 SCAR=0.0
739 392 my( $k, $v ) = @_;
740 392 $cb->( $k, $v );
741 392 return(1);
742 78 });
743  
744 78 return( $self );
745 }
746  
747 # instead of aliasing it, we redirect so it shows up in a stack trace.
748 221 ▶sub set { return( shift->replace_header( @_ ) ); }
Subroutine set: called CC=1 SCAR=0.0
Pod documented
749  
750 # replace( $name, $value ) is an alias for set(). Provided for API compatibility.
751 # sub replace { return( shift->set( @_ ) ); }
752  
753 sub _canon_name
754 2242 ▶{
Subroutine _canon_name: called CC=3 SCAR=11.0
755 2242 my $self = shift( @_ );
756 2242 ▶ my $name = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No header name was provided.'))
l!l
22420
MC/DC0%0/1
shift @_ || (return $self->error('No header name was provided.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
757 return( $self->error( "No header name was provided." ) );
758  
759 2242 ▶ $self->_validate_field_name( $name ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_validate_field_name($name) or return $self->pass_error 2240 2 2242
760  
761 2240 $name =~ tr/_/-/;
762 2240 return( $self->_display_name( $name ) );
763 }
764  
765 sub _coerce_values
766 1169 ▶{
Subroutine _coerce_values: called CC=7 SCAR=20.4
767 1169 my $self = shift( @_ );
768 1169 my $val = shift( @_ );
769 1169 ▶ unless( defined( $val ) && CORE::length( $val ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $val and CORE::length $val) 0 1169 1169
Condition33%1/3
defined $val and CORE::length $val
!ll&&!rl&&r
001169
MC/DC0%0/2
defined $val and CORE::length $val
defined $val CORE::length $val
Truth table33%1/3
A and B
A= defined $valB= CORE::length $val
ABresult
0X0
100
111
770 {
771 0 return( $self->error( "No header value was provided to coerce." ) );
772 }
773  
774 1169 my @vals;
775 1169 ▶ if( ref( $val ) eq 'ARRAY' )
Branch: 1 branch
BranchTrueFalseTotal
if (ref $val eq 'ARRAY') { } 2 1167 1169
776 {
777 2 ▶ for( my $i = 0; $i < @$val; $i++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < @$val) 4 2 6
778 {
779 4 ▶ my $clean = $self->_sanitize_value( $val->[$i] ) ||
Condition50%1/2
$self->_sanitize_value($val->[$i]) || (return $self->pass_error)
l!l
40
MC/DC0%0/1
$self->_sanitize_value($val->[$i]) || (return $self->pass_error)
$self->_sanitize_value($val->[$i])
Truth table50%1/2
A
A= $self->_sanitize_value($val->[$i])
Aresult
11
00
780 return( $self->pass_error );
781 4 push( @vals, $clean );
782 }
783 }
784 else
785 {
786 1167 ▶ my $clean = $self->_sanitize_value( $val ) ||
Condition50%1/2
$self->_sanitize_value($val) || (return $self->pass_error)
l!l
11670
MC/DC0%0/1
$self->_sanitize_value($val) || (return $self->pass_error)
$self->_sanitize_value($val)
Truth table50%1/2
A
A= $self->_sanitize_value($val)
Aresult
11
00
787 return( $self->pass_error );
788 1167 push( @vals, $clean );
789 }
790  
791 1169 return( \@vals );
792 }
793  
794 sub _display_name
795 2579 ▶{
Subroutine _display_name: called CC=4 SCAR=14.0
796 2579 my $self = shift( @_ );
797 2579 ▶ my $name = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No header name was provided.'))
l!l
25790
MC/DC0%0/1
shift @_ || (return $self->error('No header name was provided.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
798 return( $self->error( "No header name was provided." ) );
799  
800 2579 my $k = lc( $name );
801 2579 $k =~ tr/_/-/;
802  
803 2579 my $canon = $self->_mail_canonical_name( $k );
804 2579 ▶ return( $self->pass_error ) if( !defined( $canon ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $canon 0 2579 2579
805 2579 ▶ return( $canon ) if( $canon );
Branch: 1 branch
BranchTrueFalseTotal
if $canon 2525 54 2579
806  
807 54 return( join( '-', map{ ucfirst( $_ ) } split( /-/, $k ) ) );
808 }
809  
810 sub _fold_header_line
811 339 ▶{
Subroutine _fold_header_line: called CC=7 SCAR=19.7
812 339 my $self = shift( @_ );
813 339 my( $line, $eol, $max ) = @_;
814  
815 339 ▶ $max ||= 78;
Condition50%1/2
$max ||= 78
l!l
3390
MC/DC0%0/1
$max ||= 78
$max
Truth table50%1/2
A
A= $max
Aresult
11
00
816 # Unsigned integer
817 339 ▶ if( $max !~ /^\d+$/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($max =~ /^\d+$/) 0 339 339
818 {
819 0 return( $self->error( "The maximum line length value provided (", $self->_str_val( $max ), ") is not an unsigned integer." ) );
820 }
821  
822 # If already short enough, return unchanged
823 339 ▶ if( CORE::length( $line ) <= $max )
Branch: 1 branch
BranchTrueFalseTotal
if (CORE::length $line <= $max) 329 10 339
824 {
825 329 return( $line );
826 }
827  
828 10 my $out = '';
829 10 ▶ while( CORE::length( $line ) > $max )
Branch: 1 branch
BranchTrueFalseTotal
if (CORE::length $line > $max) 13 10 23
830 {
831 13 my $cut = $max;
832  
833 # Find last WSP within first $max chars
834 13 my $chunk = substr( $line, 0, $max + 1 );
835 13 my $pos_sp = rindex( $chunk, ' ' );
836 13 my $pos_tab = rindex( $chunk, "\t" );
837 13 ▶ my $pos = $pos_sp > $pos_tab ? $pos_sp : $pos_tab;
Branch: 1 branch
BranchTrueFalseTotal
$pos_sp > $pos_tab ? : 13 0 13
838  
839 13 ▶ if( $pos > 0 )
Branch: 1 branch
BranchTrueFalseTotal
if ($pos > 0) 13 0 13
840 {
841 13 $cut = $pos;
842 }
843  
844 13 $out .= substr( $line, 0, $cut ) . $eol . ' ';
845  
846 # Drop leading WSP on the remainder
847 13 $line = substr( $line, $cut );
848 13 $line =~ s/^[ \t]+//;
849 }
850 10 $out .= $line;
851 10 return( $out );
852 }
853  
854 sub _format_rfc5322_date
855 1 ▶{
Subroutine _format_rfc5322_date: called CC=4 SCAR=14.8
856 1 my $self = shift( @_ );
857 1 my $epoch = shift( @_ );
858 1 ▶ if( !defined( $epoch ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $epoch) 0 1 1
859 {
860 0 return( $self->error( "No timestamp was provided to get the mail formatted date." ) );
861 }
862  
863 # Good until 2286
864 1 ▶ unless( $epoch =~ /^\d{1,10}$/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($epoch =~ /^\d{1,10}$/) 0 1 1
865 {
866 0 ▶ return( $self->error( "The timestamp provided is incorrect (", $self->_str_val( $epoch // 'undef' ), "). It should be a 10-digits integer." ) );
Condition0%0/2
$epoch // "undef"
l!l
00
MC/DC0%0/1
$epoch // "undef"
$epoch
Truth table0%0/2
A
A= $epoch
Aresult
11
00
867 }
868  
869 1 my @wd = qw( Sun Mon Tue Wed Thu Fri Sat );
870 1 my @mo = qw( Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec );
871  
872 # localtime gives local TZ; we also need numeric offset +HHMM
873 1 my( $sec, $min, $hour, $mday, $mon, $year, $wday ) = localtime( $epoch );
874  
875 1 $year += 1900;
876  
877 1 my $off = $self->_tz_offset_hhmm( $epoch );
878  
879 # Because providing an $epoch value of 0 would trigger warnings of uninitialized values.
880 9 ▶ no warnings 'uninitialized';
Subroutine BEGIN: called CC=1 SCAR=0.0
881 # Maybe use POSIX::strftime instead ?
882 1 return( sprintf(
883 "%s, %02d %s %04d %02d:%02d:%02d %s",
884 $wd[$wday],
885 $mday,
886 $mo[$mon],
887 $year,
888 $hour,
889 $min,
890 $sec,
891 $off
892 ) );
893 }
894  
895 sub _generate_message_id
896 65 ▶{
Subroutine _generate_message_id: called CC=5 SCAR=20.2
897 65 my( $self, $domain ) = @_;
898  
899 65 ▶ if( !defined( $domain ) || $domain !~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ || $domain !~ /\./ )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $domain and $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ and $domain =~ /\./) 0 65 65
Condition33%2/6
defined $domain and $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ and $domain =~ /\./
!ll&&!rl&&r
0065
defined $domain and $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/
!ll&&!rl&&r
0065
MC/DC0%0/3
defined $domain and $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ and $domain =~ /\./
defined $domain $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ $domain =~ /\./
Truth table25%1/4
A and B and C
A= defined $domainB= $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/C= $domain =~ /\./
ABCresult
0XX0
10X0
1100
1111
900 {
901 0 return( $self->error( "Invalid domain for Message-ID generation." ) );
902 }
903  
904 65 ▶ my $left = $self->_message_id_left_part() ||
Condition50%1/2
$self->_message_id_left_part || (return $self->pass_error)
l!l
650
MC/DC0%0/1
$self->_message_id_left_part || (return $self->pass_error)
$self->_message_id_left_part
Truth table50%1/2
A
A= $self->_message_id_left_part
Aresult
11
00
905 return( $self->pass_error );
906  
907 65 return( '<' . $left . '@' . $domain . '>' );
908 }
909  
910 sub _mail_canonical_name
911 2579 ▶{
Subroutine _mail_canonical_name: called CC=3 SCAR=11.0
912 2579 my $self = shift( @_ );
913 2579 ▶ my $name = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No header name was provided.'))
l!l
25790
MC/DC0%0/1
shift @_ || (return $self->error('No header name was provided.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
914 return( $self->error( "No header name was provided." ) );
915 2579 my $name_lc = lc( $name );
916 2579 ▶ return( $header_fields_canonical->{ $name_lc } ) if( exists( $header_fields_canonical->{ $name_lc } ) );
Branch: 1 branch
BranchTrueFalseTotal
if exists $header_fields_canonical->{$name_lc} 2525 54 2579
917 54 return( '' );
918 }
919  
920 sub _mail_header_order
921 1050 ▶{
Subroutine _mail_header_order: called CC=3 SCAR=11.0
922 1050 my $self = shift( @_ );
923 1050 ▶ my $name_disp = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No header name was provided.'))
l!l
10500
MC/DC0%0/1
shift @_ || (return $self->error('No header name was provided.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
924 return( $self->error( "No header name was provided." ) );
925  
926 1050 my $k = lc( $name_disp );
927 1050 $k =~ tr/_/-/;
928 # Moved the header fields order definition table at the top of this module, as a private variable.
929 1050 ▶ return( exists( $header_fields_order->{ $k } ) ? $header_fields_order->{ $k } : 1000 );
Branch: 1 branch
BranchTrueFalseTotal
exists $header_fields_order->{$k} ? : 1038 12 1050
930 }
931  
932 sub _message_id_left_part
933 65 ▶{
Subroutine _message_id_left_part: called CC=4 SCAR=17.9
934 65 my( $self ) = @_;
935  
936 # Prefer Data::UUID if available
937 65 ▶ if( $self->_load_class( 'Data::UUID' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_load_class("Data::UUID")) 65 0 65
938 {
939 65 my $ug = Data::UUID->new;
940 65 my $bin = $ug->create; # 16 bytes
941  
942 # Base64url, no padding, no newline
943 65 ▶ $self->_load_class( 'MIME::Base64' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("MIME::Base64") or return $self->pass_error 65 0 65
944 65 my $b64 = MIME::Base64::encode_base64( $bin, '' );
945 65 $b64 =~ tr!+/!-_!;
946 65 $b64 =~ s/=+\z//;
947  
948 65 return( $b64 );
949 }
950  
951 # Fallback: time+pid+seq+rand
952 0 my $t = time();
953 0 my $pid = $$;
954  
955 0 our $MSGID_SEQ;
956 0 ▶ $MSGID_SEQ = 0 if( !defined( $MSGID_SEQ ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $Mail::Make::Headers::MSGID_SEQ 0 0 0
957 0 $MSGID_SEQ++;
958  
959 0 my $r = int( rand( 0xFFFFFFFF ) );
960  
961 0 return( sprintf( "%x.%x.%x.%x", $t, $pid, $MSGID_SEQ, $r ) );
962 }
963  
964 sub _normalise_name
965 3 ▶{
Subroutine _normalise_name: called CC=2 SCAR=7.0
966 3 my $self = shift( @_ );
967 3 ▶ my $name = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No header name was provided to normalise.'))
l!l
30
MC/DC0%0/1
shift @_ || (return $self->error('No header name was provided to normalise.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
968 return( $self->error( "No header name was provided to normalise." ) );
969 3 $name = lc( $name );
970 3 $name =~ tr/-//d; # More efficient than $name =~ s/-//g;
971 3 return( $name );
972 }
973  
974 sub _sanitize_value
975 1171 ▶{
Subroutine _sanitize_value: called CC=4 SCAR=16.1
976 1171 my $self = shift( @_ );
977 1171 my $v = shift( @_ );
978  
979 1171 ▶ $v = '' if( !defined( $v ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $v 0 1171 1171
980  
981 # Freeze stringification NOW (important for objects like Module::Generic::HeaderValue)
982 1171 ▶ if( ref( $v ) )
Branch: 1 branch
BranchTrueFalseTotal
if (ref $v) 0 1171 1171
983 {
984 0 ▶ if( !$self->_can_overload( $v => '""' ) )
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->_can_overload($v, "\"\"")) 0 0 0
985 {
986 0 $self->error( "Header value is a reference but is not stringifiable (", $self->_str_val( $v ), ")." );
987 0 return;
988 }
989 0 $v = "$v";
990 }
991  
992 # Allow RFC-style folding: CRLF or LF followed immediately by SP/HTAB.
993 # All other CR/LF sequences (i.e. attempted header injection) are replaced
994 # by a single space instead of being passed through.
995 # First, normalise CRLF -> LF
996 1171 $v =~ s/\r\n/\n/g;
997 # Bare CR -> LF
998 1171 $v =~ s/\r/\n/g;
999 # Unwrap legal folding: LF + WSP -> single space
1000 1171 $v =~ s/\n[ \t]+/ /g;
1001 # Any remaining LF is injection; it replaces with space
1002 1171 $v =~ s/\n/ /g;
1003  
1004 # Remove ASCII control chars except tab
1005 1171 $v =~ s/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]//g;
1006  
1007 1171 return( $v );
1008 }
1009  
1010 # This is normally called by _tz_offset_hhmm()
1011 sub _timegm_approx
1012 2 ▶{
Subroutine _timegm_approx: called CC=6 SCAR=18.6
1013 2 my $self = shift( @_ );
1014 # localtime() and gmtime() return 9 elements in list context; we only need the first 7.
1015 2 ▶ unless( scalar( @_ ) >= 7 )
Branch: 1 branch
BranchTrueFalseTotal
unless (scalar @_ >= 7) 0 2 2
1016 {
1017 0 return( $self->error(
1018 q{_timegm_approx() called improperly. You need to call it as $self->_timegm_approx( $sec, $min, $hour, $mday, $mon, $year, $wday )}
1019 ) );
1020 }
1021 # Discard $yday and $isdst if present
1022 2 my @args = @_[0..6];
1023 2 my @params = qw( seconds minutes hours day month year weekday );
1024 2 ▶ for( my $i = 0; $i < scalar( @args ); $i++ )
Branch: 1 branch
BranchTrueFalseTotal
if ($i < scalar @args) 14 2 16
1025 {
1026 14 ▶ if( !$self->_is_number( $args[$i] ) )
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->_is_number($args[$i])) 0 14 14
1027 {
1028 0 ▶ return( $self->error( "The ", $params[$i], " parameter at offset $i needs to be an integer, but I got '", $self->_str_val( $args[$i] // 'undef' ), "'" ) );
Condition0%0/2
$args[$i] // "undef"
l!l
00
MC/DC0%0/1
$args[$i] // "undef"
$args[$i]
Truth table0%0/2
A
A= $args[$i]
Aresult
11
00
1029 }
1030 }
1031 2 my( $sec, $min, $hour, $mday, $mon, $year, $wday ) = @args;
1032  
1033 # localtime/gmtime give: year since 1900, mon 0..11
1034 2 $year += 1900;
1035  
1036 # Days since epoch, using a civil->days algorithm (no modules).
1037 2 my $y = $year;
1038 2 my $m = $mon + 1;
1039  
1040 2 ▶ if( $m <= 2 )
Branch: 1 branch
BranchTrueFalseTotal
if ($m <= 2) 2 0 2
1041 {
1042 2 $y -= 1;
1043 2 $m += 12;
1044 }
1045  
1046 2 my $era = int( $y / 400 );
1047 2 my $yoe = $y - $era * 400;
1048 2 my $doy = int( ( 153 * ( $m - 3 ) + 2 ) / 5 ) + $mday - 1;
1049 2 my $doe = $yoe * 365 + int( $yoe / 4 ) - int( $yoe / 100 ) + $doy;
1050  
1051 # 719468 is days from 0000-03-01 to 1970-01-01
1052 2 my $days = $era * 146097 + $doe - 719468;
1053  
1054 2 return( $days * 86400 + $hour * 3600 + $min * 60 + $sec );
1055 }
1056  
1057 sub _tz_offset_hhmm
1058 1 ▶{
Subroutine _tz_offset_hhmm: called CC=4 SCAR=14.3
1059 1 my $self = shift( @_ );
1060 1 my $epoch = shift( @_ );
1061  
1062 # Compute offset by comparing localtime and gmtime representations.
1063 # This avoids non-core modules and works across DST changes.
1064 1 my @l = localtime( $epoch );
1065 1 my @g = gmtime( $epoch );
1066  
1067 1 my $lsec = $self->_timegm_approx( @l );
1068 1 ▶ return( $self->pass_error ) if( !defined( $lsec ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $lsec 0 1 1
1069 1 my $gsec = $self->_timegm_approx( @g );
1070 1 ▶ return( $self->pass_error ) if( !defined( $gsec ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $gsec 0 1 1
1071  
1072 1 my $delta = $lsec - $gsec; # seconds east of UTC
1073  
1074 1 my $sign = '+';
1075 1 ▶ if( $delta < 0 )
Branch: 1 branch
BranchTrueFalseTotal
if ($delta < 0) 0 1 1
1076 {
1077 0 $sign = '-';
1078 0 $delta = -$delta;
1079 }
1080  
1081 1 my $hh = int( $delta / 3600 );
1082 1 my $mm = int( ( $delta % 3600 ) / 60 );
1083  
1084 1 return( sprintf( "%s%02d%02d", $sign, $hh, $mm ) );
1085 }
1086  
1087 sub _validate_date_value
1088 0 ▶{
Subroutine _validate_date_value: not called CC=3 SCAR=24.8
1089 0 my( $self, $v ) = @_;
1090  
1091 # ASCII printable only (SP .. ~), no CR/LF (already handled elsewhere, but we must be explicit)
1092 # if( $v !~ /\A[\x20-\x7E]*\z/ || $v =~ /[\r\n]/ )
1093 0 ▶ if( $v !~ /\A[\x20-\x7E]*\z/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($v =~ /\A[\x20-\x7E]*\z/) 0 0 0
1094 {
1095 0 return( $self->error( "Invalid Date header (non-ASCII or contains line breaks)." ) );
1096 }
1097  
1098 # Trim outer blanks for matching
1099 0 $v =~ s/\A[[:blank:]]+//;
1100 0 $v =~ s/[[:blank:]]+\z//;
1101  
1102 # Optional weekday, strict month names, strict numeric TZ
1103 0 my $wd = qr/(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)/;
1104 0 my $mo = qr/(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)/;
1105  
1106 0 my $re = qr/
1107 \A
1108 (?:
1109 $wd , [[:blank:]]+
1110 )?
1111 (?:0?[1-9]|[12][0-9]|3[01])
1112 [[:blank:]]+
1113 $mo
1114 [[:blank:]]+
1115 [12][0-9]{3}
1116 [[:blank:]]+
1117 (?:[01][0-9]|2[0-3])
1118 :
1119 [0-5][0-9]
1120 :
1121 [0-5][0-9]
1122 [[:blank:]]+
1123 [+-][0-9]{4}
1124 \z
1125 /x;
1126  
1127 0 ▶ if( $v !~ $re )
Branch: 1 branch
BranchTrueFalseTotal
unless ($v =~ /$re/) 0 0 0
1128 {
1129 0 return( $self->error( "Invalid Date header syntax." ) );
1130 }
1131 0 return(1);
1132 }
1133  
1134 sub _validate_field_name
1135 2242 ▶{
Subroutine _validate_field_name: called CC=3 SCAR=11.0
1136 2242 my $self = shift( @_ );
1137 2242 ▶ my $name = shift( @_ ) ||
Condition50%1/2
shift @_ || (return $self->error('No field name was provided to check.'))
l!l
22420
MC/DC0%0/1
shift @_ || (return $self->error('No field name was provided to check.'))
shift @_
Truth table50%1/2
A
A= shift @_
Aresult
11
00
1138 return( $self->error( "No field name was provided to check." ) );
1139  
1140 2242 ▶ unless( $name =~ /^[\x21-\x39\x3B-\x7E]+$/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($name =~ /^[\x21-\x39\x3B-\x7E]+$/) 2 2240 2242
1141 {
1142 2 return( $self->error( "Invalid header field name '${name}': must be printable ASCII with no colon or whitespace." ) );
1143 }
1144 2240 return(1);
1145 }
1146  
1147 sub _validate_message_id_value
1148 0 ▶{
Subroutine _validate_message_id_value: not called CC=7 SCAR=40.3
1149 0 my( $self, $v ) = @_;
1150  
1151 # ASCII visible only, no spaces, no control chars
1152 0 ▶ if( $v !~ /\A[\x21-\x7E]+\z/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($v =~ /\A[\x21-\x7E]+\z/) 0 0 0
1153 {
1154 0 return( $self->error( "Invalid Message-ID (non-ASCII or contains spaces/control characters)." ) );
1155 }
1156  
1157 # Must be wrapped in angle brackets
1158 0 ▶ if( $v !~ /\A<([^<>]+)>\z/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($v =~ /\A<([^<>]+)>\z/) 0 0 0
1159 {
1160 0 return( $self->error( "Invalid Message-ID (missing angle brackets)." ) );
1161 }
1162  
1163 0 my $inner = $1;
1164  
1165 # Exactly one '@'
1166 0 ▶ if( $inner !~ /\A([^@]+)\@([^@]+)\z/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($inner =~ /\A([^\@]+)\@([^\@]+)\z/) 0 0 0
1167 {
1168 0 return( $self->error( "Invalid Message-ID (must contain exactly one '\@')." ) );
1169 }
1170  
1171 0 my $local = $1;
1172 0 my $domain = $2;
1173  
1174 # Local-part: pragmatic (not full RFC)
1175 0 ▶ if( $local !~ /\A[A-Za-z0-9.!#\$%&'\*\+\/=\?\^_`\{\|\}~\-]+\z/ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($local =~ m[\A[A-Za-z0-9.!#\$%&'\*\+/=\?\^_`\{\|\}~\-]+\z]) 0 0 0
1176 {
1177 0 return( $self->error( "Invalid Message-ID local-part." ) );
1178 }
1179  
1180 # Domain: pragmatic
1181 0 ▶ if( $domain !~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ || $domain !~ /\./ )
Branch: 1 branch
BranchTrueFalseTotal
unless ($domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ and $domain =~ /\./) 0 0 0
Condition0%0/3
$domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ and $domain =~ /\./
!ll&&!rl&&r
000
MC/DC0%0/2
$domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ and $domain =~ /\./
$domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/ $domain =~ /\./
Truth table0%0/3
A and B
A= $domain =~ /\A[A-Za-z0-9](?:[A-Za-z0-9\-\.]*[A-Za-z0-9])?\z/B= $domain =~ /\./
ABresult
0X0
100
111
1182 {
1183 0 return( $self->error( "Invalid Message-ID domain." ) );
1184 }
1185  
1186 0 return(1);
1187 }
1188  
1189 9 1;
1190 # NOTE: POD
1191 __END__
« Mail/Make/Stream/QuotedPrint.pm ↑ Summary Mail/Make/Headers/Generic.pm »