tests: add support for inline doctests in test files This adds doctest like syntax to .t files, that can be interleaved with regular shell code: $ echo -n a > file >>> print open('file').read() a >>> open('file', 'a').write('b') $ cat file ab The syntax is exactly the same as regular doctests, so multiline statements look like this: >>> for i in range(3): ... print i 0 1 2 Each block has its own context, i.e.: >>> x = 0 >>> print x 0 $ echo 'foo' foo >>> print x will result in a NameError. Errors are displayed in standard doctest format: >>> print 'foo' bar --- /home/idan/dev/hg/default/tests/test-test.t +++ /home/idan/dev/hg/default/tests/test-test.t.err @@ -2,3 +2,16 @@ > >>> print 'foo' > bar > EOF + ********************************************************************** + File "/tmp/tmps8X_0ohg-tst", line 1, in tmps8X_0ohg-tst + Failed example: + print 'foo' + Expected: + bar + Got: + foo + ********************************************************************** + 1 items had failures: + 1 of 1 in tmps8X_0ohg-tst + ***Test Failed*** 1 failures. + [1] As for the implementation, it's quite simple: when the test runner sees a line starting with '>>>' it converts it, and all subsequent lines until the next line that begins with '$' to a 'python -m heredoctest <<EOF' call with the proper heredoc to follow. So if we have this test file: >>> for c in 'abcd': ... print c a b c d $ echo foo foo It gets converted to: $ python -m heredoctest <<EOF > >>> for c in 'abcd': > ... print c > a > b > c > d > EOF $ echo foo foo And then processed like every other test file by converting it to a sh script. [ original upstream message ]

     1

#!/usr/bin/env python

     2

# $Id$

     3

     4

from distutils.core import setup

     5

import os, time

     6

     7

# specify version, Mercurial version otherwise

     8

version = ''

     9

    10

unknown_version = 'unknown'

    11

    12

def getversion():

    13

    global version, unknown_version

    14

    if not version and os.path.isdir('.hg'):

    15

        p = os.popen('hg --quiet identify 2> %s' % os.devnull)

    16

        ident = p.read()[:-1]

    17

        if not p.close() and ident:

    18

            if ident[-1] != '+':

    19

                version = ident

    20

            else:

    21

                version = ident[:-1]

    22

                version += time.strftime('+%Y%m%d')

    23

    return version or unknown_version

    24

    25

setup(name='hgkw',

    26

      version=getversion(),

    27

      description='Mercurial keyword extension (standalone)',

    28

      author='Christian Ebert',

    29

      author_email='blacktrash@gmx.net',

    30

      url='http://www.blacktrash.org/hg/hgkeyword/',

    31

      license='GNU GPL',

    32

      packages=['hgkw'])