summaryrefslogtreecommitdiffstats
path: root/Doc/tools
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2006-03-31 05:30:19 (GMT)
committerFred Drake <fdrake@acm.org>2006-03-31 05:30:19 (GMT)
commit7b8cf389274c33a94879deed3141a3a7c627a946 (patch)
treeb9437eaaf9a921f6b7611f6237794b38ea5bdd15 /Doc/tools
parent842ab70ecf079094102eb8063e728ff59d8e816c (diff)
downloadcpython-7b8cf389274c33a94879deed3141a3a7c627a946.zip
cpython-7b8cf389274c33a94879deed3141a3a7c627a946.tar.gz
cpython-7b8cf389274c33a94879deed3141a3a7c627a946.tar.bz2
improve reporting of illegal section nesting (provide location which
caused detection of the error)
Diffstat (limited to 'Doc/tools')
-rwxr-xr-xDoc/tools/toc2bkm.py19
1 files changed, 18 insertions, 1 deletions
diff --git a/Doc/tools/toc2bkm.py b/Doc/tools/toc2bkm.py
index 636459a..ab669ba 100755
--- a/Doc/tools/toc2bkm.py
+++ b/Doc/tools/toc2bkm.py
@@ -44,6 +44,20 @@ _transition_map = {
INCLUDED_LEVELS = ("chapter", "section", "subsection", "subsubsection")
+class BadSectionNesting(Exception):
+ """Raised for unsupported section level transitions."""
+
+ def __init__(self, level, newsection, path, lineno):
+ self.level = level
+ self.newsection = newsection
+ self.path = path
+ self.lineno = lineno
+
+ def __str__(self):
+ return ("illegal transition from %s to %s at %s (line %s)"
+ % (self.level, self.newsection, self.path, self.lineno))
+
+
def parse_toc(fp, bigpart=None):
toc = top = []
stack = [toc]
@@ -65,7 +79,10 @@ def parse_toc(fp, bigpart=None):
if stype not in INCLUDED_LEVELS:
# we don't want paragraphs & subparagraphs
continue
- direction = _transition_map[(level, stype)]
+ try:
+ direction = _transition_map[(level, stype)]
+ except KeyError:
+ raise BadSectionNesting(level, stype, fp.name, lineno)
if direction == OUTER_TO_INNER:
toc = toc[-1][-1]
stack.insert(0, toc)