blob: 6481e93e2bb558b5b68fc5abdf17f426fedd6c41 [file] [log] [blame]
Fred Drake8b880931999-03-03 20:24:30 +00001#! /usr/bin/env python
2# -*- Python -*-
3"""usage: %(program)s [options...] file ...
4
5Options specifying formats to build:
Fred Drake55994412001-01-30 22:30:01 +00006 --html HyperText Markup Language (default)
7 --pdf Portable Document Format
Fred Drake8b880931999-03-03 20:24:30 +00008 --ps PostScript
9 --dvi 'DeVice Indepentent' format from TeX
10 --text ASCII text (requires lynx)
11
12 More than one output format may be specified, or --all.
13
14HTML options:
15 --address, -a Specify an address for page footers.
16 --link Specify the number of levels to include on each page.
17 --split, -s Specify a section level for page splitting, default: %(max_split_depth)s.
18 --iconserver, -i Specify location of icons (default: ../).
Fred Drake52ea0ce1999-09-22 19:55:35 +000019 --image-type Specify the image type to use in HTML output;
20 values: gif (default), png.
Fred Drake9a257b42000-03-31 20:27:36 +000021 --numeric Don't rename the HTML files; just keep node#.html for
22 the filenames.
Fred Drakefcb87252000-08-29 18:15:05 +000023 --style Specify the CSS file to use for the output (filename,
24 not a URL).
Fred Drakedfa539d2000-08-31 06:58:34 +000025 --up-link URL to a parent document.
26 --up-title Title of a parent document.
Fred Drake8b880931999-03-03 20:24:30 +000027
28Other options:
29 --a4 Format for A4 paper.
30 --letter Format for US letter paper (the default).
31 --help, -H Show this text.
32 --logging, -l Log stdout and stderr to a file (*.how).
33 --debugging, -D Echo commands as they are executed.
34 --keep, -k Keep temporary files around.
35 --quiet, -q Do not print command output to stdout.
36 (stderr is also lost, sorry; see *.how for errors)
37"""
38
39import getopt
40import glob
41import os
Fred Drakea871c2e1999-05-06 19:37:38 +000042import re
Fred Drake8b880931999-03-03 20:24:30 +000043import shutil
44import string
45import sys
46import tempfile
47
48
Fred Drakefcb87252000-08-29 18:15:05 +000049MYDIR = os.path.abspath(sys.path[0])
50TOPDIR = os.path.dirname(MYDIR)
Fred Drake8b880931999-03-03 20:24:30 +000051
52ISTFILE = os.path.join(TOPDIR, "texinputs", "python.ist")
53NODE2LABEL_SCRIPT = os.path.join(MYDIR, "node2label.pl")
54L2H_INIT_FILE = os.path.join(TOPDIR, "perl", "l2hinit.perl")
55
56BIBTEX_BINARY = "bibtex"
57DVIPS_BINARY = "dvips"
58LATEX_BINARY = "latex"
59LATEX2HTML_BINARY = "latex2html"
60LYNX_BINARY = "lynx"
61MAKEINDEX_BINARY = "makeindex"
62PDFLATEX_BINARY = "pdflatex"
63PERL_BINARY = "perl"
64PYTHON_BINARY = "python"
65
66
67def usage(options):
68 print __doc__ % options
69
70def error(options, message, err=2):
71 sys.stdout = sys.stderr
72 print message
73 print
74 usage(options)
75 sys.exit(2)
76
77
78class Options:
79 program = os.path.basename(sys.argv[0])
80 #
81 address = ''
Fred Drake50d1fcf2001-02-19 19:18:09 +000082 builddir = None
Fred Drake8b880931999-03-03 20:24:30 +000083 debugging = 0
84 discard_temps = 1
85 have_temps = 0
86 icon_server = None
Fred Drake52ea0ce1999-09-22 19:55:35 +000087 image_type = "gif"
Fred Drake8b880931999-03-03 20:24:30 +000088 logging = 0
89 max_link_depth = 3
90 max_split_depth = 6
91 paper = "letter"
92 quiet = 0
Fred Drake52ea0ce1999-09-22 19:55:35 +000093 runs = 0
Fred Drake9a257b42000-03-31 20:27:36 +000094 numeric = 0
Fred Drake42181db2001-01-09 22:02:10 +000095 global_module_index = None
Fred Drake8b880931999-03-03 20:24:30 +000096 style_file = os.path.join(TOPDIR, "html", "style.css")
Fred Drakecf1b06e1999-09-23 16:55:09 +000097 about_file = os.path.join(TOPDIR, "html", "about.dat")
Fred Drakedfa539d2000-08-31 06:58:34 +000098 up_link = None
99 up_title = None
Fred Drake8b880931999-03-03 20:24:30 +0000100 #
Fred Drake55994412001-01-30 22:30:01 +0000101 DEFAULT_FORMATS = ("html",)
Fred Drake8b880931999-03-03 20:24:30 +0000102 ALL_FORMATS = ("dvi", "html", "pdf", "ps", "text")
103
104 def __init__(self):
Fred Drake8b880931999-03-03 20:24:30 +0000105 self.formats = []
Fred Drake8bc627a2000-08-31 06:14:38 +0000106 self.l2h_init_files = []
Fred Drake8b880931999-03-03 20:24:30 +0000107
108 def __getitem__(self, key):
109 # This is used when formatting the usage message.
110 try:
111 return getattr(self, key)
112 except AttributeError:
113 raise KeyError, key
114
115 def parse(self, args):
Fred Drake52ea0ce1999-09-22 19:55:35 +0000116 opts, args = getopt.getopt(args, "Hi:a:s:lDkqr:",
Fred Drake8b880931999-03-03 20:24:30 +0000117 ["all", "postscript", "help", "iconserver=",
Fred Drake8bc627a2000-08-31 06:14:38 +0000118 "address=", "a4", "letter", "l2h-init=",
Fred Drake8b880931999-03-03 20:24:30 +0000119 "link=", "split=", "logging", "debugging",
Fred Drakecf1b06e1999-09-23 16:55:09 +0000120 "keep", "quiet", "runs=", "image-type=",
Fred Drake50d1fcf2001-02-19 19:18:09 +0000121 "about=", "numeric", "style=", "paper=",
122 "up-link=", "up-title=", "dir=",
Fred Drake42181db2001-01-09 22:02:10 +0000123 "global-module-index="]
Fred Drake52ea0ce1999-09-22 19:55:35 +0000124 + list(self.ALL_FORMATS))
Fred Drake8b880931999-03-03 20:24:30 +0000125 for opt, arg in opts:
126 if opt == "--all":
127 self.formats = list(self.ALL_FORMATS)
128 elif opt in ("-H", "--help"):
129 usage(self)
130 sys.exit()
131 elif opt == "--iconserver":
132 self.icon_server = arg
133 elif opt in ("-a", "--address"):
134 self.address = arg
135 elif opt == "--a4":
136 self.paper = "a4"
137 elif opt == "--letter":
138 self.paper = "letter"
Fred Drake8b880931999-03-03 20:24:30 +0000139 elif opt == "--link":
140 self.max_link_depth = int(arg)
141 elif opt in ("-s", "--split"):
142 self.max_split_depth = int(arg)
143 elif opt in ("-l", "--logging"):
144 self.logging = self.logging + 1
145 elif opt in ("-D", "--debugging"):
146 self.debugging = self.debugging + 1
147 elif opt in ("-k", "--keep"):
148 self.discard_temps = 0
149 elif opt in ("-q", "--quiet"):
150 self.quiet = 1
Fred Drake52ea0ce1999-09-22 19:55:35 +0000151 elif opt in ("-r", "--runs"):
152 self.runs = int(arg)
153 elif opt == "--image-type":
154 self.image_type = arg
Fred Drakecf1b06e1999-09-23 16:55:09 +0000155 elif opt == "--about":
156 # always make this absolute:
157 self.about_file = os.path.normpath(
Fred Drakefcb87252000-08-29 18:15:05 +0000158 os.path.abspath(arg))
Fred Drake9a257b42000-03-31 20:27:36 +0000159 elif opt == "--numeric":
160 self.numeric = 1
Fred Drakefcb87252000-08-29 18:15:05 +0000161 elif opt == "--style":
162 self.style_file = os.path.abspath(arg)
Fred Drake8bc627a2000-08-31 06:14:38 +0000163 elif opt == "--l2h-init":
164 self.l2h_init_files.append(os.path.abspath(arg))
Fred Drakedfa539d2000-08-31 06:58:34 +0000165 elif opt == "--up-link":
166 self.up_link = arg
167 elif opt == "--up-title":
168 self.up_title = arg
Fred Drake42181db2001-01-09 22:02:10 +0000169 elif opt == "--global-module-index":
170 self.global_module_index = arg
Fred Drake50d1fcf2001-02-19 19:18:09 +0000171 elif opt == "--dir":
172 self.builddir = arg
173 elif opt == "--paper":
174 self.paper = arg
Fred Drake8b880931999-03-03 20:24:30 +0000175 #
176 # Format specifiers:
177 #
178 elif opt[2:] in self.ALL_FORMATS:
179 self.add_format(opt[2:])
180 elif opt == "--postscript":
181 # synonym for --ps
182 self.add_format("ps")
183 self.initialize()
184 #
185 # return the args to allow the caller access:
186 #
187 return args
188
189 def add_format(self, format):
190 """Add a format to the formats list if not present."""
191 if not format in self.formats:
192 self.formats.append(format)
193
194 def initialize(self):
195 """Complete initialization. This is needed if parse() isn't used."""
196 # add the default format if no formats were specified:
197 if not self.formats:
198 self.formats = self.DEFAULT_FORMATS
199 # determine the base set of texinputs directories:
200 texinputs = string.split(os.environ.get("TEXINPUTS", ""), os.pathsep)
201 if not texinputs:
202 texinputs = ['']
203 self.base_texinputs = [
204 os.path.join(TOPDIR, "paper-" + self.paper),
205 os.path.join(TOPDIR, "texinputs"),
206 ] + texinputs
207
208
209class Job:
Fred Drake52ea0ce1999-09-22 19:55:35 +0000210 latex_runs = 0
211
Fred Drake8b880931999-03-03 20:24:30 +0000212 def __init__(self, options, path):
213 self.options = options
Fred Drakea871c2e1999-05-06 19:37:38 +0000214 self.doctype = get_doctype(path)
Fred Drake8b880931999-03-03 20:24:30 +0000215 self.filedir, self.doc = split_pathname(path)
216 self.log_filename = self.doc + ".how"
217 if os.path.exists(self.log_filename):
218 os.unlink(self.log_filename)
219 if os.path.exists(self.doc + ".l2h"):
220 self.l2h_aux_init_file = tempfile.mktemp()
221 else:
222 self.l2h_aux_init_file = self.doc + ".l2h"
223 self.write_l2h_aux_init_file()
224
225 def build(self):
226 self.setup_texinputs()
227 formats = self.options.formats
228 if "dvi" in formats or "ps" in formats:
229 self.build_dvi()
230 if "pdf" in formats:
231 self.build_pdf()
232 if "ps" in formats:
233 self.build_ps()
234 if "html" in formats:
235 self.require_temps()
Fred Drake50d1fcf2001-02-19 19:18:09 +0000236 self.build_html(self.options.builddir or self.doc)
Fred Drake8b880931999-03-03 20:24:30 +0000237 if self.options.icon_server == ".":
Fred Drake52ea0ce1999-09-22 19:55:35 +0000238 pattern = os.path.join(TOPDIR, "html", "icons",
239 "*." + self.options.image_type)
240 imgs = glob.glob(pattern)
241 if not imgs:
242 self.warning(
243 "Could not locate support images of type %s."
244 % `self.options.image_type`)
245 for fn in imgs:
Fred Drake8b880931999-03-03 20:24:30 +0000246 new_fn = os.path.join(self.doc, os.path.basename(fn))
247 shutil.copyfile(fn, new_fn)
248 if "text" in formats:
249 self.require_temps()
250 tempdir = self.doc
251 need_html = "html" not in formats
252 if self.options.max_split_depth != 1:
253 fp = open(self.l2h_aux_init_file, "a")
254 fp.write("# re-hack this file for --text:\n")
255 l2hoption(fp, "MAX_SPLIT_DEPTH", "1")
256 fp.write("1;\n")
257 fp.close()
258 tempdir = self.doc + "-temp-html"
259 need_html = 1
260 if need_html:
261 self.build_html(tempdir, max_split_depth=1)
262 self.build_text(tempdir)
263 if self.options.discard_temps:
264 self.cleanup()
265
266 def setup_texinputs(self):
267 texinputs = [self.filedir] + list(self.options.base_texinputs)
268 os.environ["TEXINPUTS"] = string.join(texinputs, os.pathsep)
Fred Drakeaaa0d9a1999-03-03 21:57:58 +0000269 self.message("TEXINPUTS=" + os.environ["TEXINPUTS"])
Fred Drake8b880931999-03-03 20:24:30 +0000270
Fred Drake8b880931999-03-03 20:24:30 +0000271 def build_aux(self, binary=None):
272 if binary is None:
273 binary = LATEX_BINARY
274 new_index( "%s.ind" % self.doc, "genindex")
275 new_index("mod%s.ind" % self.doc, "modindex")
276 self.run("%s %s" % (binary, self.doc))
277 self.use_bibtex = check_for_bibtex(self.doc + ".aux")
Fred Drake52ea0ce1999-09-22 19:55:35 +0000278 self.latex_runs = 1
Fred Drake8b880931999-03-03 20:24:30 +0000279
280 def build_dvi(self):
281 self.use_latex(LATEX_BINARY)
282
283 def build_pdf(self):
284 self.use_latex(PDFLATEX_BINARY)
285
286 def use_latex(self, binary):
287 self.require_temps(binary=binary)
Fred Drakedf84fac2000-09-20 05:49:09 +0000288 if self.latex_runs < 2:
289 if os.path.isfile("mod%s.idx" % self.doc):
290 self.run("%s mod%s.idx" % (MAKEINDEX_BINARY, self.doc))
Fred Drake9dce7b32000-11-03 02:57:31 +0000291 use_indfix = 0
Fred Drakedf84fac2000-09-20 05:49:09 +0000292 if os.path.isfile(self.doc + ".idx"):
Fred Drake9dce7b32000-11-03 02:57:31 +0000293 use_indfix = 1
Fred Drakedf84fac2000-09-20 05:49:09 +0000294 # call to Doc/tools/fix_hack omitted; doesn't appear necessary
295 self.run("%s %s.idx" % (MAKEINDEX_BINARY, self.doc))
296 import indfix
297 indfix.process(self.doc + ".ind")
298 if self.use_bibtex:
299 self.run("%s %s" % (BIBTEX_BINARY, self.doc))
300 self.process_synopsis_files()
301 #
302 # let the doctype-specific handler do some intermediate work:
303 #
304 self.run("%s %s" % (binary, self.doc))
Fred Drakeb258bed2001-02-12 15:30:22 +0000305 self.latex_runs = self.latex_runs + 1
Fred Drakedf84fac2000-09-20 05:49:09 +0000306 if os.path.isfile("mod%s.idx" % self.doc):
307 self.run("%s -s %s mod%s.idx"
308 % (MAKEINDEX_BINARY, ISTFILE, self.doc))
Fred Drake9dce7b32000-11-03 02:57:31 +0000309 if use_indfix:
Fred Drakedf84fac2000-09-20 05:49:09 +0000310 self.run("%s -s %s %s.idx"
311 % (MAKEINDEX_BINARY, ISTFILE, self.doc))
Fred Drake9dce7b32000-11-03 02:57:31 +0000312 indfix.process(self.doc + ".ind")
Fred Drakedf84fac2000-09-20 05:49:09 +0000313 self.process_synopsis_files()
Fred Drakea871c2e1999-05-06 19:37:38 +0000314 #
315 # and now finish it off:
316 #
317 if os.path.isfile(self.doc + ".toc") and binary == PDFLATEX_BINARY:
318 import toc2bkm
Fred Drake239e1d52000-09-05 21:45:11 +0000319 if self.doctype == "manual":
320 bigpart = "chapter"
321 else:
322 bigpart = "section"
323 toc2bkm.process(self.doc + ".toc", self.doc + ".bkm", bigpart)
Fred Drakea871c2e1999-05-06 19:37:38 +0000324 if self.use_bibtex:
325 self.run("%s %s" % (BIBTEX_BINARY, self.doc))
326 self.run("%s %s" % (binary, self.doc))
Fred Drakeb258bed2001-02-12 15:30:22 +0000327 self.latex_runs = self.latex_runs + 1
Fred Drakea871c2e1999-05-06 19:37:38 +0000328
329 def process_synopsis_files(self):
330 synopsis_files = glob.glob(self.doc + "*.syn")
331 for path in synopsis_files:
332 uniqify_module_table(path)
Fred Drake8b880931999-03-03 20:24:30 +0000333
334 def build_ps(self):
335 self.run("%s -N0 -o %s.ps %s" % (DVIPS_BINARY, self.doc, self.doc))
336
337 def build_html(self, builddir=None, max_split_depth=None):
338 if builddir is None:
339 builddir = self.doc
340 if max_split_depth is None:
341 max_split_depth = self.options.max_split_depth
342 texfile = None
343 for p in string.split(os.environ["TEXINPUTS"], os.pathsep):
344 fn = os.path.join(p, self.doc + ".tex")
345 if os.path.isfile(fn):
346 texfile = fn
347 break
348 if not texfile:
Fred Drake52ea0ce1999-09-22 19:55:35 +0000349 self.warning("Could not locate %s.tex; aborting." % self.doc)
Fred Drake8b880931999-03-03 20:24:30 +0000350 sys.exit(1)
351 # remove leading ./ (or equiv.); might avoid problems w/ dvips
352 if texfile[:2] == os.curdir + os.sep:
353 texfile = texfile[2:]
354 # build the command line and run LaTeX2HTML:
Fred Drakeba828782000-04-03 04:19:14 +0000355 if not os.path.isdir(builddir):
356 os.mkdir(builddir)
Fred Drakef3d41272000-09-14 22:25:47 +0000357 else:
358 for fname in glob.glob(os.path.join(builddir, "*.html")):
359 os.unlink(fname)
Fred Drake8b880931999-03-03 20:24:30 +0000360 args = [LATEX2HTML_BINARY,
Fred Drake8b880931999-03-03 20:24:30 +0000361 "-init_file", self.l2h_aux_init_file,
362 "-dir", builddir,
363 texfile
364 ]
365 self.run(string.join(args)) # XXX need quoting!
366 # ... postprocess
367 shutil.copyfile(self.options.style_file,
368 os.path.join(builddir, self.doc + ".css"))
Fred Drake4437fdf1999-05-03 14:29:07 +0000369 shutil.copyfile(os.path.join(builddir, self.doc + ".html"),
370 os.path.join(builddir, "index.html"))
Fred Drakecfef00962001-03-02 16:26:45 +0000371 if max_split_depth != 1:
Fred Drakeaf922182001-05-09 04:03:16 +0000372 label_file = os.path.join(builddir, "labels.pl")
373 fp = open(label_file)
374 about_node = None
375 target = " = q/about/;\n"
376 x = len(target)
377 while 1:
378 line = fp.readline()
379 if not line:
380 break
381 if line[-x:] == target:
Fred Drakecfef00962001-03-02 16:26:45 +0000382 line = fp.readline()
Fred Drakeaf922182001-05-09 04:03:16 +0000383 m = re.search(r"\|(node\d+\.[a-z]+)\|", line)
384 about_node = m.group(1)
385 shutil.copyfile(os.path.join(builddir, about_node),
386 os.path.join(builddir, "about.html"))
387 break
388 if not self.options.numeric:
Fred Drakecfef00962001-03-02 16:26:45 +0000389 pwd = os.getcwd()
390 try:
391 os.chdir(builddir)
392 self.run("%s %s *.html" % (PERL_BINARY, NODE2LABEL_SCRIPT))
393 finally:
394 os.chdir(pwd)
Fred Drake8b880931999-03-03 20:24:30 +0000395
396 def build_text(self, tempdir=None):
397 if tempdir is None:
398 tempdir = self.doc
399 indexfile = os.path.join(tempdir, "index.html")
400 self.run("%s -nolist -dump %s >%s.txt"
401 % (LYNX_BINARY, indexfile, self.doc))
402
403 def require_temps(self, binary=None):
Fred Drake52ea0ce1999-09-22 19:55:35 +0000404 if not self.latex_runs:
Fred Drake8b880931999-03-03 20:24:30 +0000405 self.build_aux(binary=binary)
406
407 def write_l2h_aux_init_file(self):
Fred Drake8bc627a2000-08-31 06:14:38 +0000408 options = self.options
Fred Drake8b880931999-03-03 20:24:30 +0000409 fp = open(self.l2h_aux_init_file, "w")
Fred Drake19157542000-07-31 17:47:49 +0000410 d = string_to_perl(os.path.dirname(L2H_INIT_FILE))
411 fp.write("package main;\n"
412 "push (@INC, '%s');\n"
413 "$mydir = '%s';\n"
414 % (d, d))
Fred Drake498c18f2000-07-24 23:03:32 +0000415 fp.write(open(L2H_INIT_FILE).read())
Fred Drake8bc627a2000-08-31 06:14:38 +0000416 for filename in options.l2h_init_files:
417 fp.write("\n# initialization code incorporated from:\n# ")
418 fp.write(filename)
419 fp.write("\n")
420 fp.write(open(filename).read())
Fred Drake498c18f2000-07-24 23:03:32 +0000421 fp.write("\n"
422 "# auxillary init file for latex2html\n"
Fred Drake8b880931999-03-03 20:24:30 +0000423 "# generated by mkhowto\n"
Fred Drake4437fdf1999-05-03 14:29:07 +0000424 "$NO_AUTO_LINK = 1;\n"
Fred Drake8b880931999-03-03 20:24:30 +0000425 )
Fred Drakecf1b06e1999-09-23 16:55:09 +0000426 l2hoption(fp, "ABOUT_FILE", options.about_file)
Fred Drake8b880931999-03-03 20:24:30 +0000427 l2hoption(fp, "ICONSERVER", options.icon_server)
Fred Drake52ea0ce1999-09-22 19:55:35 +0000428 l2hoption(fp, "IMAGE_TYPE", options.image_type)
Fred Drake8b880931999-03-03 20:24:30 +0000429 l2hoption(fp, "ADDRESS", options.address)
430 l2hoption(fp, "MAX_LINK_DEPTH", options.max_link_depth)
431 l2hoption(fp, "MAX_SPLIT_DEPTH", options.max_split_depth)
Fred Drakedfa539d2000-08-31 06:58:34 +0000432 l2hoption(fp, "EXTERNAL_UP_LINK", options.up_link)
433 l2hoption(fp, "EXTERNAL_UP_TITLE", options.up_title)
Fred Drake42181db2001-01-09 22:02:10 +0000434 l2hoption(fp, "GLOBAL_MODULE_INDEX", options.global_module_index)
Fred Drake8b880931999-03-03 20:24:30 +0000435 fp.write("1;\n")
436 fp.close()
437
438 def cleanup(self):
439 self.__have_temps = 0
440 for pattern in ("%s.aux", "%s.log", "%s.out", "%s.toc", "%s.bkm",
Fred Drakea871c2e1999-05-06 19:37:38 +0000441 "%s.idx", "%s.ilg", "%s.ind", "%s.pla",
Fred Drake8b880931999-03-03 20:24:30 +0000442 "%s.bbl", "%s.blg",
443 "mod%s.idx", "mod%s.ind", "mod%s.ilg",
444 ):
445 safe_unlink(pattern % self.doc)
Fred Drakea871c2e1999-05-06 19:37:38 +0000446 map(safe_unlink, glob.glob(self.doc + "*.syn"))
Fred Drake8b880931999-03-03 20:24:30 +0000447 for spec in ("IMG*", "*.pl", "WARNINGS", "index.dat", "modindex.dat"):
448 pattern = os.path.join(self.doc, spec)
449 map(safe_unlink, glob.glob(pattern))
450 if "dvi" not in self.options.formats:
451 safe_unlink(self.doc + ".dvi")
452 if os.path.isdir(self.doc + "-temp-html"):
453 shutil.rmtree(self.doc + "-temp-html", ignore_errors=1)
454 if not self.options.logging:
455 os.unlink(self.log_filename)
456 if not self.options.debugging:
457 os.unlink(self.l2h_aux_init_file)
458
459 def run(self, command):
Fred Drakeaaa0d9a1999-03-03 21:57:58 +0000460 self.message(command)
461 rc = os.system("(%s) </dev/null >>%s 2>&1"
462 % (command, self.log_filename))
Fred Drake8b880931999-03-03 20:24:30 +0000463 if rc:
Fred Drake52ea0ce1999-09-22 19:55:35 +0000464 self.warning(
465 "Session transcript and error messages are in %s."
Fred Drake8b880931999-03-03 20:24:30 +0000466 % self.log_filename)
Fred Drake4e3f2752001-02-04 15:20:26 +0000467 sys.stderr.write("The relevant lines from the transcript are:\n")
468 sys.stderr.write("-" * 72 + "\n")
469 sys.stderr.writelines(get_run_transcript(self.log_filename))
Fred Drake8b880931999-03-03 20:24:30 +0000470 sys.exit(rc)
471
Fred Drakeaaa0d9a1999-03-03 21:57:58 +0000472 def message(self, msg):
473 msg = "+++ " + msg
474 if not self.options.quiet:
475 print msg
Fred Drake52ea0ce1999-09-22 19:55:35 +0000476 self.log(msg + "\n")
477
478 def warning(self, msg):
479 msg = "*** %s\n" % msg
480 sys.stderr.write(msg)
481 self.log(msg)
482
483 def log(self, msg):
Fred Drakeaaa0d9a1999-03-03 21:57:58 +0000484 fp = open(self.log_filename, "a")
Fred Drake52ea0ce1999-09-22 19:55:35 +0000485 fp.write(msg)
Fred Drakeaaa0d9a1999-03-03 21:57:58 +0000486 fp.close()
487
Fred Drake8b880931999-03-03 20:24:30 +0000488
Fred Drake4e3f2752001-02-04 15:20:26 +0000489def get_run_transcript(filename):
490 """Return lines from the transcript file for the most recent run() call."""
491 fp = open(filename)
492 lines = fp.readlines()
493 fp.close()
494 lines.reverse()
495 L = []
496 for line in lines:
497 L.append(line)
498 if line[:4] == "+++ ":
499 break
500 L.reverse()
501 return L
502
503
Fred Drake8b880931999-03-03 20:24:30 +0000504def safe_unlink(path):
Fred Drake4e3f2752001-02-04 15:20:26 +0000505 """Unlink a file without raising an error if it doesn't exist."""
Fred Drake8b880931999-03-03 20:24:30 +0000506 try:
507 os.unlink(path)
508 except os.error:
509 pass
510
511
Fred Drakea871c2e1999-05-06 19:37:38 +0000512def split_pathname(path):
513 path = os.path.normpath(os.path.join(os.getcwd(), path))
514 dirname, basename = os.path.split(path)
Fred Drake8b880931999-03-03 20:24:30 +0000515 if basename[-4:] == ".tex":
516 basename = basename[:-4]
517 return dirname, basename
518
519
Fred Drakea871c2e1999-05-06 19:37:38 +0000520_doctype_rx = re.compile(r"\\documentclass(?:\[[^]]*\])?{([a-zA-Z]*)}")
521def get_doctype(path):
522 fp = open(path)
523 doctype = None
524 while 1:
525 line = fp.readline()
526 if not line:
527 break
528 m = _doctype_rx.match(line)
529 if m:
530 doctype = m.group(1)
531 break
532 fp.close()
533 return doctype
534
535
Fred Drake8b880931999-03-03 20:24:30 +0000536def main():
537 options = Options()
538 try:
539 args = options.parse(sys.argv[1:])
540 except getopt.error, msg:
541 error(options, msg)
542 if not args:
543 # attempt to locate single .tex file in current directory:
544 args = glob.glob("*.tex")
545 if not args:
546 error(options, "No file to process.")
547 if len(args) > 1:
548 error(options, "Could not deduce which files should be processed.")
549 #
550 # parameters are processed, let's go!
551 #
552 for path in args:
553 Job(options, path).build()
554
555
556def l2hoption(fp, option, value):
557 if value:
558 fp.write('$%s = "%s";\n' % (option, string_to_perl(str(value))))
559
560
561_to_perl = {}
562for c in map(chr, range(1, 256)):
563 _to_perl[c] = c
564_to_perl["@"] = "\\@"
565_to_perl["$"] = "\\$"
566_to_perl['"'] = '\\"'
567
568def string_to_perl(s):
569 return string.join(map(_to_perl.get, s), '')
570
571
572def check_for_bibtex(filename):
573 fp = open(filename)
574 pos = string.find(fp.read(), r"\bibdata{")
575 fp.close()
576 return pos >= 0
577
578def uniqify_module_table(filename):
579 lines = open(filename).readlines()
580 if len(lines) > 1:
581 if lines[-1] == lines[-2]:
582 del lines[-1]
583 open(filename, "w").writelines(lines)
584
585
586def new_index(filename, label="genindex"):
587 fp = open(filename, "w")
588 fp.write(r"""\
589\begin{theindex}
590\label{%s}
591\end{theindex}
592""" % label)
593 fp.close()
594
595
596if __name__ == "__main__":
597 main()