def parse_args():
"""
Parse command line arguments.
Returns a tuple of: (options, js_shell, requested_paths, excluded_paths)
options :object: The raw OptionParser output.
js_shell :str: The absolute location of the shell to test with.
requested_paths :set<str>: Test paths specially requested on the CLI.
excluded_paths :set<str>: Test paths specifically excluded by the CLI.
"""
from optparse import OptionParser, OptionGroup
op = OptionParser(
usage=textwrap.dedent(
"""
%prog [OPTIONS] JS_SHELL [TESTS]
Shell output format: [ pass | fail | timeout | skip ] progress | time
"""
).strip()
)
op.add_option(
"--xul-info", dest="xul_info_src", help="config data for xulRuntime" " (avoids search for config/autoconf.mk)"
)
harness_og = OptionGroup(op, "Harness Controls", "Control how tests are run.")
harness_og.add_option(
"-j",
"--worker-count",
type=int,
default=max(1, get_cpu_count()),
help="Number of tests to run in parallel" " (default %default)",
)
harness_og.add_option(
"-t", "--timeout", type=float, default=150.0, help="Set maximum time a test is allows to run" " (in seconds)."
)
harness_og.add_option("-a", "--args", dest="shell_args", default="", help="Extra args to pass to the JS shell.")
harness_og.add_option(
"--jitflags",
dest="jitflags",
default="none",
type="string",
help="IonMonkey option combinations. One of all," " debug, ion, and none (default %default).",
)
harness_og.add_option("--tbpl", action="store_true", help="Runs each test in all configurations tbpl" " tests.")
harness_og.add_option(
"--tbpl-debug", action="store_true", help="Runs each test in some faster configurations" " tbpl tests."
)
harness_og.add_option("-g", "--debug", action="store_true", help="Run a test in debugger.")
harness_og.add_option("--debugger", default="gdb -q --args", help="Debugger command.")
harness_og.add_option("-J", "--jorendb", action="store_true", help="Run under JS debugger.")
harness_og.add_option(
"--passthrough", action="store_true", help="Run tests with stdin/stdout attached to" " caller."
)
harness_og.add_option("--valgrind", action="store_true", help="Run tests in valgrind.")
harness_og.add_option("--valgrind-args", default="", help="Extra args to pass to valgrind.")
op.add_option_group(harness_og)
input_og = OptionGroup(op, "Inputs", "Change what tests are run.")
input_og.add_option("-f", "--file", dest="test_file", action="append", help="Get tests from the given file.")
input_og.add_option("-x", "--exclude-file", action="append", help="Exclude tests from the given file.")
input_og.add_option(
"-d", "--exclude-random", dest="random", action="store_false", help='Exclude tests marked as "random."'
)
input_og.add_option("--run-skipped", action="store_true", help='Run tests marked as "skip."')
input_og.add_option("--run-only-skipped", action="store_true", help='Run only tests marked as "skip."')
input_og.add_option("--run-slow-tests", action="store_true", help='Do not skip tests marked as "slow."')
input_og.add_option(
"--no-extensions", action="store_true", help="Run only tests conforming to the ECMAScript 5" " standard."
)
op.add_option_group(input_og)
output_og = OptionGroup(op, "Output", "Modify the harness and tests output.")
output_og.add_option("-s", "--show-cmd", action="store_true", help="Show exact commandline used to run each test.")
output_og.add_option(
"-o",
"--show-output",
action="store_true",
help="Print each test's output to the file given by" " --output-file.",
)
output_og.add_option(
"-F",
"--failed-only",
action="store_true",
help="If a --show-* option is given, only print" " output for failed tests.",
)
output_og.add_option(
"--no-show-failed",
action="store_true",
help="Don't print output for failed tests" " (no-op with --show-output).",
)
output_og.add_option("-O", "--output-file", help="Write all output to the given file" " (default: stdout).")
output_og.add_option("--failure-file", help="Write all not-passed tests to the given file.")
output_og.add_option(
"--no-progress", dest="hide_progress", action="store_true", help="Do not show the progress bar."
)
output_og.add_option(
"--tinderbox",
dest="format",
action="store_const",
const="automation",
help="Use automation-parseable output format.",
)
output_og.add_option(
"--format",
dest="format",
default="none",
type="choice",
choices=["automation", "none"],
help="Output format. Either automation or none" " (default %default).",
)
op.add_option_group(output_og)
special_og = OptionGroup(op, "Special", "Special modes that do not run tests.")
special_og.add_option("--make-manifests", metavar="BASE_TEST_PATH", help="Generate reftest manifest files.")
op.add_option_group(special_og)
options, args = op.parse_args()
# Acquire the JS shell given on the command line.
options.js_shell = None
requested_paths = set()
if len(args) > 0:
options.js_shell = abspath(args[0])
requested_paths |= set(args[1:])
# If we do not have a shell, we must be in a special mode.
if options.js_shell is None and not options.make_manifests:
op.error("missing JS_SHELL argument")
# Valgrind and gdb are mutually exclusive.
if options.valgrind and options.debug:
op.error("--valgrind and --debug are mutually exclusive.")
# Fill the debugger field, as needed.
prefix = options.debugger.split() if options.debug else []
if options.valgrind:
prefix = ["valgrind"] + options.valgrind_args.split()
if os.uname()[0] == "Darwin":
prefix.append("--dsymutil=yes")
options.show_output = True
js_cmd_args = options.shell_args.split()
if options.jorendb:
options.passthrough = True
options.hide_progress = True
options.worker_count = 1
debugger_path = realpath(
os.path.join(abspath(dirname(abspath(__file__))), "..", "..", "examples", "jorendb.js")
)
js_cmd_args.extend(["-d", "-f", debugger_path, "--"])
TestCase.set_js_cmd_prefix(options.js_shell, js_cmd_args, prefix)
# If files with lists of tests to run were specified, add them to the
# requested tests set.
if options.test_file:
for test_file in options.test_file:
requested_paths |= set([line.strip() for line in open(test_file).readlines()])
# If files with lists of tests to exclude were specified, add them to the
# excluded tests set.
excluded_paths = set()
if options.exclude_file:
for filename in options.exclude_file:
try:
fp = open(filename, "r")
for line in fp:
if line.startswith("#"):
continue
line = line.strip()
if not line:
continue
excluded_paths |= set((line,))
finally:
fp.close()
# Handle output redirection, if requested and relevant.
options.output_fp = sys.stdout
if options.output_file:
if not options.show_cmd:
options.show_output = True
try:
options.output_fp = open(options.output_file, "w")
except IOError as ex:
raise SystemExit("Failed to open output file: " + str(ex))
# Hide the progress bar if it will get in the way of other output.
options.hide_progress = (
options.format == "automation" or not ProgressBar.conservative_isatty() or options.hide_progress
)
return (options, requested_paths, excluded_paths)
def parse_args():
"""
Parse command line arguments.
Returns a tuple of: (options, js_shell, requested_paths, excluded_paths)
options :object: The raw OptionParser output.
js_shell :str: The absolute location of the shell to test with.
requested_paths :set<str>: Test paths specially requested on the CLI.
excluded_paths :set<str>: Test paths specifically excluded by the CLI.
"""
from optparse import OptionParser, OptionGroup
op = OptionParser(usage=textwrap.dedent("""
%prog [OPTIONS] JS_SHELL [TESTS]
Shell output format: [ pass | fail | timeout | skip ] progress | time
""").strip())
op.add_option('--xul-info', dest='xul_info_src',
help='config data for xulRuntime'
' (avoids search for config/autoconf.mk)')
harness_og = OptionGroup(op, "Harness Controls",
"Control how tests are run.")
harness_og.add_option('-j', '--worker-count', type=int,
default=max(1, get_cpu_count()),
help='Number of tests to run in parallel'
' (default %default)')
harness_og.add_option('-t', '--timeout', type=float, default=150.0,
help='Set maximum time a test is allows to run'
' (in seconds).')
harness_og.add_option('-a', '--args', dest='shell_args', default='',
help='Extra args to pass to the JS shell.')
harness_og.add_option('--jitflags', dest='jitflags', default='none',
type='string',
help='IonMonkey option combinations. One of all,'
' debug, ion, and none (default %default).')
harness_og.add_option('--tbpl', action='store_true',
help='Runs each test in all configurations tbpl'
' tests.')
harness_og.add_option('--tbpl-debug', action='store_true',
help='Runs each test in some faster configurations'
' tbpl tests.')
harness_og.add_option('-g', '--debug', action='store_true',
help='Run a test in debugger.')
harness_og.add_option('--debugger', default='gdb -q --args',
help='Debugger command.')
harness_og.add_option('-J', '--jorendb', action='store_true',
help='Run under JS debugger.')
harness_og.add_option('--passthrough', action='store_true',
help='Run tests with stdin/stdout attached to'
' caller.')
harness_og.add_option('--valgrind', action='store_true',
help='Run tests in valgrind.')
harness_og.add_option('--valgrind-args', default='',
help='Extra args to pass to valgrind.')
harness_og.add_option('--rr', action='store_true',
help='Run tests under RR record-and-replay debugger.')
op.add_option_group(harness_og)
input_og = OptionGroup(op, "Inputs", "Change what tests are run.")
input_og.add_option('-f', '--file', dest='test_file', action='append',
help='Get tests from the given file.')
input_og.add_option('-x', '--exclude-file', action='append',
help='Exclude tests from the given file.')
input_og.add_option('-d', '--exclude-random', dest='random',
action='store_false',
help='Exclude tests marked as "random."')
input_og.add_option('--run-skipped', action='store_true',
help='Run tests marked as "skip."')
input_og.add_option('--run-only-skipped', action='store_true',
help='Run only tests marked as "skip."')
input_og.add_option('--run-slow-tests', action='store_true',
help='Do not skip tests marked as "slow."')
input_og.add_option('--no-extensions', action='store_true',
help='Run only tests conforming to the ECMAScript 5'
' standard.')
op.add_option_group(input_og)
output_og = OptionGroup(op, "Output",
"Modify the harness and tests output.")
output_og.add_option('-s', '--show-cmd', action='store_true',
help='Show exact commandline used to run each test.')
output_og.add_option('-o', '--show-output', action='store_true',
help="Print each test's output to the file given by"
" --output-file.")
output_og.add_option('-F', '--failed-only', action='store_true',
help="If a --show-* option is given, only print"
" output for failed tests.")
output_og.add_option('--no-show-failed', action='store_true',
help="Don't print output for failed tests"
" (no-op with --show-output).")
output_og.add_option('-O', '--output-file',
help='Write all output to the given file'
' (default: stdout).')
output_og.add_option('--failure-file',
help='Write all not-passed tests to the given file.')
output_og.add_option('--no-progress', dest='hide_progress',
action='store_true',
help='Do not show the progress bar.')
output_og.add_option('--tinderbox', dest='format', action='store_const',
const='automation',
help='Use automation-parseable output format.')
output_og.add_option('--format', dest='format', default='none',
type='choice', choices=['automation', 'none'],
help='Output format. Either automation or none'
' (default %default).')
op.add_option_group(output_og)
special_og = OptionGroup(op, "Special",
"Special modes that do not run tests.")
special_og.add_option('--make-manifests', metavar='BASE_TEST_PATH',
help='Generate reftest manifest files.')
op.add_option_group(special_og)
options, args = op.parse_args()
# Acquire the JS shell given on the command line.
options.js_shell = None
requested_paths = set()
if len(args) > 0:
options.js_shell = abspath(args[0])
requested_paths |= set(args[1:])
# If we do not have a shell, we must be in a special mode.
if options.js_shell is None and not options.make_manifests:
op.error('missing JS_SHELL argument')
# Valgrind, gdb, and rr are mutually exclusive.
if sum(map(lambda e: 1 if e else 0, [options.valgrind, options.debug, options.rr])) > 1:
op.error("--valgrind, --debug, and --rr are mutually exclusive.")
# Fill the debugger field, as needed.
prefix = options.debugger.split() if options.debug else []
if options.valgrind:
prefix = ['valgrind'] + options.valgrind_args.split()
if os.uname()[0] == 'Darwin':
prefix.append('--dsymutil=yes')
options.show_output = True
if options.rr:
prefix = ['rr', 'record']
js_cmd_args = options.shell_args.split()
if options.jorendb:
options.passthrough = True
options.hide_progress = True
options.worker_count = 1
debugger_path = realpath(os.path.join(
abspath(dirname(abspath(__file__))),
'..', '..', 'examples', 'jorendb.js'))
js_cmd_args.extend(['-d', '-f', debugger_path, '--'])
TestCase.set_js_cmd_prefix(options.js_shell, js_cmd_args, prefix)
# If files with lists of tests to run were specified, add them to the
# requested tests set.
if options.test_file:
for test_file in options.test_file:
requested_paths |= set(
[line.strip() for line in open(test_file).readlines()])
# If files with lists of tests to exclude were specified, add them to the
# excluded tests set.
excluded_paths = set()
if options.exclude_file:
for filename in options.exclude_file:
try:
fp = open(filename, 'r')
for line in fp:
if line.startswith('#'): continue
line = line.strip()
if not line: continue
excluded_paths |= set((line,))
finally:
fp.close()
# Handle output redirection, if requested and relevant.
options.output_fp = sys.stdout
if options.output_file:
if not options.show_cmd:
options.show_output = True
try:
options.output_fp = open(options.output_file, 'w')
except IOError as ex:
raise SystemExit("Failed to open output file: " + str(ex))
# Hide the progress bar if it will get in the way of other output.
options.hide_progress = (options.format == 'automation' or
not ProgressBar.conservative_isatty() or
options.hide_progress)
return (options, requested_paths, excluded_paths)
def parse_args():
"""
Parse command line arguments.
Returns a tuple of: (options, js_shell, requested_paths, excluded_paths)
options :object: The raw OptionParser output.
js_shell :str: The absolute location of the shell to test with.
requested_paths :set<str>: Test paths specially requested on the CLI.
excluded_paths :set<str>: Test paths specifically excluded by the CLI.
"""
from optparse import OptionParser, OptionGroup
op = OptionParser(usage=textwrap.dedent("""
%prog [OPTIONS] JS_SHELL [TESTS]
Shell output format: [ pass | fail | timeout | skip ] progress | time
""").strip())
op.add_option(
'--xul-info',
dest='xul_info_src',
help='config data for xulRuntime (avoids search for config/autoconf.mk)'
)
harness_og = OptionGroup(op, "Harness Controls",
"Control how tests are run.")
harness_og.add_option(
'-j',
'--worker-count',
type=int,
default=max(1, get_cpu_count()),
help='Number of tests to run in parallel (default %default)')
harness_og.add_option(
'-t',
'--timeout',
type=float,
default=150.0,
help='Set maximum time a test is allows to run (in seconds).')
harness_og.add_option('-a',
'--args',
dest='shell_args',
default='',
help='Extra args to pass to the JS shell.')
harness_og.add_option(
'--jitflags',
default='',
help=
'Example: --jitflags=m,amd to run each test with -m, -a -m -d [default=%default]'
)
harness_og.add_option('-g',
'--debug',
action='store_true',
help='Run a test in debugger.')
harness_og.add_option('--debugger',
default='gdb -q --args',
help='Debugger command.')
harness_og.add_option('--valgrind',
action='store_true',
help='Run tests in valgrind.')
harness_og.add_option('--valgrind-args',
default='',
help='Extra args to pass to valgrind.')
op.add_option_group(harness_og)
input_og = OptionGroup(op, "Inputs", "Change what tests are run.")
input_og.add_option('-f',
'--file',
dest='test_file',
action='append',
help='Get tests from the given file.')
input_og.add_option('-x',
'--exclude-file',
action='append',
help='Exclude tests from the given file.')
input_og.add_option('-d',
'--exclude-random',
dest='random',
action='store_false',
help='Exclude tests marked as "random."')
input_og.add_option('--run-skipped',
action='store_true',
help='Run tests marked as "skip."')
input_og.add_option('--run-only-skipped',
action='store_true',
help='Run only tests marked as "skip."')
input_og.add_option('--run-slow-tests',
action='store_true',
help='Do not skip tests marked as "slow."')
input_og.add_option(
'--no-extensions',
action='store_true',
help='Run only tests conforming to the ECMAScript 5 standard.')
op.add_option_group(input_og)
output_og = OptionGroup(op, "Output",
"Modify the harness and tests output.")
output_og.add_option('-s',
'--show-cmd',
action='store_true',
help='Show exact commandline used to run each test.')
output_og.add_option(
'-o',
'--show-output',
action='store_true',
help="Print each test's output to the file given by --output-file.")
output_og.add_option(
'-F',
'--failed-only',
action='store_true',
help=
"If a --show-* option is given, only print output for failed tests.")
output_og.add_option(
'-O',
'--output-file',
help='Write all output to the given file (default: stdout).')
output_og.add_option('--failure-file',
help='Write all not-passed tests to the given file.')
output_og.add_option('--no-progress',
dest='hide_progress',
action='store_true',
help='Do not show the progress bar.')
output_og.add_option('--tinderbox',
action='store_true',
help='Use tinderbox-parseable output format.')
op.add_option_group(output_og)
special_og = OptionGroup(op, "Special",
"Special modes that do not run tests.")
special_og.add_option('--make-manifests',
metavar='BASE_TEST_PATH',
help='Generate reftest manifest files.')
op.add_option_group(special_og)
options, args = op.parse_args()
# Acquire the JS shell given on the command line.
options.js_shell = None
requested_paths = set()
if len(args) > 0:
options.js_shell = os.path.abspath(args[0])
requested_paths |= set(args[1:])
# If we do not have a shell, we must be in a special mode.
if options.js_shell is None and not options.make_manifests:
op.error('missing JS_SHELL argument')
# Valgrind and gdb are mutually exclusive.
if options.valgrind and options.debug:
op.error("--valgrind and --debug are mutually exclusive.")
# Fill the debugger field, as needed.
prefix = options.debugger.split() if options.debug else []
if options.valgrind:
prefix = ['valgrind'] + options.valgrind_args.split()
if os.uname()[0] == 'Darwin':
prefix.append('--dsymutil=yes')
options.show_output = True
TestCase.set_js_cmd_prefix(options.js_shell, options.shell_args.split(),
prefix)
# If files with lists of tests to run were specified, add them to the
# requested tests set.
if options.test_file:
for test_file in options.test_file:
requested_paths |= set(
[line.strip() for line in open(test_file).readlines()])
# If files with lists of tests to exclude were specified, add them to the
# excluded tests set.
excluded_paths = set()
if options.exclude_file:
for filename in options.exclude_file:
try:
fp = open(filename, 'r')
for line in fp:
if line.startswith('#'): continue
line = line.strip()
if not line: continue
excluded_paths |= set((line, ))
finally:
fp.close()
# Handle output redirection, if requested and relevant.
options.output_fp = sys.stdout
if options.output_file:
if not options.show_cmd:
options.show_output = True
try:
options.output_fp = open(options.output_file, 'w')
except IOError, ex:
raise SystemExit("Failed to open output file: " + str(ex))
def parse_args():
"""
Parse command line arguments.
Returns a tuple of: (options, js_shell, requested_paths, excluded_paths)
options :object: The raw OptionParser output.
js_shell :str: The absolute location of the shell to test with.
requested_paths :set<str>: Test paths specially requested on the CLI.
excluded_paths :set<str>: Test paths specifically excluded by the CLI.
"""
from optparse import OptionParser, OptionGroup
op = OptionParser(usage=textwrap.dedent("""
%prog [OPTIONS] JS_SHELL [TESTS]
Shell output format: [ pass | fail | timeout | skip ] progress | time
""").strip())
op.add_option('--xul-info',
dest='xul_info_src',
help='config data for xulRuntime'
' (avoids search for config/autoconf.mk)')
harness_og = OptionGroup(op, "Harness Controls",
"Control how tests are run.")
harness_og.add_option('-j',
'--worker-count',
type=int,
default=max(1, get_cpu_count()),
help='Number of tests to run in parallel'
' (default %default)')
harness_og.add_option('-t',
'--timeout',
type=float,
default=150.0,
help='Set maximum time a test is allows to run'
' (in seconds).')
harness_og.add_option('-a',
'--args',
dest='shell_args',
default='',
help='Extra args to pass to the JS shell.')
harness_og.add_option('--jitflags',
dest='jitflags',
default='none',
type='string',
help='IonMonkey option combinations. One of all,'
' debug, ion, and none (default %default).')
harness_og.add_option('--tbpl',
action='store_true',
help='Runs each test in all configurations tbpl'
' tests.')
harness_og.add_option('--tbpl-debug',
action='store_true',
help='Runs each test in some faster configurations'
' tbpl tests.')
harness_og.add_option('-g',
'--debug',
action='store_true',
help='Run a test in debugger.')
harness_og.add_option('--debugger',
default='gdb -q --args',
help='Debugger command.')
harness_og.add_option('-J',
'--jorendb',
action='store_true',
help='Run under JS debugger.')
harness_og.add_option('--passthrough',
action='store_true',
help='Run tests with stdin/stdout attached to'
' caller.')
harness_og.add_option('--valgrind',
action='store_true',
help='Run tests in valgrind.')
harness_og.add_option('--valgrind-args',
default='',
help='Extra args to pass to valgrind.')
harness_og.add_option(
'--rr',
action='store_true',
help='Run tests under RR record-and-replay debugger.')
op.add_option_group(harness_og)
input_og = OptionGroup(op, "Inputs", "Change what tests are run.")
input_og.add_option('-f',
'--file',
dest='test_file',
action='append',
help='Get tests from the given file.')
input_og.add_option('-x',
'--exclude-file',
action='append',
help='Exclude tests from the given file.')
input_og.add_option('-d',
'--exclude-random',
dest='random',
action='store_false',
help='Exclude tests marked as "random."')
input_og.add_option('--run-skipped',
action='store_true',
help='Run tests marked as "skip."')
input_og.add_option('--run-only-skipped',
action='store_true',
help='Run only tests marked as "skip."')
input_og.add_option('--run-slow-tests',
action='store_true',
help='Do not skip tests marked as "slow."')
input_og.add_option('--no-extensions',
action='store_true',
help='Run only tests conforming to the ECMAScript 5'
' standard.')
op.add_option_group(input_og)
output_og = OptionGroup(op, "Output",
"Modify the harness and tests output.")
output_og.add_option('-s',
'--show-cmd',
action='store_true',
help='Show exact commandline used to run each test.')
output_og.add_option('-o',
'--show-output',
action='store_true',
help="Print each test's output to the file given by"
" --output-file.")
output_og.add_option('-F',
'--failed-only',
action='store_true',
help="If a --show-* option is given, only print"
" output for failed tests.")
output_og.add_option('--no-show-failed',
action='store_true',
help="Don't print output for failed tests"
" (no-op with --show-output).")
output_og.add_option('-O',
'--output-file',
help='Write all output to the given file'
' (default: stdout).')
output_og.add_option('--failure-file',
help='Write all not-passed tests to the given file.')
output_og.add_option('--no-progress',
dest='hide_progress',
action='store_true',
help='Do not show the progress bar.')
output_og.add_option('--tinderbox',
dest='format',
action='store_const',
const='automation',
help='Use automation-parseable output format.')
output_og.add_option('--format',
dest='format',
default='none',
type='choice',
choices=['automation', 'none'],
help='Output format. Either automation or none'
' (default %default).')
op.add_option_group(output_og)
special_og = OptionGroup(op, "Special",
"Special modes that do not run tests.")
special_og.add_option('--make-manifests',
metavar='BASE_TEST_PATH',
help='Generate reftest manifest files.')
op.add_option_group(special_og)
options, args = op.parse_args()
# Acquire the JS shell given on the command line.
options.js_shell = None
requested_paths = set()
if len(args) > 0:
options.js_shell = abspath(args[0])
requested_paths |= set(args[1:])
# If we do not have a shell, we must be in a special mode.
if options.js_shell is None and not options.make_manifests:
op.error('missing JS_SHELL argument')
# Valgrind, gdb, and rr are mutually exclusive.
if sum(
map(lambda e: 1 if e else 0,
[options.valgrind, options.debug, options.rr])) > 1:
op.error("--valgrind, --debug, and --rr are mutually exclusive.")
# Fill the debugger field, as needed.
debugger_prefix = options.debugger.split() if options.debug else []
if options.valgrind:
debugger_prefix = ['valgrind'] + options.valgrind_args.split()
if os.uname()[0] == 'Darwin':
debugger_prefix.append('--dsymutil=yes')
options.show_output = True
if options.rr:
debugger_prefix = ['rr', 'record']
js_cmd_args = options.shell_args.split()
if options.jorendb:
options.passthrough = True
options.hide_progress = True
options.worker_count = 1
debugger_path = realpath(
os.path.join(abspath(dirname(abspath(__file__))), '..', '..',
'examples', 'jorendb.js'))
js_cmd_args.extend(['-d', '-f', debugger_path, '--'])
prefix = TestCase.build_js_cmd_prefix(options.js_shell, js_cmd_args,
debugger_prefix)
# If files with lists of tests to run were specified, add them to the
# requested tests set.
if options.test_file:
for test_file in options.test_file:
requested_paths |= set(
[line.strip() for line in open(test_file).readlines()])
# If files with lists of tests to exclude were specified, add them to the
# excluded tests set.
excluded_paths = set()
if options.exclude_file:
for filename in options.exclude_file:
try:
fp = open(filename, 'r')
for line in fp:
if line.startswith('#'): continue
line = line.strip()
if not line: continue
excluded_paths |= set((line, ))
finally:
fp.close()
# Handle output redirection, if requested and relevant.
options.output_fp = sys.stdout
if options.output_file:
if not options.show_cmd:
options.show_output = True
try:
options.output_fp = open(options.output_file, 'w')
except IOError as ex:
raise SystemExit("Failed to open output file: " + str(ex))
# Hide the progress bar if it will get in the way of other output.
options.hide_progress = (options.format == 'automation'
or not ProgressBar.conservative_isatty()
or options.hide_progress)
return (options, prefix, requested_paths, excluded_paths)
def parse_args():
"""
Parse command line arguments.
Returns a tuple of: (options, js_shell, requested_paths, excluded_paths)
options :object: The raw OptionParser output.
js_shell :str: The absolute location of the shell to test with.
requested_paths :set<str>: Test paths specially requested on the CLI.
excluded_paths :set<str>: Test paths specifically excluded by the CLI.
"""
from optparse import OptionParser, OptionGroup
op = OptionParser(usage=textwrap.dedent("""
%prog [OPTIONS] JS_SHELL [TESTS]
Shell output format: [ pass | fail | timeout | skip ] progress | time
""").strip())
op.add_option('--xul-info', dest='xul_info_src',
help='config data for xulRuntime (avoids search for config/autoconf.mk)')
harness_og = OptionGroup(op, "Harness Controls", "Control how tests are run.")
harness_og.add_option('-j', '--worker-count', type=int, default=max(1, get_cpu_count()),
help='Number of tests to run in parallel (default %default)')
harness_og.add_option('-t', '--timeout', type=float, default=150.0,
help='Set maximum time a test is allows to run (in seconds).')
harness_og.add_option('-a', '--args', dest='shell_args', default='',
help='Extra args to pass to the JS shell.')
harness_og.add_option('-g', '--debug', action='store_true', help='Run a test in debugger.')
harness_og.add_option('--debugger', default='gdb -q --args', help='Debugger command.')
harness_og.add_option('--valgrind', action='store_true', help='Run tests in valgrind.')
harness_og.add_option('--valgrind-args', default='', help='Extra args to pass to valgrind.')
op.add_option_group(harness_og)
input_og = OptionGroup(op, "Inputs", "Change what tests are run.")
input_og.add_option('-f', '--file', dest='test_file', action='append',
help='Get tests from the given file.')
input_og.add_option('-x', '--exclude-file', action='append',
help='Exclude tests from the given file.')
input_og.add_option('-d', '--exclude-random', dest='random', action='store_false',
help='Exclude tests marked as "random."')
input_og.add_option('--run-skipped', action='store_true', help='Run tests marked as "skip."')
input_og.add_option('--run-only-skipped', action='store_true', help='Run only tests marked as "skip."')
input_og.add_option('--run-slow-tests', action='store_true',
help='Do not skip tests marked as "slow."')
input_og.add_option('--no-extensions', action='store_true',
help='Run only tests conforming to the ECMAScript 5 standard.')
op.add_option_group(input_og)
output_og = OptionGroup(op, "Output", "Modify the harness and tests output.")
output_og.add_option('-s', '--show-cmd', action='store_true',
help='Show exact commandline used to run each test.')
output_og.add_option('-o', '--show-output', action='store_true',
help="Print each test's output to stdout.")
output_og.add_option('-O', '--output-file',
help='Write all output to the given file.')
output_og.add_option('--failure-file',
help='Write all not-passed tests to the given file.')
output_og.add_option('--no-progress', dest='hide_progress', action='store_true',
help='Do not show the progress bar.')
output_og.add_option('--tinderbox', action='store_true',
help='Use tinderbox-parseable output format.')
op.add_option_group(output_og)
special_og = OptionGroup(op, "Special", "Special modes that do not run tests.")
special_og.add_option('--make-manifests', metavar='BASE_TEST_PATH',
help='Generate reftest manifest files.')
op.add_option_group(special_og)
options, args = op.parse_args()
# Acquire the JS shell given on the command line.
options.js_shell = None
requested_paths = set()
if len(args) > 0:
options.js_shell = os.path.abspath(args[0])
requested_paths |= set(args[1:])
# If we do not have a shell, we must be in a special mode.
if options.js_shell is None and not options.make_manifests:
op.error('missing JS_SHELL argument')
# Valgrind and gdb are mutually exclusive.
if options.valgrind and options.debug:
op.error("--valgrind and --debug are mutually exclusive.")
# Fill the debugger field, as needed.
prefix = options.debugger.split() if options.debug else []
if options.valgrind:
prefix = ['valgrind'] + options.valgrind_args.split()
if os.uname()[0] == 'Darwin':
prefix.append('--dsymutil=yes')
options.show_output = True
TestCase.set_js_cmd_prefix(options.js_shell, options.shell_args.split(), prefix)
# If files with lists of tests to run were specified, add them to the
# requested tests set.
if options.test_file:
for test_file in options.test_file:
requested_paths |= set([line.strip() for line in open(test_file).readlines()])
# If files with lists of tests to exclude were specified, add them to the
# excluded tests set.
excluded_paths = set()
if options.exclude_file:
for filename in options.exclude_file:
try:
fp = open(filename, 'r')
for line in fp:
if line.startswith('#'): continue
line = line.strip()
if not line: continue
excluded_paths |= set((line,))
finally:
fp.close()
# Handle output redirection, if requested and relevant.
options.output_fp = sys.stdout
if options.output_file and (options.show_cmd or options.show_output):
try:
options.output_fp = open(options.output_file, 'w')
except IOError, ex:
raise SystemExit("Failed to open output file: " + str(ex))
