1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
#
# Attempt to analyse a dblatex failure occured on a Debian platform.
#
# Author: Andreas Hoenen
#
from __future__ import print_function
import subprocess
import sys
import apt
import os
from dbtexmf.core.error import ErrorHandler
from dbtexmf.core.imagedata import ImageConverter
from dbtexmf.core.dbtex import DbTexCommand
class AptSilentProgress(apt.progress.text.OpProgress):
"""
Avoid the annoying progress messages when building the apt cache:
Reading package lists... Done
Building dependency tree
Reading state information... Done
Building data structures... Done
"""
def __init__(self, outfile=None):
pass
def done(self):
pass
def update(self, percent=None):
pass
class DebianHandler(ErrorHandler):
def __init__(self):
ErrorHandler.__init__(self)
self.object = None
self.aptcache = None
def signal(self, failed_object, *args, **kwargs):
self.object = failed_object
if not self.aptcache:
self.aptcache = apt.Cache(progress=AptSilentProgress())
if (isinstance(self.object, DbTexCommand)):
error_handled = self._check_dbtexrun()
elif (isinstance(self.object, ImageConverter)):
error_handled = self._check_imagerun(*args)
else:
error_handled = False
if not error_handled:
super(DebianHandler, self).signal(failed_object, *args, **kwargs)
def _check_dbtexrun(self):
# First, check the XML input sanity
if (self._check_input()):
return True
# Check that all the required utilities are there
if (self._check_dependencies()):
return True
# Check some alternative reasons
if (self._check_cyrillic()):
return True
return False
def _check_imagerun(self, cmd):
"""
In case of failed image converter calls check on dependency problems.
In Debian dblatex package dependencies on image converters are not
absolute, as image conversion is not dblatex's core functionality.
Thus the converters may be not installed. Therefore check for each one:
If it is used but missing, dump an appropriate hint.
"""
aptcache = self.aptcache
warn_msgs = []
if ((cmd.startswith('convert') or cmd.find('&& convert') > -1)
and not aptcache['graphicsmagick-imagemagick-compat'].is_installed
and not aptcache['imagemagick'].is_installed):
warn_msgs.append('For image conversion one of Debian packages'
+ ' graphicsmagick-imagemagick-compat')
warn_msgs.append('or imagemagick is needed')
if ((cmd.startswith('epstopdf') or cmd.find('&& epstopdf') > -1)
and not aptcache['ghostscript'].is_installed):
warn_msgs.append('For image conversion Debian package ghostscript'
+ ' is needed')
if ((cmd.startswith('fig2dev') or cmd.find('&& fig2dev') > -1)
and not aptcache['transfig'].is_installed):
warn_msgs.append('For image conversion Debian package transfig is'
+ ' needed')
if ((cmd.startswith('inkscape') or cmd.find('&& inkscape') > -1)
and not aptcache['inkscape'].is_installed):
warn_msgs.append('For image conversion Debian package inkscape is'
+ ' needed')
if warn_msgs:
print("\n" + "\n".join(warn_msgs) + "\n", file=sys.stderr)
return True
else:
return False
def _check_input(self):
"""
In case of failed processing try to validate the input.
As invalid DocBook sometimes results in strange TeX error messages, a
hint about the failure cause may be helpful.
Post failure validation is a convenience function and thus works in
a best effort approach, that is it will silently skip any problems,
e.g. the external validation program xmllint not installed.
"""
obj = self.object.run
nulldev0 = open(os.devnull, "r")
nulldev1 = open(os.devnull, "w")
try:
rc = subprocess.Popen(['xmllint', '--noout', '--postvalid',
'--xinclude', obj.input],
stdin=nulldev0,
stderr=nulldev1,
stdout=nulldev1).wait()
except:
rc = -1
nulldev0.close()
nulldev1.close()
if rc == 3 or rc == 4:
print(file=sys.stderr)
print('A possible reason for transformation', end=' ', file=sys.stderr)
print('failure is invalid DocBook', file=sys.stderr)
print('(as reported by xmllint)', file=sys.stderr)
print(file=sys.stderr)
return True
else:
return False
def _check_dependencies(self):
"""
In case of failed processing check on dependency problems.
For not commonly used dblatex functionality the Debian package
dependencies are not absolute, thus the functionality may be not
installed. Therefore check for each one:
If it is used but a needed dependency is missing, dump an appropriate
hint.
"""
obj = self.object.run
aptcache = self.aptcache
warn_msgs = []
if obj.backend == 'xetex':
for debian_pkg in 'texlive-xetex', 'lmodern':
if not aptcache[debian_pkg].is_installed:
warn_msgs.append('For xetex backend Debian package '
+ debian_pkg + ' is needed')
if obj.input_format == 'sgml':
for debian_pkg in 'docbook', 'opensp':
if not aptcache[debian_pkg].is_installed:
warn_msgs.append('For SGML documents Debian package '
+ debian_pkg + ' is needed')
if obj.runtex.texer.encoding == 'utf8':
debian_pkg = 'texlive-lang-cyrillic'
if not aptcache[debian_pkg].is_installed:
warn_msgs.append('For utf8 encoding Debian package '
+ debian_pkg + ' is needed')
if warn_msgs:
print("\n" + "\n".join(warn_msgs) + "\n", file=sys.stderr)
return True
else:
return False
def _check_cyrillic(self):
obj = self.object.run
"""
In case of failed processing check on the "cyrillic scenario":
Transforming cyrillic documents will fail when neither using the
XeTeX backend nor setting option latex.unicode.use
In this case a hint to XeTeX (as the preferred way) may be helpful.
Post failure validation is a convenience function and thus works in
a best effort approach, that is it will silently skip any problems.
"""
# This kind of error cannot occur with backends that natively support
# Unicode
if obj.backend == 'xetex':
return False
try:
for log_entry in obj.runtex.texer.tex.log.get_errors():
if (log_entry['text']
== r'Undefined control sequence \cyrchar.'):
print(file=sys.stderr)
print('Transformation failure', end=' ', file=sys.stderr)
print('might be caused by handling a', end=' ', file=sys.stderr)
print('cyrillic document', file=sys.stderr)
print('without the XeTeX backend', file=sys.stderr)
print(file=sys.stderr)
return True
except:
pass
return False
|
