RenJuan/TASKPM
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Ported doctool from Python 2 to Python 3

Browse source
This commit is contained in:
Jeroen Baten 2025-03-19 16:02:47 +01:00
parent ca6eae9a90
commit 2897f22aa7
1 changed files with 22 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
doc/tools/doctool
View file

@ -1,9 +1,10 @@
#! /usr/bin/env python #! /usr/bin/env python3
import sys, shlex, subprocess import sys, shlex, subprocess
from optparse import OptionParser, OptionGroup from optparse import OptionParser, OptionGroup
from docutils.writers import latex2e from docutils.writers import latex2e
import re import re
from functools import reduce
try: try:
import locale import locale
@ -78,7 +79,7 @@ class DupRefsRemover(object):
def handle_line(self, line): def handle_line(self, line):
if line.startswith(".. _") and ":" in line: if line.startswith(".. _") and ":" in line:
r = map(lambda x: x.strip(), line[4:].split(":", 1)) r = [x.strip() for x in line[4:].split(":", 1)]
if r[0] in self.ref: if r[0] in self.ref:
# Do some sanity check # Do some sanity check
if self.ref[r[0]] != r[1]: if self.ref[r[0]] != r[1]:
@ -291,14 +292,14 @@ class DocTool(object):
opts, args = optparser(OPT.docinfo).parse_args(list(args)) opts, args = optparser(OPT.docinfo).parse_args(list(args))
if opts.docinfo: if opts.docinfo:
f = file(opts.docinfo, "rU") f = open(opts.docinfo, "r")
e = ShellEscapeRunner(sys.stdout) e = ShellEscapeRunner(sys.stdout)
map(e.handle_line, f.readlines()) list(map(e.handle_line, f.readlines()))
f.close() f.close()
print print()
print ".. contents::" print(".. contents::")
print print()
out = DupRefsRemover(sys.stdout) out = DupRefsRemover(sys.stdout)
out_xlate = UnderlineXlate(out) out_xlate = UnderlineXlate(out)
@ -310,47 +311,47 @@ class DocTool(object):
if not name.endswith(".rst"): if not name.endswith(".rst"):
continue continue
f = file(name, "rU") f = open(name, "r")
map(is_index_filename(name) and out.handle_line or out_xlate.handle_line, list(map(is_index_filename(name) and out.handle_line or out_xlate.handle_line,
filter(lambda l: ".. contents::" not in l, [l for l in f.readlines() if ".. contents::" not in l]
f.readlines()) ))
)
f.close() f.close()
print print()
def cmd_htmlindex(self, cmd, *args): def cmd_htmlindex(self, cmd, *args):
opts, args = optparser(OPT.docinfo).parse_args(list(args)) opts, args = optparser(OPT.docinfo).parse_args(list(args))
if opts.docinfo: if opts.docinfo:
f = file(opts.docinfo, "rU") f = open(opts.docinfo, "r")
e = ShellEscapeRunner(sys.stdout) e = ShellEscapeRunner(sys.stdout)
map(e.handle_line, f.readlines()) list(map(e.handle_line, f.readlines()))
f.close() f.close()
print print()
args = list(args) args = list(args)
args.sort(str_tuple_sort) #args.sort(key=str_tuple_sort)
args.sort()
for name in args: for name in args:
# Skip non-RST inputs # Skip non-RST inputs
if not name.endswith(".rst") or not is_index_filename(name): if not name.endswith(".rst") or not is_index_filename(name):
continue continue
f = file(name, "rU") f = open(name, "r")
line = f.readline().strip() line = f.readline().strip()
f.close() f.close()
print "#. `%s <%s.html>`__" % (line, name[:-4]) print("#. `%s <%s.html>`__" % (line, name[:-4]))
def cmd_help(self, cmd, *args): def cmd_help(self, cmd, *args):
if args: if args:
self.main([args[0], args[0], "--help"]) self.main([args[0], args[0], "--help"])
else: else:
print "Available commands:" print("Available commands:")
for k in dir(self): for k in dir(self):
if k.startswith("cmd_"): if k.startswith("cmd_"):
print " ", k[4:].replace("_", "-") print(" ", k[4:].replace("_", "-"))
cmd_commands = cmd_help cmd_commands = cmd_help