lib/LaTeXML/Common/Error.pm

filter: Statementstmt 12.6% 61 / 483 Branchbran 0.3% 1 / 278 Conditioncond 0.0% 0 / 240 MC/DCmcdc 0.0% 0 / 134 Subroutinesub 19.3% 11 / 57 Podpod 46.1% 18 / 39 totaltotal 7.3% 91 / 1231 CC 226 SCAR 52.2
CC
226
Cov
6%
generateMessage
930.0
Fatal
272.0
objectStack
240.0
CRAP 185.5
« lib/LaTeXML/Core/State.pm ↑ Summary lib/LaTeXML/Post/MathML/Linebreaker.pm »
1 # /=====================================================================\ #
2 # | LaTeXML::Common::Error | #
3 # | Error handler | #
4 # |=====================================================================| #
5 # | Part of LaTeXML: | #
6 # | Public domain software, produced as part of work done by the | #
7 # | United States Government & not subject to copyright in the US. | #
8 # |---------------------------------------------------------------------| #
9 # | Bruce Miller <bruce.miller@nist.gov> #_# | #
10 # | http://dlmf.nist.gov/LaTeXML/ (o o) | #
11 # \=========================================================ooo==U==ooo=/ #
12 package LaTeXML::Common::Error;
13 34 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
14 34 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
15 34 ▶use LaTeXML::Global;
Subroutine BEGIN: called CC=1 SCAR=0.0
16 34 ▶use LaTeXML::Common::Object;
Subroutine BEGIN: called CC=1 SCAR=0.0
17 34 ▶use LaTeXML::Util::Pathname;
Subroutine BEGIN: called CC=1 SCAR=0.0
18 34 ▶use Time::HiRes;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 34 ▶use Term::ANSIColor qw(colored colorstrip);
Subroutine BEGIN: called CC=1 SCAR=0.0
20  
21 34 my $IS_WINDOWS;
22  
23 34 ▶BEGIN {
Subroutine BEGIN: called CC=2 SCAR=7.2
24 34 $IS_WINDOWS = $^O eq 'MSWin32';
25 34 ▶ require Win32::Console if $IS_WINDOWS;
Branch: 1 branch
BranchTrueFalseTotal
if $IS_WINDOWS 0 34 34
26 }
27  
28 34 ▶use base qw(Exporter);
Subroutine BEGIN: called CC=1 SCAR=0.0
29 34 our @EXPORT = (
30 qw(&SetVerbosity),
31 # Managing STDERR and Logfile messages
32 qw(&UseSTDERR &UseLog),
33 # Error Reporting
34 qw(&Fatal &Error &Warn &Info),
35 # General messages
36 qw(&Note &NoteSTDERR &NoteLog),
37 # Progress Spinner
38 qw(&ProgressSpinup &ProgressSpindown &ProgressStep),
39 # Debugging messages
40 qw(&DebuggableFeature &Debug &CheckDebuggable &Deprecated),
41 # Colored-logging related functions
42 qw(&colorizeString),
43 # stateless message generation
44 qw(&generateMessage),
45 # Status management
46 qw(&MergeStatus),
47 # Run time reporting
48 qw(&StartTime &RunTime),
49 );
50  
51 34 our $VERBOSITY = 0;
52 34 our $IS_TERMINAL = undef;
53 34 our $USE_STDERR = undef;
54  
55 0 ▶sub SetVerbosity {
Subroutine SetVerbosity: not called CC=2 SCAR=17.9
Pod documented
56 0 ▶ return $VERBOSITY = $_[0] || 0; }
Condition0%0/2
$_[0] || 0
l!l
00
MC/DC0%0/1
$_[0] || 0
$_[0]
Truth table0%0/2
A
A= $_[0]
Aresult
11
00
57  
58 34 our $DIE_MESSAGE = "LaTeXML died!\n"; # with cr
59 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
60 # Terminal setup
61  
62 # Color setup
63 # Possibly more dynamic?
64 34 $Term::ANSIColor::AUTORESET = 1;
65  
66 # Possibility of more terminal initialization & control?
67 0 ▶sub UseSTDERR {
Subroutine UseSTDERR: not called CC=9 SCAR=42.8
Pod documented
68 0 ▶ if (scalar(@_) && !$_[0]) { # Single false argument? Turn OFF
Branch: 1 branch
BranchTrueFalseTotal
if (scalar @_ and not $_[0]) { } 0 0 0
Condition0%0/3
scalar @_ and not $_[0]
!ll&&!rl&&r
000
MC/DC0%0/2
scalar @_ and not $_[0]
scalar @_ not $_[0]
Truth table0%0/3
A and not(B)
A= scalar @_B= not $_[0]
ABresult
0X0
100
111
69 0 ▶ _spinnerclear() if $USE_STDERR && $IS_TERMINAL;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::IS_TERMINAL
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::IS_TERMINAL
ABresult
0X0
100
111
70 0 $USE_STDERR = undef;
71 0 $IS_TERMINAL = undef; }
72 else {
73 0 $USE_STDERR = 1;
74 0 $IS_TERMINAL = -t STDERR;
75 0 binmode(STDERR, ":encoding(UTF-8)");
76 34 ▶ use IO::Handle;
Subroutine BEGIN: called CC=1 SCAR=0.0
77 0 *STDERR->autoflush();
78  
79 # Win32 console handling
80 0 ▶ if ($IS_WINDOWS && $IS_TERMINAL) {
Branch: 1 branch
BranchTrueFalseTotal
if ($IS_WINDOWS and $LaTeXML::Common::Error::IS_TERMINAL) 0 0 0
Condition0%0/3
$IS_WINDOWS and $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
MC/DC0%0/2
$IS_WINDOWS and $LaTeXML::Common::Error::IS_TERMINAL
$IS_WINDOWS $LaTeXML::Common::Error::IS_TERMINAL
Truth table0%0/3
A and B
A= $IS_WINDOWSB= $LaTeXML::Common::Error::IS_TERMINAL
ABresult
0X0
100
111
81 # set utf-8 codepage
82 # CP_UTF8 = 65001
83 0 Win32::Console::OutputCP(65001);
84  
85 # get standard error console
86 0 our $W32_STDERR = Win32::Console->new(&Win32::Console::STD_ERROR_HANDLE());
87  
88 # enable VT100 emulation or fall back to ANSI emulation if unsuccessful
89 # ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004 (not exported by Win32::Console)
90 0 my $mode = $W32_STDERR->Mode();
91 0 ▶ unless ($W32_STDERR->Mode($mode | 0x0004) && $W32_STDERR->Mode() & 0x0004) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($LaTeXML::Common::Error::W32_STDERR->Mode($mode | 4) and $LaTeXML::Common::Error::W32_STDERR->Mode & 4) 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::W32_STDERR->Mode($mode | 4) and $LaTeXML::Common::Error::W32_STDERR->Mode & 4
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::W32_STDERR->Mode($mode | 4) and $LaTeXML::Common::Error::W32_STDERR->Mode & 4
$LaTeXML::Common::Error::W32_STDERR->Mode($mode | 4) $LaTeXML::Common::Error::W32_STDERR->Mode & 4
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::W32_STDERR->Mode($mode | 4)B= $LaTeXML::Common::Error::W32_STDERR->Mode & 4
ABresult
0X0
100
111
92 0 require Win32::Console::ANSI; } } }
93  
94 0 return; }
95  
96 34 our %color_scheme = (
97 details => 'bold',
98 success => 'green',
99 info => 'bright_blue', # bright only recently defined
100 warning => 'yellow',
101 error => 'bold red',
102 fatal => 'bold red underline',
103 );
104  
105 0 ▶sub colorizeString {
Subroutine colorizeString: not called CC=3 SCAR=24.8
Pod undocumented
106 0 my ($string, $alias) = @_;
107 return ($IS_TERMINAL && $color_scheme{$alias}
108 0 ▶ ? colored($string, $color_scheme{$alias})
Branch: 1 branch
BranchTrueFalseTotal
$LaTeXML::Common::Error::IS_TERMINAL && $LaTeXML::Common::Error::color_scheme{$alias} ? : 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::color_scheme{$alias}
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::color_scheme{$alias}
$LaTeXML::Common::Error::IS_TERMINAL $LaTeXML::Common::Error::color_scheme{$alias}
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::IS_TERMINALB= $LaTeXML::Common::Error::color_scheme{$alias}
ABresult
0X0
100
111
109 : $string); }
110  
111 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
112 # Log file
113 34 our $LOG;
114 34 our $LOG_PATH;
115 # NOTE: since LaTeXML.pm (currently) repeatedly opens & closes the log,
116 # and doesn't (YET) know whether there's already a log open,
117 # this bit of hackery only keeps the outermost log open. FIX THIS!
118 34 our $log_count = 0;
119 # Where? Current directory? (probably) Source directory? (probably not)
120 # Option for appending?
121 # Note that the $path can be a reference to a string (which gets appended to)
122  
123 0 ▶sub UseLog {
Subroutine UseLog: not called CC=9 SCAR=45.0
Pod documented
124 0 my ($path, $append) = @_;
125 0 ▶ if (!$path) { # Single false argument? Turn OFF and Close
Branch: 1 branch
BranchTrueFalseTotal
if (not $path) { } 0 0 0
126 0 $log_count--;
127 0 ▶ return if !$LOG || $log_count;
Branch: 1 branch
BranchTrueFalseTotal
if not $LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::log_count 0 0 0
Condition0%0/3
not $LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::log_count
l!l&&r!l&&!r
000
MC/DC0%0/2
not $LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::log_count
not $LaTeXML::Common::Error::LOG $LaTeXML::Common::Error::log_count
Truth table0%0/3
not(A) or B
A= not $LaTeXML::Common::Error::LOGB= $LaTeXML::Common::Error::log_count
ABresult
1X1
011
000
128 # ensure trailing newline when flushing, since we may have
129 # multiple re-opens during the same conversion run (preamble, main, post ...)
130 0 print $LOG _freshline($LOG);
131 0 ▶ close($LOG) or die "Cannot close log file: $!";
Branch: 1 branch
BranchTrueFalseTotal
close $LaTeXML::Common::Error::LOG or die "Cannot close log file: $!" 0 0 0
132 0 $LOG = undef; }
133 else {
134 0 $log_count++;
135 0 ▶ return if $LOG or not($path); # already opened?
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::LOG or not $path 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::LOG or not $path
l!l&&r!l&&!r
000
MC/DC0%0/2
$LaTeXML::Common::Error::LOG or not $path
$LaTeXML::Common::Error::LOG not $path
Truth table0%0/3
A or not(B)
A= $LaTeXML::Common::Error::LOGB= not $path
ABresult
1X1
011
000
136 0 pathname_mkdir(pathname_directory($path)); # and hopefully no errors! :>
137 0 ▶ open($LOG, ($append ? '>>' : '>'), $path) or die "Cannot open log file $path for writing: $!";
Branch: 2 branches
BranchTrueFalseTotal
open $LaTeXML::Common::Error::LOG, $append ? ">>" : ">", $path or die "Cannot open log file $path for writing: $!" 0 0 0
$append ? : 0 0 0
138 0 $LOG_PATH = $path;
139 0 binmode($LOG, ":encoding(UTF-8)"); }
140 0 return; }
141  
142 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
143 # Low-level I/O
144  
145 # print one (or more) lines to the Log, if opened
146 # Print first line to STDERR if enabled & verbosity >= 0
147 # Starts a fresh line by pushing any Spinner line ahead.
148 0 ▶sub _printline {
Subroutine _printline: not called CC=14 SCAR=53.5
149 0 my ($message) = @_;
150 0 ▶ return if (!$LOG && !($USE_STDERR && ($VERBOSITY >= 0)));
Branch: 1 branch
BranchTrueFalseTotal
unless $LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
l!l&&r!l&&!r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::LOG $LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/4
A or B and C
A= $LaTeXML::Common::Error::LOGB= $LaTeXML::Common::Error::USE_STDERRC= $LaTeXML::Common::Error::VERBOSITY >= 0
ABCresult
1XX1
0111
00X0
0100
151 0 $message =~ s/^\n+//s; # Strip newlines off ends.
152 0 $message =~ s/\n+$//s;
153 0 ▶ if (my $clean_message = ($LOG || !$IS_TERMINAL ? strip_ansi($message) : $message)) {
Branch: 2 branches
BranchTrueFalseTotal
if (my $clean_message = $LaTeXML::Common::Error::LOG || !$LaTeXML::Common::Error::IS_TERMINAL ? strip_ansi($message) : $message) 0 0 0
$LaTeXML::Common::Error::LOG || !$LaTeXML::Common::Error::IS_TERMINAL ? : 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::LOG or not $LaTeXML::Common::Error::IS_TERMINAL
l!l&&r!l&&!r
000
MC/DC0%0/2
$LaTeXML::Common::Error::LOG or not $LaTeXML::Common::Error::IS_TERMINAL
$LaTeXML::Common::Error::LOG not $LaTeXML::Common::Error::IS_TERMINAL
Truth table0%0/3
A or not(B)
A= $LaTeXML::Common::Error::LOGB= not $LaTeXML::Common::Error::IS_TERMINAL
ABresult
1X1
011
000
154 0 ▶ $message = $clean_message unless $IS_TERMINAL;
Branch: 1 branch
BranchTrueFalseTotal
unless $LaTeXML::Common::Error::IS_TERMINAL 0 0 0
155 0 ▶ if ($LOG) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::LOG) 0 0 0
156 0 print $LOG _freshline($LOG), $clean_message, "\n"; }
157 # Spinner logic only for terminal-enabled applications
158 0 ▶ if ($USE_STDERR && ($VERBOSITY >= 0)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0) 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::VERBOSITY >= 0
ABresult
0X0
100
111
159 0 _spinnerclear();
160 0 my $short = $message;
161 0 ▶ if ($short =~ /^([^\n]*)(:?\n\s*(at\s+[^\n]*))?/s) {
Branch: 1 branch
BranchTrueFalseTotal
if ($short =~ /^([^\n]*)(:?\n\s*(at\s+[^\n]*))?/s) 0 0 0
162 0 my ($first, $more, $at) = ($1, $2, $3);
163 0 ▶ $at =~ s/\s+-\s+.*$// if $at;
Branch: 1 branch
BranchTrueFalseTotal
if $at 0 0 0
164 0 $short = $first;
165 0 ▶ $short .= ' ' . $at if $at; }
Branch: 1 branch
BranchTrueFalseTotal
if $at 0 0 0
166 0 print STDERR _freshline(\*STDERR), $short, "\n"; ##}
167 0 _spinnerrestore(); } }
168 0 return; }
169  
170 # Similar, but print ALL lines to STDERR as well.
171 0 ▶sub _printlines {
Subroutine _printlines: not called CC=11 SCAR=48.8
172 0 my ($message) = @_;
173 0 ▶ return if (!$LOG && !($USE_STDERR && ($VERBOSITY >= 0)));
Branch: 1 branch
BranchTrueFalseTotal
unless $LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
l!l&&r!l&&!r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::LOG $LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/4
A or B and C
A= $LaTeXML::Common::Error::LOGB= $LaTeXML::Common::Error::USE_STDERRC= $LaTeXML::Common::Error::VERBOSITY >= 0
ABCresult
1XX1
0111
00X0
0100
174 0 $message =~ s/^\n+//s; # Strip newlines off ends.
175 0 $message =~ s/\n+$//s;
176 0 ▶ if (my $clean_message = ($LOG || !$IS_TERMINAL ? strip_ansi($message) : $message)) {
Branch: 2 branches
BranchTrueFalseTotal
if (my $clean_message = $LaTeXML::Common::Error::LOG || !$LaTeXML::Common::Error::IS_TERMINAL ? strip_ansi($message) : $message) 0 0 0
$LaTeXML::Common::Error::LOG || !$LaTeXML::Common::Error::IS_TERMINAL ? : 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::LOG or not $LaTeXML::Common::Error::IS_TERMINAL
l!l&&r!l&&!r
000
MC/DC0%0/2
$LaTeXML::Common::Error::LOG or not $LaTeXML::Common::Error::IS_TERMINAL
$LaTeXML::Common::Error::LOG not $LaTeXML::Common::Error::IS_TERMINAL
Truth table0%0/3
A or not(B)
A= $LaTeXML::Common::Error::LOGB= not $LaTeXML::Common::Error::IS_TERMINAL
ABresult
1X1
011
000
177 0 ▶ $message = $clean_message unless $IS_TERMINAL;
Branch: 1 branch
BranchTrueFalseTotal
unless $LaTeXML::Common::Error::IS_TERMINAL 0 0 0
178 0 ▶ if ($LOG) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::LOG) 0 0 0
179 0 print $LOG _freshline($LOG), $clean_message, "\n"; }
180 # Spinner logic only for terminal-enabled applications
181 0 ▶ if ($USE_STDERR && ($VERBOSITY >= 0)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0) 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::VERBOSITY >= 0
ABresult
0X0
100
111
182 0 _spinnerclear();
183 0 print STDERR _freshline(\*STDERR), $message, "\n"; ##}
184 0 _spinnerrestore(); } }
185 0 return; }
186  
187 34 our %NEEDSFRESHLINE = ();
188  
189 0 ▶sub _freshline {
Subroutine _freshline: not called CC=3 SCAR=24.8
190 0 my ($stream) = @_;
191 0 ▶ if ($stream && $NEEDSFRESHLINE{$stream}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($stream and $LaTeXML::Common::Error::NEEDSFRESHLINE{$stream}) 0 0 0
Condition0%0/3
$stream and $LaTeXML::Common::Error::NEEDSFRESHLINE{$stream}
!ll&&!rl&&r
000
MC/DC0%0/2
$stream and $LaTeXML::Common::Error::NEEDSFRESHLINE{$stream}
$stream $LaTeXML::Common::Error::NEEDSFRESHLINE{$stream}
Truth table0%0/3
A and B
A= $streamB= $LaTeXML::Common::Error::NEEDSFRESHLINE{$stream}
ABresult
0X0
100
111
192 0 $NEEDSFRESHLINE{$stream} = 0;
193 0 return "\n"; }
194 0 return ''; }
195  
196 0 ▶sub strip_ansi {
Subroutine strip_ansi: not called CC=1 SCAR=6.9
Pod undocumented
197 0 my ($string) = @_;
198 0 $string =~ s/\e\[[0-9;]*[a-zA-Z]//g;
199 0 return $string; }
200  
201 #======================================================================
202 0 ▶sub StartTime {
Subroutine StartTime: not called CC=1 SCAR=6.9
Pod undocumented
203 0 return [Time::HiRes::gettimeofday]; }
204  
205 0 ▶sub RunTime {
Subroutine RunTime: not called CC=3 SCAR=24.8
Pod undocumented
206 0 my ($starttime) = @_;
207 0 my $s = Time::HiRes::tv_interval($starttime, [Time::HiRes::gettimeofday]);
208 0 my ($h, $m);
209 0 $m = int($s / 60); $s -= 60 * $m;
210 0 $h = int($m / 60); $m -= 60 * $h;
211 0 ▶ return ($h ? $h . 'h ' : '') . ($m ? $m . 'm ' : '') . sprintf("%.2fs", $s); }
Branch: 2 branches
BranchTrueFalseTotal
$h ? : 0 0 0
$m ? : 0 0 0
212  
213 #======================================================================
214 # Spinner support
215 # Stack of [stage,count,count_message]
216 # Note: Would look prettier if we blank the cursor, but have to restore!
217 # Note: linewrap leaves terminal turds: the disable/enable codes are VT escape codes
218 34 our @spinnerstack = ();
219 34 our @spinnerchar = map { colored($_, "bold red"); } ('-', '\\', '|', '/');
220 34 our $spinnerpos = 0;
221 34 our $spinnerpre = "\x1b[1G\x1b[?7l"; # Cursor to col 1; turn off linewrap
222 34 our $spinnerpost = "\x1b[?7h";
223 # sub _spinnerreset {
224 # if($USE_STDERR && $IS_TERMINAL){
225 # print STDERR "\x1b[?7h"; } # Reset linewrap on
226 # return; }
227  
228 0 ▶sub _spinnerclear { # Clear the spinner line (if any)
Subroutine _spinnerclear: not called CC=5 SCAR=34.0
229 0 ▶ if ($USE_STDERR && $IS_TERMINAL && ($VERBOSITY >= 0) && @spinnerstack) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack) 0 0 0
Condition0%0/9
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
MC/DC0%0/4
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::IS_TERMINAL $LaTeXML::Common::Error::VERBOSITY >= 0 @LaTeXML::Common::Error::spinnerstack
Truth table0%0/5
A and B and C and D
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::IS_TERMINALC= $LaTeXML::Common::Error::VERBOSITY >= 0D= @LaTeXML::Common::Error::spinnerstack
ABCDresult
0XXX0
10XX0
110X0
11100
11111
230 0 print STDERR "\x1b[1G\x1b[0K"; } # clear line
231 0 return; }
232  
233 0 ▶sub _spinnerrestore { # Restore the spinner line (if any)
Subroutine _spinnerrestore: not called CC=5 SCAR=34.0
234 0 ▶ if ($USE_STDERR && $IS_TERMINAL && ($VERBOSITY >= 0) && @spinnerstack) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack) 0 0 0
Condition0%0/9
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
MC/DC0%0/4
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::IS_TERMINAL $LaTeXML::Common::Error::VERBOSITY >= 0 @LaTeXML::Common::Error::spinnerstack
Truth table0%0/5
A and B and C and D
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::IS_TERMINALC= $LaTeXML::Common::Error::VERBOSITY >= 0D= @LaTeXML::Common::Error::spinnerstack
ABCDresult
0XXX0
10XX0
110X0
11100
11111
235 0 my ($stage, $short, $start) = @{ $spinnerstack[-1] };
236 print STDERR join(' ', $spinnerpre, $spinnerchar[$spinnerpos],
237 0 (map { $$_[1]; } @spinnerstack[0 .. $#spinnerstack - 1]), $stage), $spinnerpost; }
238 0 return; }
239  
240 0 ▶sub _spinnerstep { # Increment stepper
Subroutine _spinnerstep: not called CC=6 SCAR=37.4
241 0 my ($note) = @_;
242 0 ▶ if ($USE_STDERR && $IS_TERMINAL && ($VERBOSITY >= 0) && @spinnerstack) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack) 0 0 0
Condition0%0/9
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
MC/DC0%0/4
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0 and @LaTeXML::Common::Error::spinnerstack
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::IS_TERMINAL $LaTeXML::Common::Error::VERBOSITY >= 0 @LaTeXML::Common::Error::spinnerstack
Truth table0%0/5
A and B and C and D
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::IS_TERMINALC= $LaTeXML::Common::Error::VERBOSITY >= 0D= @LaTeXML::Common::Error::spinnerstack
ABCDresult
0XXX0
10XX0
110X0
11100
11111
243 0 my ($stage, $short, $start) = @{ $spinnerstack[-1] };
244 0 $spinnerpos = ($spinnerpos + 1) % 4;
245 0 ▶ if ($note) { # If note, redraw whole line.
Branch: 1 branch
BranchTrueFalseTotal
if ($note) { } 0 0 0
246 print STDERR join(' ', $spinnerpre, $spinnerchar[$spinnerpos],
247 0 (map { $$_[1]; } @spinnerstack), $note, "\x1b[0K"), $spinnerpost; }
248 else { # overwrite previous spinner
249 0 print STDERR $spinnerpre . ' ', $spinnerchar[$spinnerpos], $spinnerpost; } }
250 0 return; }
251  
252 0 ▶sub _spinnerpush { # New spinner level
Subroutine _spinnerpush: not called CC=3 SCAR=24.8
253 0 my ($stage) = @_;
254 0 ▶ my $short = ($stage =~ /^(\w+)\s+(.*)$/ && $2 ? "$1 >" : $stage);
Branch: 1 branch
BranchTrueFalseTotal
$stage =~ /^(\w+)\s+(.*)$/ && $2 ? : 0 0 0
Condition0%0/3
$stage =~ /^(\w+)\s+(.*)$/ and $2
!ll&&!rl&&r
000
MC/DC0%0/2
$stage =~ /^(\w+)\s+(.*)$/ and $2
$stage =~ /^(\w+)\s+(.*)$/ $2
Truth table0%0/3
A and B
A= $stage =~ /^(\w+)\s+(.*)$/B= $2
ABresult
0X0
100
111
255 0 push(@spinnerstack, [$stage, $short, [Time::HiRes::gettimeofday]]);
256 0 return; }
257  
258 0 ▶sub _spinnerpop { # Finished with spinner level
Subroutine _spinnerpop: not called CC=7 SCAR=40.3
259 0 my ($stage) = @_;
260 0 ▶ if (@spinnerstack && ($stage eq $spinnerstack[-1][0])) {
Branch: 2 branches
BranchTrueFalseTotal
if (@LaTeXML::Common::Error::spinnerstack and $stage eq $LaTeXML::Common::Error::spinnerstack[-1][0]) { } 0 0 0
elsif ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0) { } 0 0 0
Condition0%0/3
@LaTeXML::Common::Error::spinnerstack and $stage eq $LaTeXML::Common::Error::spinnerstack[-1][0]
!ll&&!rl&&r
000
MC/DC0%0/2
@LaTeXML::Common::Error::spinnerstack and $stage eq $LaTeXML::Common::Error::spinnerstack[-1][0]
@LaTeXML::Common::Error::spinnerstack $stage eq $LaTeXML::Common::Error::spinnerstack[-1][0]
Truth table0%0/3
A and B
A= @LaTeXML::Common::Error::spinnerstackB= $stage eq $LaTeXML::Common::Error::spinnerstack[-1][0]
ABresult
0X0
100
111
261 0 my ($xstage, $short, $start) = @{ pop(@spinnerstack) };
262 0 return Time::HiRes::tv_interval($start, [Time::HiRes::gettimeofday]); }
263 ▶ elsif ($USE_STDERR && ($VERBOSITY >= 0)) { # What else to do about mis-matched begin/end ??
Condition0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::VERBOSITY >= 0
ABresult
0X0
100
111
264 0 ▶ print STDERR "SPINNER is " . ((@spinnerstack && $spinnerstack[-1][0]) || 'undef') . " not $stage\n"; }
Condition0%0/5
@LaTeXML::Common::Error::spinnerstack && $LaTeXML::Common::Error::spinnerstack[-1][0] || 'undef'
l!l
00
@LaTeXML::Common::Error::spinnerstack and $LaTeXML::Common::Error::spinnerstack[-1][0]
!ll&&!rl&&r
000
MC/DC0%0/2
@LaTeXML::Common::Error::spinnerstack && $LaTeXML::Common::Error::spinnerstack[-1][0] || 'undef'
@LaTeXML::Common::Error::spinnerstack $LaTeXML::Common::Error::spinnerstack[-1][0]
Truth table0%0/3
A and B
A= @LaTeXML::Common::Error::spinnerstackB= $LaTeXML::Common::Error::spinnerstack[-1][0]
ABresult
111
0X0
100
265 0 return; }
266  
267 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
268 # Error reporting
269 # Public API
270  
271 0 ▶sub Fatal {
Subroutine Fatal: not called CC=16 SCAR=56.1
Pod documented
272 0 my ($category, $object, $where, $message, @details) = @_;
273  
274 # Check if this is a known unsafe fatal and flag it if so (so that we reinitialize in daemon contexts)
275 0 ▶ if ((($category eq 'internal') && ($object eq '<recursion>')) ||
Branch: 1 branch
BranchTrueFalseTotal
if ($category eq "internal" and $object eq "<recursion>" or $category eq "too_many_errors" or $object eq "deep_recursion" or $object eq "die") 0 0 0
Condition0%0/12
$category eq "internal" and $object eq "<recursion>" or $category eq "too_many_errors" or $object eq "deep_recursion" or $object eq "die"
l!l&&r!l&&!r
000
$category eq "internal" and $object eq "<recursion>" or $category eq "too_many_errors" or $object eq "deep_recursion"
l!l&&r!l&&!r
000
$category eq "internal" and $object eq "<recursion>" or $category eq "too_many_errors"
l!l&&r!l&&!r
000
$category eq "internal" and $object eq "<recursion>"
!ll&&!rl&&r
000
MC/DC0%0/5
$category eq "internal" and $object eq "<recursion>" or $category eq "too_many_errors" or $object eq "deep_recursion" or $object eq "die"
$category eq "internal" $object eq "<recursion>" $category eq "too_many_errors" $object eq "deep_recursion" $object eq "die"
Truth table0%0/9
A and B or C or D or E
A= $category eq "internal"B= $object eq "<recursion>"C= $category eq "too_many_errors"D= $object eq "deep_recursion"E= $object eq "die"
ABCDEresult
11XXX1
0X1XX1
101XX1
0X01X1
1001X1
0X0011
100011
0X0000
100000
276 ($category eq 'too_many_errors') ||
277 ($object eq 'deep_recursion') || ($object eq 'die')) {
278 0 $LaTeXML::UNSAFE_FATAL = 1; }
279  
280 # We'll assume that if the DIE handler is bound (presumably to this function)
281 # we're in the outermost call to Fatal; we'll clear the handler so that we don't nest calls.
282 die $DIE_MESSAGE if $LaTeXML::IGNORE_ERRORS # Short circuit, w/no formatting, if in probing eval
283 0 ▶ || (($SIG{__DIE__} eq 'DEFAULT') && $^S); # Also missing class when parsing bindings(?!?!)
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::IGNORE_ERRORS or $SIG{"__DIE__"} eq "DEFAULT" and $^S 0 0 0
Condition0%0/6
$LaTeXML::IGNORE_ERRORS or $SIG{"__DIE__"} eq "DEFAULT" and $^S
l!l&&r!l&&!r
000
$SIG{"__DIE__"} eq "DEFAULT" and $^S
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::IGNORE_ERRORS or $SIG{"__DIE__"} eq "DEFAULT" and $^S
$LaTeXML::IGNORE_ERRORS $SIG{"__DIE__"} eq "DEFAULT" $^S
Truth table0%0/4
A or B and C
A= $LaTeXML::IGNORE_ERRORSB= $SIG{"__DIE__"} eq "DEFAULT"C= $^S
ABCresult
1XX1
0111
00X0
0100
284  
285 0 my $inhandler = !$SIG{__DIE__};
286 0 my $ineval = 0; # whether we're in an eval should no longer matter!
287  
288 # This seemingly should be "local", but that doesn't seem to help with timeout/alarm/term?
289 # It should be safe so long as the caller has bound it and rebinds it if necessary.
290 0 local $SIG{__DIE__} = 'DEFAULT'; # Avoid recursion while preparing the message.
291 0 my $state = $STATE;
292  
293 0 ▶ if (!$inhandler) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $inhandler) { } 0 0 0
294 0 local $LaTeXML::BAILOUT = $LaTeXML::BAILOUT;
295 0 ▶ if (checkRecursiveError()) {
Branch: 1 branch
BranchTrueFalseTotal
if (checkRecursiveError()) 0 0 0
296 0 $LaTeXML::BAILOUT = 1;
297 0 push(@details, "Recursive Error!"); }
298 0 ▶ $state->noteStatus('fatal') if $state && !$ineval;
Branch: 1 branch
BranchTrueFalseTotal
if $state and not $ineval 0 0 0
Condition0%0/3
$state and not $ineval
!ll&&!rl&&r
000
MC/DC0%0/2
$state and not $ineval
$state not $ineval
Truth table0%0/3
A and not(B)
A= $stateB= not $ineval
ABresult
0X0
100
111
299 0 ▶ my $detail_level = (($VERBOSITY <= 1) && ($category =~ /^(?:timeout|too_many_errors)$/)) ? 0 : 2;
Branch: 1 branch
BranchTrueFalseTotal
$LaTeXML::Common::Error::VERBOSITY <= 1 && $category =~ /^(?:timeout|too_many_errors)$/ ? : 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::VERBOSITY <= 1 and $category =~ /^(?:timeout|too_many_errors)$/
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::VERBOSITY <= 1 and $category =~ /^(?:timeout|too_many_errors)$/
$LaTeXML::Common::Error::VERBOSITY <= 1 $category =~ /^(?:timeout|too_many_errors)$/
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::VERBOSITY <= 1B= $category =~ /^(?:timeout|too_many_errors)$/
ABresult
0X0
100
111
300 0 $message
301 = generateMessage(colorizeString("Fatal:" . $category . ":" . ToString($object), 'fatal'),
302 $where, $message, $detail_level, @details);
303 # If we're about to (really) DIE, we'll bypass the usual status message, so add it here.
304 # This really should be handled by the top-level program,
305 # after doing all processing within an eval
306 # BIZARRE: Note that die adds the "at <file> <line>" stuff IFF the message doesn't end w/ CR!
307 #### $message .= $state->getStatusMessage . "\n" if $state && !$ineval;
308 }
309 else { # If we ARE in a recursive call, the actual message is $details[0]
310 0 ▶ $message = $details[0] if $details[0]; }
Branch: 1 branch
BranchTrueFalseTotal
if $details[0] 0 0 0
311 # inhibit message to STDERR, since die will handle that
312 0 _printlines($message);
313 0 hardYankProcessing();
314 # Now that we have yanked the processing state, ignore any following errors
315 0 $LaTeXML::IGNORE_ERRORS = 1;
316  
317 # If inside an eval, this won't actually die, but WILL set $@ for caller's use.
318 0 die $DIE_MESSAGE; }
319  
320 0 ▶sub hardYankProcessing {
Subroutine hardYankProcessing: not called CC=6 SCAR=37.4
Pod undocumented
321 0 my $state = $STATE;
322 # Nothing we can do if we are called without a global $STATE bound
323 0 ▶ return unless $state;
Branch: 1 branch
BranchTrueFalseTotal
unless $state 0 0 0
324 # Ensure we have nothing else to do in the main processing.
325 # NOTE: this recovery procedure must always be run after all logging messages are generated,
326 # as resetting the various stacks loses information (e.g. location is lost).
327 0 my $stomach = $$state{stomach};
328 0 my $gullet = $$stomach{gullet};
329 0 $$stomach{token_stack} = [];
330 # If we were in an infinite loop, disable any potential busy token.
331 0 my $relax_def = $$state{meaning}{"\\relax"}[0];
332 0 ▶ $state->assignMeaning($LaTeXML::CURRENT_TOKEN, $relax_def, 'global') if $LaTeXML::CURRENT_TOKEN;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::CURRENT_TOKEN 0 0 0
333 0 for my $token (@{ $$gullet{pushback} }) {
334 0 $state->assignMeaning($token, $relax_def, 'global'); }
335 # Rescue data structures that may be serializable/resumable
336 0 ▶ if (@LaTeXML::LIST) {
Branch: 1 branch
BranchTrueFalseTotal
if (@LaTeXML::LIST) 0 0 0
337 0 $$stomach{rescued_boxes} = [@LaTeXML::LIST];
338 0 @LaTeXML::LIST = ();
339 }
340 0 ▶ if ($LaTeXML::DOCUMENT) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::DOCUMENT) 0 0 0
341 0 $$state{rescued_document} = $LaTeXML::DOCUMENT; }
342 # avoid looping at \end{document}, Fatal brings us back to the doc level
343 0 $state->assignValue('current_environment', undef, 'global');
344 # then reset the gullet
345 0 $$gullet{pushback} = [];
346 0 $$gullet{mouthstack} = [];
347 0 $$gullet{pending_comments} = [];
348 0 $$gullet{mouth} = LaTeXML::Core::Mouth->new();
349 0 return; }
350  
351 0 ▶sub checkRecursiveError {
Subroutine checkRecursiveError: not called CC=3 SCAR=24.8
Pod undocumented
352 0 my @caller;
353 0 ▶ for (my $frame = 2 ; @caller = caller($frame) ; $frame++) {
Branch: 1 branch
BranchTrueFalseTotal
if (@caller = caller $frame) 0 0 0
354 0 ▶ if ($caller[3] =~ /^LaTeXML::(Global::ToString|Global::Stringify)$/) {
Branch: 1 branch
BranchTrueFalseTotal
if ($caller[3] =~ /^LaTeXML::(Global::ToString|Global::Stringify)$/) 0 0 0
355 # print STDERR "RECURSED ON $caller[3]\n";
356 0 return 1; } }
357 0 return; }
358  
359 # Should be fatal if strict is set, else warn.
360 0 ▶sub Error {
Subroutine Error: not called CC=10 SCAR=47.0
Pod documented
361 0 my ($category, $object, $where, $message, @details) = @_;
362 0 ▶ return if $LaTeXML::IGNORE_ERRORS;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::IGNORE_ERRORS 0 0 0
363 0 my $state = $STATE;
364 0 ▶ $state && $state->noteStatus('error');
Branch: 1 branch
BranchTrueFalseTotal
$state and $state->noteStatus("error") 0 0 0
365 0 ▶ if ($state && $state->lookupValue('STRICT')) {
Branch: 1 branch
BranchTrueFalseTotal
if ($state and $state->lookupValue('STRICT')) { } 0 0 0
Condition0%0/3
$state and $state->lookupValue("STRICT")
!ll&&!rl&&r
000
MC/DC0%0/2
$state and $state->lookupValue("STRICT")
$state $state->lookupValue("STRICT")
Truth table0%0/3
A and B
A= $stateB= $state->lookupValue("STRICT")
ABresult
0X0
100
111
366 0 Fatal($category, $object, $where, $message, @details); }
367 else {
368 0 my $formatted = generateMessage("Error:" . $category . ":" . ToString($object),
369 $where, $message, 1, @details);
370 0 _printline($formatted); }
371 # Note that "100" is hardwired into TeX, The Program!!!
372 0 ▶ my $maxerrors = ($state ? $state->lookupValue('MAX_ERRORS') : 100);
Branch: 1 branch
BranchTrueFalseTotal
$state ? : 0 0 0
373 0 ▶ if ($state && (defined $maxerrors) && (($state->getStatus('error') || 0) > $maxerrors)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($state and defined $maxerrors and ($state->getStatus("error") || 0) > $maxerrors) 0 0 0
Condition0%0/8
$state and defined $maxerrors and ($state->getStatus("error") || 0) > $maxerrors
!ll&&!rl&&r
000
$state and defined $maxerrors
!ll&&!rl&&r
000
$state->getStatus('error') || 0
l!l
00
MC/DC0%0/3
$state and defined $maxerrors and ($state->getStatus("error") || 0) > $maxerrors
$state defined $maxerrors $state->getStatus('error')
Truth table0%0/4
A and B and C
A= $stateB= defined $maxerrorsC= $state->getStatus('error')
ABCresult
0XX0
10X0
1100
1111
374 0 Fatal('too_many_errors', $maxerrors, $where, "Too many errors (> $maxerrors)!"); }
375 0 return; }
376  
377 # Warning message; results may be OK, but somewhat unlikely
378 0 ▶sub Warn {
Subroutine Warn: not called CC=3 SCAR=24.8
Pod documented
379 0 my ($category, $object, $where, $message, @details) = @_;
380 0 ▶ return if $LaTeXML::IGNORE_ERRORS;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::IGNORE_ERRORS 0 0 0
381 0 my $state = $STATE;
382 0 ▶ $state && $state->noteStatus('warning');
Branch: 1 branch
BranchTrueFalseTotal
$state and $state->noteStatus("warning") 0 0 0
383 0 my $formatted = generateMessage("Warning:" . $category . ":" . ToString($object),
384 $where, $message, 0, @details);
385 0 _printline($formatted);
386 0 return; }
387  
388 # Informational message; results likely unaffected
389 # but the message may give clues about subsequent warnings or errors
390 0 ▶sub Info {
Subroutine Info: not called CC=3 SCAR=24.8
Pod documented
391 0 my ($category, $object, $where, $message, @details) = @_;
392 0 ▶ return if $LaTeXML::IGNORE_ERRORS;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::IGNORE_ERRORS 0 0 0
393 0 my $state = $STATE;
394 0 ▶ $state && $state->noteStatus('info');
Branch: 1 branch
BranchTrueFalseTotal
$state and $state->noteStatus("info") 0 0 0
395 0 my $formatted = generateMessage("Info:" . $category . ":" . ToString($object),
396 $where, $message, -1, @details);
397 0 _printline($formatted);
398 0 return; }
399  
400 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
401 # Progress Reporting
402 #**********************************************************************
403  
404 0 ▶sub Note {
Subroutine Note: not called CC=1 SCAR=6.9
Pod documented
405 0 my ($message) = @_;
406 0 _printline($message);
407 0 return; }
408  
409 0 ▶sub NoteSTDERR {
Subroutine NoteSTDERR: not called CC=3 SCAR=24.8
Pod documented
410 0 my ($message) = @_;
411 0 ▶ if ($USE_STDERR && ($VERBOSITY >= 0)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0) 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::VERBOSITY >= 0
ABresult
0X0
100
111
412 0 _spinnerclear();
413 0 print STDERR _freshline(\*STDERR), $message, "\n";
414 0 _spinnerrestore(); }
415 0 return; }
416  
417 0 ▶sub NoteLog {
Subroutine NoteLog: not called CC=2 SCAR=17.9
Pod documented
418 0 my ($message) = @_;
419 0 ▶ print $LOG _freshline($LOG), strip_ansi($message), "\n" if $LOG;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::LOG 0 0 0
420 0 return; }
421  
422 # Progress reporting.
423 # Needs LOG/STDERR sorted out. Maybe some Term magic on STDERR? (rotating "-"?)
424 # Possibly wants more explicit levels?
425 # or at least a report-always level?
426 0 ▶sub ProgressStep {
Subroutine ProgressStep: not called CC=1 SCAR=6.9
Pod documented
427 0 my ($note) = @_;
428 0 _spinnerstep($note);
429 0 return; }
430  
431 0 ▶sub ProgressSpinup {
Subroutine ProgressSpinup: not called CC=9 SCAR=45.0
Pod documented
432 0 my ($stage) = @_;
433 0 ▶ if ($LOG || ($USE_STDERR && ($VERBOSITY >= 0))) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0) 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
l!l&&r!l&&!r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::LOG $LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/4
A or B and C
A= $LaTeXML::Common::Error::LOGB= $LaTeXML::Common::Error::USE_STDERRC= $LaTeXML::Common::Error::VERBOSITY >= 0
ABCresult
1XX1
0111
00X0
0100
434 0 my $message = "($stage...";
435 0 _spinnerclear();
436 0 _spinnerpush($stage);
437 0 _spinnerrestore();
438 0 ▶ if ($LOG) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::LOG) 0 0 0
439 0 print $LOG _freshline($LOG), $message;
440 0 ▶ $NEEDSFRESHLINE{$LOG} = 1 if $LOG; }
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::LOG 0 0 0
441 0 ▶ if ($USE_STDERR && ($VERBOSITY >= 0) && !$IS_TERMINAL) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 and not $LaTeXML::Common::Error::IS_TERMINAL) 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 and not $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 and not $LaTeXML::Common::Error::IS_TERMINAL
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0 not $LaTeXML::Common::Error::IS_TERMINAL
Truth table0%0/4
A and B and not(C)
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::VERBOSITY >= 0C= not $LaTeXML::Common::Error::IS_TERMINAL
ABCresult
0XX0
10X0
1100
1111
442 0 print STDERR _freshline(\*STDERR), $message;
443 0 $NEEDSFRESHLINE{ \*STDERR } = 1; } }
444 0 return; }
445  
446 0 ▶sub ProgressSpindown {
Subroutine ProgressSpindown: not called CC=10 SCAR=47.0
Pod undocumented
447 0 my ($stage) = @_;
448 0 ▶ if ($LOG || ($USE_STDERR && ($VERBOSITY >= 0))) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0) 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
l!l&&r!l&&!r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::LOG or $LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::LOG $LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/4
A or B and C
A= $LaTeXML::Common::Error::LOGB= $LaTeXML::Common::Error::USE_STDERRC= $LaTeXML::Common::Error::VERBOSITY >= 0
ABCresult
1XX1
0111
00X0
0100
449 0 _spinnerclear();
450 0 my $elapsed = _spinnerpop($stage);
451 0 _spinnerrestore();
452 0 ▶ my $message = ($elapsed ? sprintf(" %.2f sec)", $elapsed) : '?');
Branch: 1 branch
BranchTrueFalseTotal
$elapsed ? : 0 0 0
453 0 ▶ print $LOG $message if $LOG;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::LOG 0 0 0
454 0 ▶ $NEEDSFRESHLINE{$LOG} = 1 if $LOG;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::LOG 0 0 0
455 0 ▶ if ($USE_STDERR && ($VERBOSITY >= 0) && !$IS_TERMINAL) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 and not $LaTeXML::Common::Error::IS_TERMINAL) 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 and not $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::VERBOSITY >= 0 and not $LaTeXML::Common::Error::IS_TERMINAL
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::VERBOSITY >= 0 not $LaTeXML::Common::Error::IS_TERMINAL
Truth table0%0/4
A and B and not(C)
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::VERBOSITY >= 0C= not $LaTeXML::Common::Error::IS_TERMINAL
ABCresult
0XX0
10X0
1100
1111
456 0 print STDERR $message;
457 0 $NEEDSFRESHLINE{ \*STDERR } = 1; } }
458 0 return; }
459  
460 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
461 # Debugging support.
462 # Short of real macros, here's a flexible, low-cost debug technique:
463 # Debug(message...) if $LaTeXML::DEBUG{feature};
464 34 our %Debugbable = ();
465 # %LaTeXML::DEBUG = {};
466  
467 10 ▶sub DebuggableFeature {
Subroutine DebuggableFeature: called CC=1 SCAR=0.0
Pod documented
468 10 my ($feature, $description) = @_;
469 10 $LaTeXML::Debuggable{$feature} = $description;
470 10 return; }
471  
472 0 ▶sub Debug {
Subroutine Debug: not called CC=1 SCAR=6.9
Pod documented
473 0 my ($message) = @_;
474 # Note: Could append source code location of the caller?
475 0 _printlines($message);
476 0 return; }
477  
478 # This only makes sense at end of run, after all needed modules have been loaded!
479 0 ▶sub CheckDebuggable {
Subroutine CheckDebuggable: not called CC=4 SCAR=30.0
Pod documented
480 0 my %unknown = ();
481 0 foreach my $feature (keys %LaTeXML::DEBUG) {
482 0 ▶ $unknown{$feature} = 1 unless $LaTeXML::Debuggable{$feature}; }
Branch: 1 branch
BranchTrueFalseTotal
unless $LaTeXML::Debuggable{$feature} 0 0 0
483 # Now report unknown; suggest similar spellings ?
484 0 ▶ if (keys %unknown) {
Branch: 1 branch
BranchTrueFalseTotal
if (keys %unknown) 0 0 0
485 0 print STDERR _freshline(\*STDERR), "The debugging feature(s) " . join(', ', sort keys %unknown) . " were never declared\n";
486 0 print STDERR _freshline(\*STDERR), "Known debugging features: " . join(', ', sort keys %LaTeXML::Debuggable) . "\n"; }
487 0 return; }
488  
489 0 ▶sub Deprecated {
Subroutine Deprecated: not called CC=4 SCAR=30.0
Pod undocumented
490 0 my ($key, $version, $message) = @_;
491 0 ▶ return if $STATE && $STATE->lookupMapping('DEPRECATIONS_WARNED', $key);
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::STATE and $LaTeXML::Common::Error::STATE->lookupMapping("DEPRECATIONS_WARNED", $key) 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::STATE and $LaTeXML::Common::Error::STATE->lookupMapping("DEPRECATIONS_WARNED", $key)
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::STATE and $LaTeXML::Common::Error::STATE->lookupMapping("DEPRECATIONS_WARNED", $key)
$LaTeXML::Common::Error::STATE $LaTeXML::Common::Error::STATE->lookupMapping("DEPRECATIONS_WARNED", $key)
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::STATEB= $LaTeXML::Common::Error::STATE->lookupMapping("DEPRECATIONS_WARNED", $key)
ABresult
0X0
100
111
492 0 Warn('deprecated', $key, undef, "$key is deprecated (as of $version)", $message);
493 0 ▶ $STATE->assignMapping('DEPRECATIONS_WARNED', $key => 1) if $STATE;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::STATE 0 0 0
494 0 return; }
495  
496 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
497 # Handlers for perl's die & warn
498 # We'll try to decode some common errors to make them more usable
499 # for build systems.
500  
501 34 my $quoted_re = qr/\"([^\"]*)\"/; # [CONSTANT]
502 34 my $cantcall_re = qr/Can't call method/; # [CONSTANT]
503 34 my $cantlocate_re = qr/Can't locate object method/; # [CONSTANT]
504 34 my $undef_re = qr/Undefined subroutine/; # [CONSTANT]
505 34 my $noself_re = qr/on an undefined value|without a package or object reference/; # [CONSTANT]
506 34 my $via_re = qr/via package/; # [CONSTANT]
507 34 my $at_re = qr/(at .*)/; # [CONSTANT]
508  
509 0 ▶sub perl_die_handler {
Subroutine perl_die_handler: not called CC=9 SCAR=45.0
Pod undocumented
510 0 my (@line) = @_;
511 0 ▶ if ($LaTeXML::IGNORE_ERRORS # Just get out now, if we're ignoring errors within an eval.
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::IGNORE_ERRORS or colorstrip($line[0]) =~ /^\s*Fatal:/) 0 0 0
Condition0%0/3
$LaTeXML::IGNORE_ERRORS or colorstrip($line[0]) =~ /^\s*Fatal:/
l!l&&r!l&&!r
000
MC/DC0%0/2
$LaTeXML::IGNORE_ERRORS or colorstrip($line[0]) =~ /^\s*Fatal:/
$LaTeXML::IGNORE_ERRORS colorstrip($line[0]) =~ /^\s*Fatal:/
Truth table0%0/3
A or B
A= $LaTeXML::IGNORE_ERRORSB= colorstrip($line[0]) =~ /^\s*Fatal:/
ABresult
1X1
011
000
512 || (colorstrip($line[0]) =~ /^\s*Fatal:/)) { # Or, we've already been through here.
513 0 local $SIG{__DIE__} = undef;
514 0 die @line; }
515 # We try to find a meaningful name for where the error occurred;
516 # That's the thing that is "misdefined", after all.
517 # Not completely sure we're looking in the right place up the stack, though.
518 0 ▶ if ($line[0] =~ /^$cantcall_re\s+$quoted_re\s+($noself_re)\s+$at_re$/) {
Branch: 6 branches
BranchTrueFalseTotal
if ($line[0] =~ /^$cantcall_re\s+$quoted_re\s+($noself_re)\s+$at_re$/) { } 0 0 0
elsif ($line[0] =~ /^$undef_re\s+(\S+)\s+called $at_re$/) { } 0 0 0
elsif ($line[0] =~ /^$cantlocate_re\s+$quoted_re\s+$via_re\s+$quoted_re\s+\(.*\)\s+$at_re/) { } 0 0 0
elsif ($line[0] =~ /^Can't locate \S* in \@INC \(you may need to install the (\S*) module\) \(\@INC contains: ([^\)]*)\) $at_re$/) { } 0 0 0
elsif ($line[0] =~ /^Can't use\s+(\w*)\s+\([^\)]*\) as (.*?) ref(?:\s+while "strict refs" in use)? at (.*)$/) { } 0 0 0
elsif ($line[0] =~ /^File (.*?) had an error:/) { } 0 0 0
519 0 my ($method, $kind, $where) = ($1, $2, $3);
520 0 Fatal('misdefined', callerName(1), $where,
521 "Can't call method '$method' $kind", @line[1 .. $#line]); }
522 elsif ($line[0] =~ /^$undef_re\s+(\S+)\s+called $at_re$/) {
523 0 my ($function, $where) = ($1, $2);
524 0 Fatal('misdefined', callerName(1), $where,
525 "Undefined subroutine '$function' called", @line[1 .. $#line]); }
526 elsif ($line[0] =~ /^$cantlocate_re\s+$quoted_re\s+$via_re\s+$quoted_re\s+\(.*\)\s+$at_re/) {
527 0 my ($method, $class, $where) = ($1, $2, $3);
528 0 Fatal('misdefined', callerName(1), $where,
529 "Can't locate method '$method' via '$class'", @line[1 .. $#line]); }
530 elsif ($line[0] =~ /^Can't locate \S* in \@INC \(you may need to install the (\S*) module\) \(\@INC contains: ([^\)]*)\) $at_re$/) {
531 0 my ($class, $inc, $where) = ($1, $2);
532 0 Fatal('misdefined', callerName(1), $where,
533 "Can't locate class '$class' (not installed or misspelled?)", @line[1 .. $#line]); }
534 elsif ($line[0] =~ /^Can't use\s+(\w*)\s+\([^\)]*\) as (.*?) ref(?:\s+while "strict refs" in use)? at (.*)$/) {
535 0 my ($gottype, $wanttype, $where) = ($1, $2, $3);
536 0 Fatal('misdefined', callerName(1), $where,
537 "Can't use $gottype as $wanttype reference", @line[1 .. $#line]); }
538 elsif ($line[0] =~ /^File (.*?) had an error:/) {
539 0 my ($file) = ($1);
540 0 Fatal('misdefined', $file, undef, @line); }
541 else {
542 0 Fatal('perl', 'die', undef, "Perl died", @line); }
543 0 return; }
544  
545 0 ▶sub perl_warn_handler {
Subroutine perl_warn_handler: not called CC=6 SCAR=37.4
Pod undocumented
546 0 my (@line) = @_;
547 0 ▶ return if $LaTeXML::IGNORE_ERRORS;
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::IGNORE_ERRORS 0 0 0
548 0 ▶ if ($line[0] =~ /^Use of uninitialized value (.*?)(\s?+in .*?)\s+(at\s+.*?\s+line\s+\d+)\.$/) {
Branch: 3 branches
BranchTrueFalseTotal
if ($line[0] =~ /^Use of uninitialized value (.*?)(\s?+in .*?)\s+(at\s+.*?\s+line\s+\d+)\.$/) { } 0 0 0
elsif ($line[0] =~ /^Deep recursion on/) { } 0 0 0
elsif ($line[0] =~ /^(.*?)\s+(at\s+.*?\s+line\s+\d+)\.$/) { } 0 0 0
549 0 ▶ my ($what, $how, $where) = ($1 || 'value', $2, $3);
Condition0%0/2
$1 || 'value'
l!l
00
MC/DC0%0/1
$1 || 'value'
$1
Truth table0%0/2
A
A= $1
Aresult
11
00
550 0 Warn('uninitialized', $what, $where, "Use of uninitialized value $what $how", @line[1 .. $#line]); }
551 elsif ($line[0] =~ /^Deep recursion on/) {
552 0 Fatal('perl', 'deep_recursion', undef, $line[0]); }
553 elsif ($line[0] =~ /^(.*?)\s+(at\s+.*?\s+line\s+\d+)\.$/) {
554 0 my ($warning, $where) = ($1, $2);
555 0 Warn('perl', 'warn', undef, $warning, $where, @line[1 .. $#line]); }
556 else {
557 0 Warn('perl', 'warn', undef, @line); }
558 0 return; }
559  
560 # The following handlers SHOULD report the problem,
561 # even when within a "safe" eval that's ignoring errors.
562 # Moreover, we'd really like to be able to throw all the way to
563 # the top-level containing eval. How to do that?
564 0 ▶sub perl_interrupt_handler {
Subroutine perl_interrupt_handler: not called CC=1 SCAR=6.9
Pod undocumented
565 0 my (@line) = @_;
566 0 $LaTeXML::IGNORE_ERRORS = 0; # NOT ignored
567 0 $LaTeXML::UNSAFE_FATAL = 1;
568 0 Fatal('interrupt', 'interrupted', undef, "LaTeXML was interrupted", @line);
569 0 return; }
570  
571 0 ▶sub perl_timeout_handler {
Subroutine perl_timeout_handler: not called CC=1 SCAR=6.9
Pod undocumented
572 0 my (@line) = @_;
573 0 $LaTeXML::IGNORE_ERRORS = 0; # NOT ignored
574 0 $LaTeXML::UNSAFE_FATAL = 1;
575 0 Fatal('timeout', 'timedout', undef, "Conversion timed out", @line);
576 0 return; }
577  
578 0 ▶sub perl_terminate_handler {
Subroutine perl_terminate_handler: not called CC=1 SCAR=6.9
Pod undocumented
579 0 my (@line) = @_;
580 0 $LaTeXML::IGNORE_ERRORS = 0; # NOT ignored
581 0 $LaTeXML::UNSAFE_FATAL = 1;
582 0 Fatal('terminate', 'terminated', undef, "Conversion was terminated", @line);
583 0 return; }
584  
585 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
586 # Internals
587 # Synthesize an error message describing what happened, and where.
588 # $detail specifies the level of detail
589 # $detail == -1 : no context or stack
590 # $detail == 0 : context, no stack
591 # $detail == +1 : context & stack
592 # including a level requesting full stack trace?
593  
594 0 ▶sub generateMessage {
Subroutine generateMessage: not called CC=30 SCAR=68.4
Pod documented
595 0 my ($errorcode, $where, $message, $detail, @extra) = @_;
596 # Colorize errorcode if appropriate
597 0 ▶ if ($USE_STDERR && $IS_TERMINAL && ($VERBOSITY >= 0)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0) 0 0 0
Condition0%0/6
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0
!ll&&!rl&&r
000
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL
!ll&&!rl&&r
000
MC/DC0%0/3
$LaTeXML::Common::Error::USE_STDERR and $LaTeXML::Common::Error::IS_TERMINAL and $LaTeXML::Common::Error::VERBOSITY >= 0
$LaTeXML::Common::Error::USE_STDERR $LaTeXML::Common::Error::IS_TERMINAL $LaTeXML::Common::Error::VERBOSITY >= 0
Truth table0%0/4
A and B and C
A= $LaTeXML::Common::Error::USE_STDERRB= $LaTeXML::Common::Error::IS_TERMINALC= $LaTeXML::Common::Error::VERBOSITY >= 0
ABCresult
0XX0
10X0
1100
1111
598 0 $errorcode =~ /^(\w+)\:/;
599 0 ▶ my $errorkind = $1 && lc($1);
Condition0%0/3
$1 && lc $1
!ll&&!rl&&r
000
MC/DC0%0/2
$1 && lc $1
$1 lc $1
Truth table0%0/3
A && B
A= $1B= lc $1
ABresult
0X0
100
111
600 0 ▶ $errorcode = colorizeString($errorcode, $errorkind) if $errorkind; }
Branch: 1 branch
BranchTrueFalseTotal
if $errorkind 0 0 0
601  
602 #----------------------------------------
603 # Generate location information; basic and for stack trace.
604 # If we've been given an object $where, where the error occurred, use it.
605 0 my $docloc = getLocation($where);
606 0 ▶ $docloc = defined $docloc ? ToString($docloc) : '';
Branch: 1 branch
BranchTrueFalseTotal
defined $docloc ? : 0 0 0
607  
608 # $message and each of @extra should be single lines
609 0 @extra = grep { $_ ne '' } map { split("\n", $_) } grep { defined $_ } $message, @extra;
610 # make 1st line be 1st line of message
611 0 $message = shift(@extra);
612 # $message =~ s/\n.*//g;
613 # The initial portion of the message will consist of:
614 0 ▶ $message = '' unless defined $message;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $message 0 0 0
615 0 ▶ my @lines = (
Branch: 1 branch
BranchTrueFalseTotal
$docloc ? : 0 0 0
616 # Start with the error code & primary error message
617 $errorcode . ' ' . $message,
618 # Followed by single line location of where the message occurred (if we know)
619 ($docloc ? ('at ' . $docloc) : ()),
620 # and then any additional message lines supplied
621 @extra);
622  
623 #----------------------------------------
624 # Now add some additional context
625 # NOTE: Should skip this for INFO
626 # NOTE: Need to pass more of this onto the objects themselves....
627 # What should it be called?
628 # showErrorContext() ?????
629 0 ▶ $detail = 0 unless defined $detail;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $detail 0 0 0
630 # Increment $detail if $verbosity > 0, unless $detail = -1,
631 0 ▶ if (($detail > -1) && ($VERBOSITY > 0)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($detail > -1 and $LaTeXML::Common::Error::VERBOSITY > 0) 0 0 0
Condition0%0/3
$detail > -1 and $LaTeXML::Common::Error::VERBOSITY > 0
!ll&&!rl&&r
000
MC/DC0%0/2
$detail > -1 and $LaTeXML::Common::Error::VERBOSITY > 0
$detail > -1 $LaTeXML::Common::Error::VERBOSITY > 0
Truth table0%0/3
A and B
A= $detail > -1B= $LaTeXML::Common::Error::VERBOSITY > 0
ABresult
0X0
100
111
632 0 ▶ $detail = 0 if defined $VERBOSITY && $VERBOSITY < -1;
Branch: 1 branch
BranchTrueFalseTotal
if defined $LaTeXML::Common::Error::VERBOSITY and $LaTeXML::Common::Error::VERBOSITY < -1 0 0 0
Condition0%0/3
defined $LaTeXML::Common::Error::VERBOSITY and $LaTeXML::Common::Error::VERBOSITY < -1
!ll&&!rl&&r
000
MC/DC0%0/2
defined $LaTeXML::Common::Error::VERBOSITY and $LaTeXML::Common::Error::VERBOSITY < -1
defined $LaTeXML::Common::Error::VERBOSITY $LaTeXML::Common::Error::VERBOSITY < -1
Truth table0%0/3
A and B
A= defined $LaTeXML::Common::Error::VERBOSITYB= $LaTeXML::Common::Error::VERBOSITY < -1
ABresult
0X0
100
111
633 0 ▶ $detail++ if defined $VERBOSITY && $VERBOSITY > +1; }
Branch: 1 branch
BranchTrueFalseTotal
if defined $LaTeXML::Common::Error::VERBOSITY and $LaTeXML::Common::Error::VERBOSITY > 1 0 0 0
Condition0%0/3
defined $LaTeXML::Common::Error::VERBOSITY and $LaTeXML::Common::Error::VERBOSITY > 1
!ll&&!rl&&r
000
MC/DC0%0/2
defined $LaTeXML::Common::Error::VERBOSITY and $LaTeXML::Common::Error::VERBOSITY > 1
defined $LaTeXML::Common::Error::VERBOSITY $LaTeXML::Common::Error::VERBOSITY > 1
Truth table0%0/3
A and B
A= defined $LaTeXML::Common::Error::VERBOSITYB= $LaTeXML::Common::Error::VERBOSITY > 1
ABresult
0X0
100
111
634  
635 # FIRST line of stack trace information ought to look at the $where
636 0 my $wheretype = ref $where;
637 0 ▶ if ($detail <= 0) { } # No extra context
Branch: 4 branches
BranchTrueFalseTotal
if ($detail <= 0) { } 0 0 0
elsif ($wheretype =~ /^XML::LibXML/) { } 0 0 0
elsif ($wheretype =~ /LaTeXML::Core::Gullet/) { } 0 0 0
elsif ($wheretype =~ /LaTeXML::Core::Stomach/) { } 0 0 0
638 elsif ($wheretype =~ /^XML::LibXML/) {
639 0 push(@lines, "Node is " . Stringify($where)); }
640 ## Hmm... if we're being verbose or level is high, we might do this:
641 ### "Currently in ".$doc->getInsertionContext); }
642 elsif ($wheretype =~ 'LaTeXML::Core::Gullet') {
643 0 push(@lines, $where->showUnexpected); } # Or better?
644 elsif ($wheretype =~ 'LaTeXML::Core::Stomach') {
645 push(@lines,
646 0 ▶ "Recently digested: " . join(' ', map { Stringify($_) } @LaTeXML::LIST))
Branch: 1 branch
BranchTrueFalseTotal
if $LaTeXML::Common::Error::VERBOSITY > 1 0 0 0
647 if $VERBOSITY > 1; }
648  
649 #----------------------------------------
650 # Add Stack Trace, if that seems worthwhile.
651 0 ▶ if (($detail > 1) && ($VERBOSITY > 0)) {
Branch: 2 branches
BranchTrueFalseTotal
if ($detail > 1 and $LaTeXML::Common::Error::VERBOSITY > 0) { } 0 0 0
elsif ($detail > -1) { } 0 0 0
Condition0%0/3
$detail > 1 and $LaTeXML::Common::Error::VERBOSITY > 0
!ll&&!rl&&r
000
MC/DC0%0/2
$detail > 1 and $LaTeXML::Common::Error::VERBOSITY > 0
$detail > 1 $LaTeXML::Common::Error::VERBOSITY > 0
Truth table0%0/3
A and B
A= $detail > 1B= $LaTeXML::Common::Error::VERBOSITY > 0
ABresult
0X0
100
111
652 0 push(@lines, "Stack Trace:", stacktrace()); }
653 elsif ($detail > -1) {
654 0 ▶ my $nstack = ($detail > 1 ? undef : ($detail > 0 ? 4 : 1));
Branch: 2 branches
BranchTrueFalseTotal
$detail > 1 ? : 0 0 0
$detail > 0 ? : 0 0 0
655 0 ▶ if (my @objects = objectStack($nstack)) {
Branch: 1 branch
BranchTrueFalseTotal
if (my(@objects) = objectStack($nstack)) 0 0 0
656 0 my $top = shift(@objects);
657 0 push(@lines, "In " . trim(Stringify($$top[0])) . ' ' . Stringify($$top[1]));
658 0 ▶ push(@objects, ['...']) if @objects && defined $nstack;
Branch: 1 branch
BranchTrueFalseTotal
if @objects and defined $nstack 0 0 0
Condition0%0/3
@objects and defined $nstack
!ll&&!rl&&r
000
MC/DC0%0/2
@objects and defined $nstack
@objects defined $nstack
Truth table0%0/3
A and B
A= @objectsB= defined $nstack
ABresult
0X0
100
111
659 0 ▶ push(@lines, join('', (map { ' <= ' . trim(Stringify($$_[0])) } @objects))) if @objects;
Branch: 1 branch
BranchTrueFalseTotal
if @objects 0 0 0
660 } }
661  
662 # finally, join the result into a block of lines, indenting all but the 1st line.
663 0 return join("\n\t", @lines); }
664  
665 0 ▶sub MergeStatus {
Subroutine MergeStatus: not called CC=7 SCAR=40.3
Pod undocumented
666 0 my ($external_state) = @_;
667 0 my $state = $STATE;
668 0 ▶ return unless $state && $external_state;
Branch: 1 branch
BranchTrueFalseTotal
unless $state and $external_state 0 0 0
Condition0%0/3
$state and $external_state
!ll&&!rl&&r
000
MC/DC0%0/2
$state and $external_state
$state $external_state
Truth table0%0/3
A and B
A= $stateB= $external_state
ABresult
0X0
100
111
669 0 my $status = $$state{status};
670 0 my $external_status = $$external_state{status};
671 # Should this be a state method? I suspect XS-ive conflicts later on...
672 0 foreach my $type (keys %$external_status) {
673 0 ▶ if ($type eq 'undefined' or $type eq 'missing') {
Branch: 1 branch
BranchTrueFalseTotal
if ($type eq 'undefined' or $type eq 'missing') { } 0 0 0
Condition0%0/3
$type eq "undefined" or $type eq "missing"
l!l&&r!l&&!r
000
MC/DC0%0/2
$type eq "undefined" or $type eq "missing"
$type eq "undefined" $type eq "missing"
Truth table0%0/3
A or B
A= $type eq "undefined"B= $type eq "missing"
ABresult
1X1
011
000
674 0 my $table = $$external_status{$type};
675 0 foreach my $subtype (keys %$table) {
676 0 $$status{$type}{$subtype} += $$table{$subtype};
677 }
678 } else {
679 0 $$status{$type} += $$external_status{$type};
680 }
681 }
682 0 return; }
683  
684 # returns the locator of an object, or undef
685 0 ▶sub Locator {
Subroutine Locator: not called CC=3 SCAR=24.8
Pod undocumented
686 0 my ($object) = @_;
687 0 ▶ return ($object && $object->can('getLocator') ? $object->getLocator : undef); }
Branch: 1 branch
BranchTrueFalseTotal
$object && $object->can('getLocator') ? : 0 0 0
Condition0%0/3
$object and $object->can("getLocator")
!ll&&!rl&&r
000
MC/DC0%0/2
$object and $object->can("getLocator")
$object $object->can("getLocator")
Truth table0%0/3
A and B
A= $objectB= $object->can("getLocator")
ABresult
0X0
100
111
688  
689 # A more organized abstraction along there likes of $where->whereAreYou
690 # might be useful?
691 0 ▶sub getLocation {
Subroutine getLocation: not called CC=13 SCAR=52.0
Pod undocumented
692 0 my ($where) = @_;
693 0 my $wheretype = ref $where;
694 0 ▶ if ($wheretype && ($wheretype =~ /^XML::LibXML/)) {
Branch: 4 branches
BranchTrueFalseTotal
if ($wheretype and $wheretype =~ /^XML::LibXML/) { } 0 0 0
elsif ($wheretype and $where->can('getLocator')) { } 0 0 0
elsif (defined $where) { } 0 0 0
elsif ($LaTeXML::DOCUMENT) { } 0 0 0
Condition0%0/3
$wheretype and $wheretype =~ /^XML::LibXML/
!ll&&!rl&&r
000
MC/DC0%0/2
$wheretype and $wheretype =~ /^XML::LibXML/
$wheretype $wheretype =~ /^XML::LibXML/
Truth table0%0/3
A and B
A= $wheretypeB= $wheretype =~ /^XML::LibXML/
ABresult
0X0
100
111
695 0 ▶ my $box = $LaTeXML::DOCUMENT && $LaTeXML::DOCUMENT->getNodeBox($where);
Condition0%0/3
$LaTeXML::DOCUMENT && $LaTeXML::DOCUMENT->getNodeBox($where)
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::DOCUMENT && $LaTeXML::DOCUMENT->getNodeBox($where)
$LaTeXML::DOCUMENT $LaTeXML::DOCUMENT->getNodeBox($where)
Truth table0%0/3
A && B
A= $LaTeXML::DOCUMENTB= $LaTeXML::DOCUMENT->getNodeBox($where)
ABresult
0X0
100
111
696 0 ▶ return Locator($box) if $box; }
Branch: 1 branch
BranchTrueFalseTotal
if $box 0 0 0
697 ▶ elsif ($wheretype && $where->can('getLocator')) {
Condition0%0/3
$wheretype and $where->can("getLocator")
!ll&&!rl&&r
000
MC/DC0%0/2
$wheretype and $where->can("getLocator")
$wheretype $where->can("getLocator")
Truth table0%0/3
A and B
A= $wheretypeB= $where->can("getLocator")
ABresult
0X0
100
111
698 0 return $where->getLocator; }
699 elsif (defined $where) {
700 0 return $where; }
701 # Otherwise, try to guess where the error came from!
702 elsif ($LaTeXML::DOCUMENT) { # During construction?
703 0 my $node = $LaTeXML::DOCUMENT->getNode;
704 0 my $box = $LaTeXML::DOCUMENT->getNodeBox($node);
705 0 ▶ return Locator($box) if $box; }
Branch: 1 branch
BranchTrueFalseTotal
if $box 0 0 0
706 0 ▶ if ($LaTeXML::BOX) { # In constructor?
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::BOX) 0 0 0
707 0 return Locator($LaTeXML::BOX); }
708 0 ▶ if ($STATE && $STATE->getStomach) {
Branch: 1 branch
BranchTrueFalseTotal
if ($LaTeXML::Common::Error::STATE and $LaTeXML::Common::Error::STATE->getStomach) 0 0 0
Condition0%0/3
$LaTeXML::Common::Error::STATE and $LaTeXML::Common::Error::STATE->getStomach
!ll&&!rl&&r
000
MC/DC0%0/2
$LaTeXML::Common::Error::STATE and $LaTeXML::Common::Error::STATE->getStomach
$LaTeXML::Common::Error::STATE $LaTeXML::Common::Error::STATE->getStomach
Truth table0%0/3
A and B
A= $LaTeXML::Common::Error::STATEB= $LaTeXML::Common::Error::STATE->getStomach
ABresult
0X0
100
111
709 0 my $gullet = $STATE->getStomach->getGullet;
710 # NOTE: Problems here.
711 # (1) With obsoleting Tokens as a Mouth, we can get pointless "Anonymous String" locators!
712 # (2) If gullet is the source, we probably want to include next token, etc or
713 0 return Locator($gullet); }
714 # # If in postprocessing
715 # if($LaTeXML::Post::PROCESSOR && $LaTeXML::Post::DOCUMENT){
716 # return 'in '. $LaTeXML::Post::PROCESSOR->getName
717 # . ' on '. $LaTeXML::Post::DOCUMENT->siteRelativeDestination; }
718 0 return; }
719  
720 0 ▶sub callerName {
Subroutine callerName: not called CC=2 SCAR=17.9
Pod undocumented
721 0 my ($frame) = @_;
722 0 ▶ my %info = caller_info(($frame || 0) + 2);
Condition0%0/2
$frame || 0
l!l
00
MC/DC0%0/1
$frame || 0
$frame
Truth table0%0/2
A
A= $frame
Aresult
11
00
723 0 return $info{sub}; }
724  
725 0 ▶sub callerInfo {
Subroutine callerInfo: not called CC=2 SCAR=17.9
Pod undocumented
726 0 my ($frame) = @_;
727 0 ▶ my %info = caller_info(($frame || 0) + 2);
Condition0%0/2
$frame || 0
l!l
00
MC/DC0%0/1
$frame || 0
$frame
Truth table0%0/2
A
A= $frame
Aresult
11
00
728 0 return "$info{call} @ $info{file} line $info{line}"; }
729  
730 #======================================================================
731 # This portion adapted from Carp; simplified (but hopefully still correct),
732 # allow stringify overload, handle methods, make more concise!
733 #======================================================================
734 34 my $MAXARGS = 8; # [CONSTANT]
735 34 my $MAXLEN = 40; # Or more? [CONSTANT]
736  
737 0 ▶sub trim {
Subroutine trim: not called CC=3 SCAR=24.8
Pod undocumented
738 0 my ($string) = @_;
739 0 ▶ return $string unless defined $string;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $string 0 0 0
740 0 ▶ $string = substr($string, 0, $MAXLEN - 3) . "..." if (length($string) > $MAXLEN);
Branch: 1 branch
BranchTrueFalseTotal
if length $string > $MAXLEN 0 0 0
741 0 $string =~ s/\n/\x{240D}/gs; # symbol for CR
742 0 return $string; }
743  
744 0 ▶sub caller_info {
Subroutine caller_info: not called CC=12 SCAR=50.5
Pod undocumented
745 0 my ($i) = @_;
746  
747 0 my (%info, @args);
748 0 { package DB;
749 0 @info{qw(package file line sub has_args wantarray evaltext is_require)}
750 = caller($i);
751 0 @args = @DB::args; }
752 0 ▶ return () unless defined $info{package};
Branch: 1 branch
BranchTrueFalseTotal
unless defined $info{"package"} 0 0 0
753 # Work out the effective sub name, or eval, or method ...
754 0 my $call = '';
755 0 ▶ if (defined $info{evaltext}) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $info{'evaltext'}) { } 0 0 0
elsif ($info{'sub'} eq '(eval)') { } 0 0 0
756 0 my $eval = $info{evaltext};
757 0 ▶ if ($info{is_require}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($info{'is_require'}) { } 0 0 0
758 0 $call = "require $eval"; }
759 else {
760 0 $eval =~ s/([\\\'])/\\$1/g;
761 0 $call = "eval '" . trim($eval) . "'"; } }
762 elsif ($info{sub} eq '(eval)') {
763 0 $call = "eval {...}"; }
764 else {
765 0 $call = $info{sub};
766 0 my $method = $call;
767 0 $method =~ s/^.*:://;
768 # If $arg[0] is blessed, and `can' do $method, then we'll guess it's a method call?
769 0 ▶ if ($info{has_args} && @args
Branch: 1 branch
BranchTrueFalseTotal
if ($info{"has_args"} and @args and ref $args[0] and not ref($args[0]) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/ and $args[0]->can($method)) 0 0 0
Condition0%0/12
$info{"has_args"} and @args and ref $args[0] and not ref($args[0]) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/ and $args[0]->can($method)
!ll&&!rl&&r
000
$info{"has_args"} and @args and ref $args[0] and not ref($args[0]) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/
!ll&&!rl&&r
000
$info{"has_args"} and @args and ref $args[0]
!ll&&!rl&&r
000
$info{"has_args"} and @args
!ll&&!rl&&r
000
MC/DC0%0/5
$info{"has_args"} and @args and ref $args[0] and not ref($args[0]) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/ and $args[0]->can($method)
$info{"has_args"} @args ref $args[0] not ref($args[0]) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/ $args[0]->can($method)
Truth table0%0/6
A and B and C and not(D) and E
A= $info{"has_args"}B= @argsC= ref $args[0]D= not ref($args[0]) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/E= $args[0]->can($method)
ABCDEresult
0XXXX0
10XXX0
110XX0
1110X0
111100
111111
770 && ref $args[0] && ((ref $args[0]) !~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/)
771 && $args[0]->can($method)) {
772 0 $call = format_arg(shift(@args)) . "->" . $method; } }
773 # Append arguments, if any.
774 0 ▶ if ($info{has_args}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($info{"has_args"}) 0 0 0
775 0 @args = map { format_arg($_) } @args;
776 0 ▶ if (@args > $MAXARGS) {
Branch: 1 branch
BranchTrueFalseTotal
if (@args > $MAXARGS) 0 0 0
777 0 $#args = $MAXARGS; push(@args, '...'); }
778 0 $call .= '(' . join(',', @args) . ')'; }
779 0 $info{call} = $call;
780 0 return %info; }
781  
782 0 ▶sub format_arg {
Subroutine format_arg: not called CC=4 SCAR=30.0
Pod undocumented
783 0 my ($arg) = @_;
784 0 ▶ if (not defined $arg) { $arg = 'undef'; }
Branch: 3 branches
BranchTrueFalseTotal
if (not defined $arg) { } 0 0 0
elsif (ref $arg) { } 0 0 0
elsif ($arg =~ /^-?[\d.]+\z/) { } 0 0 0
785 0 elsif (ref $arg) { $arg = Stringify($arg); } # Allow overloaded stringify!
786 elsif ($arg =~ /^-?[\d.]+\z/) { } # Leave numbers alone.
787 else { # Otherwise, string, so quote
788 0 $arg =~ s/'/\\'/g; # Slashify '
789 0 $arg =~ s/([[:cntrl:]])/ "\\".chr(ord($1)+ord('A'))/ge;
790 0 $arg = "'$arg'" }
791 0 return trim($arg); }
792  
793 # Semi-traditional (but reformatted) stack trace
794 0 ▶sub stacktrace {
Subroutine stacktrace: not called CC=3 SCAR=24.8
Pod documented
795 0 my $frame = 0;
796 0 my $trace = "";
797 0 ▶ while (my %info = caller_info($frame++)) {
Branch: 1 branch
BranchTrueFalseTotal
if (my(%info) = caller_info($frame++)) 0 0 0
798 0 ▶ next if $info{sub} =~ /^LaTeXML::Common::Error/;
Branch: 1 branch
BranchTrueFalseTotal
if $info{"sub"} =~ /^LaTeXML::Common::Error/ 0 0 0
799 ## $info{call} = '' if $info{sub} =~ /^LaTeXML::Common::Error::(?:Fatal|Error|Warn|Info)/;
800 0 $trace .= "\t$info{call} @ $info{file} line $info{line}\n"; }
801 0 return $trace; }
802  
803 # Extract blessed `interesting' objects on stack.
804 # Get a maximum of $maxdepth objects (if $maxdepth is defined).
805 0 ▶sub objectStack {
Subroutine objectStack: not called CC=15 SCAR=54.8
Pod documented
806 0 my ($maxdepth) = @_;
807 0 my $frame = 0;
808 0 my @objects = ();
809 0 while (1) {
810 0 my (%info, @args);
811 0 { package DB;
812 0 @info{qw(package file line sub has_args wantarray evaltext is_require)} = caller($frame++);
813 0 @args = @DB::args; }
814 0 ▶ last unless defined $info{package};
Branch: 1 branch
BranchTrueFalseTotal
unless defined $info{"package"} 0 0 0
815 0 ▶ next if ($info{sub} eq '(eval)') || !$info{has_args} || !@args;
Branch: 1 branch
BranchTrueFalseTotal
if $info{"sub"} eq "(eval)" or not $info{"has_args"} or not @args 0 0 0
Condition0%0/6
$info{"sub"} eq "(eval)" or not $info{"has_args"} or not @args
l!l&&r!l&&!r
000
$info{"sub"} eq "(eval)" or not $info{"has_args"}
l!l&&r!l&&!r
000
MC/DC0%0/3
$info{"sub"} eq "(eval)" or not $info{"has_args"} or not @args
$info{"sub"} eq "(eval)" not $info{"has_args"} not @args
Truth table0%0/4
A or not(B) or not(C)
A= $info{"sub"} eq "(eval)"B= not $info{"has_args"}C= not @args
ABCresult
1XX1
01X1
0011
0000
816 0 my $self = $args[0];
817 # If $arg[0] is blessed, and `can' do $method, then we'll guess it's a method call?
818 # We'll collect such objects provided they can ->getLocator
819 0 ▶ if ((ref $self) && ((ref $self) !~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/)) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $self and not ref($self) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/) 0 0 0
Condition0%0/3
ref $self and not ref($self) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/
!ll&&!rl&&r
000
MC/DC0%0/2
ref $self and not ref($self) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/
ref $self not ref($self) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/
Truth table0%0/3
A and not(B)
A= ref $selfB= not ref($self) =~ /^(?:SCALAR|ARRAY|HASH|CODE|REF|GLOB|LVALUE)$/
ABresult
0X0
100
111
820 0 my $method = $info{sub};
821 0 $method =~ s/^.*:://;
822 0 ▶ if ($self->can($method)) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->can($method)) 0 0 0
823 0 ▶ next if @objects && ($self eq $objects[-1][0]); # but don't duplicate
Branch: 1 branch
BranchTrueFalseTotal
if @objects and $self eq $objects[-1][0] 0 0 0
Condition0%0/3
@objects and $self eq $objects[-1][0]
!ll&&!rl&&r
000
MC/DC0%0/2
@objects and $self eq $objects[-1][0]
@objects $self eq $objects[-1][0]
Truth table0%0/3
A and B
A= @objectsB= $self eq $objects[-1][0]
ABresult
0X0
100
111
824 0 ▶ if ($self->can('getLocator')) { # Digestion object?
Branch: 2 branches
BranchTrueFalseTotal
if ($self->can('getLocator')) { } 0 0 0
elsif ($self->isa('LaTeXML::Post::Processor') or $self->isa('LaTeXML::Post::Document')) { } 0 0 0
825 0 push(@objects, [$self, Locator($self)]); }
826 ▶ elsif ($self->isa('LaTeXML::Post::Processor') || $self->isa('LaTeXML::Post::Document')) {
Condition0%0/3
$self->isa("LaTeXML::Post::Processor") or $self->isa("LaTeXML::Post::Document")
l!l&&r!l&&!r
000
MC/DC0%0/2
$self->isa("LaTeXML::Post::Processor") or $self->isa("LaTeXML::Post::Document")
$self->isa("LaTeXML::Post::Processor") $self->isa("LaTeXML::Post::Document")
Truth table0%0/3
A or B
A= $self->isa("LaTeXML::Post::Processor")B= $self->isa("LaTeXML::Post::Document")
ABresult
1X1
011
000
827 0 push(@objects, [$self, '->' . $method]); }
828 0 ▶ last if $maxdepth && (scalar(@objects) >= $maxdepth); } } }
Branch: 1 branch
BranchTrueFalseTotal
if $maxdepth and scalar @objects >= $maxdepth 0 0 0
Condition0%0/3
$maxdepth and scalar @objects >= $maxdepth
!ll&&!rl&&r
000
MC/DC0%0/2
$maxdepth and scalar @objects >= $maxdepth
$maxdepth scalar @objects >= $maxdepth
Truth table0%0/3
A and B
A= $maxdepthB= scalar @objects >= $maxdepth
ABresult
0X0
100
111
829 0 return @objects; }
830  
831 #**********************************************************************
832 34 1;
833  
834 __END__
« lib/LaTeXML/Core/State.pm ↑ Summary lib/LaTeXML/Post/MathML/Linebreaker.pm »