GH-121970: Remove ``escape4chm`` (#122065)

This commit is contained in:
Adam Turner 2024-07-23 13:30:06 +01:00 committed by GitHub
parent 1bcc9eb862
commit 53e9e7de63
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 0 additions and 60 deletions

View File

@ -5,7 +5,6 @@ line-length = 79
extend-exclude = [ extend-exclude = [
"includes/*", "includes/*",
# Temporary exclusions: # Temporary exclusions:
"tools/extensions/escape4chm.py",
"tools/extensions/pyspecific.py", "tools/extensions/pyspecific.py",
] ]

View File

@ -21,7 +21,6 @@ from pyspecific import SOURCE_URI
extensions = [ extensions = [
'c_annotations', 'c_annotations',
'escape4chm',
'glossary_search', 'glossary_search',
'lexers', 'lexers',
'pyspecific', 'pyspecific',

View File

@ -1,58 +0,0 @@
"""
Escape the `body` part of .chm source file to 7-bit ASCII, to fix visual
effect on some MBCS Windows systems.
https://bugs.python.org/issue32174
"""
import pathlib
import re
from html.entities import codepoint2name
from sphinx.util.logging import getLogger
# escape the characters which codepoint > 0x7F
def _process(string):
def escape(matchobj):
codepoint = ord(matchobj.group(0))
name = codepoint2name.get(codepoint)
if name is None:
return '&#%d;' % codepoint
else:
return '&%s;' % name
return re.sub(r'[^\x00-\x7F]', escape, string)
def escape_for_chm(app, pagename, templatename, context, doctree):
# only works for .chm output
if getattr(app.builder, 'name', '') != 'htmlhelp':
return
# escape the `body` part to 7-bit ASCII
body = context.get('body')
if body is not None:
context['body'] = _process(body)
def fixup_keywords(app, exception):
# only works for .chm output
if getattr(app.builder, 'name', '') != 'htmlhelp' or exception:
return
getLogger(__name__).info('fixing HTML escapes in keywords file...')
outdir = pathlib.Path(app.builder.outdir)
outname = app.builder.config.htmlhelp_basename
with open(outdir / (outname + '.hhk'), 'rb') as f:
index = f.read()
with open(outdir / (outname + '.hhk'), 'wb') as f:
f.write(index.replace(b''', b'''))
def setup(app):
# `html-page-context` event emitted when the HTML builder has
# created a context dictionary to render a template with.
app.connect('html-page-context', escape_for_chm)
# `build-finished` event emitted when all the files have been
# output.
app.connect('build-finished', fixup_keywords)
return {'version': '1.0', 'parallel_read_safe': True}