From 58a12412510bb331b74beca9732b1ce10b1f0bc9 Mon Sep 17 00:00:00 2001
From: "Jason R. Coombs" <jaraco@jaraco.com>
Date: Fri, 27 Jun 2014 16:38:43 -0400
Subject: Move util scripts to docs

---
 docs/util/convert-trac.py   | 134 ++++++++++++++++++++++++++++++++++++++++++++
 docs/util/test-doc.py       |  23 ++++++++
 sphinx/util/convert-trac.py | 134 --------------------------------------------
 sphinx/util/test-doc.py     |  23 --------
 4 files changed, 157 insertions(+), 157 deletions(-)
 create mode 100644 docs/util/convert-trac.py
 create mode 100644 docs/util/test-doc.py
 delete mode 100644 sphinx/util/convert-trac.py
 delete mode 100644 sphinx/util/test-doc.py

diff --git a/docs/util/convert-trac.py b/docs/util/convert-trac.py
new file mode 100644
index 00000000..ebb77d42
--- /dev/null
+++ b/docs/util/convert-trac.py
@@ -0,0 +1,134 @@
+#!python
+
+"""
+%prog <filename>
+
+A utility script for performing some commonly-encountered patterns in
+Trac Wiki format into reStructuredText (rst).
+
+filename is the name of the text file to be saved. If -U is not used,
+the file is converted in-place and filename is also the name of the
+source.
+"""
+
+from __future__ import print_function
+import sys
+import re
+import inspect
+import optparse
+import shutil
+import urllib2
+from StringIO import StringIO
+
+
+def get_options():
+    global options
+    parser = optparse.OptionParser(usage=inspect.cleandoc(__doc__))
+    parser.add_option('-U', '--url',
+                      help="Trac URL from which to retrieve source")
+    options, args = parser.parse_args()
+    try:
+        options.filename = args.pop()
+    except IndexError:
+        parser.error("Filename required")
+
+# each of the replacement functions should have a docstring
+#  which is a regular expression to be matched.
+
+
+def replace_external_link(matcher):
+    r"\[(?P<href>(?P<scheme>\w+)\://.+?) (?P<name>.+?)\]"
+    return '`{name} <{href}>`_'.format(**matcher.groupdict())
+
+
+def replace_wiki_link(matcher):
+    r"\[wiki\:(?P<ref>.+?) (?P<name>.+?)\]"
+    return '`{name} <TODO-fix wiki target {ref}>`_'.format(
+        **matcher.groupdict()
+    )
+
+# character array indexed by level for characters
+heading_characters = [None, '*', '=', '-', '^']
+
+
+def replace_headings(matcher):
+    r"^(?P<level>=+) (?P<name>.*) (?P=level)$"
+    level = len(matcher.groupdict()['level'])
+    char = heading_characters[level]
+    name = matcher.groupdict()['name']
+    lines = [name, char * len(name)]
+    if level == 1:
+        lines.insert(0, char * len(name))
+    return '\n'.join(lines)
+
+
+def indent(block):
+    add_indent = lambda s: '    ' + s
+    lines = StringIO(block)
+    i_lines = map(add_indent, lines)
+    return ''.join(i_lines)
+
+
+def replace_inline_code(matcher):
+    r"\{\{\{(?P<code>[^\n]*?)\}\}\}"
+    return '``{code}``'.format(**matcher.groupdict())
+
+
+def replace_code_block(matcher):
+    r"\{\{\{\n(?P<code>(.|\n)*?)^\}\}\}"
+    return '::\n\n' + indent(matcher.groupdict()['code'])
+
+
+def replace_page_outline(matcher):
+    r"\[\[PageOutline\]\]\n"
+    return ''
+
+
+def replace_bang_symbols(matcher):
+    r"!(?P<symbol>\w+)"
+    return matcher.groupdict()['symbol']
+
+# a number of the files end in
+"""{{{
+#!html
+<h2 class='compatibility'>Older versions</h2>
+}}}"""  # and everything after is garbage, so just remove it.
+
+
+def remove_2x_compat_notes(matcher):
+    r"\{\{\{\n#!html\n<h2(.|\n)*"
+    return ''
+
+replacements = [remove_2x_compat_notes] + \
+    [func for name,
+     func in globals().items() if name.startswith('replace_')]
+
+
+def normalize_linebreaks(text):
+    return text.replace('\r\n', '\n')
+
+
+def convert_file():
+    filename = options.filename
+    if options.url:
+        text = urllib2.urlopen(options.url).read()
+        text = normalize_linebreaks(text)
+    else:
+        shutil.copy(filename, filename + '.bak')
+        text = open(filename).read()
+    # iterate over each of the replacements and execute it
+    new_text = text
+    for repl in replacements:
+        pattern = re.compile(inspect.getdoc(repl), re.MULTILINE)
+        new_text = pattern.sub(repl, new_text)
+
+    open(filename, 'w').write(new_text)
+    print("done")
+
+
+def handle_command_line():
+    get_options()
+    convert_file()
+
+if __name__ == '__main__':
+    handle_command_line()
diff --git a/docs/util/test-doc.py b/docs/util/test-doc.py
new file mode 100644
index 00000000..3d06da99
--- /dev/null
+++ b/docs/util/test-doc.py
@@ -0,0 +1,23 @@
+from __future__ import print_function
+import sys
+import inspect
+import docutils.utils
+import docutils.parsers.rst
+from StringIO import StringIO
+
+
+def print_with_line_numbers(block):
+    stream = StringIO(block)
+    for number, line in enumerate(stream):
+        number += 1
+        print(number, line.rstrip())
+
+target_class_spec = sys.argv[1]
+import cherrypy
+target_class = eval(target_class_spec)
+source = inspect.getdoc(target_class)
+print_with_line_numbers(source)
+parser = docutils.parsers.rst.Parser()
+settings = None  # ?
+document = docutils.utils.new_document(source, settings)
+parser.parse(source, document)
diff --git a/sphinx/util/convert-trac.py b/sphinx/util/convert-trac.py
deleted file mode 100644
index ebb77d42..00000000
--- a/sphinx/util/convert-trac.py
+++ /dev/null
@@ -1,134 +0,0 @@
-#!python
-
-"""
-%prog <filename>
-
-A utility script for performing some commonly-encountered patterns in
-Trac Wiki format into reStructuredText (rst).
-
-filename is the name of the text file to be saved. If -U is not used,
-the file is converted in-place and filename is also the name of the
-source.
-"""
-
-from __future__ import print_function
-import sys
-import re
-import inspect
-import optparse
-import shutil
-import urllib2
-from StringIO import StringIO
-
-
-def get_options():
-    global options
-    parser = optparse.OptionParser(usage=inspect.cleandoc(__doc__))
-    parser.add_option('-U', '--url',
-                      help="Trac URL from which to retrieve source")
-    options, args = parser.parse_args()
-    try:
-        options.filename = args.pop()
-    except IndexError:
-        parser.error("Filename required")
-
-# each of the replacement functions should have a docstring
-#  which is a regular expression to be matched.
-
-
-def replace_external_link(matcher):
-    r"\[(?P<href>(?P<scheme>\w+)\://.+?) (?P<name>.+?)\]"
-    return '`{name} <{href}>`_'.format(**matcher.groupdict())
-
-
-def replace_wiki_link(matcher):
-    r"\[wiki\:(?P<ref>.+?) (?P<name>.+?)\]"
-    return '`{name} <TODO-fix wiki target {ref}>`_'.format(
-        **matcher.groupdict()
-    )
-
-# character array indexed by level for characters
-heading_characters = [None, '*', '=', '-', '^']
-
-
-def replace_headings(matcher):
-    r"^(?P<level>=+) (?P<name>.*) (?P=level)$"
-    level = len(matcher.groupdict()['level'])
-    char = heading_characters[level]
-    name = matcher.groupdict()['name']
-    lines = [name, char * len(name)]
-    if level == 1:
-        lines.insert(0, char * len(name))
-    return '\n'.join(lines)
-
-
-def indent(block):
-    add_indent = lambda s: '    ' + s
-    lines = StringIO(block)
-    i_lines = map(add_indent, lines)
-    return ''.join(i_lines)
-
-
-def replace_inline_code(matcher):
-    r"\{\{\{(?P<code>[^\n]*?)\}\}\}"
-    return '``{code}``'.format(**matcher.groupdict())
-
-
-def replace_code_block(matcher):
-    r"\{\{\{\n(?P<code>(.|\n)*?)^\}\}\}"
-    return '::\n\n' + indent(matcher.groupdict()['code'])
-
-
-def replace_page_outline(matcher):
-    r"\[\[PageOutline\]\]\n"
-    return ''
-
-
-def replace_bang_symbols(matcher):
-    r"!(?P<symbol>\w+)"
-    return matcher.groupdict()['symbol']
-
-# a number of the files end in
-"""{{{
-#!html
-<h2 class='compatibility'>Older versions</h2>
-}}}"""  # and everything after is garbage, so just remove it.
-
-
-def remove_2x_compat_notes(matcher):
-    r"\{\{\{\n#!html\n<h2(.|\n)*"
-    return ''
-
-replacements = [remove_2x_compat_notes] + \
-    [func for name,
-     func in globals().items() if name.startswith('replace_')]
-
-
-def normalize_linebreaks(text):
-    return text.replace('\r\n', '\n')
-
-
-def convert_file():
-    filename = options.filename
-    if options.url:
-        text = urllib2.urlopen(options.url).read()
-        text = normalize_linebreaks(text)
-    else:
-        shutil.copy(filename, filename + '.bak')
-        text = open(filename).read()
-    # iterate over each of the replacements and execute it
-    new_text = text
-    for repl in replacements:
-        pattern = re.compile(inspect.getdoc(repl), re.MULTILINE)
-        new_text = pattern.sub(repl, new_text)
-
-    open(filename, 'w').write(new_text)
-    print("done")
-
-
-def handle_command_line():
-    get_options()
-    convert_file()
-
-if __name__ == '__main__':
-    handle_command_line()
diff --git a/sphinx/util/test-doc.py b/sphinx/util/test-doc.py
deleted file mode 100644
index 3d06da99..00000000
--- a/sphinx/util/test-doc.py
+++ /dev/null
@@ -1,23 +0,0 @@
-from __future__ import print_function
-import sys
-import inspect
-import docutils.utils
-import docutils.parsers.rst
-from StringIO import StringIO
-
-
-def print_with_line_numbers(block):
-    stream = StringIO(block)
-    for number, line in enumerate(stream):
-        number += 1
-        print(number, line.rstrip())
-
-target_class_spec = sys.argv[1]
-import cherrypy
-target_class = eval(target_class_spec)
-source = inspect.getdoc(target_class)
-print_with_line_numbers(source)
-parser = docutils.parsers.rst.Parser()
-settings = None  # ?
-document = docutils.utils.new_document(source, settings)
-parser.parse(source, document)
-- 
cgit v1.2.1