Changes/Change.pm

filter: Statementstmt 93.4% 99 / 106 Branchbran 61.1% 22 / 36 Conditioncond 66.0% 35 / 53 MC/DCmcdc 30.7% 8 / 26 Subroutinesub 100% 25 / 25 Podpod 86.6% 13 / 15 totaltotal 77.3% 202 / 261 CC 39 SCAR 27.6
CC
39
Cov
80%
as_string
38.7
normalise
8.2
reset
5.1
CRAP 15.7
« Changes/Release.pm ↑ Summary Changes/Group.pm »
1 ##----------------------------------------------------------------------------
2 ## Changes file management - ~/lib/Changes/Change.pm
3 ## Version v0.1.2
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::Change;
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 );
Subroutine BEGIN: called CC=1 SCAR=0.0
22 19 our $VERSION = 'v0.1.2';
23 };
24  
25 19 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
26 19 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
27  
28 sub init
29 47 ▶{
Subroutine init: called CC=2 SCAR=6.9
Pod documented
30 47 my $self = shift( @_ );
31 47 $self->{line} = undef;
32 47 $self->{marker} = undef;
33 47 $self->{max_width} = 0;
34 47 $self->{nl} = "\n";
35 47 $self->{raw} = undef;
36 47 $self->{spacer1} = undef;
37 47 $self->{spacer2} = undef;
38 47 $self->{text} = undef;
39 47 $self->{wrapper} = undef;
40 47 $self->{_init_strict_use_sub} = 1;
41 47 ▶ $self->SUPER::init( @_ ) || return( $self->pass_error );
Branch: 1 branch
BranchTrueFalseTotal
$self->SUPER::init(@_) or return $self->pass_error 47 0 47
42 47 $self->{_reset} = 1;
43 47 $self->{_reset_normalise} = 1;
44 47 return( $self );
45 }
46  
47 sub as_string
48 49 ▶{
Subroutine as_string: called CC=22 SCAR=36.5
Pod documented
49 49 my $self = shift( @_ );
50 49 ▶ if( !exists( $self->{_reset} ) ||
Branch: 1 branch
BranchTrueFalseTotal
unless (exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}) 43 6 49
Condition66%4/6
exists $self->{"_reset"} and defined $self->{"_reset"} and length $self->{"_reset"}
!ll&&!rl&&r
4306
exists $self->{"_reset"} and defined $self->{"_reset"}
!ll&&!rl&&r
4306
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
51 !defined( $self->{_reset} ) ||
52 !CORE::length( $self->{_reset} ) )
53 {
54 43 ▶ if( exists( $self->{_cache_value} ) &&
Branch: 2 branches
BranchTrueFalseTotal
if (exists $self->{'_cache_value'} and defined $self->{'_cache_value'} and length $self->{'_cache_value'}) { } 4 39 43
elsif (defined $self->{'raw'} and length "$self->{'raw'}") { } 39 0 39
Condition66%4/6
exists $self->{"_cache_value"} and defined $self->{"_cache_value"} and length $self->{"_cache_value"}
!ll&&!rl&&r
3904
exists $self->{"_cache_value"} and defined $self->{"_cache_value"}
!ll&&!rl&&r
3904
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
55 defined( $self->{_cache_value} ) &&
56 length( $self->{_cache_value} ) )
57 {
58 4 return( $self->{_cache_value} );
59 }
60 ▶ elsif( defined( $self->{raw} ) && length( "$self->{raw}" ) )
Condition33%1/3
defined $self->{"raw"} and length qq[$self->{"raw"}]
!ll&&!rl&&r
0039
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
61 {
62 39 return( $self->{raw} );
63 }
64 }
65 6 my $nl = $self->nl;
66 6 ▶ my $str = $self->new_scalar( ( $self->spacer1 // '' ) . ( $self->marker // '-' ) . ( $self->spacer2 // '' ) );
Condition66%4/6
$self->spacer1 // ""
l!l
60
$self->marker // "-"
l!l
15
$self->spacer2 // ""
l!l
60
MC/DC0%0/1
$self->spacer1 // ""
$self->spacer1
MC/DC100%1/1
$self->marker // "-"
$self->marker
MC/DC0%0/1
$self->spacer2 // ""
$self->spacer2
Truth table50%1/2
A
A= $self->spacer1
Aresult
11
00
Truth table100%2/2
A
A= $self->marker
Aresult
11
00
Truth table50%1/2
A
A= $self->spacer2
Aresult
11
00
67 6 my $max = $self->max_width;
68 6 ▶ if( $max > 0 && ( $self->normalise->length + $str->length ) > $max )
Branch: 1 branch
BranchTrueFalseTotal
if ($max > 0 and $self->normalise->length + $str->length > $max) { } 1 5 6
Condition100%3/3
$max > 0 and $self->normalise->length + $str->length > $max
!ll&&!rl&&r
411
MC/DC100%2/2
$max > 0 and $self->normalise->length + $str->length > $max
$max > 0 $self->normalise->length + $str->length > $max
Truth table100%3/3
A and B
A= $max > 0B= $self->normalise->length + $str->length > $max
ABresult
0X0
100
111
69 {
70 1 my $text;
71 1 ▶ my @spaces = map{ $_ eq "\t" ? "\t" : ' ' } split( //, "$str" );
Branch: 1 branch
BranchTrueFalseTotal
$_ eq "\t" ? : 1 2 3
72 1 my $sep = join( '', @spaces );
73 1 my $wrapper = $self->wrapper;
74 1 ▶ if( $self->_is_code( $wrapper ) )
Branch: 3 branches
BranchTrueFalseTotal
if ($self->_is_code($wrapper)) { } 0 1 1
elsif ($self->_load_class('Text::Wrap')) { } 1 0 1
elsif ($self->_load_class('Text::Format')) { } 0 0 0
75 {
76 # try-catch
77 0 local $@;
78 $text = eval
79 0 {
80 0 $wrapper->( $self->normalise->scalar, ( $max - $str->length ) );
81 };
82 0 ▶ if( $@ )
Branch: 1 branch
BranchTrueFalseTotal
if ($@) 0 0 0
83 {
84 0 ▶ warn( "Warning only: an error occurred while calling the wrapper calback with ", $self->normalise->length, " bytes of change text and a maximum width of ", ( $max - $str->length ), " characters: $@\n" ) if( $self->_warnings_is_enabled );
Branch: 1 branch
BranchTrueFalseTotal
if $self->_warnings_is_enabled 0 0 0
85 }
86 }
87 elsif( $self->_load_class( 'Text::Wrap' ) )
88 {
89 # Silence the use of $Text::Wrap::columns used once
90 19 ▶ no warnings 'once';
Subroutine BEGIN: called CC=1 SCAR=0.0
91 # We need to reduce $max by as much indentation there is
92 1 local $Text::Wrap::columns = ( $max - $str->length );
93 1 $text = Text::Wrap::wrap( '', '', $self->normalise->scalar );
94 }
95 elsif( $self->_load_class( 'Text::Format' ) )
96 {
97 0 my $fmt = Text::Format->new({
98 columns => ( $max - $str->length ),
99 extraSpace => 0,
100 firstIndent => 0,
101 });
102 0 $text = $fmt->format( $self->normalise->scalar );
103 }
104  
105 1 ▶ if( defined( $text ) && length( "$text" ) )
Branch: 1 branch
BranchTrueFalseTotal
if (defined $text and length "$text") 1 0 1
Condition33%1/3
defined $text and length "$text"
!ll&&!rl&&r
001
MC/DC0%0/2
defined $text and length "$text"
defined $text length "$text"
Truth table33%1/3
A and B
A= defined $textB= length "$text"
ABresult
0X0
100
111
106 {
107 1 $str->append( join( "\n$sep", split( /\r?\n/, "$text" ) ) );
108 }
109 }
110 else
111 {
112 5 $str->append( $self->normalise );
113 }
114 6 $str->append( $nl );
115 6 $self->{_cache_value} = $str;
116 6 CORE::delete( $self->{_reset} );
117 6 return( $str );
118 }
119  
120 sub freeze
121 41 ▶{
Subroutine freeze: called CC=1 SCAR=0.0
Pod undocumented
122 41 my $self = shift( @_ );
123 41 CORE::delete( @$self{qw( _reset _reset_normalise )} );
124 41 return( $self );
125 }
126  
127 41 ▶sub line { return( shift->reset(@_)->_set_get_number( 'line', @_ ) ); }
Subroutine line: called CC=1 SCAR=0.0
Pod documented
128  
129 55 ▶sub marker { return( shift->reset(@_)->_set_get_scalar_as_object( 'marker', @_ ) ); }
Subroutine marker: called CC=1 SCAR=0.0
Pod documented
130  
131 51 ▶sub max_width { return( shift->_set_get_number( 'max_width', @_ ) ); }
Subroutine max_width: called CC=1 SCAR=0.0
Pod documented
132  
133 55 ▶sub nl { return( shift->reset(@_)->_set_get_scalar_as_object( 'nl', @_ ) ); }
Subroutine nl: called CC=1 SCAR=0.0
Pod documented
134  
135 sub normalise
136 10 ▶{
Subroutine normalise: called CC=8 SCAR=21.0
Pod documented
137 10 my $self = shift( @_ );
138 10 ▶ if( (
Branch: 1 branch
BranchTrueFalseTotal
if (not exists $self->{"_reset_normalise"} && defined $self->{"_reset_normalise"} && length $self->{"_reset_normalise"} and exists $self->{"_normalised"} and $self->_is_a($self->{"_normalised"}, "Module::Generic::Scalar")) 2 8 10
Condition75%9/12
not exists $self->{"_reset_normalise"} && defined $self->{"_reset_normalise"} && length $self->{"_reset_normalise"} and exists $self->{"_normalised"} and $self->_is_a($self->{"_normalised"}, "Module::Generic::Scalar")
!ll&&!rl&&r
802
not exists $self->{"_reset_normalise"} && defined $self->{"_reset_normalise"} && length $self->{"_reset_normalise"} and exists $self->{"_normalised"}
!ll&&!rl&&r
622
exists $self->{'_reset_normalise'} && defined $self->{'_reset_normalise'} && length $self->{'_reset_normalise'}
!ll&&!rl&&r
406
exists $self->{"_reset_normalise"} and defined $self->{"_reset_normalise"}
!ll&&!rl&&r
406
MC/DC40%2/5
not exists $self->{"_reset_normalise"} && defined $self->{"_reset_normalise"} && length $self->{"_reset_normalise"} and exists $self->{"_normalised"} and $self->_is_a($self->{"_normalised"}, "Module::Generic::Scalar")
exists $self->{"_reset_normalise"} defined $self->{"_reset_normalise"} length $self->{'_reset_normalise'} exists $self->{"_normalised"} $self->_is_a($self->{"_normalised"}, "Module::Generic::Scalar")
Truth table30%3/10
not(A and B && C) and D and E
A= exists $self->{"_reset_normalise"}B= defined $self->{"_reset_normalise"}C= length $self->{'_reset_normalise'}D= exists $self->{"_normalised"}E= $self->_is_a($self->{"_normalised"}, "Module::Generic::Scalar")
ABCDEresult
111XX0
0XX0X0
10X0X0
1100X0
0XX100
10X100
110100
0XX111
10X111
110111
139 !exists( $self->{_reset_normalise} ) ||
140 !defined( $self->{_reset_normalise} ) ||
141 !CORE::length( $self->{_reset_normalise} )
142 ) && exists( $self->{_normalised} ) &&
143 $self->_is_a( $self->{_normalised} => 'Module::Generic::Scalar' ) )
144 {
145 2 return( $self->{_normalised} );
146 }
147 8 my $str = $self->text->clone;
148 8 ▶ return( $str ) if( $str->is_empty );
Branch: 1 branch
BranchTrueFalseTotal
if $str->is_empty 0 8 8
149 8 ▶ if( $str->index( "\n" ) != -1 )
Branch: 1 branch
BranchTrueFalseTotal
if ($str->index("\n") != -1) 2 6 8
150 {
151 2 $str->replace( qr/[[:blank:]\h]*\n[[:blank:]\h]*/ => ' ' );
152 }
153 8 $self->{_normalised} = $str;
154 8 CORE::delete( $self->{_reset_normalise} );
155 8 return( $str );
156 }
157  
158 sub prefix
159 4 ▶{
Subroutine prefix: called CC=4 SCAR=15.2
Pod documented
160 4 my $self = shift( @_ );
161 4 ▶ my $s = ( $self->spacer1 // '' ) . ( $self->marker // '' ) . ( $self->spacer2 // '' );
Condition50%3/6
$self->spacer1 // ""
l!l
40
$self->marker // ""
l!l
40
$self->spacer2 // ""
l!l
40
MC/DC0%0/1
$self->spacer1 // ""
$self->spacer1
MC/DC0%0/1
$self->marker // ""
$self->marker
MC/DC0%0/1
$self->spacer2 // ""
$self->spacer2
Truth table50%1/2
A
A= $self->spacer1
Aresult
11
00
Truth table50%1/2
A
A= $self->marker
Aresult
11
00
Truth table50%1/2
A
A= $self->spacer2
Aresult
11
00
162 4 return( $self->new_scalar( \$s ) );
163 }
164  
165 46 ▶sub raw { return( shift->_set_get_scalar_as_object( 'raw', @_ ) ); }
Subroutine raw: called CC=1 SCAR=0.0
Pod documented
166  
167 sub reset
168 366 ▶{
Subroutine reset: called CC=5 SCAR=16.2
Pod undocumented
169 366 my $self = shift( @_ );
170 366 ▶ if( (
Branch: 1 branch
BranchTrueFalseTotal
if (not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_) 47 319 366
Condition75%6/8
not exists $self->{"_reset"} && defined $self->{"_reset"} && length $self->{"_reset"} and scalar @_
!ll
26997
exists $self->{'_reset'} && defined $self->{'_reset'} && length $self->{'_reset'}
!ll&&!rl&&r
970269
exists $self->{"_reset"} and defined $self->{"_reset"}
!ll&&!rl&&r
970269
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
171 !exists( $self->{_reset} ) ||
172 !defined( $self->{_reset} ) ||
173 !CORE::length( $self->{_reset} )
174 ) && scalar( @_ ) )
175 {
176 47 $self->{_reset} = scalar( @_ );
177 47 $self->{_reset_normalise} = 1;
178 }
179 366 return( $self );
180 }
181  
182 # space before the marker
183 58 ▶sub spacer1 { return( shift->reset(@_)->_set_get_scalar_as_object( 'spacer1', @_ ) ); }
Subroutine spacer1: called CC=1 SCAR=0.0
Pod documented
184  
185 # space after the marker
186 58 ▶sub spacer2 { return( shift->reset(@_)->_set_get_scalar_as_object( 'spacer2', @_ ) ); }
Subroutine spacer2: called CC=1 SCAR=0.0
Pod documented
187  
188 99 ▶sub text { return( shift->reset(@_)->_set_get_scalar_as_object( 'text', @_ ) ); }
Subroutine text: called CC=1 SCAR=0.0
Pod documented
189  
190 # We do not use the reset here, because just setting a wrap callback has no direct impact on the output
191 1 ▶sub wrapper { return( shift->_set_get_code( 'wrapper', @_ ) ); }
Subroutine wrapper: called CC=1 SCAR=0.0
Pod documented
192  
193 sub DESTROY
194 6 ▶{
Subroutine DESTROY: called CC=3 SCAR=11.4
195 # <https://perldoc.perl.org/perlobj#Destructors>
196 6 CORE::local( $., $@, $!, $^E, $? );
197 6 my $self = CORE::shift( @_ );
198 6 ▶ CORE::return if( !CORE::defined( $self ) );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $self 0 6 6
199 6 ▶ CORE::return if( ${^GLOBAL_PHASE} eq 'DESTRUCT' );
Branch: 1 branch
BranchTrueFalseTotal
if ${^GLOBAL_PHASE} eq "DESTRUCT" 0 6 6
200 };
201  
202 19 1;
203 # NOTE: POD
204 __END__
« Changes/Release.pm ↑ Summary Changes/Group.pm »