Changes/Group.pm

filter: Statementstmt 82.6% 105 / 127 Branchbran 45.4% 20 / 44 Conditioncond 51.1% 23 / 45 MC/DCmcdc 13.0% 3 / 23 Subroutinesub 90.3% 28 / 31 Podpod 88.8% 16 / 18 totaltotal 67.7% 195 / 288 CC 42 SCAR 23.1
CC
42
Cov
69%
delete_change
42.0
as_string
18.0
new_line
12.0
CRAP 10.0
« Changes/Change.pm ↑ Summary Changes/NewLine.pm »
1 ##----------------------------------------------------------------------------
2 ## Changes file management - ~/lib/Changes/Group.pm
3 ## Version v0.2.1
4 ## Copyright(c) 2022 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::Group;
15 BEGIN
16 20 ▶{
Subroutine BEGIN: called CC=1 SCAR=0.0
17 20 ▶ use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
18 20 ▶ use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 20 ▶ use warnings::register;
Subroutine BEGIN: called CC=1 SCAR=0.0
20 20 ▶ use parent qw( Module::Generic );
Subroutine BEGIN: called CC=1 SCAR=0.0
21 20 ▶ use vars qw( $VERSION );
Subroutine BEGIN: called CC=1 SCAR=0.0
22 20 our $VERSION = 'v0.2.1';
23 };
24  
25 20 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
26 20 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
27  
28 sub init
29 9 ▶{
Subroutine init: called CC=2 SCAR=6.9
Pod documented
30 9 my $self = shift( @_ );
31 9 $self->{defaults} = undef;
32 9 $self->{elements} = [];
33 9 $self->{line} = undef;
34 9 $self->{name} = undef;
35 9 $self->{nl} = "\n";
36 9 $self->{raw} = undef;
37 9 $self->{spacer} = undef;
38 9 $self->{type} = 'bracket';
39 9 $self->{_init_strict_use_sub} = 1;
40 9 ▶ $self->SUPER::init( @_ ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->SUPER::init(@_) or return $self->pass_error 9 0 9
41 9 $self->{_reset} = 1;
42 9 return( $self );
43 }
44  
45 sub add_change
46 3 ▶{
Subroutine add_change: called CC=5 SCAR=20.4
Pod documented
47 3 my $self = shift( @_ );
48 3 my( $change, $opts );
49 3 my $elements = $self->elements;
50 3 ▶ if( scalar( @_ ) == 1 && $self->_is_a( $_[0] => 'Changes::Change' ) )
Branch: 1 branch
BranchTrueFalseTotal
if (scalar @_ == 1 and $self->_is_a($_[0], 'Changes::Change')) { } 0 3 3
Condition33%1/3
scalar @_ == 1 and $self->_is_a($_[0], "Changes::Change")
!ll&&!rl&&r
300
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
51 {
52 0 $change = shift( @_ );
53 0 ▶ if( $elements->exists( $change ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($elements->exists($change)) 0 0 0
54 {
55 0 $self->_load_class( 'overload' );
56 0 return( $self->error( "A very same change object (", $self->_str_val( $change ), ") is already registered." ) );
57 }
58 }
59 else
60 {
61 3 $opts = $self->_get_args_as_hash( @_ );
62 3 ▶ $change = $self->new_change( %$opts ) || return( $self->pass_error );
Condition50%1/2
$self->new_change(%$opts) || (return $self->pass_error)
l!l
30
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
63 }
64 3 $elements->push( $change );
65 3 return( $change );
66 }
67  
68 sub as_string
69 11 ▶{
Subroutine as_string: called CC=15 SCAR=28.9
Pod documented
70 11 my $self = shift( @_ );
71 11 ▶ if( !exists( $self->{_reset} ) ||
Branch: 1 branch
BranchTrueFalseTotal
unless (exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}) 8 3 11
Condition66%4/6
exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}
!ll&&!rl&&r
803
exists $self->{"_reset"} and defined $self->{"_reset"}
!ll&&!rl&&r
803
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
72 !defined( $self->{_reset} ) ||
73 !CORE::length( $self->{_reset} ) )
74 {
75 8 my $cache;
76 8 ▶ 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 6 8
elsif (defined $self->{'raw'} and length "$self->{'raw'}") { } 6 0 6
Condition66%4/6
exists $self->{"_cache_value"} and defined $self->{"_cache_value"} and length $self->{"_cache_value"}
!ll&&!rl&&r
602
exists $self->{"_cache_value"} and defined $self->{"_cache_value"}
!ll&&!rl&&r
602
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
77 defined( $self->{_cache_value} ) &&
78 length( $self->{_cache_value} ) )
79 {
80 2 $cache = $self->{_cache_value};
81 }
82 ▶ elsif( defined( $self->{raw} ) && length( "$self->{raw}" ) )
Condition33%1/3
defined $self->{"raw"} and length qq[$self->{"raw"}]
!ll&&!rl&&r
006
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
83 {
84 6 $cache = $self->{raw};
85 }
86  
87 8 my $lines = $self->new_array( $cache->scalar );
88 $self->elements->foreach(sub
89 10 ▶ {
Subroutine __ANON__: called CC=2 SCAR=7.1
90 10 my $this = $_->as_string;
91 10 ▶ if( defined( $this ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $this) 10 0 10
92 {
93 10 $lines->push( $this->scalar );
94 }
95 8 });
96 # my $str = $lines->join( "\n" );
97 8 my $str = $lines->join( '' );
98 8 return( $str );
99 }
100 3 my $nl = $self->nl;
101 3 my $lines = $self->new_array;
102 # Either bracket or colon
103 3 ▶ my $type = $self->type // 'bracket';
Condition50%1/2
$self->type // "bracket"
l!l
30
MC/DC0%0/1
$self->type // "bracket"
$self->type
Truth table50%1/2
A
A= $self->type
Aresult
11
00
104 3 ▶ my $grp_str = $self->new_scalar( ( $self->spacer // '' ) . ( $type eq 'bracket' ? '[' : '' ) . ( $self->name // '' ) . ( $type eq 'bracket' ? ']' : ':' ) . ( $nl // '' ) );
Branch: 2 branches
BranchTrueFalseTotal
$type eq 'bracket' ? : 3 0 3
$type eq 'bracket' ? : 3 0 3
Condition50%3/6
$self->spacer // ""
l!l
30
$self->name // ""
l!l
30
$nl // ""
l!l
30
MC/DC0%0/1
$self->spacer // ""
$self->spacer
MC/DC0%0/1
$self->name // ""
$self->name
MC/DC0%0/1
$nl // ""
$nl
Truth table50%1/2
A
A= $self->spacer
Aresult
11
00
Truth table50%1/2
A
A= $self->name
Aresult
11
00
Truth table50%1/2
A
A= $nl
Aresult
11
00
105 3 $lines->push( $grp_str->scalar );
106 $self->changes->foreach(sub
107 3 ▶ {
Subroutine __ANON__: called CC=2 SCAR=7.1
108 3 my $this = $_->as_string;
109 3 ▶ if( defined( $this ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $this) 3 0 3
110 {
111 3 $lines->push( $this->scalar );
112 }
113 3 });
114 # my $str = $lines->join( "$nl" );
115 3 my $str = $lines->join( '' );
116 3 $self->{_cache_value} = $str;
117 3 CORE::delete( $self->{_reset} );
118 3 return( $str );
119 }
120  
121 sub changes
122 12 ▶{
Subroutine changes: called CC=1 SCAR=0.0
Pod documented
123 12 my $self = shift( @_ );
124 12 ▶ my $a = $self->elements->grep(sub{ $self->_is_a( $_ => 'Changes::Change' ) });
Subroutine __ANON__: called CC=1 SCAR=0.0
125 12 return( $a );
126 }
127  
128 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
129  
130 sub delete_change
131 0 ▶{
Subroutine delete_change: not called CC=6 SCAR=37.4
Pod documented
132 0 my $self = shift( @_ );
133 0 my $elements = $self->elements;
134 0 ▶ if( scalar( @_ ) != 1 )
Branch: 2 branches
BranchTrueFalseTotal
if (scalar @_ != 1) { } 0 0 0
elsif ($self->_is_a($_[0], 'Changes::Change')) { } 0 0 0
135 {
136 0 return( $self->error( 'Usage: $group->delete_change( $change_object );' ) );
137 }
138 elsif( $self->_is_a( $_[0] => 'Changes::Change' ) )
139 {
140 0 my $change = shift( @_ );
141 0 my $pos = $elements->pos( $change );
142 0 ▶ if( !defined( $pos ) )
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $pos) 0 0 0
143 {
144 0 $self->_load_class( 'overload' );
145 0 return( '' );
146 }
147 0 $elements->delete( $pos, 1 );
148 0 return( $change );
149 }
150 else
151 {
152 0 $self->_load_class( 'overload' );
153 0 ▶ return( $self->error( "I was expecting a Changes::Change object, but instead got '", ( $_[0] // '' ), "' (", ( defined( $_[0] ) ? overload::StrVal( $_[0] ) : 'undef' ), ")." ) );
Branch: 1 branch
BranchTrueFalseTotal
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
154 }
155 }
156  
157 44 ▶sub elements { return( shift->_set_get_array_as_object( 'elements', @_ ) ); }
Subroutine elements: called CC=1 SCAR=0.0
Pod documented
158  
159 sub freeze
160 6 ▶{
Subroutine freeze: called CC=1 SCAR=0.0
Pod undocumented
161 6 my $self = shift( @_ );
162 6 CORE::delete( @$self{qw( _reset )} );
163 $self->elements->foreach(sub
164 7 ▶ {
Subroutine __ANON__: called CC=2 SCAR=7.2
165 7 ▶ if( $self->_can( $_ => 'freeze' ) )
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_can($_, "freeze")) 7 0 7
166 {
167 7 $_->freeze;
168 }
169 6 });
170 6 return( $self );
171 }
172  
173 6 ▶sub line { return( shift->reset(@_)->_set_get_number( 'line', @_ ) ); }
Subroutine line: called CC=1 SCAR=0.0
Pod documented
174  
175 22 ▶sub name { return( shift->reset(@_)->_set_get_scalar_as_object( 'name', @_ ) ); }
Subroutine name: called CC=1 SCAR=0.0
Pod documented
176  
177 sub new_change
178 3 ▶{
Subroutine new_change: called CC=7 SCAR=20.5
Pod documented
179 3 my $self = shift( @_ );
180 3 my $opts = $self->_get_args_as_hash( @_ );
181 3 ▶ $self->_load_class( 'Changes::Change' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Changes::Change") or return $self->pass_error 3 0 3
182 3 my $defaults = $self->defaults;
183 3 ▶ if( defined( $defaults ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $defaults) 3 0 3
184 {
185 3 foreach my $opt ( qw( spacer1 marker spacer2 max_width wrapper ) )
186 {
187 15 ▶ $opts->{ $opt } //= $defaults->{ $opt } if( defined( $defaults->{ $opt } ) );
Branch: 1 branch
BranchTrueFalseTotal
if defined $defaults->{$opt} 6 9 15
Condition33%1/3
$opts->{$opt} //= $defaults->{$opt}
l!l&&r!l&&!r
060
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
188 }
189 }
190 3 ▶ my $c = Changes::Change->new( $opts ) ||
Condition50%1/2
'Changes::Change'->new($opts) || (return $self->pass_error('Changes::Change'->error))
l!l
30
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
191 return( $self->pass_error( Changes::Change->error ) );
192 3 return( $c );
193 }
194  
195 sub new_line
196 0 ▶{
Subroutine new_line: not called CC=3 SCAR=24.8
Pod documented
197 0 my $self = shift( @_ );
198 0 ▶ $self->_load_class( 'Changes::NewLine' ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->_load_class("Changes::NewLine") or return $self->pass_error 0 0 0
199 0 ▶ my $nl = Changes::NewLine->new( @_ ) ||
Condition0%0/2
'Changes::NewLine'->new(@_) || (return $self->pass_error('Changes::NewLine'->error))
l!l
00
MC/DC0%0/1
'Changes::NewLine'->new(@_) || (return $self->pass_error('Changes::NewLine'->error))
'Changes::NewLine'->new(@_)
Truth table0%0/2
A
A= 'Changes::NewLine'->new(@_)
Aresult
11
00
200 return( $self->pass_error( Changes::NewLine->error ) );
201 0 return( $nl );
202 }
203  
204 9 ▶sub nl { return( shift->reset(@_)->_set_get_scalar_as_object( 'nl', @_ ) ); }
Subroutine nl: called CC=1 SCAR=0.0
Pod documented
205  
206 7 ▶sub raw { return( shift->_set_get_scalar_as_object( 'raw', @_ ) ); }
Subroutine raw: called CC=1 SCAR=0.0
Pod documented
207  
208 0 ▶sub remove_change { return( shift->delete_change( @_ ) ); }
Subroutine remove_change: not called CC=1 SCAR=6.9
Pod documented
209  
210 sub reset
211 59 ▶{
Subroutine reset: called CC=5 SCAR=16.2
Pod undocumented
212 59 my $self = shift( @_ );
213 59 ▶ if( (
Branch: 1 branch
BranchTrueFalseTotal
if (not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_) 9 50 59
Condition75%6/8
not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_
!ll
4217
exists $self->{'_reset'} && defined $self->{'_reset'} && length $self->{'_reset'}
!ll&&!rl&&r
17042
exists $self->{"_reset"} and defined $self->{"_reset"}
!ll&&!rl&&r
17042
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
214 !exists( $self->{_reset} ) ||
215 !defined( $self->{_reset} ) ||
216 !CORE::length( $self->{_reset} )
217 ) && scalar( @_ ) )
218 {
219 9 $self->{_reset} = scalar( @_ );
220 }
221 59 return( $self );
222 }
223  
224 13 ▶sub spacer { return( shift->reset(@_)->_set_get_scalar_as_object( 'spacer', @_ ) ); }
Subroutine spacer: called CC=1 SCAR=0.0
Pod documented
225  
226 9 ▶sub type { return( shift->reset(@_)->_set_get_scalar_as_object( 'type', @_ ) ); }
Subroutine type: called CC=1 SCAR=0.0
Pod documented
227  
228 sub DESTROY
229 3 ▶{
Subroutine DESTROY: called CC=3 SCAR=11.4
230 # <https://perldoc.perl.org/perlobj#Destructors>
231 3 CORE::local( $., $@, $!, $^E, $? );
232 3 my $self = CORE::shift( @_ );
233 3 ▶ CORE::return if( !CORE::defined( $self ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $self 0 3 3
234 3 ▶ CORE::return if( ${^GLOBAL_PHASE} eq 'DESTRUCT' );
Branch: 1 branch
BranchTrueFalseTotal
if ${^GLOBAL_PHASE} eq "DESTRUCT" 0 3 3
235 };
236  
237 20 1;
238 # NOTE: POD
239 __END__
« Changes/Change.pm ↑ Summary Changes/NewLine.pm »