Changes/Release.pm

filter: Statementstmt 77.0% 212 / 275 Branchbran 44.6% 58 / 130 Conditioncond 47.2% 51 / 108 MC/DCmcdc 13.5% 8 / 59 Subroutinesub 83.0% 44 / 53 Podpod 93.3% 28 / 30 totaltotal 61.2% 401 / 655 CC 110 SCAR 35.1
CC
110
Cov
63%
as_string
91.9
delete_group
90.0
delete_change
72.0
CRAP 33.6
« Changes/Version.pm ↑ Summary Changes/Change.pm »
1 ##----------------------------------------------------------------------------
2 ## Changes file management - ~/lib/Changes/Release.pm
3 ## Version v0.2.3
4 ## Copyright(c) 2023 DEGUEST Pte. Ltd.
5 ## Author: Jacques Deguest <jack@deguest.jp>
6 ## Created 2022/11/23
7 ## Modified 2025/07/28
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 Changes::Release;
15 BEGIN
16 19 ▶{
Subroutine BEGIN: called CC=1 SCAR=0.0
17 19 ▶ use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
18 19 ▶ use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 19 ▶ use warnings::register;
Subroutine BEGIN: called CC=1 SCAR=0.0
20 19 ▶ use parent qw( Module::Generic );
Subroutine BEGIN: called CC=1 SCAR=0.0
21 19 ▶ use vars qw( $VERSION $VERSION_CLASS $DEFAULT_DATETIME_FORMAT );
Subroutine BEGIN: called CC=1 SCAR=0.0
22 19 ▶ use Changes::Group;
Subroutine BEGIN: called CC=1 SCAR=0.0
23 19 ▶ use Changes::Version;
Subroutine BEGIN: called CC=1 SCAR=0.0
24 19 ▶ use DateTime::Lite;
Subroutine BEGIN: called CC=1 SCAR=0.0
25 19 ▶ use Wanted;
Subroutine BEGIN: called CC=1 SCAR=0.0
26 19 our $VERSION_CLASS = 'Changes::Version';
27 19 our $DEFAULT_DATETIME_FORMAT = '%FT%T%z';
28 19 our $VERSION = 'v0.2.3';
29 };
30  
31 19 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
32 19 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
33  
34 sub init
35 47 ▶{
Subroutine init: called CC=2 SCAR=6.9
Pod documented
36 47 my $self = shift( @_ );
37 47 $self->{changes} = [];
38 47 $self->{container} = undef;
39 47 $self->{datetime} = undef;
40 47 $self->{datetime_formatter} = undef;
41 47 $self->{defaults} = undef;
42 47 $self->{elements} = [];
43 # DateTime::Lite format
44 47 $self->{format} = undef;
45 47 $self->{line} = undef;
46 47 $self->{nl} = "\n";
47 47 $self->{note} = undef;
48 47 $self->{raw} = undef;
49 47 $self->{spacer} = undef;
50 47 $self->{time_zone} = undef;
51 47 $self->{version} = '';
52 47 $self->{_init_strict_use_sub} = 1;
53 47 ▶ $self->SUPER::init( @_ ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->SUPER::init(@_) or return $self->pass_error 47 0 47
54 47 $self->{_reset} = 1;
55 47 return( $self );
56 }
57  
58 sub add_change
59 1 ▶{
Subroutine add_change: called CC=5 SCAR=20.4
Pod documented
60 1 my $self = shift( @_ );
61 1 my( $change, $opts );
62 1 my $elements = $self->elements;
63 1 ▶ if( scalar( @_ ) == 1 && $self->_is_a( $_[0] => 'Changes::Change' ) )
Branch: 1 branch
BranchTrueFalseTotal
if (scalar @_ == 1 and $self->_is_a($_[0], 'Changes::Change')) { } 0 1 1
Condition33%1/3
scalar @_ == 1 and $self->_is_a($_[0], "Changes::Change")
!ll&&!rl&&r
100
MC/DC0%0/2
scalar @_ == 1 and $self->_is_a($_[0], "Changes::Change")
scalar @_ == 1 $self->_is_a($_[0], "Changes::Change")
Truth table33%1/3
A and B
A= scalar @_ == 1B= $self->_is_a($_[0], "Changes::Change")
ABresult
0X0
100
111
64 {
65 0 $change = shift( @_ );
66 0 ▶ if( $elements->exists( $change ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($elements->exists($change)) 0 0 0
67 {
68 0 $self->_load_class( 'overload' );
69 0 return( $self->error( "A very same change object (", overload::StrVal( $change ), ") is already registered." ) );
70 }
71 }
72 else
73 {
74 1 $opts = $self->_get_args_as_hash( @_ );
75 1 ▶ $change = $self->new_change( %$opts ) || return( $self->pass_error );
Condition50%1/2
$self->new_change(%$opts) || (return $self->pass_error)
l!l
10
MC/DC0%0/1
$self->new_change(%$opts) || (return $self->pass_error)
$self->new_change(%$opts)
Truth table50%1/2
A
A= $self->new_change(%$opts)
Aresult
11
00
76 }
77 1 $elements->push( $change );
78 1 return( $change );
79 }
80  
81 sub add_group
82 4 ▶{
Subroutine add_group: called CC=11 SCAR=26.3
Pod documented
83 4 my $self = shift( @_ );
84 4 my( $group, $opts );
85 4 my $elements = $self->elements;
86 4 ▶ if( scalar( @_ ) == 1 && $self->_is_a( $_[0] => 'Changes::Group' ) )
Branch: 1 branch
BranchTrueFalseTotal
if (scalar @_ == 1 and $self->_is_a($_[0], 'Changes::Group')) { } 2 2 4
Condition66%2/3
scalar @_ == 1 and $self->_is_a($_[0], "Changes::Group")
!ll&&!rl&&r
202
MC/DC50%1/2
scalar @_ == 1 and $self->_is_a($_[0], "Changes::Group")
scalar @_ == 1 $self->_is_a($_[0], "Changes::Group")
Truth table66%2/3
A and B
A= scalar @_ == 1B= $self->_is_a($_[0], "Changes::Group")
ABresult
0X0
100
111
87 {
88 2 $group = shift( @_ );
89 2 ▶ if( $elements->exists( $group ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($elements->exists($group)) 0 2 2
90 {
91 0 $self->_load_class( 'overload' );
92 0 return( $self->error( "A very same group object (", overload::StrVal( $group ), ") is already registered." ) );
93 }
94 2 my $name = $group->name;
95 2 ▶ if( !defined( $name ) || !length( "$name" ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $name and length "$name") 0 2 2
Condition33%1/3
defined $name and length "$name"
!ll&&!rl&&r
002
MC/DC0%0/2
defined $name and length "$name"
defined $name length "$name"
Truth table33%1/3
A and B
A= defined $nameB= length "$name"
ABresult
0X0
100
111
96 {
97 0 return( $self->error( "Group object provided has empty name." ) );
98 }
99 2 ▶ my $same = $elements->grep(sub{ $self->_is_a( $_ => 'Changes::Group' ) && ( ( $_->name // '' ) eq "$name" ) });
Subroutine __ANON__: called CC=3 SCAR=12.0
Branch: 1 branch
BranchTrueFalseTotal
$self->_is_a($_, "Changes::Group") and ($_->name // "") eq "$name" 1 0 1
Condition50%1/2
$_->name // ""
l!l
10
MC/DC0%0/1
$_->name // ""
$_->name
Truth table50%1/2
A
A= $_->name
Aresult
11
00
100 2 ▶ return( $self->error( "A similar group with name '$name' is already registered." ) ) if( !$same->is_empty );
Branch: 1 branch
BranchTrueFalseTotal
unless $same->is_empty 0 2 2
101 }
102 else
103 {
104 2 $opts = $self->_get_args_as_hash( @_ );
105 2 ▶ $group = $self->new_group( %$opts ) || return( $self->pass_error );
Condition50%1/2
$self->new_group(%$opts) || (return $self->pass_error)
l!l
20
MC/DC0%0/1
$self->new_group(%$opts) || (return $self->pass_error)
$self->new_group(%$opts)
Truth table50%1/2
A
A= $self->new_group(%$opts)
Aresult
11
00
106 2 return( $self->add_group( $group ) );
107 }
108 2 my $last = $elements->last;
109 # If we are not the first element of this release, and the last element is not a blank new line, we add one to separate this new group from the preceding rest
110 2 ▶ if( $elements->length && !$self->_is_a( $last => 'Changes::NewLine' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($elements->length and not $self->_is_a($last, "Changes::NewLine")) 1 1 2
Condition66%2/3
$elements->length and not $self->_is_a($last, "Changes::NewLine")
!ll&&!rl&&r
101
MC/DC50%1/2
$elements->length and not $self->_is_a($last, "Changes::NewLine")
$elements->length not $self->_is_a($last, "Changes::NewLine")
Truth table66%2/3
A and not(B)
A= $elements->lengthB= not $self->_is_a($last, "Changes::NewLine")
ABresult
0X0
100
111
111 {
112 1 ▶ $elements->push( $self->new_line( nl => ( $self->nl // "\n" ) ) );
Condition50%1/2
$self->nl // "\n"
l!l
10
MC/DC0%0/1
$self->nl // "\n"
$self->nl
Truth table50%1/2
A
A= $self->nl
Aresult
11
00
113 }
114 2 $elements->push( $group );
115 2 return( $group );
116 }
117  
118 sub as_string
119 47 ▶{
Subroutine as_string: called CC=37 SCAR=45.2
Pod documented
120 47 my $self = shift( @_ );
121 47 ▶ if( !exists( $self->{_reset} ) ||
Branch: 1 branch
BranchTrueFalseTotal
unless (exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}) 44 3 47
Condition66%4/6
exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}
!ll&&!rl&&r
4403
exists $self->{"_reset"} and defined $self->{"_reset"}
!ll&&!rl&&r
4403
MC/DC33%1/3
exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}
exists $self->{"_reset"} defined $self->{"_reset"} length $self->{"_reset"}
Truth table50%2/4
A and B and C
A= exists $self->{"_reset"}B= defined $self->{"_reset"}C= length $self->{"_reset"}
ABCresult
0XX0
10X0
1100
1111
122 !defined( $self->{_reset} ) ||
123 !CORE::length( $self->{_reset} ) )
124 {
125 44 my $cache;
126 44 ▶ if( exists( $self->{_cache_value} ) &&
Branch: 2 branches
BranchTrueFalseTotal
if (exists $self->{'_cache_value'} and defined $self->{'_cache_value'} and length $self->{'_cache_value'}) { } 2 42 44
elsif (defined $self->{'raw'} and length "$self->{'raw'}") { } 42 0 42
Condition66%4/6
exists $self->{"_cache_value"} and defined $self->{"_cache_value"} and length $self->{"_cache_value"}
!ll&&!rl&&r
4202
exists $self->{"_cache_value"} and defined $self->{"_cache_value"}
!ll&&!rl&&r
4202
MC/DC33%1/3
exists $self->{"_cache_value"} and defined $self->{"_cache_value"} and length $self->{"_cache_value"}
exists $self->{"_cache_value"} defined $self->{"_cache_value"} length $self->{"_cache_value"}
Truth table50%2/4
A and B and C
A= exists $self->{"_cache_value"}B= defined $self->{"_cache_value"}C= length $self->{"_cache_value"}
ABCresult
0XX0
10X0
1100
1111
127 defined( $self->{_cache_value} ) &&
128 length( $self->{_cache_value} ) )
129 {
130 2 $cache = $self->{_cache_value};
131 }
132 ▶ elsif( defined( $self->{raw} ) && length( "$self->{raw}" ) )
Condition33%1/3
defined $self->{"raw"} and length qq[$self->{"raw"}]
!ll&&!rl&&r
0042
MC/DC0%0/2
defined $self->{"raw"} and length qq[$self->{"raw"}]
defined $self->{"raw"} length qq[$self->{"raw"}]
Truth table33%1/3
A and B
A= defined $self->{"raw"}B= length qq[$self->{"raw"}]
ABresult
0X0
100
111
133 {
134 42 $cache = $self->{raw};
135 }
136  
137 44 my $lines = $self->new_array( $cache->scalar );
138 $self->elements->foreach(sub
139 42 ▶ {
Subroutine __ANON__: called CC=2 SCAR=7.1
140 42 my $this = $_->as_string;
141 42 ▶ if( defined( $this ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $this) 42 0 42
142 {
143 42 $lines->push( $this->scalar );
144 }
145 44 });
146 # my $str = $lines->join( "\n" );
147 44 my $str = $lines->join( '' );
148 44 return( $str );
149 }
150 3 my $v = $self->version;
151 3 ▶ return( $self->error( "No version set yet. Set a version before calling as_string()" ) ) if( !defined( $v ) || !length( "$v" ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $v and length "$v" 0 3 3
Condition33%1/3
defined $v and length "$v"
!ll&&!rl&&r
003
MC/DC0%0/2
defined $v and length "$v"
defined $v length "$v"
Truth table33%1/3
A and B
A= defined $vB= length "$v"
ABresult
0X0
100
111
152 3 my $dt = $self->datetime;
153 3 my $code = $self->datetime_formatter;
154 3 ▶ if( defined( $code ) && ref( $code ) eq 'CODE' )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $code and ref $code eq "CODE") 1 2 3
Condition66%2/3
defined $code and ref $code eq "CODE"
!ll&&!rl&&r
201
MC/DC50%1/2
defined $code and ref $code eq "CODE"
defined $code ref $code eq "CODE"
Truth table66%2/3
A and B
A= defined $codeB= ref $code eq "CODE"
ABresult
0X0
100
111
155 {
156 # try-catch
157 1 local $@;
158 $dt = eval
159 1 {
160 1 ▶ $code->( defined( $dt ) ? $dt : () );
Branch: 1 branch
BranchTrueFalseTotal
defined $dt ? : 1 0 1
161 };
162 1 ▶ if( $@ )
Branch: 1 branch
BranchTrueFalseTotal
if ($@) 0 1 1
163 {
164 0 ▶ warn( "Warning only: error with datetime formatter calback: $@\n" ) if( $self->_warnings_is_enabled( 'Changes' ) );
Branch: 1 branch
BranchTrueFalseTotal
if $self->_warnings_is_enabled("Changes") 0 0 0
165 }
166 }
167 3 ▶ if( !defined( $dt ) || !length( "$dt" ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $dt and length "$dt") 0 3 3
Condition33%1/3
defined $dt and length "$dt"
!ll&&!rl&&r
003
MC/DC0%0/2
defined $dt and length "$dt"
defined $dt length "$dt"
Truth table33%1/3
A and B
A= defined $dtB= length "$dt"
ABresult
0X0
100
111
168 {
169 0 $dt = DateTime::Lite->now;
170 }
171  
172 3 my $fmt_pattern = $self->format;
173 3 ▶ $fmt_pattern = $DEFAULT_DATETIME_FORMAT if( defined( $fmt_pattern ) && $fmt_pattern eq 'default' );
Branch: 1 branch
BranchTrueFalseTotal
if defined $fmt_pattern and $fmt_pattern eq "default" 0 3 3
Condition33%1/3
defined $fmt_pattern and $fmt_pattern eq "default"
!ll&&!rl&&r
030
MC/DC0%0/2
defined $fmt_pattern and $fmt_pattern eq "default"
defined $fmt_pattern $fmt_pattern eq "default"
Truth table33%1/3
A and B
A= defined $fmt_patternB= $fmt_pattern eq "default"
ABresult
0X0
100
111
174 3 my $tz = $self->time_zone;
175 3 ▶ if( ( !defined( $fmt_pattern ) || !length( "$fmt_pattern" ) ) &&
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $fmt_pattern && length "$fmt_pattern" || $dt->formatter and defined $Changes::Release::DEFAULT_DATETIME_FORMAT and length "$Changes::Release::DEFAULT_DATETIME_FORMAT") 0 3 3
Condition33%4/12
not defined $fmt_pattern && length "$fmt_pattern" || $dt->formatter and defined $Changes::Release::DEFAULT_DATETIME_FORMAT and length "$Changes::Release::DEFAULT_DATETIME_FORMAT"
!ll&&!rl&&r
300
not defined $fmt_pattern && length "$fmt_pattern" || $dt->formatter and defined $Changes::Release::DEFAULT_DATETIME_FORMAT
!ll&&!rl&&r
300
defined $fmt_pattern && length "$fmt_pattern" || $dt->formatter
l!l&&r!l&&!r
300
defined $fmt_pattern and length "$fmt_pattern"
!ll&&!rl&&r
003
MC/DC0%0/5
not defined $fmt_pattern && length "$fmt_pattern" || $dt->formatter and defined $Changes::Release::DEFAULT_DATETIME_FORMAT and length "$Changes::Release::DEFAULT_DATETIME_FORMAT"
defined $fmt_pattern length "$fmt_pattern" $dt->formatter defined $Changes::Release::DEFAULT_DATETIME_FORMAT length "$Changes::Release::DEFAULT_DATETIME_FORMAT"
Truth table11%1/9
not(A and B || C) and D and E
A= defined $fmt_patternB= length "$fmt_pattern"C= $dt->formatterD= defined $Changes::Release::DEFAULT_DATETIME_FORMATE= length "$Changes::Release::DEFAULT_DATETIME_FORMAT"
ABCDEresult
11XXX0
0X1XX0
101XX0
0X00X0
1000X0
0X0100
100100
0X0111
100111
176 !$dt->formatter &&
177 defined( $DEFAULT_DATETIME_FORMAT ) &&
178 length( "$DEFAULT_DATETIME_FORMAT" ) )
179 {
180 0 $fmt_pattern = $DEFAULT_DATETIME_FORMAT;
181 }
182 3 ▶ if( defined( $tz ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $tz) 3 0 3
183 {
184 # try-catch
185 3 local $@;
186 eval
187 3 {
188 3 $dt->set_time_zone( $tz );
189 };
190 3 ▶ if( $@ )
Branch: 1 branch
BranchTrueFalseTotal
if ($@) 0 3 3
191 {
192 0 ▶ warn( "Warning only: error trying to set the time zone '", $tz->name, "' (", overload::StrVal( $tz ), ") to DateTime::Lite object: $@\n" ) if( $self->_warnings_is_enabled( 'Changes' ) );
Branch: 1 branch
BranchTrueFalseTotal
if $self->_warnings_is_enabled("Changes") 0 0 0
193 }
194 }
195 3 ▶ if( defined( $fmt_pattern ) &&
Branch: 1 branch
BranchTrueFalseTotal
if (defined $fmt_pattern and length "$fmt_pattern") 3 0 3
Condition33%1/3
defined $fmt_pattern and length "$fmt_pattern"
!ll&&!rl&&r
003
MC/DC0%0/2
defined $fmt_pattern and length "$fmt_pattern"
defined $fmt_pattern length "$fmt_pattern"
Truth table33%1/3
A and B
A= defined $fmt_patternB= length "$fmt_pattern"
ABresult
0X0
100
111
196 length( "$fmt_pattern" ) )
197 {
198 # try-catch
199 3 local $@;
200 eval
201 3 {
202 3 require DateTime::Format::Lite;
203 };
204 3 ▶ if( $@ )
Branch: 1 branch
BranchTrueFalseTotal
if ($@) 0 3 3
205 {
206 0 return( $self->error( "Unable to load DateTime::Format::Lite: $@" ) );
207 }
208 3 my $dt_fmt = DateTime::Format::Lite->new(
209 pattern => $fmt_pattern,
210 locale => 'en_GB',
211 );
212 3 ▶ if( !defined( $dt_fmt ) && DateTime::Format::Lite->error )
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $dt_fmt and "DateTime::Format::Lite"->error) 0 3 3
Condition33%1/3
not defined $dt_fmt and "DateTime::Format::Lite"->error
!ll&&!rl&&r
300
MC/DC0%0/2
not defined $dt_fmt and "DateTime::Format::Lite"->error
not defined $dt_fmt "DateTime::Format::Lite"->error
Truth table33%1/3
not(A) and B
A= not defined $dt_fmtB= "DateTime::Format::Lite"->error
ABresult
0X0
100
111
213 {
214 0 return( $self->error( "Error trying to set formatter for format '${fmt_pattern}': ", DateTime::Format::Lite->error ) );
215 }
216 3 ▶ $dt->set_formatter( $dt_fmt ) ||
Branch: 1 branch
BranchTrueFalseTotal
$dt->set_formatter($dt_fmt) or return $self->error("Error trying to set formatter for format '${fmt_pattern}': ", "DateTime::Format::Lite"->error) 3 0 3
217 return( $self->error( "Error trying to set formatter for format '${fmt_pattern}': ", DateTime::Format::Lite->error ) );
218 }
219 3 my $nl = $self->nl;
220 3 my $lines = $self->new_array;
221 3 ▶ my $rel_str = $self->new_scalar( $v . ( $self->spacer // ' ' ) . "$dt" . ( $self->note->length ? ( ' ' . $self->note->scalar ) : '' ) . ( $nl // '' ) );
Branch: 1 branch
BranchTrueFalseTotal
$self->note->length ? : 1 2 3
Condition75%3/4
$self->spacer // " "
l!l
12
$nl // ""
l!l
30
MC/DC100%1/1
$self->spacer // " "
$self->spacer
MC/DC0%0/1
$nl // ""
$nl
Truth table100%2/2
A
A= $self->spacer
Aresult
11
00
Truth table50%1/2
A
A= $nl
Aresult
11
00
222 3 $lines->push( $rel_str->scalar );
223 $self->elements->foreach(sub
224 4 ▶ {
Subroutine __ANON__: called CC=2 SCAR=7.1
225 4 my $this = $_->as_string;
226 4 ▶ if( defined( $this ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $this) 4 0 4
227 {
228 4 $lines->push( $this->scalar );
229 }
230 3 });
231 # my $str = $lines->join( "$nl" );
232 3 my $str = $lines->join( '' );
233 3 $self->{_cache_value} = $str;
234 3 CORE::delete( $self->{_reset} );
235 3 return( $str );
236 }
237  
238 sub changes
239 156 ▶{
Subroutine changes: called CC=1 SCAR=0.0
Pod documented
240 156 my $self = shift( @_ );
241 # my $a = $self->elements->grep(sub{ $self->_is_a( $_ => 'Changes::Change' ) });
242 # We account for both Changes::Change objects registered directly under this release object, and
243 # and Changes::Change objects registered under any Changes::Group objects
244 156 my $a = $self->new_array;
245 $self->elements->foreach(sub
246 110 ▶ {
Subroutine __ANON__: called CC=4 SCAR=14.1
247 110 ▶ if( $self->_is_a( $_ => 'Changes::Change' ) )
Branch: 2 branches
BranchTrueFalseTotal
if ($self->_is_a($_, 'Changes::Change')) { } 102 8 110
elsif ($self->_is_a($_, 'Changes::Group')) { } 8 0 8
248 {
249 102 $a->push( $_ );
250 }
251 elsif( $self->_is_a( $_ => 'Changes::Group' ) )
252 {
253 8 ▶ my $changes = $_->elements->grep(sub{ $self->_is_a( $_ => 'Changes::Change' ) });
Subroutine __ANON__: called CC=1 SCAR=0.0
254 8 ▶ $a->push( $changes->list ) if( defined( $changes ) );
Branch: 1 branch
BranchTrueFalseTotal
if defined $changes 8 0 8
255 }
256 156 });
257 156 return( $a );
258 }
259  
260 44 ▶sub container { return( shift->_set_get_object_without_init( 'container', 'Changes', @_ ) ); }
Subroutine container: called CC=1 SCAR=0.0
Pod documented
261  
262 86 ▶sub datetime { return( shift->reset(@_)->_set_get_datetime( 'datetime', @_ ) ); }
Subroutine datetime: called CC=1 SCAR=0.0
Pod documented
263  
264 5 ▶sub datetime_formatter { return( shift->reset(@_)->_set_get_code( { field => 'datetime_formatter', undef_ok => 1 }, @_ ) ); }
Subroutine datetime_formatter: called CC=1 SCAR=0.0
Pod documented
265  
266 5 ▶sub defaults { return( shift->_set_get_hash_as_mix_object( { field => 'defaults', undef_ok => 1 }, @_ ) ); }
Subroutine defaults: called CC=1 SCAR=0.0
Pod documented
267  
268 sub delete_change
269 0 ▶{
Subroutine delete_change: not called CC=8 SCAR=42.8
Pod documented
270 0 my $self = shift( @_ );
271 0 my $elements = $self->elements;
272 0 my $removed = $self->new_array;
273 0 $self->_load_class( 'overload' );
274 0 foreach my $change ( @_ )
275 {
276 0 ▶ if( $self->_is_a( $change => 'Changes::Change' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_is_a($change, 'Changes::Change')) { } 0 0 0
277 {
278 0 my $pos = $elements->pos( $change );
279 0 ▶ if( !defined( $pos ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $pos) 0 0 0
280 {
281 0 next;
282 }
283 0 my $deleted = $elements->delete( $pos, 1 );
284 0 ▶ $removed->push( $deleted->list ) if( !$deleted->is_empty );
Branch: 1 branch
BranchTrueFalseTotal
unless $deleted->is_empty 0 0 0
285 }
286 else
287 {
288 0 ▶ warn( "I was expecting a Changes::Change object, but instead got '", ( $_[0] // '' ), "' (", ( defined( $_[0] ) ? overload::StrVal( $_[0] ) : 'undef' ), ").\n" ) if( $self->_warnings_is_enabled );
Branch: 2 branches
BranchTrueFalseTotal
if $self->_warnings_is_enabled 0 0 0
defined $_[0] ? : 0 0 0
Condition0%0/2
$_[0] // ""
l!l
00
MC/DC0%0/1
$_[0] // ""
$_[0]
Truth table0%0/2
A
A= $_[0]
Aresult
11
00
289 }
290 }
291 0 return( $removed );
292 }
293  
294 sub delete_group
295 0 ▶{
Subroutine delete_group: not called CC=9 SCAR=45.0
Pod documented
296 0 my $self = shift( @_ );
297 0 my $elements = $self->elements;
298 0 my $removed = $self->new_array;
299 0 $self->_load_class( 'overload' );
300 0 foreach my $group ( @_ )
301 {
302 0 ▶ if( $self->_is_a( $group => 'Changes::Group' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_is_a($group, 'Changes::Group')) { } 0 0 0
303 {
304 0 my $pos = $elements->pos( $group );
305 0 ▶ if( !defined( $pos ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $pos) 0 0 0
306 {
307 0 next;
308 }
309 0 my $deleted = $elements->delete( $pos, 1 );
310 0 ▶ $removed->push( $deleted->list ) if( !$deleted->is_empty );
Branch: 1 branch
BranchTrueFalseTotal
unless $deleted->is_empty 0 0 0
311 }
312 else
313 {
314 0 my $name = $group;
315 0 ▶ if( !defined( $name ) || !length( "$name" ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $name and length "$name") 0 0 0
Condition0%0/3
defined $name and length "$name"
!ll&&!rl&&r
000
MC/DC0%0/2
defined $name and length "$name"
defined $name length "$name"
Truth table0%0/3
A and B
A= defined $nameB= length "$name"
ABresult
0X0
100
111
316 {
317 0 ▶ warn( "No group name provided to remove its corresponding group object.\n" ) if( $self->_warnings_is_enabled );
Branch: 1 branch
BranchTrueFalseTotal
if $self->_warnings_is_enabled 0 0 0
318 0 next;
319 }
320 0 ▶ my $found = $elements->grep(sub{ $self->_is_a( $_ => 'Changes::Group' ) && $_->name eq "$name" });
Subroutine __ANON__: not called CC=2 SCAR=17.9
Branch: 1 branch
BranchTrueFalseTotal
$self->_is_a($_, "Changes::Group") and $_->name eq "$name" 0 0 0
321 0 ▶ if( $found->is_empty )
Branch: 1 branch
BranchTrueFalseTotal
if ($found->is_empty) 0 0 0
322 {
323 0 next;
324 }
325 $found->foreach(sub
326 0 ▶ {
Subroutine __ANON__: not called CC=2 SCAR=17.9
327 0 my $deleted = $self->delete_group( $_ );
328 0 ▶ $removed->push( $deleted->list ) if( !$deleted->is_empty );
Branch: 1 branch
BranchTrueFalseTotal
if not $deleted->is_empty 0 0 0
329 0 });
330 }
331 }
332 0 return( $removed );
333 }
334  
335 298 ▶sub elements { return( shift->_set_get_array_as_object( 'elements', @_ ) ); }
Subroutine elements: called CC=1 SCAR=0.0
Pod documented
336  
337 7 ▶sub format { return( shift->reset(@_)->_set_get_scalar_as_object( 'format', @_ ) ); }
Subroutine format: called CC=1 SCAR=0.0
Pod documented
338  
339 sub freeze
340 44 ▶{
Subroutine freeze: called CC=1 SCAR=0.0
Pod undocumented
341 44 my $self = shift( @_ );
342 44 CORE::delete( @$self{qw( _reset )} );
343 $self->elements->foreach(sub
344 40 ▶ {
Subroutine __ANON__: called CC=2 SCAR=7.2
345 40 ▶ if( $self->_can( $_ => 'freeze' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_can($_, "freeze")) 40 0 40
346 {
347 40 $_->freeze;
348 }
349 44 });
350 44 return( $self );
351 }
352  
353 sub groups
354 6 ▶{
Subroutine groups: called CC=1 SCAR=0.0
Pod documented
355 6 my $self = shift( @_ );
356 6 ▶ my $a = $self->elements->grep(sub{ $self->_is_a( $_ => 'Changes::Group' ) });
Subroutine __ANON__: called CC=1 SCAR=0.0
357 6 return( $a );
358 }
359  
360 44 ▶sub line { return( shift->reset(@_)->_set_get_number( 'line', @_ ) ); }
Subroutine line: called CC=1 SCAR=0.0
Pod documented
361  
362 sub new_change
363 1 ▶{
Subroutine new_change: called CC=7 SCAR=20.5
Pod documented
364 1 my $self = shift( @_ );
365 1 my $opts = $self->_get_args_as_hash( @_ );
366 1 ▶ $self->_load_class( 'Changes::Change' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Changes::Change") or return $self->pass_error 1 0 1
367 1 my $defaults = $self->defaults;
368 1 ▶ if( defined( $defaults ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $defaults) 1 0 1
369 {
370 1 foreach my $opt ( qw( spacer1 marker spacer2 max_width wrapper ) )
371 {
372 5 ▶ $opts->{ $opt } //= $defaults->{ $opt } if( defined( $defaults->{ $opt } ) );
Branch: 1 branch
BranchTrueFalseTotal
if defined $defaults->{$opt} 2 3 5
Condition33%1/3
$opts->{$opt} //= $defaults->{$opt}
l!l&&r!l&&!r
020
MC/DC0%0/2
$opts->{$opt} //= $defaults->{$opt}
$opts->{$opt} $defaults->{$opt}
Truth table33%1/3
A //= B
A= $opts->{$opt}B= $defaults->{$opt}
ABresult
1X1
011
000
373 }
374 }
375 1 ▶ my $c = Changes::Change->new( $opts ) ||
Condition50%1/2
'Changes::Change'->new($opts) || (return $self->pass_error('Changes::Change'->error))
l!l
10
MC/DC0%0/1
'Changes::Change'->new($opts) || (return $self->pass_error('Changes::Change'->error))
'Changes::Change'->new($opts)
Truth table50%1/2
A
A= 'Changes::Change'->new($opts)
Aresult
11
00
376 return( $self->pass_error( Changes::Change->error ) );
377 1 return( $c );
378 }
379  
380 sub new_group
381 2 ▶{
Subroutine new_group: called CC=10 SCAR=24.5
Pod documented
382 2 my $self = shift( @_ );
383 2 my $opts = $self->_get_args_as_hash( @_ );
384 2 ▶ $self->_load_class( 'Changes::Group' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Changes::Group") or return $self->pass_error 2 0 2
385 2 my $defaults = $self->defaults;
386 2 ▶ if( defined( $defaults ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $defaults) 2 0 2
387 {
388 2 my $def = { %$defaults };
389 2 foreach my $opt ( qw( spacer type ) )
390 {
391 4 ▶ if( !defined( $opts->{ "group_${opt}" } ) &&
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $$opts{"group_$opt"} and exists $$def{"group_$opt"} and defined $$def{"group_$opt"} and length $$def{"group_$opt"}) 2 2 4
Condition66%6/9
not defined $$opts{"group_$opt"} and exists $$def{"group_$opt"} and defined $$def{"group_$opt"} and length $$def{"group_$opt"}
!ll&&!rl&&r
202
not defined $$opts{"group_$opt"} and exists $$def{"group_$opt"} and defined $$def{"group_$opt"}
!ll&&!rl&&r
202
not defined $$opts{"group_$opt"} and exists $$def{"group_$opt"}
!ll&&!rl&&r
022
MC/DC25%1/4
not defined $$opts{"group_$opt"} and exists $$def{"group_$opt"} and defined $$def{"group_$opt"} and length $$def{"group_$opt"}
not defined $$opts{"group_$opt"} exists $$def{"group_$opt"} defined $$def{"group_$opt"} length $$def{"group_$opt"}
Truth table40%2/5
not(A) and B and C and D
A= not defined $$opts{"group_$opt"}B= exists $$def{"group_$opt"}C= defined $$def{"group_$opt"}D= length $$def{"group_$opt"}
ABCDresult
0XXX0
10XX0
110X0
11100
11111
392 exists( $def->{ "group_${opt}" } ) &&
393 defined( $def->{ "group_${opt}" } ) &&
394 length( $def->{ "group_${opt}" } ) )
395 {
396 2 $opts->{ $opt } = CORE::delete( $def->{ "group_${opt}" } );
397 }
398 }
399 2 ▶ $opts->{defaults} //= $def;
Condition33%1/3
$opts->{"defaults"} //= $def
l!l&&r!l&&!r
020
MC/DC0%0/2
$opts->{"defaults"} //= $def
$opts->{"defaults"} $def
Truth table33%1/3
A //= B
A= $opts->{"defaults"}B= $def
ABresult
1X1
011
000
400 }
401 2 ▶ my $g = Changes::Group->new( $opts ) ||
Condition50%1/2
'Changes::Group'->new($opts) || (return $self->pass_error('Changes::Group'->error))
l!l
20
MC/DC0%0/1
'Changes::Group'->new($opts) || (return $self->pass_error('Changes::Group'->error))
'Changes::Group'->new($opts)
Truth table50%1/2
A
A= 'Changes::Group'->new($opts)
Aresult
11
00
402 return( $self->pass_error( Changes::Group->error ) );
403 2 return( $g );
404 }
405  
406 sub new_line
407 1 ▶{
Subroutine new_line: called CC=3 SCAR=11.4
Pod documented
408 1 my $self = shift( @_ );
409 1 ▶ $self->_load_class( 'Changes::NewLine' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Changes::NewLine") or return $self->pass_error 1 0 1
410 1 ▶ my $nl = Changes::NewLine->new( @_ ) ||
Condition50%1/2
'Changes::NewLine'->new(@_) || (return $self->pass_error('Changes::NewLine'->error))
l!l
10
MC/DC0%0/1
'Changes::NewLine'->new(@_) || (return $self->pass_error('Changes::NewLine'->error))
'Changes::NewLine'->new(@_)
Truth table50%1/2
A
A= 'Changes::NewLine'->new(@_)
Aresult
11
00
411 return( $self->pass_error( Changes::NewLine->error ) );
412 1 return( $nl );
413 }
414  
415 sub new_version
416 0 ▶{
Subroutine new_version: not called CC=3 SCAR=24.8
Pod documented
417 0 my $self = shift( @_ );
418 0 ▶ $self->_load_class( 'Changes::Version' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Changes::Version") or return $self->pass_error 0 0 0
419 0 ▶ my $v = Changes::Version->new( @_ ) ||
Condition0%0/2
'Changes::Version'->new(@_) || (return $self->pass_error('Changes::Version'->error))
l!l
00
MC/DC0%0/1
'Changes::Version'->new(@_) || (return $self->pass_error('Changes::Version'->error))
'Changes::Version'->new(@_)
Truth table0%0/2
A
A= 'Changes::Version'->new(@_)
Aresult
11
00
420 return( $self->pass_error( Changes::Version->error ) );
421 0 return( $v );
422 }
423  
424 48 ▶sub nl { return( shift->reset(@_)->_set_get_scalar_as_object( 'nl', @_ ) ); }
Subroutine nl: called CC=1 SCAR=0.0
Pod documented
425  
426 29 ▶sub note { return( shift->reset(@_)->_set_get_scalar_as_object( 'note', @_ ) ); }
Subroutine note: called CC=1 SCAR=0.0
Pod documented
427  
428 45 ▶sub raw { return( shift->_set_get_scalar_as_object( 'raw', @_ ) ); }
Subroutine raw: called CC=1 SCAR=0.0
Pod documented
429  
430 0 ▶sub remove_change { return( shift->delete_change( @_ ) ); }
Subroutine remove_change: not called CC=1 SCAR=6.9
Pod documented
431  
432 0 ▶sub remove_group { return( shift->delete_group( @_ ) ); }
Subroutine remove_group: not called CC=1 SCAR=6.9
Pod documented
433  
434 sub reset
435 378 ▶{
Subroutine reset: called CC=5 SCAR=17.6
Pod undocumented
436 378 my $self = shift( @_ );
437 378 ▶ if( (
Branch: 1 branch
BranchTrueFalseTotal
if (not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_) 47 331 378
Condition75%6/8
not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_
!ll
218160
exists $self->{'_reset'} && defined $self->{'_reset'} && length $self->{'_reset'}
!ll&&!rl&&r
1600218
exists $self->{"_reset"} and defined $self->{"_reset"}
!ll&&!rl&&r
1600218
MC/DC33%1/3
not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_
exists $self->{"_reset"} defined $self->{"_reset"} length $self->{'_reset'}
Truth table50%2/4
not(A and B && C)
A= exists $self->{"_reset"}B= defined $self->{"_reset"}C= length $self->{'_reset'}
ABCresult
1110
0XX1
10X1
1101
438 !exists( $self->{_reset} ) ||
439 !defined( $self->{_reset} ) ||
440 !CORE::length( $self->{_reset} )
441 ) && scalar( @_ ) )
442 {
443 47 $self->{_reset} = scalar( @_ );
444 # Cascade down the need for reset
445 $self->changes->foreach(sub
446 0 ▶ {
Subroutine __ANON__: not called CC=2 SCAR=17.9
447 0 ▶ if( $self->_can( $_ => 'reset' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_can($_, "reset")) 0 0 0
448 {
449 0 $_->reset(1);
450 }
451 47 });
452 }
453 378 return( $self );
454 }
455  
456 0 ▶sub set_default_format { return( shift->format( $DEFAULT_DATETIME_FORMAT ) ); }
Subroutine set_default_format: not called CC=1 SCAR=6.9
Pod documented
457  
458 52 ▶sub spacer { return( shift->reset(@_)->_set_get_scalar_as_object( 'spacer', @_ ) ); }
Subroutine spacer: called CC=1 SCAR=0.0
Pod documented
459  
460 sub time_zone
461 10 ▶{
Subroutine time_zone: called CC=8 SCAR=24.3
Pod documented
462 10 my $self = shift( @_ );
463 10 ▶ if( @_ )
Branch: 1 branch
BranchTrueFalseTotal
if (@_) 5 5 10
464 {
465 5 my $v = shift( @_ );
466 5 ▶ if( $self->_is_a( $v => 'DateTime::Lite::TimeZone' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_is_a($v, 'DateTime::Lite::TimeZone')) { } 2 3 5
467 {
468 2 $self->{time_zone} = $v;
469 }
470 else
471 {
472 3 ▶ $self->_load_class( 'DateTime::Lite::TimeZone' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("DateTime::Lite::TimeZone") or return $self->pass_error 3 0 3
473 3 my $tz = DateTime::Lite::TimeZone->new( name => "$v" );
474 3 ▶ if( !defined( $tz ) && DateTime::Lite::TimeZone->error )
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $tz and "DateTime::Lite::TimeZone"->error) 0 3 3
Condition33%1/3
not defined $tz and "DateTime::Lite::TimeZone"->error
!ll&&!rl&&r
300
MC/DC0%0/2
not defined $tz and "DateTime::Lite::TimeZone"->error
not defined $tz "DateTime::Lite::TimeZone"->error
Truth table33%1/3
not(A) and B
A= not defined $tzB= "DateTime::Lite::TimeZone"->error
ABresult
0X0
100
111
475 {
476 0 return( $self->error( "Error setting time zone for '$v': ", DateTime::Lite::TimeZone->error ) );
477 }
478 3 $self->{time_zone} = $tz;
479 }
480 5 $self->reset(1);
481 }
482 10 ▶ if( !defined( $self->{time_zone} ) )
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $self->{'time_zone'}) { } 0 10 10
483 {
484 0 ▶ if( Wanted::want( 'OBJECT' ) )
Branch: 1 branch
BranchTrueFalseTotal
if (Wanted::want('OBJECT')) { } 0 0 0
485 {
486 0 require Module::Generic::Null;
487 0 rreturn( Module::Generic::Null->new( wants => 'OBJECT' ) );
488 }
489 else
490 {
491 0 return;
492 }
493 }
494 else
495 {
496 10 return( $self->{time_zone} );
497 }
498 }
499  
500 102 ▶sub version { return( shift->reset(@_)->_set_get_version( { field => 'version', class => $VERSION_CLASS }, @_ ) ); }
Subroutine version: called CC=1 SCAR=0.0
Pod documented
501  
502 sub DESTROY
503 3 ▶{
Subroutine DESTROY: called CC=3 SCAR=11.4
504 # <https://perldoc.perl.org/perlobj#Destructors>
505 3 CORE::local( $., $@, $!, $^E, $? );
506 3 my $self = CORE::shift( @_ );
507 3 ▶ CORE::return if( !CORE::defined( $self ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $self 0 3 3
508 3 ▶ CORE::return if( ${^GLOBAL_PHASE} eq 'DESTRUCT' );
Branch: 1 branch
BranchTrueFalseTotal
if ${^GLOBAL_PHASE} eq "DESTRUCT" 0 3 3
509 };
510  
511 19 1;
512 # NOTE: POD
513 __END__
« Changes/Version.pm ↑ Summary Changes/Change.pm »