##// END OF EJS Templates
run-tests: update .t reference output after reading the test...
Jun Wu -
r32981:02bca6dc default
parent child Browse files
Show More
@@ -1,2763 +1,2769 b''
1 1 #!/usr/bin/env python
2 2 #
3 3 # run-tests.py - Run a set of tests on Mercurial
4 4 #
5 5 # Copyright 2006 Matt Mackall <mpm@selenic.com>
6 6 #
7 7 # This software may be used and distributed according to the terms of the
8 8 # GNU General Public License version 2 or any later version.
9 9
10 10 # Modifying this script is tricky because it has many modes:
11 11 # - serial (default) vs parallel (-jN, N > 1)
12 12 # - no coverage (default) vs coverage (-c, -C, -s)
13 13 # - temp install (default) vs specific hg script (--with-hg, --local)
14 14 # - tests are a mix of shell scripts and Python scripts
15 15 #
16 16 # If you change this script, it is recommended that you ensure you
17 17 # haven't broken it by running it in various modes with a representative
18 18 # sample of test scripts. For example:
19 19 #
20 20 # 1) serial, no coverage, temp install:
21 21 # ./run-tests.py test-s*
22 22 # 2) serial, no coverage, local hg:
23 23 # ./run-tests.py --local test-s*
24 24 # 3) serial, coverage, temp install:
25 25 # ./run-tests.py -c test-s*
26 26 # 4) serial, coverage, local hg:
27 27 # ./run-tests.py -c --local test-s* # unsupported
28 28 # 5) parallel, no coverage, temp install:
29 29 # ./run-tests.py -j2 test-s*
30 30 # 6) parallel, no coverage, local hg:
31 31 # ./run-tests.py -j2 --local test-s*
32 32 # 7) parallel, coverage, temp install:
33 33 # ./run-tests.py -j2 -c test-s* # currently broken
34 34 # 8) parallel, coverage, local install:
35 35 # ./run-tests.py -j2 -c --local test-s* # unsupported (and broken)
36 36 # 9) parallel, custom tmp dir:
37 37 # ./run-tests.py -j2 --tmpdir /tmp/myhgtests
38 38 # 10) parallel, pure, tests that call run-tests:
39 39 # ./run-tests.py --pure `grep -l run-tests.py *.t`
40 40 #
41 41 # (You could use any subset of the tests: test-s* happens to match
42 42 # enough that it's worth doing parallel runs, few enough that it
43 43 # completes fairly quickly, includes both shell and Python scripts, and
44 44 # includes some scripts that run daemon processes.)
45 45
46 46 from __future__ import absolute_import, print_function
47 47
48 48 import difflib
49 49 import distutils.version as version
50 50 import errno
51 51 import json
52 52 import optparse
53 53 import os
54 54 import random
55 55 import re
56 56 import shutil
57 57 import signal
58 58 import socket
59 59 import subprocess
60 60 import sys
61 61 import sysconfig
62 62 import tempfile
63 63 import threading
64 64 import time
65 65 import unittest
66 66 import xml.dom.minidom as minidom
67 67
68 68 try:
69 69 import Queue as queue
70 70 except ImportError:
71 71 import queue
72 72
73 73 if os.environ.get('RTUNICODEPEDANTRY', False):
74 74 try:
75 75 reload(sys)
76 76 sys.setdefaultencoding("undefined")
77 77 except NameError:
78 78 pass
79 79
80 80 osenvironb = getattr(os, 'environb', os.environ)
81 81 processlock = threading.Lock()
82 82
83 83 if sys.version_info > (3, 5, 0):
84 84 PYTHON3 = True
85 85 xrange = range # we use xrange in one place, and we'd rather not use range
86 86 def _bytespath(p):
87 87 return p.encode('utf-8')
88 88
89 89 def _strpath(p):
90 90 return p.decode('utf-8')
91 91
92 92 elif sys.version_info >= (3, 0, 0):
93 93 print('%s is only supported on Python 3.5+ and 2.7, not %s' %
94 94 (sys.argv[0], '.'.join(str(v) for v in sys.version_info[:3])))
95 95 sys.exit(70) # EX_SOFTWARE from `man 3 sysexit`
96 96 else:
97 97 PYTHON3 = False
98 98
99 99 # In python 2.x, path operations are generally done using
100 100 # bytestrings by default, so we don't have to do any extra
101 101 # fiddling there. We define the wrapper functions anyway just to
102 102 # help keep code consistent between platforms.
103 103 def _bytespath(p):
104 104 return p
105 105
106 106 _strpath = _bytespath
107 107
108 108 # For Windows support
109 109 wifexited = getattr(os, "WIFEXITED", lambda x: False)
110 110
111 111 # Whether to use IPv6
112 112 def checksocketfamily(name, port=20058):
113 113 """return true if we can listen on localhost using family=name
114 114
115 115 name should be either 'AF_INET', or 'AF_INET6'.
116 116 port being used is okay - EADDRINUSE is considered as successful.
117 117 """
118 118 family = getattr(socket, name, None)
119 119 if family is None:
120 120 return False
121 121 try:
122 122 s = socket.socket(family, socket.SOCK_STREAM)
123 123 s.bind(('localhost', port))
124 124 s.close()
125 125 return True
126 126 except socket.error as exc:
127 127 if exc.errno == errno.EADDRINUSE:
128 128 return True
129 129 elif exc.errno in (errno.EADDRNOTAVAIL, errno.EPROTONOSUPPORT):
130 130 return False
131 131 else:
132 132 raise
133 133 else:
134 134 return False
135 135
136 136 # useipv6 will be set by parseargs
137 137 useipv6 = None
138 138
139 139 def checkportisavailable(port):
140 140 """return true if a port seems free to bind on localhost"""
141 141 if useipv6:
142 142 family = socket.AF_INET6
143 143 else:
144 144 family = socket.AF_INET
145 145 try:
146 146 s = socket.socket(family, socket.SOCK_STREAM)
147 147 s.bind(('localhost', port))
148 148 s.close()
149 149 return True
150 150 except socket.error as exc:
151 151 if exc.errno not in (errno.EADDRINUSE, errno.EADDRNOTAVAIL,
152 152 errno.EPROTONOSUPPORT):
153 153 raise
154 154 return False
155 155
156 156 closefds = os.name == 'posix'
157 157 def Popen4(cmd, wd, timeout, env=None):
158 158 processlock.acquire()
159 159 p = subprocess.Popen(cmd, shell=True, bufsize=-1, cwd=wd, env=env,
160 160 close_fds=closefds,
161 161 stdin=subprocess.PIPE, stdout=subprocess.PIPE,
162 162 stderr=subprocess.STDOUT)
163 163 processlock.release()
164 164
165 165 p.fromchild = p.stdout
166 166 p.tochild = p.stdin
167 167 p.childerr = p.stderr
168 168
169 169 p.timeout = False
170 170 if timeout:
171 171 def t():
172 172 start = time.time()
173 173 while time.time() - start < timeout and p.returncode is None:
174 174 time.sleep(.1)
175 175 p.timeout = True
176 176 if p.returncode is None:
177 177 terminate(p)
178 178 threading.Thread(target=t).start()
179 179
180 180 return p
181 181
182 182 PYTHON = _bytespath(sys.executable.replace('\\', '/'))
183 183 IMPL_PATH = b'PYTHONPATH'
184 184 if 'java' in sys.platform:
185 185 IMPL_PATH = b'JYTHONPATH'
186 186
187 187 defaults = {
188 188 'jobs': ('HGTEST_JOBS', 1),
189 189 'timeout': ('HGTEST_TIMEOUT', 180),
190 190 'slowtimeout': ('HGTEST_SLOWTIMEOUT', 500),
191 191 'port': ('HGTEST_PORT', 20059),
192 192 'shell': ('HGTEST_SHELL', 'sh'),
193 193 }
194 194
195 195 def canonpath(path):
196 196 return os.path.realpath(os.path.expanduser(path))
197 197
198 198 def parselistfiles(files, listtype, warn=True):
199 199 entries = dict()
200 200 for filename in files:
201 201 try:
202 202 path = os.path.expanduser(os.path.expandvars(filename))
203 203 f = open(path, "rb")
204 204 except IOError as err:
205 205 if err.errno != errno.ENOENT:
206 206 raise
207 207 if warn:
208 208 print("warning: no such %s file: %s" % (listtype, filename))
209 209 continue
210 210
211 211 for line in f.readlines():
212 212 line = line.split(b'#', 1)[0].strip()
213 213 if line:
214 214 entries[line] = filename
215 215
216 216 f.close()
217 217 return entries
218 218
219 219 def parsettestcases(path):
220 220 """read a .t test file, return a set of test case names
221 221
222 222 If path does not exist, return an empty set.
223 223 """
224 224 cases = set()
225 225 try:
226 226 with open(path, 'rb') as f:
227 227 for l in f:
228 228 if l.startswith(b'#testcases '):
229 229 cases.update(l[11:].split())
230 230 except IOError as ex:
231 231 if ex.errno != errno.ENOENT:
232 232 raise
233 233 return cases
234 234
235 235 def getparser():
236 236 """Obtain the OptionParser used by the CLI."""
237 237 parser = optparse.OptionParser("%prog [options] [tests]")
238 238
239 239 # keep these sorted
240 240 parser.add_option("--blacklist", action="append",
241 241 help="skip tests listed in the specified blacklist file")
242 242 parser.add_option("--whitelist", action="append",
243 243 help="always run tests listed in the specified whitelist file")
244 244 parser.add_option("--changed", type="string",
245 245 help="run tests that are changed in parent rev or working directory")
246 246 parser.add_option("-C", "--annotate", action="store_true",
247 247 help="output files annotated with coverage")
248 248 parser.add_option("-c", "--cover", action="store_true",
249 249 help="print a test coverage report")
250 250 parser.add_option("-d", "--debug", action="store_true",
251 251 help="debug mode: write output of test scripts to console"
252 252 " rather than capturing and diffing it (disables timeout)")
253 253 parser.add_option("-f", "--first", action="store_true",
254 254 help="exit on the first test failure")
255 255 parser.add_option("-H", "--htmlcov", action="store_true",
256 256 help="create an HTML report of the coverage of the files")
257 257 parser.add_option("-i", "--interactive", action="store_true",
258 258 help="prompt to accept changed output")
259 259 parser.add_option("-j", "--jobs", type="int",
260 260 help="number of jobs to run in parallel"
261 261 " (default: $%s or %d)" % defaults['jobs'])
262 262 parser.add_option("--keep-tmpdir", action="store_true",
263 263 help="keep temporary directory after running tests")
264 264 parser.add_option("-k", "--keywords",
265 265 help="run tests matching keywords")
266 266 parser.add_option("--list-tests", action="store_true",
267 267 help="list tests instead of running them")
268 268 parser.add_option("-l", "--local", action="store_true",
269 269 help="shortcut for --with-hg=<testdir>/../hg, "
270 270 "and --with-chg=<testdir>/../contrib/chg/chg if --chg is set")
271 271 parser.add_option("--loop", action="store_true",
272 272 help="loop tests repeatedly")
273 273 parser.add_option("--runs-per-test", type="int", dest="runs_per_test",
274 274 help="run each test N times (default=1)", default=1)
275 275 parser.add_option("-n", "--nodiff", action="store_true",
276 276 help="skip showing test changes")
277 277 parser.add_option("--outputdir", type="string",
278 278 help="directory to write error logs to (default=test directory)")
279 279 parser.add_option("-p", "--port", type="int",
280 280 help="port on which servers should listen"
281 281 " (default: $%s or %d)" % defaults['port'])
282 282 parser.add_option("--compiler", type="string",
283 283 help="compiler to build with")
284 284 parser.add_option("--pure", action="store_true",
285 285 help="use pure Python code instead of C extensions")
286 286 parser.add_option("-R", "--restart", action="store_true",
287 287 help="restart at last error")
288 288 parser.add_option("-r", "--retest", action="store_true",
289 289 help="retest failed tests")
290 290 parser.add_option("-S", "--noskips", action="store_true",
291 291 help="don't report skip tests verbosely")
292 292 parser.add_option("--shell", type="string",
293 293 help="shell to use (default: $%s or %s)" % defaults['shell'])
294 294 parser.add_option("-t", "--timeout", type="int",
295 295 help="kill errant tests after TIMEOUT seconds"
296 296 " (default: $%s or %d)" % defaults['timeout'])
297 297 parser.add_option("--slowtimeout", type="int",
298 298 help="kill errant slow tests after SLOWTIMEOUT seconds"
299 299 " (default: $%s or %d)" % defaults['slowtimeout'])
300 300 parser.add_option("--time", action="store_true",
301 301 help="time how long each test takes")
302 302 parser.add_option("--json", action="store_true",
303 303 help="store test result data in 'report.json' file")
304 304 parser.add_option("--tmpdir", type="string",
305 305 help="run tests in the given temporary directory"
306 306 " (implies --keep-tmpdir)")
307 307 parser.add_option("-v", "--verbose", action="store_true",
308 308 help="output verbose messages")
309 309 parser.add_option("--xunit", type="string",
310 310 help="record xunit results at specified path")
311 311 parser.add_option("--view", type="string",
312 312 help="external diff viewer")
313 313 parser.add_option("--with-hg", type="string",
314 314 metavar="HG",
315 315 help="test using specified hg script rather than a "
316 316 "temporary installation")
317 317 parser.add_option("--chg", action="store_true",
318 318 help="install and use chg wrapper in place of hg")
319 319 parser.add_option("--with-chg", metavar="CHG",
320 320 help="use specified chg wrapper in place of hg")
321 321 parser.add_option("--ipv6", action="store_true",
322 322 help="prefer IPv6 to IPv4 for network related tests")
323 323 parser.add_option("-3", "--py3k-warnings", action="store_true",
324 324 help="enable Py3k warnings on Python 2.7+")
325 325 # This option should be deleted once test-check-py3-compat.t and other
326 326 # Python 3 tests run with Python 3.
327 327 parser.add_option("--with-python3", metavar="PYTHON3",
328 328 help="Python 3 interpreter (if running under Python 2)"
329 329 " (TEMPORARY)")
330 330 parser.add_option('--extra-config-opt', action="append",
331 331 help='set the given config opt in the test hgrc')
332 332 parser.add_option('--random', action="store_true",
333 333 help='run tests in random order')
334 334 parser.add_option('--profile-runner', action='store_true',
335 335 help='run statprof on run-tests')
336 336 parser.add_option('--allow-slow-tests', action='store_true',
337 337 help='allow extremely slow tests')
338 338 parser.add_option('--showchannels', action='store_true',
339 339 help='show scheduling channels')
340 340 parser.add_option('--known-good-rev', type="string",
341 341 metavar="known_good_rev",
342 342 help=("Automatically bisect any failures using this "
343 343 "revision as a known-good revision."))
344 344
345 345 for option, (envvar, default) in defaults.items():
346 346 defaults[option] = type(default)(os.environ.get(envvar, default))
347 347 parser.set_defaults(**defaults)
348 348
349 349 return parser
350 350
351 351 def parseargs(args, parser):
352 352 """Parse arguments with our OptionParser and validate results."""
353 353 (options, args) = parser.parse_args(args)
354 354
355 355 # jython is always pure
356 356 if 'java' in sys.platform or '__pypy__' in sys.modules:
357 357 options.pure = True
358 358
359 359 if options.with_hg:
360 360 options.with_hg = canonpath(_bytespath(options.with_hg))
361 361 if not (os.path.isfile(options.with_hg) and
362 362 os.access(options.with_hg, os.X_OK)):
363 363 parser.error('--with-hg must specify an executable hg script')
364 364 if os.path.basename(options.with_hg) not in [b'hg', b'hg.exe']:
365 365 sys.stderr.write('warning: --with-hg should specify an hg script\n')
366 366 if options.local:
367 367 testdir = os.path.dirname(_bytespath(canonpath(sys.argv[0])))
368 368 reporootdir = os.path.dirname(testdir)
369 369 pathandattrs = [(b'hg', 'with_hg')]
370 370 if options.chg:
371 371 pathandattrs.append((b'contrib/chg/chg', 'with_chg'))
372 372 for relpath, attr in pathandattrs:
373 373 binpath = os.path.join(reporootdir, relpath)
374 374 if os.name != 'nt' and not os.access(binpath, os.X_OK):
375 375 parser.error('--local specified, but %r not found or '
376 376 'not executable' % binpath)
377 377 setattr(options, attr, binpath)
378 378
379 379 if (options.chg or options.with_chg) and os.name == 'nt':
380 380 parser.error('chg does not work on %s' % os.name)
381 381 if options.with_chg:
382 382 options.chg = False # no installation to temporary location
383 383 options.with_chg = canonpath(_bytespath(options.with_chg))
384 384 if not (os.path.isfile(options.with_chg) and
385 385 os.access(options.with_chg, os.X_OK)):
386 386 parser.error('--with-chg must specify a chg executable')
387 387 if options.chg and options.with_hg:
388 388 # chg shares installation location with hg
389 389 parser.error('--chg does not work when --with-hg is specified '
390 390 '(use --with-chg instead)')
391 391
392 392 global useipv6
393 393 if options.ipv6:
394 394 useipv6 = checksocketfamily('AF_INET6')
395 395 else:
396 396 # only use IPv6 if IPv4 is unavailable and IPv6 is available
397 397 useipv6 = ((not checksocketfamily('AF_INET'))
398 398 and checksocketfamily('AF_INET6'))
399 399
400 400 options.anycoverage = options.cover or options.annotate or options.htmlcov
401 401 if options.anycoverage:
402 402 try:
403 403 import coverage
404 404 covver = version.StrictVersion(coverage.__version__).version
405 405 if covver < (3, 3):
406 406 parser.error('coverage options require coverage 3.3 or later')
407 407 except ImportError:
408 408 parser.error('coverage options now require the coverage package')
409 409
410 410 if options.anycoverage and options.local:
411 411 # this needs some path mangling somewhere, I guess
412 412 parser.error("sorry, coverage options do not work when --local "
413 413 "is specified")
414 414
415 415 if options.anycoverage and options.with_hg:
416 416 parser.error("sorry, coverage options do not work when --with-hg "
417 417 "is specified")
418 418
419 419 global verbose
420 420 if options.verbose:
421 421 verbose = ''
422 422
423 423 if options.tmpdir:
424 424 options.tmpdir = canonpath(options.tmpdir)
425 425
426 426 if options.jobs < 1:
427 427 parser.error('--jobs must be positive')
428 428 if options.interactive and options.debug:
429 429 parser.error("-i/--interactive and -d/--debug are incompatible")
430 430 if options.debug:
431 431 if options.timeout != defaults['timeout']:
432 432 sys.stderr.write(
433 433 'warning: --timeout option ignored with --debug\n')
434 434 if options.slowtimeout != defaults['slowtimeout']:
435 435 sys.stderr.write(
436 436 'warning: --slowtimeout option ignored with --debug\n')
437 437 options.timeout = 0
438 438 options.slowtimeout = 0
439 439 if options.py3k_warnings:
440 440 if PYTHON3:
441 441 parser.error(
442 442 '--py3k-warnings can only be used on Python 2.7')
443 443 if options.with_python3:
444 444 if PYTHON3:
445 445 parser.error('--with-python3 cannot be used when executing with '
446 446 'Python 3')
447 447
448 448 options.with_python3 = canonpath(options.with_python3)
449 449 # Verify Python3 executable is acceptable.
450 450 proc = subprocess.Popen([options.with_python3, b'--version'],
451 451 stdout=subprocess.PIPE,
452 452 stderr=subprocess.STDOUT)
453 453 out, _err = proc.communicate()
454 454 ret = proc.wait()
455 455 if ret != 0:
456 456 parser.error('could not determine version of python 3')
457 457 if not out.startswith('Python '):
458 458 parser.error('unexpected output from python3 --version: %s' %
459 459 out)
460 460 vers = version.LooseVersion(out[len('Python '):])
461 461 if vers < version.LooseVersion('3.5.0'):
462 462 parser.error('--with-python3 version must be 3.5.0 or greater; '
463 463 'got %s' % out)
464 464
465 465 if options.blacklist:
466 466 options.blacklist = parselistfiles(options.blacklist, 'blacklist')
467 467 if options.whitelist:
468 468 options.whitelisted = parselistfiles(options.whitelist, 'whitelist')
469 469 else:
470 470 options.whitelisted = {}
471 471
472 472 if options.showchannels:
473 473 options.nodiff = True
474 474
475 475 return (options, args)
476 476
477 477 def rename(src, dst):
478 478 """Like os.rename(), trade atomicity and opened files friendliness
479 479 for existing destination support.
480 480 """
481 481 shutil.copy(src, dst)
482 482 os.remove(src)
483 483
484 484 _unified_diff = difflib.unified_diff
485 485 if PYTHON3:
486 486 import functools
487 487 _unified_diff = functools.partial(difflib.diff_bytes, difflib.unified_diff)
488 488
489 489 def getdiff(expected, output, ref, err):
490 490 servefail = False
491 491 lines = []
492 492 for line in _unified_diff(expected, output, ref, err):
493 493 if line.startswith(b'+++') or line.startswith(b'---'):
494 494 line = line.replace(b'\\', b'/')
495 495 if line.endswith(b' \n'):
496 496 line = line[:-2] + b'\n'
497 497 lines.append(line)
498 498 if not servefail and line.startswith(
499 499 b'+ abort: child process failed to start'):
500 500 servefail = True
501 501
502 502 return servefail, lines
503 503
504 504 verbose = False
505 505 def vlog(*msg):
506 506 """Log only when in verbose mode."""
507 507 if verbose is False:
508 508 return
509 509
510 510 return log(*msg)
511 511
512 512 # Bytes that break XML even in a CDATA block: control characters 0-31
513 513 # sans \t, \n and \r
514 514 CDATA_EVIL = re.compile(br"[\000-\010\013\014\016-\037]")
515 515
516 516 # Match feature conditionalized output lines in the form, capturing the feature
517 517 # list in group 2, and the preceeding line output in group 1:
518 518 #
519 519 # output..output (feature !)\n
520 520 optline = re.compile(b'(.+) \((.+?) !\)\n$')
521 521
522 522 def cdatasafe(data):
523 523 """Make a string safe to include in a CDATA block.
524 524
525 525 Certain control characters are illegal in a CDATA block, and
526 526 there's no way to include a ]]> in a CDATA either. This function
527 527 replaces illegal bytes with ? and adds a space between the ]] so
528 528 that it won't break the CDATA block.
529 529 """
530 530 return CDATA_EVIL.sub(b'?', data).replace(b']]>', b'] ]>')
531 531
532 532 def log(*msg):
533 533 """Log something to stdout.
534 534
535 535 Arguments are strings to print.
536 536 """
537 537 with iolock:
538 538 if verbose:
539 539 print(verbose, end=' ')
540 540 for m in msg:
541 541 print(m, end=' ')
542 542 print()
543 543 sys.stdout.flush()
544 544
545 545 def terminate(proc):
546 546 """Terminate subprocess"""
547 547 vlog('# Terminating process %d' % proc.pid)
548 548 try:
549 549 proc.terminate()
550 550 except OSError:
551 551 pass
552 552
553 553 def killdaemons(pidfile):
554 554 import killdaemons as killmod
555 555 return killmod.killdaemons(pidfile, tryhard=False, remove=True,
556 556 logfn=vlog)
557 557
558 558 class Test(unittest.TestCase):
559 559 """Encapsulates a single, runnable test.
560 560
561 561 While this class conforms to the unittest.TestCase API, it differs in that
562 562 instances need to be instantiated manually. (Typically, unittest.TestCase
563 563 classes are instantiated automatically by scanning modules.)
564 564 """
565 565
566 566 # Status code reserved for skipped tests (used by hghave).
567 567 SKIPPED_STATUS = 80
568 568
569 569 def __init__(self, path, outputdir, tmpdir, keeptmpdir=False,
570 570 debug=False,
571 571 timeout=defaults['timeout'],
572 572 startport=defaults['port'], extraconfigopts=None,
573 573 py3kwarnings=False, shell=None, hgcommand=None,
574 574 slowtimeout=defaults['slowtimeout'], usechg=False,
575 575 useipv6=False):
576 576 """Create a test from parameters.
577 577
578 578 path is the full path to the file defining the test.
579 579
580 580 tmpdir is the main temporary directory to use for this test.
581 581
582 582 keeptmpdir determines whether to keep the test's temporary directory
583 583 after execution. It defaults to removal (False).
584 584
585 585 debug mode will make the test execute verbosely, with unfiltered
586 586 output.
587 587
588 588 timeout controls the maximum run time of the test. It is ignored when
589 589 debug is True. See slowtimeout for tests with #require slow.
590 590
591 591 slowtimeout overrides timeout if the test has #require slow.
592 592
593 593 startport controls the starting port number to use for this test. Each
594 594 test will reserve 3 port numbers for execution. It is the caller's
595 595 responsibility to allocate a non-overlapping port range to Test
596 596 instances.
597 597
598 598 extraconfigopts is an iterable of extra hgrc config options. Values
599 599 must have the form "key=value" (something understood by hgrc). Values
600 600 of the form "foo.key=value" will result in "[foo] key=value".
601 601
602 602 py3kwarnings enables Py3k warnings.
603 603
604 604 shell is the shell to execute tests in.
605 605 """
606 606 self.path = path
607 607 self.bname = os.path.basename(path)
608 608 self.name = _strpath(self.bname)
609 609 self._testdir = os.path.dirname(path)
610 610 self._outputdir = outputdir
611 611 self._tmpname = os.path.basename(path)
612 612 self.errpath = os.path.join(self._outputdir, b'%s.err' % self.bname)
613 613
614 614 self._threadtmp = tmpdir
615 615 self._keeptmpdir = keeptmpdir
616 616 self._debug = debug
617 617 self._timeout = timeout
618 618 self._slowtimeout = slowtimeout
619 619 self._startport = startport
620 620 self._extraconfigopts = extraconfigopts or []
621 621 self._py3kwarnings = py3kwarnings
622 622 self._shell = _bytespath(shell)
623 623 self._hgcommand = hgcommand or b'hg'
624 624 self._usechg = usechg
625 625 self._useipv6 = useipv6
626 626
627 627 self._aborted = False
628 628 self._daemonpids = []
629 629 self._finished = None
630 630 self._ret = None
631 631 self._out = None
632 632 self._skipped = None
633 633 self._testtmp = None
634 634 self._chgsockdir = None
635 635
636 636 self._refout = self.readrefout()
637 637
638 638 def readrefout(self):
639 639 """read reference output"""
640 640 # If we're not in --debug mode and reference output file exists,
641 641 # check test output against it.
642 642 if self._debug:
643 643 return None # to match "out is None"
644 644 elif os.path.exists(self.refpath):
645 645 with open(self.refpath, 'rb') as f:
646 646 return f.read().splitlines(True)
647 647 else:
648 648 return []
649 649
650 650 # needed to get base class __repr__ running
651 651 @property
652 652 def _testMethodName(self):
653 653 return self.name
654 654
655 655 def __str__(self):
656 656 return self.name
657 657
658 658 def shortDescription(self):
659 659 return self.name
660 660
661 661 def setUp(self):
662 662 """Tasks to perform before run()."""
663 663 self._finished = False
664 664 self._ret = None
665 665 self._out = None
666 666 self._skipped = None
667 667
668 668 try:
669 669 os.mkdir(self._threadtmp)
670 670 except OSError as e:
671 671 if e.errno != errno.EEXIST:
672 672 raise
673 673
674 674 name = self._tmpname
675 675 self._testtmp = os.path.join(self._threadtmp, name)
676 676 os.mkdir(self._testtmp)
677 677
678 678 # Remove any previous output files.
679 679 if os.path.exists(self.errpath):
680 680 try:
681 681 os.remove(self.errpath)
682 682 except OSError as e:
683 683 # We might have raced another test to clean up a .err
684 684 # file, so ignore ENOENT when removing a previous .err
685 685 # file.
686 686 if e.errno != errno.ENOENT:
687 687 raise
688 688
689 689 if self._usechg:
690 690 self._chgsockdir = os.path.join(self._threadtmp,
691 691 b'%s.chgsock' % name)
692 692 os.mkdir(self._chgsockdir)
693 693
694 694 def run(self, result):
695 695 """Run this test and report results against a TestResult instance."""
696 696 # This function is extremely similar to unittest.TestCase.run(). Once
697 697 # we require Python 2.7 (or at least its version of unittest), this
698 698 # function can largely go away.
699 699 self._result = result
700 700 result.startTest(self)
701 701 try:
702 702 try:
703 703 self.setUp()
704 704 except (KeyboardInterrupt, SystemExit):
705 705 self._aborted = True
706 706 raise
707 707 except Exception:
708 708 result.addError(self, sys.exc_info())
709 709 return
710 710
711 711 success = False
712 712 try:
713 713 self.runTest()
714 714 except KeyboardInterrupt:
715 715 self._aborted = True
716 716 raise
717 717 except unittest.SkipTest as e:
718 718 result.addSkip(self, str(e))
719 719 # The base class will have already counted this as a
720 720 # test we "ran", but we want to exclude skipped tests
721 721 # from those we count towards those run.
722 722 result.testsRun -= 1
723 723 except self.failureException as e:
724 724 # This differs from unittest in that we don't capture
725 725 # the stack trace. This is for historical reasons and
726 726 # this decision could be revisited in the future,
727 727 # especially for PythonTest instances.
728 728 if result.addFailure(self, str(e)):
729 729 success = True
730 730 except Exception:
731 731 result.addError(self, sys.exc_info())
732 732 else:
733 733 success = True
734 734
735 735 try:
736 736 self.tearDown()
737 737 except (KeyboardInterrupt, SystemExit):
738 738 self._aborted = True
739 739 raise
740 740 except Exception:
741 741 result.addError(self, sys.exc_info())
742 742 success = False
743 743
744 744 if success:
745 745 result.addSuccess(self)
746 746 finally:
747 747 result.stopTest(self, interrupted=self._aborted)
748 748
749 749 def runTest(self):
750 750 """Run this test instance.
751 751
752 752 This will return a tuple describing the result of the test.
753 753 """
754 754 env = self._getenv()
755 755 self._daemonpids.append(env['DAEMON_PIDS'])
756 756 self._createhgrc(env['HGRCPATH'])
757 757
758 758 vlog('# Test', self.name)
759 759
760 760 ret, out = self._run(env)
761 761 self._finished = True
762 762 self._ret = ret
763 763 self._out = out
764 764
765 765 def describe(ret):
766 766 if ret < 0:
767 767 return 'killed by signal: %d' % -ret
768 768 return 'returned error code %d' % ret
769 769
770 770 self._skipped = False
771 771
772 772 if ret == self.SKIPPED_STATUS:
773 773 if out is None: # Debug mode, nothing to parse.
774 774 missing = ['unknown']
775 775 failed = None
776 776 else:
777 777 missing, failed = TTest.parsehghaveoutput(out)
778 778
779 779 if not missing:
780 780 missing = ['skipped']
781 781
782 782 if failed:
783 783 self.fail('hg have failed checking for %s' % failed[-1])
784 784 else:
785 785 self._skipped = True
786 786 raise unittest.SkipTest(missing[-1])
787 787 elif ret == 'timeout':
788 788 self.fail('timed out')
789 789 elif ret is False:
790 790 self.fail('no result code from test')
791 791 elif out != self._refout:
792 792 # Diff generation may rely on written .err file.
793 793 if (ret != 0 or out != self._refout) and not self._skipped \
794 794 and not self._debug:
795 795 f = open(self.errpath, 'wb')
796 796 for line in out:
797 797 f.write(line)
798 798 f.close()
799 799
800 800 # The result object handles diff calculation for us.
801 801 if self._result.addOutputMismatch(self, ret, out, self._refout):
802 802 # change was accepted, skip failing
803 803 return
804 804
805 805 if ret:
806 806 msg = 'output changed and ' + describe(ret)
807 807 else:
808 808 msg = 'output changed'
809 809
810 810 self.fail(msg)
811 811 elif ret:
812 812 self.fail(describe(ret))
813 813
814 814 def tearDown(self):
815 815 """Tasks to perform after run()."""
816 816 for entry in self._daemonpids:
817 817 killdaemons(entry)
818 818 self._daemonpids = []
819 819
820 820 if self._keeptmpdir:
821 821 log('\nKeeping testtmp dir: %s\nKeeping threadtmp dir: %s' %
822 822 (self._testtmp.decode('utf-8'),
823 823 self._threadtmp.decode('utf-8')))
824 824 else:
825 825 shutil.rmtree(self._testtmp, True)
826 826 shutil.rmtree(self._threadtmp, True)
827 827
828 828 if self._usechg:
829 829 # chgservers will stop automatically after they find the socket
830 830 # files are deleted
831 831 shutil.rmtree(self._chgsockdir, True)
832 832
833 833 if (self._ret != 0 or self._out != self._refout) and not self._skipped \
834 834 and not self._debug and self._out:
835 835 f = open(self.errpath, 'wb')
836 836 for line in self._out:
837 837 f.write(line)
838 838 f.close()
839 839
840 840 vlog("# Ret was:", self._ret, '(%s)' % self.name)
841 841
842 842 def _run(self, env):
843 843 # This should be implemented in child classes to run tests.
844 844 raise unittest.SkipTest('unknown test type')
845 845
846 846 def abort(self):
847 847 """Terminate execution of this test."""
848 848 self._aborted = True
849 849
850 850 def _portmap(self, i):
851 851 offset = b'' if i == 0 else b'%d' % i
852 852 return (br':%d\b' % (self._startport + i), b':$HGPORT%s' % offset)
853 853
854 854 def _getreplacements(self):
855 855 """Obtain a mapping of text replacements to apply to test output.
856 856
857 857 Test output needs to be normalized so it can be compared to expected
858 858 output. This function defines how some of that normalization will
859 859 occur.
860 860 """
861 861 r = [
862 862 # This list should be parallel to defineport in _getenv
863 863 self._portmap(0),
864 864 self._portmap(1),
865 865 self._portmap(2),
866 866 (br'(?m)^(saved backup bundle to .*\.hg)( \(glob\))?$',
867 867 br'\1 (glob)'),
868 868 (br'([^0-9])%s' % re.escape(self._localip()), br'\1$LOCALIP'),
869 869 (br'\bHG_TXNID=TXN:[a-f0-9]{40}\b', br'HG_TXNID=TXN:$ID$'),
870 870 ]
871 871 r.append((self._escapepath(self._testtmp), b'$TESTTMP'))
872 872
873 873 return r
874 874
875 875 def _escapepath(self, p):
876 876 if os.name == 'nt':
877 877 return (
878 878 (b''.join(c.isalpha() and b'[%s%s]' % (c.lower(), c.upper()) or
879 879 c in b'/\\' and br'[/\\]' or c.isdigit() and c or b'\\' + c
880 880 for c in p))
881 881 )
882 882 else:
883 883 return re.escape(p)
884 884
885 885 def _localip(self):
886 886 if self._useipv6:
887 887 return b'::1'
888 888 else:
889 889 return b'127.0.0.1'
890 890
891 891 def _getenv(self):
892 892 """Obtain environment variables to use during test execution."""
893 893 def defineport(i):
894 894 offset = '' if i == 0 else '%s' % i
895 895 env["HGPORT%s" % offset] = '%s' % (self._startport + i)
896 896 env = os.environ.copy()
897 897 env['PYTHONUSERBASE'] = sysconfig.get_config_var('userbase')
898 898 env['HGEMITWARNINGS'] = '1'
899 899 env['TESTTMP'] = self._testtmp
900 900 env['HOME'] = self._testtmp
901 901 # This number should match portneeded in _getport
902 902 for port in xrange(3):
903 903 # This list should be parallel to _portmap in _getreplacements
904 904 defineport(port)
905 905 env["HGRCPATH"] = os.path.join(self._threadtmp, b'.hgrc')
906 906 env["DAEMON_PIDS"] = os.path.join(self._threadtmp, b'daemon.pids')
907 907 env["HGEDITOR"] = ('"' + sys.executable + '"'
908 908 + ' -c "import sys; sys.exit(0)"')
909 909 env["HGMERGE"] = "internal:merge"
910 910 env["HGUSER"] = "test"
911 911 env["HGENCODING"] = "ascii"
912 912 env["HGENCODINGMODE"] = "strict"
913 913 env['HGIPV6'] = str(int(self._useipv6))
914 914
915 915 # LOCALIP could be ::1 or 127.0.0.1. Useful for tests that require raw
916 916 # IP addresses.
917 917 env['LOCALIP'] = self._localip()
918 918
919 919 # Reset some environment variables to well-known values so that
920 920 # the tests produce repeatable output.
921 921 env['LANG'] = env['LC_ALL'] = env['LANGUAGE'] = 'C'
922 922 env['TZ'] = 'GMT'
923 923 env["EMAIL"] = "Foo Bar <foo.bar@example.com>"
924 924 env['COLUMNS'] = '80'
925 925 env['TERM'] = 'xterm'
926 926
927 927 for k in ('HG HGPROF CDPATH GREP_OPTIONS http_proxy no_proxy ' +
928 928 'HGPLAIN HGPLAINEXCEPT EDITOR VISUAL PAGER ' +
929 929 'NO_PROXY CHGDEBUG').split():
930 930 if k in env:
931 931 del env[k]
932 932
933 933 # unset env related to hooks
934 934 for k in env.keys():
935 935 if k.startswith('HG_'):
936 936 del env[k]
937 937
938 938 if self._usechg:
939 939 env['CHGSOCKNAME'] = os.path.join(self._chgsockdir, b'server')
940 940
941 941 return env
942 942
943 943 def _createhgrc(self, path):
944 944 """Create an hgrc file for this test."""
945 945 hgrc = open(path, 'wb')
946 946 hgrc.write(b'[ui]\n')
947 947 hgrc.write(b'slash = True\n')
948 948 hgrc.write(b'interactive = False\n')
949 949 hgrc.write(b'mergemarkers = detailed\n')
950 950 hgrc.write(b'promptecho = True\n')
951 951 hgrc.write(b'[defaults]\n')
952 952 hgrc.write(b'[devel]\n')
953 953 hgrc.write(b'all-warnings = true\n')
954 954 hgrc.write(b'default-date = 0 0\n')
955 955 hgrc.write(b'[largefiles]\n')
956 956 hgrc.write(b'usercache = %s\n' %
957 957 (os.path.join(self._testtmp, b'.cache/largefiles')))
958 958 hgrc.write(b'[web]\n')
959 959 hgrc.write(b'address = localhost\n')
960 960 hgrc.write(b'ipv6 = %s\n' % str(self._useipv6).encode('ascii'))
961 961
962 962 for opt in self._extraconfigopts:
963 963 section, key = opt.split('.', 1)
964 964 assert '=' in key, ('extra config opt %s must '
965 965 'have an = for assignment' % opt)
966 966 hgrc.write(b'[%s]\n%s\n' % (section, key))
967 967 hgrc.close()
968 968
969 969 def fail(self, msg):
970 970 # unittest differentiates between errored and failed.
971 971 # Failed is denoted by AssertionError (by default at least).
972 972 raise AssertionError(msg)
973 973
974 974 def _runcommand(self, cmd, env, normalizenewlines=False):
975 975 """Run command in a sub-process, capturing the output (stdout and
976 976 stderr).
977 977
978 978 Return a tuple (exitcode, output). output is None in debug mode.
979 979 """
980 980 if self._debug:
981 981 proc = subprocess.Popen(cmd, shell=True, cwd=self._testtmp,
982 982 env=env)
983 983 ret = proc.wait()
984 984 return (ret, None)
985 985
986 986 proc = Popen4(cmd, self._testtmp, self._timeout, env)
987 987 def cleanup():
988 988 terminate(proc)
989 989 ret = proc.wait()
990 990 if ret == 0:
991 991 ret = signal.SIGTERM << 8
992 992 killdaemons(env['DAEMON_PIDS'])
993 993 return ret
994 994
995 995 output = ''
996 996 proc.tochild.close()
997 997
998 998 try:
999 999 output = proc.fromchild.read()
1000 1000 except KeyboardInterrupt:
1001 1001 vlog('# Handling keyboard interrupt')
1002 1002 cleanup()
1003 1003 raise
1004 1004
1005 1005 ret = proc.wait()
1006 1006 if wifexited(ret):
1007 1007 ret = os.WEXITSTATUS(ret)
1008 1008
1009 1009 if proc.timeout:
1010 1010 ret = 'timeout'
1011 1011
1012 1012 if ret:
1013 1013 killdaemons(env['DAEMON_PIDS'])
1014 1014
1015 1015 for s, r in self._getreplacements():
1016 1016 output = re.sub(s, r, output)
1017 1017
1018 1018 if normalizenewlines:
1019 1019 output = output.replace('\r\n', '\n')
1020 1020
1021 1021 return ret, output.splitlines(True)
1022 1022
1023 1023 class PythonTest(Test):
1024 1024 """A Python-based test."""
1025 1025
1026 1026 @property
1027 1027 def refpath(self):
1028 1028 return os.path.join(self._testdir, b'%s.out' % self.bname)
1029 1029
1030 1030 def _run(self, env):
1031 1031 py3kswitch = self._py3kwarnings and b' -3' or b''
1032 1032 cmd = b'%s%s "%s"' % (PYTHON, py3kswitch, self.path)
1033 1033 vlog("# Running", cmd)
1034 1034 normalizenewlines = os.name == 'nt'
1035 1035 result = self._runcommand(cmd, env,
1036 1036 normalizenewlines=normalizenewlines)
1037 1037 if self._aborted:
1038 1038 raise KeyboardInterrupt()
1039 1039
1040 1040 return result
1041 1041
1042 1042 # Some glob patterns apply only in some circumstances, so the script
1043 1043 # might want to remove (glob) annotations that otherwise should be
1044 1044 # retained.
1045 1045 checkcodeglobpats = [
1046 1046 # On Windows it looks like \ doesn't require a (glob), but we know
1047 1047 # better.
1048 1048 re.compile(br'^pushing to \$TESTTMP/.*[^)]$'),
1049 1049 re.compile(br'^moving \S+/.*[^)]$'),
1050 1050 re.compile(br'^pulling from \$TESTTMP/.*[^)]$'),
1051 1051 # Not all platforms have 127.0.0.1 as loopback (though most do),
1052 1052 # so we always glob that too.
1053 1053 re.compile(br'.*\$LOCALIP.*$'),
1054 1054 ]
1055 1055
1056 1056 bchr = chr
1057 1057 if PYTHON3:
1058 1058 bchr = lambda x: bytes([x])
1059 1059
1060 1060 class TTest(Test):
1061 1061 """A "t test" is a test backed by a .t file."""
1062 1062
1063 1063 SKIPPED_PREFIX = b'skipped: '
1064 1064 FAILED_PREFIX = b'hghave check failed: '
1065 1065 NEEDESCAPE = re.compile(br'[\x00-\x08\x0b-\x1f\x7f-\xff]').search
1066 1066
1067 1067 ESCAPESUB = re.compile(br'[\x00-\x08\x0b-\x1f\\\x7f-\xff]').sub
1068 1068 ESCAPEMAP = dict((bchr(i), br'\x%02x' % i) for i in range(256))
1069 1069 ESCAPEMAP.update({b'\\': b'\\\\', b'\r': br'\r'})
1070 1070
1071 1071 def __init__(self, path, *args, **kwds):
1072 1072 # accept an extra "case" parameter
1073 1073 case = None
1074 1074 if 'case' in kwds:
1075 1075 case = kwds.pop('case')
1076 1076 self._case = case
1077 1077 self._allcases = parsettestcases(path)
1078 1078 super(TTest, self).__init__(path, *args, **kwds)
1079 1079 if case:
1080 1080 self.name = '%s (case %s)' % (self.name, _strpath(case))
1081 1081 self.errpath = b'%s.%s.err' % (self.errpath[:-4], case)
1082 1082 self._tmpname += b'-%s' % case
1083 1083
1084 1084 @property
1085 1085 def refpath(self):
1086 1086 return os.path.join(self._testdir, self.bname)
1087 1087
1088 1088 def _run(self, env):
1089 1089 f = open(self.path, 'rb')
1090 1090 lines = f.readlines()
1091 1091 f.close()
1092 1092
1093 # .t file is both reference output and the test input, keep reference
1094 # output updated with the the test input. This avoids some race
1095 # conditions where the reference output does not match the actual test.
1096 if self._refout is not None:
1097 self._refout = lines
1098
1093 1099 salt, script, after, expected = self._parsetest(lines)
1094 1100
1095 1101 # Write out the generated script.
1096 1102 fname = b'%s.sh' % self._testtmp
1097 1103 f = open(fname, 'wb')
1098 1104 for l in script:
1099 1105 f.write(l)
1100 1106 f.close()
1101 1107
1102 1108 cmd = b'%s "%s"' % (self._shell, fname)
1103 1109 vlog("# Running", cmd)
1104 1110
1105 1111 exitcode, output = self._runcommand(cmd, env)
1106 1112
1107 1113 if self._aborted:
1108 1114 raise KeyboardInterrupt()
1109 1115
1110 1116 # Do not merge output if skipped. Return hghave message instead.
1111 1117 # Similarly, with --debug, output is None.
1112 1118 if exitcode == self.SKIPPED_STATUS or output is None:
1113 1119 return exitcode, output
1114 1120
1115 1121 return self._processoutput(exitcode, output, salt, after, expected)
1116 1122
1117 1123 def _hghave(self, reqs):
1118 1124 # TODO do something smarter when all other uses of hghave are gone.
1119 1125 runtestdir = os.path.abspath(os.path.dirname(_bytespath(__file__)))
1120 1126 tdir = runtestdir.replace(b'\\', b'/')
1121 1127 proc = Popen4(b'%s -c "%s/hghave %s"' %
1122 1128 (self._shell, tdir, b' '.join(reqs)),
1123 1129 self._testtmp, 0, self._getenv())
1124 1130 stdout, stderr = proc.communicate()
1125 1131 ret = proc.wait()
1126 1132 if wifexited(ret):
1127 1133 ret = os.WEXITSTATUS(ret)
1128 1134 if ret == 2:
1129 1135 print(stdout.decode('utf-8'))
1130 1136 sys.exit(1)
1131 1137
1132 1138 if ret != 0:
1133 1139 return False, stdout
1134 1140
1135 1141 if 'slow' in reqs:
1136 1142 self._timeout = self._slowtimeout
1137 1143 return True, None
1138 1144
1139 1145 def _iftest(self, args):
1140 1146 # implements "#if"
1141 1147 reqs = []
1142 1148 for arg in args:
1143 1149 if arg.startswith(b'no-') and arg[3:] in self._allcases:
1144 1150 if arg[3:] == self._case:
1145 1151 return False
1146 1152 elif arg in self._allcases:
1147 1153 if arg != self._case:
1148 1154 return False
1149 1155 else:
1150 1156 reqs.append(arg)
1151 1157 return self._hghave(reqs)[0]
1152 1158
1153 1159 def _parsetest(self, lines):
1154 1160 # We generate a shell script which outputs unique markers to line
1155 1161 # up script results with our source. These markers include input
1156 1162 # line number and the last return code.
1157 1163 salt = b"SALT%d" % time.time()
1158 1164 def addsalt(line, inpython):
1159 1165 if inpython:
1160 1166 script.append(b'%s %d 0\n' % (salt, line))
1161 1167 else:
1162 1168 script.append(b'echo %s %d $?\n' % (salt, line))
1163 1169
1164 1170 script = []
1165 1171
1166 1172 # After we run the shell script, we re-unify the script output
1167 1173 # with non-active parts of the source, with synchronization by our
1168 1174 # SALT line number markers. The after table contains the non-active
1169 1175 # components, ordered by line number.
1170 1176 after = {}
1171 1177
1172 1178 # Expected shell script output.
1173 1179 expected = {}
1174 1180
1175 1181 pos = prepos = -1
1176 1182
1177 1183 # True or False when in a true or false conditional section
1178 1184 skipping = None
1179 1185
1180 1186 # We keep track of whether or not we're in a Python block so we
1181 1187 # can generate the surrounding doctest magic.
1182 1188 inpython = False
1183 1189
1184 1190 if self._debug:
1185 1191 script.append(b'set -x\n')
1186 1192 if self._hgcommand != b'hg':
1187 1193 script.append(b'alias hg="%s"\n' % self._hgcommand)
1188 1194 if os.getenv('MSYSTEM'):
1189 1195 script.append(b'alias pwd="pwd -W"\n')
1190 1196
1191 1197 n = 0
1192 1198 for n, l in enumerate(lines):
1193 1199 if not l.endswith(b'\n'):
1194 1200 l += b'\n'
1195 1201 if l.startswith(b'#require'):
1196 1202 lsplit = l.split()
1197 1203 if len(lsplit) < 2 or lsplit[0] != b'#require':
1198 1204 after.setdefault(pos, []).append(' !!! invalid #require\n')
1199 1205 haveresult, message = self._hghave(lsplit[1:])
1200 1206 if not haveresult:
1201 1207 script = [b'echo "%s"\nexit 80\n' % message]
1202 1208 break
1203 1209 after.setdefault(pos, []).append(l)
1204 1210 elif l.startswith(b'#if'):
1205 1211 lsplit = l.split()
1206 1212 if len(lsplit) < 2 or lsplit[0] != b'#if':
1207 1213 after.setdefault(pos, []).append(' !!! invalid #if\n')
1208 1214 if skipping is not None:
1209 1215 after.setdefault(pos, []).append(' !!! nested #if\n')
1210 1216 skipping = not self._iftest(lsplit[1:])
1211 1217 after.setdefault(pos, []).append(l)
1212 1218 elif l.startswith(b'#else'):
1213 1219 if skipping is None:
1214 1220 after.setdefault(pos, []).append(' !!! missing #if\n')
1215 1221 skipping = not skipping
1216 1222 after.setdefault(pos, []).append(l)
1217 1223 elif l.startswith(b'#endif'):
1218 1224 if skipping is None:
1219 1225 after.setdefault(pos, []).append(' !!! missing #if\n')
1220 1226 skipping = None
1221 1227 after.setdefault(pos, []).append(l)
1222 1228 elif skipping:
1223 1229 after.setdefault(pos, []).append(l)
1224 1230 elif l.startswith(b' >>> '): # python inlines
1225 1231 after.setdefault(pos, []).append(l)
1226 1232 prepos = pos
1227 1233 pos = n
1228 1234 if not inpython:
1229 1235 # We've just entered a Python block. Add the header.
1230 1236 inpython = True
1231 1237 addsalt(prepos, False) # Make sure we report the exit code.
1232 1238 script.append(b'%s -m heredoctest <<EOF\n' % PYTHON)
1233 1239 addsalt(n, True)
1234 1240 script.append(l[2:])
1235 1241 elif l.startswith(b' ... '): # python inlines
1236 1242 after.setdefault(prepos, []).append(l)
1237 1243 script.append(l[2:])
1238 1244 elif l.startswith(b' $ '): # commands
1239 1245 if inpython:
1240 1246 script.append(b'EOF\n')
1241 1247 inpython = False
1242 1248 after.setdefault(pos, []).append(l)
1243 1249 prepos = pos
1244 1250 pos = n
1245 1251 addsalt(n, False)
1246 1252 cmd = l[4:].split()
1247 1253 if len(cmd) == 2 and cmd[0] == b'cd':
1248 1254 l = b' $ cd %s || exit 1\n' % cmd[1]
1249 1255 script.append(l[4:])
1250 1256 elif l.startswith(b' > '): # continuations
1251 1257 after.setdefault(prepos, []).append(l)
1252 1258 script.append(l[4:])
1253 1259 elif l.startswith(b' '): # results
1254 1260 # Queue up a list of expected results.
1255 1261 expected.setdefault(pos, []).append(l[2:])
1256 1262 else:
1257 1263 if inpython:
1258 1264 script.append(b'EOF\n')
1259 1265 inpython = False
1260 1266 # Non-command/result. Queue up for merged output.
1261 1267 after.setdefault(pos, []).append(l)
1262 1268
1263 1269 if inpython:
1264 1270 script.append(b'EOF\n')
1265 1271 if skipping is not None:
1266 1272 after.setdefault(pos, []).append(' !!! missing #endif\n')
1267 1273 addsalt(n + 1, False)
1268 1274
1269 1275 return salt, script, after, expected
1270 1276
1271 1277 def _processoutput(self, exitcode, output, salt, after, expected):
1272 1278 # Merge the script output back into a unified test.
1273 1279 warnonly = 1 # 1: not yet; 2: yes; 3: for sure not
1274 1280 if exitcode != 0:
1275 1281 warnonly = 3
1276 1282
1277 1283 pos = -1
1278 1284 postout = []
1279 1285 for l in output:
1280 1286 lout, lcmd = l, None
1281 1287 if salt in l:
1282 1288 lout, lcmd = l.split(salt, 1)
1283 1289
1284 1290 while lout:
1285 1291 if not lout.endswith(b'\n'):
1286 1292 lout += b' (no-eol)\n'
1287 1293
1288 1294 # Find the expected output at the current position.
1289 1295 els = [None]
1290 1296 if expected.get(pos, None):
1291 1297 els = expected[pos]
1292 1298
1293 1299 i = 0
1294 1300 optional = []
1295 1301 while i < len(els):
1296 1302 el = els[i]
1297 1303
1298 1304 r = TTest.linematch(el, lout)
1299 1305 if isinstance(r, str):
1300 1306 if r == '+glob':
1301 1307 lout = el[:-1] + ' (glob)\n'
1302 1308 r = '' # Warn only this line.
1303 1309 elif r == '-glob':
1304 1310 lout = ''.join(el.rsplit(' (glob)', 1))
1305 1311 r = '' # Warn only this line.
1306 1312 elif r == "retry":
1307 1313 postout.append(b' ' + el)
1308 1314 els.pop(i)
1309 1315 break
1310 1316 else:
1311 1317 log('\ninfo, unknown linematch result: %r\n' % r)
1312 1318 r = False
1313 1319 if r:
1314 1320 els.pop(i)
1315 1321 break
1316 1322 if el:
1317 1323 if el.endswith(b" (?)\n"):
1318 1324 optional.append(i)
1319 1325 else:
1320 1326 m = optline.match(el)
1321 1327 if m:
1322 1328 conditions = [c for c in m.group(2).split(' ')]
1323 1329
1324 1330 if self._hghave(conditions)[0]:
1325 1331 lout = el
1326 1332 else:
1327 1333 optional.append(i)
1328 1334
1329 1335 i += 1
1330 1336
1331 1337 if r:
1332 1338 if r == "retry":
1333 1339 continue
1334 1340 # clean up any optional leftovers
1335 1341 for i in optional:
1336 1342 postout.append(b' ' + els[i])
1337 1343 for i in reversed(optional):
1338 1344 del els[i]
1339 1345 postout.append(b' ' + el)
1340 1346 else:
1341 1347 if self.NEEDESCAPE(lout):
1342 1348 lout = TTest._stringescape(b'%s (esc)\n' %
1343 1349 lout.rstrip(b'\n'))
1344 1350 postout.append(b' ' + lout) # Let diff deal with it.
1345 1351 if r != '': # If line failed.
1346 1352 warnonly = 3 # for sure not
1347 1353 elif warnonly == 1: # Is "not yet" and line is warn only.
1348 1354 warnonly = 2 # Yes do warn.
1349 1355 break
1350 1356 else:
1351 1357 # clean up any optional leftovers
1352 1358 while expected.get(pos, None):
1353 1359 el = expected[pos].pop(0)
1354 1360 if el:
1355 1361 if (not optline.match(el)
1356 1362 and not el.endswith(b" (?)\n")):
1357 1363 break
1358 1364 postout.append(b' ' + el)
1359 1365
1360 1366 if lcmd:
1361 1367 # Add on last return code.
1362 1368 ret = int(lcmd.split()[1])
1363 1369 if ret != 0:
1364 1370 postout.append(b' [%d]\n' % ret)
1365 1371 if pos in after:
1366 1372 # Merge in non-active test bits.
1367 1373 postout += after.pop(pos)
1368 1374 pos = int(lcmd.split()[0])
1369 1375
1370 1376 if pos in after:
1371 1377 postout += after.pop(pos)
1372 1378
1373 1379 if warnonly == 2:
1374 1380 exitcode = False # Set exitcode to warned.
1375 1381
1376 1382 return exitcode, postout
1377 1383
1378 1384 @staticmethod
1379 1385 def rematch(el, l):
1380 1386 try:
1381 1387 # use \Z to ensure that the regex matches to the end of the string
1382 1388 if os.name == 'nt':
1383 1389 return re.match(el + br'\r?\n\Z', l)
1384 1390 return re.match(el + br'\n\Z', l)
1385 1391 except re.error:
1386 1392 # el is an invalid regex
1387 1393 return False
1388 1394
1389 1395 @staticmethod
1390 1396 def globmatch(el, l):
1391 1397 # The only supported special characters are * and ? plus / which also
1392 1398 # matches \ on windows. Escaping of these characters is supported.
1393 1399 if el + b'\n' == l:
1394 1400 if os.altsep:
1395 1401 # matching on "/" is not needed for this line
1396 1402 for pat in checkcodeglobpats:
1397 1403 if pat.match(el):
1398 1404 return True
1399 1405 return b'-glob'
1400 1406 return True
1401 1407 el = el.replace(b'$LOCALIP', b'*')
1402 1408 i, n = 0, len(el)
1403 1409 res = b''
1404 1410 while i < n:
1405 1411 c = el[i:i + 1]
1406 1412 i += 1
1407 1413 if c == b'\\' and i < n and el[i:i + 1] in b'*?\\/':
1408 1414 res += el[i - 1:i + 1]
1409 1415 i += 1
1410 1416 elif c == b'*':
1411 1417 res += b'.*'
1412 1418 elif c == b'?':
1413 1419 res += b'.'
1414 1420 elif c == b'/' and os.altsep:
1415 1421 res += b'[/\\\\]'
1416 1422 else:
1417 1423 res += re.escape(c)
1418 1424 return TTest.rematch(res, l)
1419 1425
1420 1426 @staticmethod
1421 1427 def linematch(el, l):
1422 1428 retry = False
1423 1429 if el == l: # perfect match (fast)
1424 1430 return True
1425 1431 if el:
1426 1432 if el.endswith(b" (?)\n"):
1427 1433 retry = "retry"
1428 1434 el = el[:-5] + b"\n"
1429 1435 else:
1430 1436 m = optline.match(el)
1431 1437 if m:
1432 1438 el = m.group(1) + b"\n"
1433 1439 retry = "retry"
1434 1440
1435 1441 if el.endswith(b" (esc)\n"):
1436 1442 if PYTHON3:
1437 1443 el = el[:-7].decode('unicode_escape') + '\n'
1438 1444 el = el.encode('utf-8')
1439 1445 else:
1440 1446 el = el[:-7].decode('string-escape') + '\n'
1441 1447 if el == l or os.name == 'nt' and el[:-1] + b'\r\n' == l:
1442 1448 return True
1443 1449 if el.endswith(b" (re)\n"):
1444 1450 return TTest.rematch(el[:-6], l) or retry
1445 1451 if el.endswith(b" (glob)\n"):
1446 1452 # ignore '(glob)' added to l by 'replacements'
1447 1453 if l.endswith(b" (glob)\n"):
1448 1454 l = l[:-8] + b"\n"
1449 1455 return TTest.globmatch(el[:-8], l) or retry
1450 1456 if os.altsep and l.replace(b'\\', b'/') == el:
1451 1457 return b'+glob'
1452 1458 return retry
1453 1459
1454 1460 @staticmethod
1455 1461 def parsehghaveoutput(lines):
1456 1462 '''Parse hghave log lines.
1457 1463
1458 1464 Return tuple of lists (missing, failed):
1459 1465 * the missing/unknown features
1460 1466 * the features for which existence check failed'''
1461 1467 missing = []
1462 1468 failed = []
1463 1469 for line in lines:
1464 1470 if line.startswith(TTest.SKIPPED_PREFIX):
1465 1471 line = line.splitlines()[0]
1466 1472 missing.append(line[len(TTest.SKIPPED_PREFIX):].decode('utf-8'))
1467 1473 elif line.startswith(TTest.FAILED_PREFIX):
1468 1474 line = line.splitlines()[0]
1469 1475 failed.append(line[len(TTest.FAILED_PREFIX):].decode('utf-8'))
1470 1476
1471 1477 return missing, failed
1472 1478
1473 1479 @staticmethod
1474 1480 def _escapef(m):
1475 1481 return TTest.ESCAPEMAP[m.group(0)]
1476 1482
1477 1483 @staticmethod
1478 1484 def _stringescape(s):
1479 1485 return TTest.ESCAPESUB(TTest._escapef, s)
1480 1486
1481 1487 iolock = threading.RLock()
1482 1488
1483 1489 class TestResult(unittest._TextTestResult):
1484 1490 """Holds results when executing via unittest."""
1485 1491 # Don't worry too much about accessing the non-public _TextTestResult.
1486 1492 # It is relatively common in Python testing tools.
1487 1493 def __init__(self, options, *args, **kwargs):
1488 1494 super(TestResult, self).__init__(*args, **kwargs)
1489 1495
1490 1496 self._options = options
1491 1497
1492 1498 # unittest.TestResult didn't have skipped until 2.7. We need to
1493 1499 # polyfill it.
1494 1500 self.skipped = []
1495 1501
1496 1502 # We have a custom "ignored" result that isn't present in any Python
1497 1503 # unittest implementation. It is very similar to skipped. It may make
1498 1504 # sense to map it into skip some day.
1499 1505 self.ignored = []
1500 1506
1501 1507 self.times = []
1502 1508 self._firststarttime = None
1503 1509 # Data stored for the benefit of generating xunit reports.
1504 1510 self.successes = []
1505 1511 self.faildata = {}
1506 1512
1507 1513 def addFailure(self, test, reason):
1508 1514 self.failures.append((test, reason))
1509 1515
1510 1516 if self._options.first:
1511 1517 self.stop()
1512 1518 else:
1513 1519 with iolock:
1514 1520 if reason == "timed out":
1515 1521 self.stream.write('t')
1516 1522 else:
1517 1523 if not self._options.nodiff:
1518 1524 self.stream.write('\nERROR: %s output changed\n' % test)
1519 1525 self.stream.write('!')
1520 1526
1521 1527 self.stream.flush()
1522 1528
1523 1529 def addSuccess(self, test):
1524 1530 with iolock:
1525 1531 super(TestResult, self).addSuccess(test)
1526 1532 self.successes.append(test)
1527 1533
1528 1534 def addError(self, test, err):
1529 1535 super(TestResult, self).addError(test, err)
1530 1536 if self._options.first:
1531 1537 self.stop()
1532 1538
1533 1539 # Polyfill.
1534 1540 def addSkip(self, test, reason):
1535 1541 self.skipped.append((test, reason))
1536 1542 with iolock:
1537 1543 if self.showAll:
1538 1544 self.stream.writeln('skipped %s' % reason)
1539 1545 else:
1540 1546 self.stream.write('s')
1541 1547 self.stream.flush()
1542 1548
1543 1549 def addIgnore(self, test, reason):
1544 1550 self.ignored.append((test, reason))
1545 1551 with iolock:
1546 1552 if self.showAll:
1547 1553 self.stream.writeln('ignored %s' % reason)
1548 1554 else:
1549 1555 if reason not in ('not retesting', "doesn't match keyword"):
1550 1556 self.stream.write('i')
1551 1557 else:
1552 1558 self.testsRun += 1
1553 1559 self.stream.flush()
1554 1560
1555 1561 def addOutputMismatch(self, test, ret, got, expected):
1556 1562 """Record a mismatch in test output for a particular test."""
1557 1563 if self.shouldStop:
1558 1564 # don't print, some other test case already failed and
1559 1565 # printed, we're just stale and probably failed due to our
1560 1566 # temp dir getting cleaned up.
1561 1567 return
1562 1568
1563 1569 accepted = False
1564 1570 lines = []
1565 1571
1566 1572 with iolock:
1567 1573 if self._options.nodiff:
1568 1574 pass
1569 1575 elif self._options.view:
1570 1576 v = self._options.view
1571 1577 if PYTHON3:
1572 1578 v = _bytespath(v)
1573 1579 os.system(b"%s %s %s" %
1574 1580 (v, test.refpath, test.errpath))
1575 1581 else:
1576 1582 servefail, lines = getdiff(expected, got,
1577 1583 test.refpath, test.errpath)
1578 1584 if servefail:
1579 1585 raise test.failureException(
1580 1586 'server failed to start (HGPORT=%s)' % test._startport)
1581 1587 else:
1582 1588 self.stream.write('\n')
1583 1589 for line in lines:
1584 1590 if PYTHON3:
1585 1591 self.stream.flush()
1586 1592 self.stream.buffer.write(line)
1587 1593 self.stream.buffer.flush()
1588 1594 else:
1589 1595 self.stream.write(line)
1590 1596 self.stream.flush()
1591 1597
1592 1598 # handle interactive prompt without releasing iolock
1593 1599 if self._options.interactive:
1594 1600 if test.readrefout() != expected:
1595 1601 self.stream.write(
1596 1602 'Reference output has changed (run again to prompt '
1597 1603 'changes)')
1598 1604 else:
1599 1605 self.stream.write('Accept this change? [n] ')
1600 1606 answer = sys.stdin.readline().strip()
1601 1607 if answer.lower() in ('y', 'yes'):
1602 1608 if test.name.endswith('.t'):
1603 1609 rename(test.errpath, test.path)
1604 1610 else:
1605 1611 rename(test.errpath, '%s.out' % test.path)
1606 1612 accepted = True
1607 1613 if not accepted:
1608 1614 self.faildata[test.name] = b''.join(lines)
1609 1615
1610 1616 return accepted
1611 1617
1612 1618 def startTest(self, test):
1613 1619 super(TestResult, self).startTest(test)
1614 1620
1615 1621 # os.times module computes the user time and system time spent by
1616 1622 # child's processes along with real elapsed time taken by a process.
1617 1623 # This module has one limitation. It can only work for Linux user
1618 1624 # and not for Windows.
1619 1625 test.started = os.times()
1620 1626 if self._firststarttime is None: # thread racy but irrelevant
1621 1627 self._firststarttime = test.started[4]
1622 1628
1623 1629 def stopTest(self, test, interrupted=False):
1624 1630 super(TestResult, self).stopTest(test)
1625 1631
1626 1632 test.stopped = os.times()
1627 1633
1628 1634 starttime = test.started
1629 1635 endtime = test.stopped
1630 1636 origin = self._firststarttime
1631 1637 self.times.append((test.name,
1632 1638 endtime[2] - starttime[2], # user space CPU time
1633 1639 endtime[3] - starttime[3], # sys space CPU time
1634 1640 endtime[4] - starttime[4], # real time
1635 1641 starttime[4] - origin, # start date in run context
1636 1642 endtime[4] - origin, # end date in run context
1637 1643 ))
1638 1644
1639 1645 if interrupted:
1640 1646 with iolock:
1641 1647 self.stream.writeln('INTERRUPTED: %s (after %d seconds)' % (
1642 1648 test.name, self.times[-1][3]))
1643 1649
1644 1650 class TestSuite(unittest.TestSuite):
1645 1651 """Custom unittest TestSuite that knows how to execute Mercurial tests."""
1646 1652
1647 1653 def __init__(self, testdir, jobs=1, whitelist=None, blacklist=None,
1648 1654 retest=False, keywords=None, loop=False, runs_per_test=1,
1649 1655 loadtest=None, showchannels=False,
1650 1656 *args, **kwargs):
1651 1657 """Create a new instance that can run tests with a configuration.
1652 1658
1653 1659 testdir specifies the directory where tests are executed from. This
1654 1660 is typically the ``tests`` directory from Mercurial's source
1655 1661 repository.
1656 1662
1657 1663 jobs specifies the number of jobs to run concurrently. Each test
1658 1664 executes on its own thread. Tests actually spawn new processes, so
1659 1665 state mutation should not be an issue.
1660 1666
1661 1667 If there is only one job, it will use the main thread.
1662 1668
1663 1669 whitelist and blacklist denote tests that have been whitelisted and
1664 1670 blacklisted, respectively. These arguments don't belong in TestSuite.
1665 1671 Instead, whitelist and blacklist should be handled by the thing that
1666 1672 populates the TestSuite with tests. They are present to preserve
1667 1673 backwards compatible behavior which reports skipped tests as part
1668 1674 of the results.
1669 1675
1670 1676 retest denotes whether to retest failed tests. This arguably belongs
1671 1677 outside of TestSuite.
1672 1678
1673 1679 keywords denotes key words that will be used to filter which tests
1674 1680 to execute. This arguably belongs outside of TestSuite.
1675 1681
1676 1682 loop denotes whether to loop over tests forever.
1677 1683 """
1678 1684 super(TestSuite, self).__init__(*args, **kwargs)
1679 1685
1680 1686 self._jobs = jobs
1681 1687 self._whitelist = whitelist
1682 1688 self._blacklist = blacklist
1683 1689 self._retest = retest
1684 1690 self._keywords = keywords
1685 1691 self._loop = loop
1686 1692 self._runs_per_test = runs_per_test
1687 1693 self._loadtest = loadtest
1688 1694 self._showchannels = showchannels
1689 1695
1690 1696 def run(self, result):
1691 1697 # We have a number of filters that need to be applied. We do this
1692 1698 # here instead of inside Test because it makes the running logic for
1693 1699 # Test simpler.
1694 1700 tests = []
1695 1701 num_tests = [0]
1696 1702 for test in self._tests:
1697 1703 def get():
1698 1704 num_tests[0] += 1
1699 1705 if getattr(test, 'should_reload', False):
1700 1706 return self._loadtest(test, num_tests[0])
1701 1707 return test
1702 1708 if not os.path.exists(test.path):
1703 1709 result.addSkip(test, "Doesn't exist")
1704 1710 continue
1705 1711
1706 1712 if not (self._whitelist and test.name in self._whitelist):
1707 1713 if self._blacklist and test.bname in self._blacklist:
1708 1714 result.addSkip(test, 'blacklisted')
1709 1715 continue
1710 1716
1711 1717 if self._retest and not os.path.exists(test.errpath):
1712 1718 result.addIgnore(test, 'not retesting')
1713 1719 continue
1714 1720
1715 1721 if self._keywords:
1716 1722 f = open(test.path, 'rb')
1717 1723 t = f.read().lower() + test.bname.lower()
1718 1724 f.close()
1719 1725 ignored = False
1720 1726 for k in self._keywords.lower().split():
1721 1727 if k not in t:
1722 1728 result.addIgnore(test, "doesn't match keyword")
1723 1729 ignored = True
1724 1730 break
1725 1731
1726 1732 if ignored:
1727 1733 continue
1728 1734 for _ in xrange(self._runs_per_test):
1729 1735 tests.append(get())
1730 1736
1731 1737 runtests = list(tests)
1732 1738 done = queue.Queue()
1733 1739 running = 0
1734 1740
1735 1741 channels = [""] * self._jobs
1736 1742
1737 1743 def job(test, result):
1738 1744 for n, v in enumerate(channels):
1739 1745 if not v:
1740 1746 channel = n
1741 1747 break
1742 1748 else:
1743 1749 raise ValueError('Could not find output channel')
1744 1750 channels[channel] = "=" + test.name[5:].split(".")[0]
1745 1751 try:
1746 1752 test(result)
1747 1753 done.put(None)
1748 1754 except KeyboardInterrupt:
1749 1755 pass
1750 1756 except: # re-raises
1751 1757 done.put(('!', test, 'run-test raised an error, see traceback'))
1752 1758 raise
1753 1759 finally:
1754 1760 try:
1755 1761 channels[channel] = ''
1756 1762 except IndexError:
1757 1763 pass
1758 1764
1759 1765 def stat():
1760 1766 count = 0
1761 1767 while channels:
1762 1768 d = '\n%03s ' % count
1763 1769 for n, v in enumerate(channels):
1764 1770 if v:
1765 1771 d += v[0]
1766 1772 channels[n] = v[1:] or '.'
1767 1773 else:
1768 1774 d += ' '
1769 1775 d += ' '
1770 1776 with iolock:
1771 1777 sys.stdout.write(d + ' ')
1772 1778 sys.stdout.flush()
1773 1779 for x in xrange(10):
1774 1780 if channels:
1775 1781 time.sleep(.1)
1776 1782 count += 1
1777 1783
1778 1784 stoppedearly = False
1779 1785
1780 1786 if self._showchannels:
1781 1787 statthread = threading.Thread(target=stat, name="stat")
1782 1788 statthread.start()
1783 1789
1784 1790 try:
1785 1791 while tests or running:
1786 1792 if not done.empty() or running == self._jobs or not tests:
1787 1793 try:
1788 1794 done.get(True, 1)
1789 1795 running -= 1
1790 1796 if result and result.shouldStop:
1791 1797 stoppedearly = True
1792 1798 break
1793 1799 except queue.Empty:
1794 1800 continue
1795 1801 if tests and not running == self._jobs:
1796 1802 test = tests.pop(0)
1797 1803 if self._loop:
1798 1804 if getattr(test, 'should_reload', False):
1799 1805 num_tests[0] += 1
1800 1806 tests.append(
1801 1807 self._loadtest(test, num_tests[0]))
1802 1808 else:
1803 1809 tests.append(test)
1804 1810 if self._jobs == 1:
1805 1811 job(test, result)
1806 1812 else:
1807 1813 t = threading.Thread(target=job, name=test.name,
1808 1814 args=(test, result))
1809 1815 t.start()
1810 1816 running += 1
1811 1817
1812 1818 # If we stop early we still need to wait on started tests to
1813 1819 # finish. Otherwise, there is a race between the test completing
1814 1820 # and the test's cleanup code running. This could result in the
1815 1821 # test reporting incorrect.
1816 1822 if stoppedearly:
1817 1823 while running:
1818 1824 try:
1819 1825 done.get(True, 1)
1820 1826 running -= 1
1821 1827 except queue.Empty:
1822 1828 continue
1823 1829 except KeyboardInterrupt:
1824 1830 for test in runtests:
1825 1831 test.abort()
1826 1832
1827 1833 channels = []
1828 1834
1829 1835 return result
1830 1836
1831 1837 # Save the most recent 5 wall-clock runtimes of each test to a
1832 1838 # human-readable text file named .testtimes. Tests are sorted
1833 1839 # alphabetically, while times for each test are listed from oldest to
1834 1840 # newest.
1835 1841
1836 1842 def loadtimes(outputdir):
1837 1843 times = []
1838 1844 try:
1839 1845 with open(os.path.join(outputdir, b'.testtimes-')) as fp:
1840 1846 for line in fp:
1841 1847 ts = line.split()
1842 1848 times.append((ts[0], [float(t) for t in ts[1:]]))
1843 1849 except IOError as err:
1844 1850 if err.errno != errno.ENOENT:
1845 1851 raise
1846 1852 return times
1847 1853
1848 1854 def savetimes(outputdir, result):
1849 1855 saved = dict(loadtimes(outputdir))
1850 1856 maxruns = 5
1851 1857 skipped = set([str(t[0]) for t in result.skipped])
1852 1858 for tdata in result.times:
1853 1859 test, real = tdata[0], tdata[3]
1854 1860 if test not in skipped:
1855 1861 ts = saved.setdefault(test, [])
1856 1862 ts.append(real)
1857 1863 ts[:] = ts[-maxruns:]
1858 1864
1859 1865 fd, tmpname = tempfile.mkstemp(prefix=b'.testtimes',
1860 1866 dir=outputdir, text=True)
1861 1867 with os.fdopen(fd, 'w') as fp:
1862 1868 for name, ts in sorted(saved.items()):
1863 1869 fp.write('%s %s\n' % (name, ' '.join(['%.3f' % (t,) for t in ts])))
1864 1870 timepath = os.path.join(outputdir, b'.testtimes')
1865 1871 try:
1866 1872 os.unlink(timepath)
1867 1873 except OSError:
1868 1874 pass
1869 1875 try:
1870 1876 os.rename(tmpname, timepath)
1871 1877 except OSError:
1872 1878 pass
1873 1879
1874 1880 class TextTestRunner(unittest.TextTestRunner):
1875 1881 """Custom unittest test runner that uses appropriate settings."""
1876 1882
1877 1883 def __init__(self, runner, *args, **kwargs):
1878 1884 super(TextTestRunner, self).__init__(*args, **kwargs)
1879 1885
1880 1886 self._runner = runner
1881 1887
1882 1888 def listtests(self, test):
1883 1889 result = TestResult(self._runner.options, self.stream,
1884 1890 self.descriptions, 0)
1885 1891 test = sorted(test, key=lambda t: t.name)
1886 1892 for t in test:
1887 1893 print(t.name)
1888 1894 result.addSuccess(t)
1889 1895
1890 1896 if self._runner.options.xunit:
1891 1897 with open(self._runner.options.xunit, "wb") as xuf:
1892 1898 self._writexunit(result, xuf)
1893 1899
1894 1900 if self._runner.options.json:
1895 1901 jsonpath = os.path.join(self._runner._outputdir, b'report.json')
1896 1902 with open(jsonpath, 'w') as fp:
1897 1903 self._writejson(result, fp)
1898 1904
1899 1905 return result
1900 1906
1901 1907 def run(self, test):
1902 1908 result = TestResult(self._runner.options, self.stream,
1903 1909 self.descriptions, self.verbosity)
1904 1910
1905 1911 test(result)
1906 1912
1907 1913 failed = len(result.failures)
1908 1914 skipped = len(result.skipped)
1909 1915 ignored = len(result.ignored)
1910 1916
1911 1917 with iolock:
1912 1918 self.stream.writeln('')
1913 1919
1914 1920 if not self._runner.options.noskips:
1915 1921 for test, msg in result.skipped:
1916 1922 self.stream.writeln('Skipped %s: %s' % (test.name, msg))
1917 1923 for test, msg in result.failures:
1918 1924 self.stream.writeln('Failed %s: %s' % (test.name, msg))
1919 1925 for test, msg in result.errors:
1920 1926 self.stream.writeln('Errored %s: %s' % (test.name, msg))
1921 1927
1922 1928 if self._runner.options.xunit:
1923 1929 with open(self._runner.options.xunit, "wb") as xuf:
1924 1930 self._writexunit(result, xuf)
1925 1931
1926 1932 if self._runner.options.json:
1927 1933 jsonpath = os.path.join(self._runner._outputdir, b'report.json')
1928 1934 with open(jsonpath, 'w') as fp:
1929 1935 self._writejson(result, fp)
1930 1936
1931 1937 self._runner._checkhglib('Tested')
1932 1938
1933 1939 savetimes(self._runner._outputdir, result)
1934 1940
1935 1941 if failed and self._runner.options.known_good_rev:
1936 1942 def nooutput(args):
1937 1943 p = subprocess.Popen(args, stderr=subprocess.STDOUT,
1938 1944 stdout=subprocess.PIPE)
1939 1945 p.stdout.read()
1940 1946 p.wait()
1941 1947 for test, msg in result.failures:
1942 1948 nooutput(['hg', 'bisect', '--reset']),
1943 1949 nooutput(['hg', 'bisect', '--bad', '.'])
1944 1950 nooutput(['hg', 'bisect', '--good',
1945 1951 self._runner.options.known_good_rev])
1946 1952 # TODO: we probably need to forward some options
1947 1953 # that alter hg's behavior inside the tests.
1948 1954 rtc = '%s %s %s' % (sys.executable, sys.argv[0], test)
1949 1955 sub = subprocess.Popen(['hg', 'bisect', '--command', rtc],
1950 1956 stderr=subprocess.STDOUT,
1951 1957 stdout=subprocess.PIPE)
1952 1958 data = sub.stdout.read()
1953 1959 sub.wait()
1954 1960 m = re.search(
1955 1961 (r'\nThe first (?P<goodbad>bad|good) revision '
1956 1962 r'is:\nchangeset: +\d+:(?P<node>[a-f0-9]+)\n.*\n'
1957 1963 r'summary: +(?P<summary>[^\n]+)\n'),
1958 1964 data, (re.MULTILINE | re.DOTALL))
1959 1965 if m is None:
1960 1966 self.stream.writeln(
1961 1967 'Failed to identify failure point for %s' % test)
1962 1968 continue
1963 1969 dat = m.groupdict()
1964 1970 verb = 'broken' if dat['goodbad'] == 'bad' else 'fixed'
1965 1971 self.stream.writeln(
1966 1972 '%s %s by %s (%s)' % (
1967 1973 test, verb, dat['node'], dat['summary']))
1968 1974 self.stream.writeln(
1969 1975 '# Ran %d tests, %d skipped, %d failed.'
1970 1976 % (result.testsRun, skipped + ignored, failed))
1971 1977 if failed:
1972 1978 self.stream.writeln('python hash seed: %s' %
1973 1979 os.environ['PYTHONHASHSEED'])
1974 1980 if self._runner.options.time:
1975 1981 self.printtimes(result.times)
1976 1982 self.stream.flush()
1977 1983
1978 1984 return result
1979 1985
1980 1986 def printtimes(self, times):
1981 1987 # iolock held by run
1982 1988 self.stream.writeln('# Producing time report')
1983 1989 times.sort(key=lambda t: (t[3]))
1984 1990 cols = '%7.3f %7.3f %7.3f %7.3f %7.3f %s'
1985 1991 self.stream.writeln('%-7s %-7s %-7s %-7s %-7s %s' %
1986 1992 ('start', 'end', 'cuser', 'csys', 'real', 'Test'))
1987 1993 for tdata in times:
1988 1994 test = tdata[0]
1989 1995 cuser, csys, real, start, end = tdata[1:6]
1990 1996 self.stream.writeln(cols % (start, end, cuser, csys, real, test))
1991 1997
1992 1998 @staticmethod
1993 1999 def _writexunit(result, outf):
1994 2000 # See http://llg.cubic.org/docs/junit/ for a reference.
1995 2001 timesd = dict((t[0], t[3]) for t in result.times)
1996 2002 doc = minidom.Document()
1997 2003 s = doc.createElement('testsuite')
1998 2004 s.setAttribute('name', 'run-tests')
1999 2005 s.setAttribute('tests', str(result.testsRun))
2000 2006 s.setAttribute('errors', "0") # TODO
2001 2007 s.setAttribute('failures', str(len(result.failures)))
2002 2008 s.setAttribute('skipped', str(len(result.skipped) +
2003 2009 len(result.ignored)))
2004 2010 doc.appendChild(s)
2005 2011 for tc in result.successes:
2006 2012 t = doc.createElement('testcase')
2007 2013 t.setAttribute('name', tc.name)
2008 2014 tctime = timesd.get(tc.name)
2009 2015 if tctime is not None:
2010 2016 t.setAttribute('time', '%.3f' % tctime)
2011 2017 s.appendChild(t)
2012 2018 for tc, err in sorted(result.faildata.items()):
2013 2019 t = doc.createElement('testcase')
2014 2020 t.setAttribute('name', tc)
2015 2021 tctime = timesd.get(tc)
2016 2022 if tctime is not None:
2017 2023 t.setAttribute('time', '%.3f' % tctime)
2018 2024 # createCDATASection expects a unicode or it will
2019 2025 # convert using default conversion rules, which will
2020 2026 # fail if string isn't ASCII.
2021 2027 err = cdatasafe(err).decode('utf-8', 'replace')
2022 2028 cd = doc.createCDATASection(err)
2023 2029 # Use 'failure' here instead of 'error' to match errors = 0,
2024 2030 # failures = len(result.failures) in the testsuite element.
2025 2031 failelem = doc.createElement('failure')
2026 2032 failelem.setAttribute('message', 'output changed')
2027 2033 failelem.setAttribute('type', 'output-mismatch')
2028 2034 failelem.appendChild(cd)
2029 2035 t.appendChild(failelem)
2030 2036 s.appendChild(t)
2031 2037 for tc, message in result.skipped:
2032 2038 # According to the schema, 'skipped' has no attributes. So store
2033 2039 # the skip message as a text node instead.
2034 2040 t = doc.createElement('testcase')
2035 2041 t.setAttribute('name', tc.name)
2036 2042 message = cdatasafe(message).decode('utf-8', 'replace')
2037 2043 cd = doc.createCDATASection(message)
2038 2044 skipelem = doc.createElement('skipped')
2039 2045 skipelem.appendChild(cd)
2040 2046 t.appendChild(skipelem)
2041 2047 s.appendChild(t)
2042 2048 outf.write(doc.toprettyxml(indent=' ', encoding='utf-8'))
2043 2049
2044 2050 @staticmethod
2045 2051 def _writejson(result, outf):
2046 2052 timesd = {}
2047 2053 for tdata in result.times:
2048 2054 test = tdata[0]
2049 2055 timesd[test] = tdata[1:]
2050 2056
2051 2057 outcome = {}
2052 2058 groups = [('success', ((tc, None)
2053 2059 for tc in result.successes)),
2054 2060 ('failure', result.failures),
2055 2061 ('skip', result.skipped)]
2056 2062 for res, testcases in groups:
2057 2063 for tc, __ in testcases:
2058 2064 if tc.name in timesd:
2059 2065 diff = result.faildata.get(tc.name, b'')
2060 2066 try:
2061 2067 diff = diff.decode('unicode_escape')
2062 2068 except UnicodeDecodeError as e:
2063 2069 diff = '%r decoding diff, sorry' % e
2064 2070 tres = {'result': res,
2065 2071 'time': ('%0.3f' % timesd[tc.name][2]),
2066 2072 'cuser': ('%0.3f' % timesd[tc.name][0]),
2067 2073 'csys': ('%0.3f' % timesd[tc.name][1]),
2068 2074 'start': ('%0.3f' % timesd[tc.name][3]),
2069 2075 'end': ('%0.3f' % timesd[tc.name][4]),
2070 2076 'diff': diff,
2071 2077 }
2072 2078 else:
2073 2079 # blacklisted test
2074 2080 tres = {'result': res}
2075 2081
2076 2082 outcome[tc.name] = tres
2077 2083 jsonout = json.dumps(outcome, sort_keys=True, indent=4,
2078 2084 separators=(',', ': '))
2079 2085 outf.writelines(("testreport =", jsonout))
2080 2086
2081 2087 class TestRunner(object):
2082 2088 """Holds context for executing tests.
2083 2089
2084 2090 Tests rely on a lot of state. This object holds it for them.
2085 2091 """
2086 2092
2087 2093 # Programs required to run tests.
2088 2094 REQUIREDTOOLS = [
2089 2095 b'diff',
2090 2096 b'grep',
2091 2097 b'unzip',
2092 2098 b'gunzip',
2093 2099 b'bunzip2',
2094 2100 b'sed',
2095 2101 ]
2096 2102
2097 2103 # Maps file extensions to test class.
2098 2104 TESTTYPES = [
2099 2105 (b'.py', PythonTest),
2100 2106 (b'.t', TTest),
2101 2107 ]
2102 2108
2103 2109 def __init__(self):
2104 2110 self.options = None
2105 2111 self._hgroot = None
2106 2112 self._testdir = None
2107 2113 self._outputdir = None
2108 2114 self._hgtmp = None
2109 2115 self._installdir = None
2110 2116 self._bindir = None
2111 2117 self._tmpbinddir = None
2112 2118 self._pythondir = None
2113 2119 self._coveragefile = None
2114 2120 self._createdfiles = []
2115 2121 self._hgcommand = None
2116 2122 self._hgpath = None
2117 2123 self._portoffset = 0
2118 2124 self._ports = {}
2119 2125
2120 2126 def run(self, args, parser=None):
2121 2127 """Run the test suite."""
2122 2128 oldmask = os.umask(0o22)
2123 2129 try:
2124 2130 parser = parser or getparser()
2125 2131 options, args = parseargs(args, parser)
2126 2132 # positional arguments are paths to test files to run, so
2127 2133 # we make sure they're all bytestrings
2128 2134 args = [_bytespath(a) for a in args]
2129 2135 self.options = options
2130 2136
2131 2137 self._checktools()
2132 2138 testdescs = self.findtests(args)
2133 2139 if options.profile_runner:
2134 2140 import statprof
2135 2141 statprof.start()
2136 2142 result = self._run(testdescs)
2137 2143 if options.profile_runner:
2138 2144 statprof.stop()
2139 2145 statprof.display()
2140 2146 return result
2141 2147
2142 2148 finally:
2143 2149 os.umask(oldmask)
2144 2150
2145 2151 def _run(self, testdescs):
2146 2152 if self.options.random:
2147 2153 random.shuffle(testdescs)
2148 2154 else:
2149 2155 # keywords for slow tests
2150 2156 slow = {b'svn': 10,
2151 2157 b'cvs': 10,
2152 2158 b'hghave': 10,
2153 2159 b'largefiles-update': 10,
2154 2160 b'run-tests': 10,
2155 2161 b'corruption': 10,
2156 2162 b'race': 10,
2157 2163 b'i18n': 10,
2158 2164 b'check': 100,
2159 2165 b'gendoc': 100,
2160 2166 b'contrib-perf': 200,
2161 2167 }
2162 2168 perf = {}
2163 2169 def sortkey(f):
2164 2170 # run largest tests first, as they tend to take the longest
2165 2171 f = f['path']
2166 2172 try:
2167 2173 return perf[f]
2168 2174 except KeyError:
2169 2175 try:
2170 2176 val = -os.stat(f).st_size
2171 2177 except OSError as e:
2172 2178 if e.errno != errno.ENOENT:
2173 2179 raise
2174 2180 perf[f] = -1e9 # file does not exist, tell early
2175 2181 return -1e9
2176 2182 for kw, mul in slow.items():
2177 2183 if kw in f:
2178 2184 val *= mul
2179 2185 if f.endswith(b'.py'):
2180 2186 val /= 10.0
2181 2187 perf[f] = val / 1000.0
2182 2188 return perf[f]
2183 2189 testdescs.sort(key=sortkey)
2184 2190
2185 2191 self._testdir = osenvironb[b'TESTDIR'] = getattr(
2186 2192 os, 'getcwdb', os.getcwd)()
2187 2193 if self.options.outputdir:
2188 2194 self._outputdir = canonpath(_bytespath(self.options.outputdir))
2189 2195 else:
2190 2196 self._outputdir = self._testdir
2191 2197
2192 2198 if 'PYTHONHASHSEED' not in os.environ:
2193 2199 # use a random python hash seed all the time
2194 2200 # we do the randomness ourself to know what seed is used
2195 2201 os.environ['PYTHONHASHSEED'] = str(random.getrandbits(32))
2196 2202
2197 2203 if self.options.tmpdir:
2198 2204 self.options.keep_tmpdir = True
2199 2205 tmpdir = _bytespath(self.options.tmpdir)
2200 2206 if os.path.exists(tmpdir):
2201 2207 # Meaning of tmpdir has changed since 1.3: we used to create
2202 2208 # HGTMP inside tmpdir; now HGTMP is tmpdir. So fail if
2203 2209 # tmpdir already exists.
2204 2210 print("error: temp dir %r already exists" % tmpdir)
2205 2211 return 1
2206 2212
2207 2213 # Automatically removing tmpdir sounds convenient, but could
2208 2214 # really annoy anyone in the habit of using "--tmpdir=/tmp"
2209 2215 # or "--tmpdir=$HOME".
2210 2216 #vlog("# Removing temp dir", tmpdir)
2211 2217 #shutil.rmtree(tmpdir)
2212 2218 os.makedirs(tmpdir)
2213 2219 else:
2214 2220 d = None
2215 2221 if os.name == 'nt':
2216 2222 # without this, we get the default temp dir location, but
2217 2223 # in all lowercase, which causes troubles with paths (issue3490)
2218 2224 d = osenvironb.get(b'TMP', None)
2219 2225 tmpdir = tempfile.mkdtemp(b'', b'hgtests.', d)
2220 2226
2221 2227 self._hgtmp = osenvironb[b'HGTMP'] = (
2222 2228 os.path.realpath(tmpdir))
2223 2229
2224 2230 if self.options.with_hg:
2225 2231 self._installdir = None
2226 2232 whg = self.options.with_hg
2227 2233 self._bindir = os.path.dirname(os.path.realpath(whg))
2228 2234 assert isinstance(self._bindir, bytes)
2229 2235 self._hgcommand = os.path.basename(whg)
2230 2236 self._tmpbindir = os.path.join(self._hgtmp, b'install', b'bin')
2231 2237 os.makedirs(self._tmpbindir)
2232 2238
2233 2239 # This looks redundant with how Python initializes sys.path from
2234 2240 # the location of the script being executed. Needed because the
2235 2241 # "hg" specified by --with-hg is not the only Python script
2236 2242 # executed in the test suite that needs to import 'mercurial'
2237 2243 # ... which means it's not really redundant at all.
2238 2244 self._pythondir = self._bindir
2239 2245 else:
2240 2246 self._installdir = os.path.join(self._hgtmp, b"install")
2241 2247 self._bindir = os.path.join(self._installdir, b"bin")
2242 2248 self._hgcommand = b'hg'
2243 2249 self._tmpbindir = self._bindir
2244 2250 self._pythondir = os.path.join(self._installdir, b"lib", b"python")
2245 2251
2246 2252 # set CHGHG, then replace "hg" command by "chg"
2247 2253 chgbindir = self._bindir
2248 2254 if self.options.chg or self.options.with_chg:
2249 2255 osenvironb[b'CHGHG'] = os.path.join(self._bindir, self._hgcommand)
2250 2256 else:
2251 2257 osenvironb.pop(b'CHGHG', None) # drop flag for hghave
2252 2258 if self.options.chg:
2253 2259 self._hgcommand = b'chg'
2254 2260 elif self.options.with_chg:
2255 2261 chgbindir = os.path.dirname(os.path.realpath(self.options.with_chg))
2256 2262 self._hgcommand = os.path.basename(self.options.with_chg)
2257 2263
2258 2264 osenvironb[b"BINDIR"] = self._bindir
2259 2265 osenvironb[b"PYTHON"] = PYTHON
2260 2266
2261 2267 if self.options.with_python3:
2262 2268 osenvironb[b'PYTHON3'] = self.options.with_python3
2263 2269
2264 2270 fileb = _bytespath(__file__)
2265 2271 runtestdir = os.path.abspath(os.path.dirname(fileb))
2266 2272 osenvironb[b'RUNTESTDIR'] = runtestdir
2267 2273 if PYTHON3:
2268 2274 sepb = _bytespath(os.pathsep)
2269 2275 else:
2270 2276 sepb = os.pathsep
2271 2277 path = [self._bindir, runtestdir] + osenvironb[b"PATH"].split(sepb)
2272 2278 if os.path.islink(__file__):
2273 2279 # test helper will likely be at the end of the symlink
2274 2280 realfile = os.path.realpath(fileb)
2275 2281 realdir = os.path.abspath(os.path.dirname(realfile))
2276 2282 path.insert(2, realdir)
2277 2283 if chgbindir != self._bindir:
2278 2284 path.insert(1, chgbindir)
2279 2285 if self._testdir != runtestdir:
2280 2286 path = [self._testdir] + path
2281 2287 if self._tmpbindir != self._bindir:
2282 2288 path = [self._tmpbindir] + path
2283 2289 osenvironb[b"PATH"] = sepb.join(path)
2284 2290
2285 2291 # Include TESTDIR in PYTHONPATH so that out-of-tree extensions
2286 2292 # can run .../tests/run-tests.py test-foo where test-foo
2287 2293 # adds an extension to HGRC. Also include run-test.py directory to
2288 2294 # import modules like heredoctest.
2289 2295 pypath = [self._pythondir, self._testdir, runtestdir]
2290 2296 # We have to augment PYTHONPATH, rather than simply replacing
2291 2297 # it, in case external libraries are only available via current
2292 2298 # PYTHONPATH. (In particular, the Subversion bindings on OS X
2293 2299 # are in /opt/subversion.)
2294 2300 oldpypath = osenvironb.get(IMPL_PATH)
2295 2301 if oldpypath:
2296 2302 pypath.append(oldpypath)
2297 2303 osenvironb[IMPL_PATH] = sepb.join(pypath)
2298 2304
2299 2305 if self.options.pure:
2300 2306 os.environ["HGTEST_RUN_TESTS_PURE"] = "--pure"
2301 2307 os.environ["HGMODULEPOLICY"] = "py"
2302 2308
2303 2309 if self.options.allow_slow_tests:
2304 2310 os.environ["HGTEST_SLOW"] = "slow"
2305 2311 elif 'HGTEST_SLOW' in os.environ:
2306 2312 del os.environ['HGTEST_SLOW']
2307 2313
2308 2314 self._coveragefile = os.path.join(self._testdir, b'.coverage')
2309 2315
2310 2316 vlog("# Using TESTDIR", self._testdir)
2311 2317 vlog("# Using RUNTESTDIR", osenvironb[b'RUNTESTDIR'])
2312 2318 vlog("# Using HGTMP", self._hgtmp)
2313 2319 vlog("# Using PATH", os.environ["PATH"])
2314 2320 vlog("# Using", IMPL_PATH, osenvironb[IMPL_PATH])
2315 2321 vlog("# Writing to directory", self._outputdir)
2316 2322
2317 2323 try:
2318 2324 return self._runtests(testdescs) or 0
2319 2325 finally:
2320 2326 time.sleep(.1)
2321 2327 self._cleanup()
2322 2328
2323 2329 def findtests(self, args):
2324 2330 """Finds possible test files from arguments.
2325 2331
2326 2332 If you wish to inject custom tests into the test harness, this would
2327 2333 be a good function to monkeypatch or override in a derived class.
2328 2334 """
2329 2335 if not args:
2330 2336 if self.options.changed:
2331 2337 proc = Popen4('hg st --rev "%s" -man0 .' %
2332 2338 self.options.changed, None, 0)
2333 2339 stdout, stderr = proc.communicate()
2334 2340 args = stdout.strip(b'\0').split(b'\0')
2335 2341 else:
2336 2342 args = os.listdir(b'.')
2337 2343
2338 2344 tests = []
2339 2345 for t in args:
2340 2346 if not (os.path.basename(t).startswith(b'test-')
2341 2347 and (t.endswith(b'.py') or t.endswith(b'.t'))):
2342 2348 continue
2343 2349 if t.endswith(b'.t'):
2344 2350 # .t file may contain multiple test cases
2345 2351 cases = sorted(parsettestcases(t))
2346 2352 if cases:
2347 2353 tests += [{'path': t, 'case': c} for c in sorted(cases)]
2348 2354 else:
2349 2355 tests.append({'path': t})
2350 2356 else:
2351 2357 tests.append({'path': t})
2352 2358 return tests
2353 2359
2354 2360 def _runtests(self, testdescs):
2355 2361 def _reloadtest(test, i):
2356 2362 # convert a test back to its description dict
2357 2363 desc = {'path': test.path}
2358 2364 case = getattr(test, '_case', None)
2359 2365 if case:
2360 2366 desc['case'] = case
2361 2367 return self._gettest(desc, i)
2362 2368
2363 2369 try:
2364 2370 if self.options.restart:
2365 2371 orig = list(testdescs)
2366 2372 while testdescs:
2367 2373 desc = testdescs[0]
2368 2374 # desc['path'] is a relative path
2369 2375 if 'case' in desc:
2370 2376 errpath = b'%s.%s.err' % (desc['path'], desc['case'])
2371 2377 else:
2372 2378 errpath = b'%s.err' % desc['path']
2373 2379 errpath = os.path.join(self._outputdir, errpath)
2374 2380 if os.path.exists(errpath):
2375 2381 break
2376 2382 testdescs.pop(0)
2377 2383 if not testdescs:
2378 2384 print("running all tests")
2379 2385 testdescs = orig
2380 2386
2381 2387 tests = [self._gettest(d, i) for i, d in enumerate(testdescs)]
2382 2388
2383 2389 failed = False
2384 2390 kws = self.options.keywords
2385 2391 if kws is not None and PYTHON3:
2386 2392 kws = kws.encode('utf-8')
2387 2393
2388 2394 suite = TestSuite(self._testdir,
2389 2395 jobs=self.options.jobs,
2390 2396 whitelist=self.options.whitelisted,
2391 2397 blacklist=self.options.blacklist,
2392 2398 retest=self.options.retest,
2393 2399 keywords=kws,
2394 2400 loop=self.options.loop,
2395 2401 runs_per_test=self.options.runs_per_test,
2396 2402 showchannels=self.options.showchannels,
2397 2403 tests=tests, loadtest=_reloadtest)
2398 2404 verbosity = 1
2399 2405 if self.options.verbose:
2400 2406 verbosity = 2
2401 2407 runner = TextTestRunner(self, verbosity=verbosity)
2402 2408
2403 2409 if self.options.list_tests:
2404 2410 result = runner.listtests(suite)
2405 2411 else:
2406 2412 if self._installdir:
2407 2413 self._installhg()
2408 2414 self._checkhglib("Testing")
2409 2415 else:
2410 2416 self._usecorrectpython()
2411 2417 if self.options.chg:
2412 2418 assert self._installdir
2413 2419 self._installchg()
2414 2420
2415 2421 result = runner.run(suite)
2416 2422
2417 2423 if result.failures:
2418 2424 failed = True
2419 2425
2420 2426 if self.options.anycoverage:
2421 2427 self._outputcoverage()
2422 2428 except KeyboardInterrupt:
2423 2429 failed = True
2424 2430 print("\ninterrupted!")
2425 2431
2426 2432 if failed:
2427 2433 return 1
2428 2434
2429 2435 def _getport(self, count):
2430 2436 port = self._ports.get(count) # do we have a cached entry?
2431 2437 if port is None:
2432 2438 portneeded = 3
2433 2439 # above 100 tries we just give up and let test reports failure
2434 2440 for tries in xrange(100):
2435 2441 allfree = True
2436 2442 port = self.options.port + self._portoffset
2437 2443 for idx in xrange(portneeded):
2438 2444 if not checkportisavailable(port + idx):
2439 2445 allfree = False
2440 2446 break
2441 2447 self._portoffset += portneeded
2442 2448 if allfree:
2443 2449 break
2444 2450 self._ports[count] = port
2445 2451 return port
2446 2452
2447 2453 def _gettest(self, testdesc, count):
2448 2454 """Obtain a Test by looking at its filename.
2449 2455
2450 2456 Returns a Test instance. The Test may not be runnable if it doesn't
2451 2457 map to a known type.
2452 2458 """
2453 2459 path = testdesc['path']
2454 2460 lctest = path.lower()
2455 2461 testcls = Test
2456 2462
2457 2463 for ext, cls in self.TESTTYPES:
2458 2464 if lctest.endswith(ext):
2459 2465 testcls = cls
2460 2466 break
2461 2467
2462 2468 refpath = os.path.join(self._testdir, path)
2463 2469 tmpdir = os.path.join(self._hgtmp, b'child%d' % count)
2464 2470
2465 2471 # extra keyword parameters. 'case' is used by .t tests
2466 2472 kwds = dict((k, testdesc[k]) for k in ['case'] if k in testdesc)
2467 2473
2468 2474 t = testcls(refpath, self._outputdir, tmpdir,
2469 2475 keeptmpdir=self.options.keep_tmpdir,
2470 2476 debug=self.options.debug,
2471 2477 timeout=self.options.timeout,
2472 2478 startport=self._getport(count),
2473 2479 extraconfigopts=self.options.extra_config_opt,
2474 2480 py3kwarnings=self.options.py3k_warnings,
2475 2481 shell=self.options.shell,
2476 2482 hgcommand=self._hgcommand,
2477 2483 usechg=bool(self.options.with_chg or self.options.chg),
2478 2484 useipv6=useipv6, **kwds)
2479 2485 t.should_reload = True
2480 2486 return t
2481 2487
2482 2488 def _cleanup(self):
2483 2489 """Clean up state from this test invocation."""
2484 2490 if self.options.keep_tmpdir:
2485 2491 return
2486 2492
2487 2493 vlog("# Cleaning up HGTMP", self._hgtmp)
2488 2494 shutil.rmtree(self._hgtmp, True)
2489 2495 for f in self._createdfiles:
2490 2496 try:
2491 2497 os.remove(f)
2492 2498 except OSError:
2493 2499 pass
2494 2500
2495 2501 def _usecorrectpython(self):
2496 2502 """Configure the environment to use the appropriate Python in tests."""
2497 2503 # Tests must use the same interpreter as us or bad things will happen.
2498 2504 pyexename = sys.platform == 'win32' and b'python.exe' or b'python'
2499 2505 if getattr(os, 'symlink', None):
2500 2506 vlog("# Making python executable in test path a symlink to '%s'" %
2501 2507 sys.executable)
2502 2508 mypython = os.path.join(self._tmpbindir, pyexename)
2503 2509 try:
2504 2510 if os.readlink(mypython) == sys.executable:
2505 2511 return
2506 2512 os.unlink(mypython)
2507 2513 except OSError as err:
2508 2514 if err.errno != errno.ENOENT:
2509 2515 raise
2510 2516 if self._findprogram(pyexename) != sys.executable:
2511 2517 try:
2512 2518 os.symlink(sys.executable, mypython)
2513 2519 self._createdfiles.append(mypython)
2514 2520 except OSError as err:
2515 2521 # child processes may race, which is harmless
2516 2522 if err.errno != errno.EEXIST:
2517 2523 raise
2518 2524 else:
2519 2525 exedir, exename = os.path.split(sys.executable)
2520 2526 vlog("# Modifying search path to find %s as %s in '%s'" %
2521 2527 (exename, pyexename, exedir))
2522 2528 path = os.environ['PATH'].split(os.pathsep)
2523 2529 while exedir in path:
2524 2530 path.remove(exedir)
2525 2531 os.environ['PATH'] = os.pathsep.join([exedir] + path)
2526 2532 if not self._findprogram(pyexename):
2527 2533 print("WARNING: Cannot find %s in search path" % pyexename)
2528 2534
2529 2535 def _installhg(self):
2530 2536 """Install hg into the test environment.
2531 2537
2532 2538 This will also configure hg with the appropriate testing settings.
2533 2539 """
2534 2540 vlog("# Performing temporary installation of HG")
2535 2541 installerrs = os.path.join(self._hgtmp, b"install.err")
2536 2542 compiler = ''
2537 2543 if self.options.compiler:
2538 2544 compiler = '--compiler ' + self.options.compiler
2539 2545 if self.options.pure:
2540 2546 pure = b"--pure"
2541 2547 else:
2542 2548 pure = b""
2543 2549
2544 2550 # Run installer in hg root
2545 2551 script = os.path.realpath(sys.argv[0])
2546 2552 exe = sys.executable
2547 2553 if PYTHON3:
2548 2554 compiler = _bytespath(compiler)
2549 2555 script = _bytespath(script)
2550 2556 exe = _bytespath(exe)
2551 2557 hgroot = os.path.dirname(os.path.dirname(script))
2552 2558 self._hgroot = hgroot
2553 2559 os.chdir(hgroot)
2554 2560 nohome = b'--home=""'
2555 2561 if os.name == 'nt':
2556 2562 # The --home="" trick works only on OS where os.sep == '/'
2557 2563 # because of a distutils convert_path() fast-path. Avoid it at
2558 2564 # least on Windows for now, deal with .pydistutils.cfg bugs
2559 2565 # when they happen.
2560 2566 nohome = b''
2561 2567 cmd = (b'%(exe)s setup.py %(pure)s clean --all'
2562 2568 b' build %(compiler)s --build-base="%(base)s"'
2563 2569 b' install --force --prefix="%(prefix)s"'
2564 2570 b' --install-lib="%(libdir)s"'
2565 2571 b' --install-scripts="%(bindir)s" %(nohome)s >%(logfile)s 2>&1'
2566 2572 % {b'exe': exe, b'pure': pure,
2567 2573 b'compiler': compiler,
2568 2574 b'base': os.path.join(self._hgtmp, b"build"),
2569 2575 b'prefix': self._installdir, b'libdir': self._pythondir,
2570 2576 b'bindir': self._bindir,
2571 2577 b'nohome': nohome, b'logfile': installerrs})
2572 2578
2573 2579 # setuptools requires install directories to exist.
2574 2580 def makedirs(p):
2575 2581 try:
2576 2582 os.makedirs(p)
2577 2583 except OSError as e:
2578 2584 if e.errno != errno.EEXIST:
2579 2585 raise
2580 2586 makedirs(self._pythondir)
2581 2587 makedirs(self._bindir)
2582 2588
2583 2589 vlog("# Running", cmd)
2584 2590 if os.system(cmd) == 0:
2585 2591 if not self.options.verbose:
2586 2592 try:
2587 2593 os.remove(installerrs)
2588 2594 except OSError as e:
2589 2595 if e.errno != errno.ENOENT:
2590 2596 raise
2591 2597 else:
2592 2598 f = open(installerrs, 'rb')
2593 2599 for line in f:
2594 2600 if PYTHON3:
2595 2601 sys.stdout.buffer.write(line)
2596 2602 else:
2597 2603 sys.stdout.write(line)
2598 2604 f.close()
2599 2605 sys.exit(1)
2600 2606 os.chdir(self._testdir)
2601 2607
2602 2608 self._usecorrectpython()
2603 2609
2604 2610 if self.options.py3k_warnings and not self.options.anycoverage:
2605 2611 vlog("# Updating hg command to enable Py3k Warnings switch")
2606 2612 f = open(os.path.join(self._bindir, 'hg'), 'rb')
2607 2613 lines = [line.rstrip() for line in f]
2608 2614 lines[0] += ' -3'
2609 2615 f.close()
2610 2616 f = open(os.path.join(self._bindir, 'hg'), 'wb')
2611 2617 for line in lines:
2612 2618 f.write(line + '\n')
2613 2619 f.close()
2614 2620
2615 2621 hgbat = os.path.join(self._bindir, b'hg.bat')
2616 2622 if os.path.isfile(hgbat):
2617 2623 # hg.bat expects to be put in bin/scripts while run-tests.py
2618 2624 # installation layout put it in bin/ directly. Fix it
2619 2625 f = open(hgbat, 'rb')
2620 2626 data = f.read()
2621 2627 f.close()
2622 2628 if b'"%~dp0..\python" "%~dp0hg" %*' in data:
2623 2629 data = data.replace(b'"%~dp0..\python" "%~dp0hg" %*',
2624 2630 b'"%~dp0python" "%~dp0hg" %*')
2625 2631 f = open(hgbat, 'wb')
2626 2632 f.write(data)
2627 2633 f.close()
2628 2634 else:
2629 2635 print('WARNING: cannot fix hg.bat reference to python.exe')
2630 2636
2631 2637 if self.options.anycoverage:
2632 2638 custom = os.path.join(self._testdir, 'sitecustomize.py')
2633 2639 target = os.path.join(self._pythondir, 'sitecustomize.py')
2634 2640 vlog('# Installing coverage trigger to %s' % target)
2635 2641 shutil.copyfile(custom, target)
2636 2642 rc = os.path.join(self._testdir, '.coveragerc')
2637 2643 vlog('# Installing coverage rc to %s' % rc)
2638 2644 os.environ['COVERAGE_PROCESS_START'] = rc
2639 2645 covdir = os.path.join(self._installdir, '..', 'coverage')
2640 2646 try:
2641 2647 os.mkdir(covdir)
2642 2648 except OSError as e:
2643 2649 if e.errno != errno.EEXIST:
2644 2650 raise
2645 2651
2646 2652 os.environ['COVERAGE_DIR'] = covdir
2647 2653
2648 2654 def _checkhglib(self, verb):
2649 2655 """Ensure that the 'mercurial' package imported by python is
2650 2656 the one we expect it to be. If not, print a warning to stderr."""
2651 2657 if ((self._bindir == self._pythondir) and
2652 2658 (self._bindir != self._tmpbindir)):
2653 2659 # The pythondir has been inferred from --with-hg flag.
2654 2660 # We cannot expect anything sensible here.
2655 2661 return
2656 2662 expecthg = os.path.join(self._pythondir, b'mercurial')
2657 2663 actualhg = self._gethgpath()
2658 2664 if os.path.abspath(actualhg) != os.path.abspath(expecthg):
2659 2665 sys.stderr.write('warning: %s with unexpected mercurial lib: %s\n'
2660 2666 ' (expected %s)\n'
2661 2667 % (verb, actualhg, expecthg))
2662 2668 def _gethgpath(self):
2663 2669 """Return the path to the mercurial package that is actually found by
2664 2670 the current Python interpreter."""
2665 2671 if self._hgpath is not None:
2666 2672 return self._hgpath
2667 2673
2668 2674 cmd = b'%s -c "import mercurial; print (mercurial.__path__[0])"'
2669 2675 cmd = cmd % PYTHON
2670 2676 if PYTHON3:
2671 2677 cmd = _strpath(cmd)
2672 2678 pipe = os.popen(cmd)
2673 2679 try:
2674 2680 self._hgpath = _bytespath(pipe.read().strip())
2675 2681 finally:
2676 2682 pipe.close()
2677 2683
2678 2684 return self._hgpath
2679 2685
2680 2686 def _installchg(self):
2681 2687 """Install chg into the test environment"""
2682 2688 vlog('# Performing temporary installation of CHG')
2683 2689 assert os.path.dirname(self._bindir) == self._installdir
2684 2690 assert self._hgroot, 'must be called after _installhg()'
2685 2691 cmd = (b'"%(make)s" clean install PREFIX="%(prefix)s"'
2686 2692 % {b'make': 'make', # TODO: switch by option or environment?
2687 2693 b'prefix': self._installdir})
2688 2694 cwd = os.path.join(self._hgroot, b'contrib', b'chg')
2689 2695 vlog("# Running", cmd)
2690 2696 proc = subprocess.Popen(cmd, shell=True, cwd=cwd,
2691 2697 stdin=subprocess.PIPE, stdout=subprocess.PIPE,
2692 2698 stderr=subprocess.STDOUT)
2693 2699 out, _err = proc.communicate()
2694 2700 if proc.returncode != 0:
2695 2701 if PYTHON3:
2696 2702 sys.stdout.buffer.write(out)
2697 2703 else:
2698 2704 sys.stdout.write(out)
2699 2705 sys.exit(1)
2700 2706
2701 2707 def _outputcoverage(self):
2702 2708 """Produce code coverage output."""
2703 2709 import coverage
2704 2710 coverage = coverage.coverage
2705 2711
2706 2712 vlog('# Producing coverage report')
2707 2713 # chdir is the easiest way to get short, relative paths in the
2708 2714 # output.
2709 2715 os.chdir(self._hgroot)
2710 2716 covdir = os.path.join(self._installdir, '..', 'coverage')
2711 2717 cov = coverage(data_file=os.path.join(covdir, 'cov'))
2712 2718
2713 2719 # Map install directory paths back to source directory.
2714 2720 cov.config.paths['srcdir'] = ['.', self._pythondir]
2715 2721
2716 2722 cov.combine()
2717 2723
2718 2724 omit = [os.path.join(x, '*') for x in [self._bindir, self._testdir]]
2719 2725 cov.report(ignore_errors=True, omit=omit)
2720 2726
2721 2727 if self.options.htmlcov:
2722 2728 htmldir = os.path.join(self._outputdir, 'htmlcov')
2723 2729 cov.html_report(directory=htmldir, omit=omit)
2724 2730 if self.options.annotate:
2725 2731 adir = os.path.join(self._outputdir, 'annotated')
2726 2732 if not os.path.isdir(adir):
2727 2733 os.mkdir(adir)
2728 2734 cov.annotate(directory=adir, omit=omit)
2729 2735
2730 2736 def _findprogram(self, program):
2731 2737 """Search PATH for a executable program"""
2732 2738 dpb = _bytespath(os.defpath)
2733 2739 sepb = _bytespath(os.pathsep)
2734 2740 for p in osenvironb.get(b'PATH', dpb).split(sepb):
2735 2741 name = os.path.join(p, program)
2736 2742 if os.name == 'nt' or os.access(name, os.X_OK):
2737 2743 return name
2738 2744 return None
2739 2745
2740 2746 def _checktools(self):
2741 2747 """Ensure tools required to run tests are present."""
2742 2748 for p in self.REQUIREDTOOLS:
2743 2749 if os.name == 'nt' and not p.endswith('.exe'):
2744 2750 p += '.exe'
2745 2751 found = self._findprogram(p)
2746 2752 if found:
2747 2753 vlog("# Found prerequisite", p, "at", found)
2748 2754 else:
2749 2755 print("WARNING: Did not find prerequisite tool: %s " %
2750 2756 p.decode("utf-8"))
2751 2757
2752 2758 if __name__ == '__main__':
2753 2759 runner = TestRunner()
2754 2760
2755 2761 try:
2756 2762 import msvcrt
2757 2763 msvcrt.setmode(sys.stdin.fileno(), os.O_BINARY)
2758 2764 msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
2759 2765 msvcrt.setmode(sys.stderr.fileno(), os.O_BINARY)
2760 2766 except ImportError:
2761 2767 pass
2762 2768
2763 2769 sys.exit(runner.run(sys.argv[1:]))
General Comments 0
You need to be logged in to leave comments. Login now