mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
183da818df
* E101: indentation contains mixed spaces and tabs * E111: indentation is not a multiple of four * E128: continuation line under-indented for visual indent * E302: expected 2 blank lines, found 1 * W191: indentation contains tabs
58 lines
1.6 KiB
Python
Executable File
58 lines
1.6 KiB
Python
Executable File
#!/usr/bin/env python
|
|
from __future__ import print_function
|
|
|
|
import re
|
|
import subprocess
|
|
import sys
|
|
|
|
|
|
def run():
|
|
if len(sys.argv) > 1:
|
|
print("""
|
|
ns-html2rst - Convert Cocoa HTML documentation into ReST
|
|
|
|
usage: nshtml2rst < NSString.html > NSString.rst
|
|
""")
|
|
sys.exit(0)
|
|
|
|
html = sys.stdin.read()
|
|
|
|
# Treat <div class="declaration>...</div> as <pre>...</pre>
|
|
html = re.sub(
|
|
r'<div\s+class="declaration">(.*?)</div>',
|
|
r'<pre>\1</pre>',
|
|
html, flags=re.MULTILINE | re.DOTALL)
|
|
|
|
# Strip all attributes from <pre>...</pre> containing class="..."
|
|
# The resulting classes confound ReST
|
|
html = re.sub(
|
|
r'<pre\s[^>]*class=[^>]*>(.*?)</pre>',
|
|
r'<pre>\1</pre>',
|
|
html, flags=re.MULTILINE | re.DOTALL)
|
|
|
|
# Remove links from <code>...</code>, which doesn't have a rendering in ReST
|
|
html = re.sub(
|
|
r'<code>(.*?)<a[^>]*?>(.*?)</a>(.*?)</code>',
|
|
r'<code>\1\2\3</code>',
|
|
html, flags=re.MULTILINE | re.DOTALL)
|
|
|
|
# Let pandoc do most of the hard work
|
|
p = subprocess.Popen(
|
|
args=['pandoc', '--reference-links', '-f', 'html', '-t', 'rst'],
|
|
stdin=subprocess.PIPE,
|
|
stdout=subprocess.PIPE
|
|
)
|
|
rst, stderr = p.communicate(html)
|
|
|
|
# HACKETY HACK HACK: Our html documents apparently contain some
|
|
# bogus heading level nesting. Just fix up the one we know about
|
|
# so that ReST doesn't complain later.
|
|
rst = re.sub("(^|\n)('+)($|\n)",
|
|
lambda m: m.group(1) + len(m.group(2)) * '^' + m.group(3),
|
|
rst, flags=re.MULTILINE)
|
|
|
|
sys.stdout.write(rst)
|
|
|
|
if __name__ == '__main__':
|
|
run()
|