tests/test-doctest.py
author Augie Fackler <raf@durin42.com>
Wed, 23 Aug 2017 10:51:26 -0400
changeset 34206 1e71dddc10a2
parent 34141 9b4d7d4855f5
child 34208 0a2fd3bfc704
permissions -rw-r--r--
drawdag: add a couple of doctests to help with python3 porting

# this is hack to make sure no escape characters are inserted into the output

from __future__ import absolute_import

import doctest
import os
import re
import sys

ispy3 = (sys.version_info[0] >= 3)

if 'TERM' in os.environ:
    del os.environ['TERM']

class py3docchecker(doctest.OutputChecker):
    def check_output(self, want, got, optionflags):
        want2 = re.sub(r'''\bu(['"])(.*?)\1''', r'\1\2\1', want)  # py2: u''
        got2 = re.sub(r'''\bb(['"])(.*?)\1''', r'\1\2\1', got)  # py3: b''
        # py3: <exc.name>: b'<msg>' -> <name>: <msg>
        #      <exc.name>: <others> -> <name>: <others>
        got2 = re.sub(r'''^mercurial\.\w+\.(\w+): (['"])(.*?)\2''', r'\1: \3',
                      got2, re.MULTILINE)
        got2 = re.sub(r'^mercurial\.\w+\.(\w+): ', r'\1: ', got2, re.MULTILINE)
        return any(doctest.OutputChecker.check_output(self, w, g, optionflags)
                   for w, g in [(want, got), (want2, got2)])

# TODO: migrate doctests to py3 and enable them on both versions
def testmod(name, optionflags=0, testtarget=None, py2=True, py3=True):
    if not (not ispy3 and py2 or ispy3 and py3):
        return
    __import__(name)
    mod = sys.modules[name]
    if testtarget is not None:
        mod = getattr(mod, testtarget)

    # minimal copy of doctest.testmod()
    finder = doctest.DocTestFinder()
    checker = None
    if ispy3:
        checker = py3docchecker()
    runner = doctest.DocTestRunner(checker=checker, optionflags=optionflags)
    for test in finder.find(mod, name):
        runner.run(test)
    runner.summarize()

testmod('mercurial.changegroup')
testmod('mercurial.changelog')
testmod('mercurial.color')
testmod('mercurial.config')
testmod('mercurial.context')
testmod('mercurial.dagparser', optionflags=doctest.NORMALIZE_WHITESPACE,
        py3=False)  # py3: use of str()
testmod('mercurial.dispatch')
testmod('mercurial.encoding', py3=False)  # py3: multiple encoding issues
testmod('mercurial.formatter', py3=False)  # py3: write bytes to stdout
testmod('mercurial.hg')
testmod('mercurial.hgweb.hgwebdir_mod', py3=False)  # py3: repr(bytes) ?
testmod('mercurial.match')
testmod('mercurial.mdiff')
testmod('mercurial.minirst')
testmod('mercurial.patch', py3=False)  # py3: bytes[n], etc. ?
testmod('mercurial.pathutil', py3=False)  # py3: os.sep
testmod('mercurial.parser')
testmod('mercurial.pycompat')
testmod('mercurial.revsetlang')
testmod('mercurial.smartset')
testmod('mercurial.store', py3=False)  # py3: bytes[n]
testmod('mercurial.subrepo')
testmod('mercurial.templatefilters')
testmod('mercurial.templater')
testmod('mercurial.ui', py3=False)  # py3: __name__
testmod('mercurial.url')
testmod('mercurial.util', py3=False)  # py3: multiple bytes/unicode issues
testmod('mercurial.util', testtarget='platform')
testmod('hgext.convert.convcmd', py3=False)  # py3: use of str() ?
testmod('hgext.convert.cvsps')
testmod('hgext.convert.filemap')
testmod('hgext.convert.p4')
testmod('hgext.convert.subversion')
testmod('hgext.mq')
# Helper scripts in tests/ that have doctests:
testmod('drawdag')