Beispiel #1
0
def create_parser_update(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(
        "web-platform-tests-update", description="Update script for web-platform-tests tests."
    )
    parser.add_argument(
        "--product",
        action="store",
        choices=product_choices,
        default=None,
        help="Browser for which metadata is being updated",
    )
    parser.add_argument("--config", action="store", type=abs_path, help="Path to config file")
    parser.add_argument(
        "--metadata",
        action="store",
        type=abs_path,
        dest="metadata_root",
        help="Path to the folder containing test metadata",
    ),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root", help="Path to web-platform-tests"),
    parser.add_argument(
        "--sync-path",
        action="store",
        type=abs_path,
        help="Path to store git checkout of web-platform-tests during update",
    ),
    parser.add_argument("--remote_url", action="store", help="URL of web-platfrom-tests repository to sync against"),
    parser.add_argument("--branch", action="store", type=abs_path, help="Remote branch to sync against")
    parser.add_argument("--rev", action="store", help="Revision to sync to")
    parser.add_argument(
        "--no-patch", action="store_true", help="Don't create an mq patch or git commit containing the changes."
    )
    parser.add_argument(
        "--sync", dest="sync", action="store_true", default=False, help="Sync the tests with the latest from upstream"
    )
    parser.add_argument(
        "--ignore-existing",
        action="store_true",
        help="When updating test results only consider results from the logfiles provided, not existing expectations.",
    )
    parser.add_argument(
        "--continue", action="store_true", help="Continue a previously started run of the update script"
    )
    parser.add_argument(
        "--abort", action="store_true", help="Clear state from a previous incomplete run of the update script"
    )
    # Should make this required iff run=logfile
    parser.add_argument("run_log", nargs="*", type=abs_path, help="Log file from run of tests")
    commandline.add_logging_group(parser)
    return parser
def create_parser_update(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser("web-platform-tests-update",
                                     description="Update script for web-platform-tests tests.")
    parser.add_argument("--product", action="store", choices=product_choices,
                        default=None, help="Browser for which metadata is being updated")
    parser.add_argument("--config", action="store", type=abs_path, help="Path to config file")
    parser.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                        help="Path to web-platform-tests"),
    parser.add_argument("--manifest", action="store", type=abs_path, dest="manifest_path",
                        help="Path to test manifest (default is ${metadata_root}/MANIFEST.json)")
    parser.add_argument("--sync-path", action="store", type=abs_path,
                        help="Path to store git checkout of web-platform-tests during update"),
    parser.add_argument("--remote_url", action="store",
                        help="URL of web-platfrom-tests repository to sync against"),
    parser.add_argument("--branch", action="store", type=abs_path,
                        help="Remote branch to sync against")
    parser.add_argument("--rev", action="store", help="Revision to sync to")
    parser.add_argument("--patch", action="store_true", dest="patch", default=None,
                        help="Create a VCS commit containing the changes.")
    parser.add_argument("--no-patch", action="store_false", dest="patch",
                        help="Don't create a VCS commit containing the changes.")
    parser.add_argument("--sync", dest="sync", action="store_true", default=False,
                        help="Sync the tests with the latest from upstream (implies --patch)")
    parser.add_argument("--ignore-existing", action="store_true",
                        help="When updating test results only consider results from the logfiles provided, not existing expectations.")
    parser.add_argument("--stability", nargs="?", action="store", const="unstable", default=None,
        help=("Reason for disabling tests. When updating test results, disable tests that have "
              "inconsistent results across many runs with the given reason."))
    parser.add_argument("--no-remove-obsolete", action="store_false", dest="remove_obsolete", default=True,
                        help=("Don't remove metadata files that no longer correspond to a test file"))
    parser.add_argument("--no-store-state", action="store_false", dest="store_state",
                        help="Store state so that steps can be resumed after failure")
    parser.add_argument("--continue", action="store_true",
                        help="Continue a previously started run of the update script")
    parser.add_argument("--abort", action="store_true",
                        help="Clear state from a previous incomplete run of the update script")
    parser.add_argument("--exclude", action="store", nargs="*",
                        help="List of glob-style paths to exclude when syncing tests")
    parser.add_argument("--include", action="store", nargs="*",
                        help="List of glob-style paths to include which would otherwise be excluded when syncing tests")
    parser.add_argument("--extra-property", action="append", default=[],
                        help="Extra property from run_info.json to use in metadata update")
    # Should make this required iff run=logfile
    parser.add_argument("run_log", nargs="*", type=abs_path,
                        help="Log file from run of tests")
    commandline.add_logging_group(parser)
    return parser
Beispiel #3
0
def create_parser(product_choices=None):
    from mozlog import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="Runner for web-platform-tests tests.")
    parser.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                        help="Path to test files"),
    parser.add_argument("--run-info", action="store", type=abs_path,
                        help="Path to directory containing extra json files to add to run info")
    parser.add_argument("--config", action="store", type=abs_path, dest="config",
                        help="Path to config file")

    parser.add_argument("--manifest-update", action="store_true", default=False,
                        help="Force regeneration of the test manifest")

    parser.add_argument("--binary", action="store",
                        type=abs_path, help="Binary to run tests against")
    parser.add_argument("--webdriver-binary", action="store", metavar="BINARY",
                        type=abs_path, help="WebDriver server binary to use")
    parser.add_argument("--processes", action="store", type=int, default=None,
                        help="Number of simultaneous processes to use")

    parser.add_argument("--run-by-dir", type=int, nargs="?", default=False,
                        help="Split run into groups by directories. With a parameter,"
                        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
                        "directory")

    parser.add_argument("--timeout-multiplier", action="store", type=float, default=None,
                        help="Multiplier relative to standard test timeout to use")
    parser.add_argument("--repeat", action="store", type=int, default=1,
                        help="Number of times to run the tests")

    parser.add_argument("--no-capture-stdio", action="store_true", default=False,
                        help="Don't capture stdio and write to logging")

    parser.add_argument("--product", action="store", choices=product_choices,
                        default=None, help="Browser against which to run tests")

    parser.add_argument("--list-test-groups", action="store_true",
                        default=False,
                        help="List the top level directories containing tests that will run.")
    parser.add_argument("--list-disabled", action="store_true",
                        default=False,
                        help="List the tests that are disabled on the current platform")

    build_type = parser.add_mutually_exclusive_group()
    build_type.add_argument("--debug-build", dest="debug", action="store_true",
                            default=None,
                            help="Build is a debug build (overrides any mozinfo file)")
    build_type.add_argument("--release-build", dest="debug", action="store_false",
                            default=None,
                            help="Build is a release (overrides any mozinfo file)")

    test_selection_group = parser.add_argument_group("Test Selection")
    test_selection_group.add_argument("--test-types", action="store",
                                      nargs="*", default=["testharness", "reftest"],
                                      choices=["testharness", "reftest"],
                                      help="Test types to run")
    test_selection_group.add_argument("--include", action="append",
                                      help="URL prefix to include")
    test_selection_group.add_argument("--exclude", action="append",
                                      help="URL prefix to exclude")
    test_selection_group.add_argument("--include-manifest", type=abs_path,
                                      help="Path to manifest listing tests to include")
    test_selection_group.add_argument("--tag", action="append", dest="tags",
                                      help="Labels applied to tests to include in the run. Labels starting dir: are equivalent to top-level directories.")

    debugging_group = parser.add_argument_group("Debugging")
    debugging_group.add_argument('--debugger', const="__default__", nargs="?",
                                 help="run under a debugger, e.g. gdb or valgrind")
    debugging_group.add_argument('--debugger-args', help="arguments to the debugger")

    debugging_group.add_argument('--pause-after-test', action="store_true", default=None,
                                 help="Halt the test runner after each test (this happens by default if only a single test is run)")
    debugging_group.add_argument('--no-pause-after-test', dest="pause_after_test", action="store_false",
                                 help="Don't halt the test runner irrespective of the number of tests run")

    debugging_group.add_argument('--pause-on-unexpected', action="store_true",
                                 help="Halt the test runner when an unexpected result is encountered")

    debugging_group.add_argument("--symbols-path", action="store", type=url_or_path,
                                 help="Path or url to symbols file used to analyse crash minidumps.")
    debugging_group.add_argument("--stackwalk-binary", action="store", type=abs_path,
                                 help="Path to stackwalker program used to analyse minidumps.")

    chunking_group = parser.add_argument_group("Test Chunking")
    chunking_group.add_argument("--total-chunks", action="store", type=int, default=1,
                                help="Total number of chunks to use")
    chunking_group.add_argument("--this-chunk", action="store", type=int, default=1,
                                help="Chunk number to run")
    chunking_group.add_argument("--chunk-type", action="store", choices=["none", "equal_time", "hash"],
                                default=None, help="Chunking type to use")

    ssl_group = parser.add_argument_group("SSL/TLS")
    ssl_group.add_argument("--ssl-type", action="store", default=None,
                        choices=["openssl", "pregenerated", "none"],
                        help="Type of ssl support to enable (running without ssl may lead to spurious errors)")

    ssl_group.add_argument("--openssl-binary", action="store",
                        help="Path to openssl binary", default="openssl")
    ssl_group.add_argument("--certutil-binary", action="store",
                        help="Path to certutil binary for use with Firefox + ssl")

    ssl_group.add_argument("--ca-cert-path", action="store", type=abs_path,
                        help="Path to ca certificate when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-key-path", action="store", type=abs_path,
                        help="Path to host private key when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-cert-path", action="store", type=abs_path,
                        help="Path to host certificate when using pregenerated ssl certificates")

    gecko_group = parser.add_argument_group("Gecko-specific")
    gecko_group.add_argument("--prefs-root", dest="prefs_root", action="store", type=abs_path,
                             help="Path to the folder containing browser prefs")

    b2g_group = parser.add_argument_group("B2G-specific")
    b2g_group.add_argument("--b2g-no-backup", action="store_true", default=False,
                           help="Don't backup device before testrun with --product=b2g")

    servo_group = parser.add_argument_group("Servo-specific")
    servo_group.add_argument("--user-stylesheet",
                             default=[], action="append", dest="user_stylesheets",
                             help="Inject a user CSS stylesheet into every test.")

    parser.add_argument("test_list", nargs="*",
                        help="List of URLs for tests to run, or paths including tests to run. "
                             "(equivalent to --include)")

    commandline.add_logging_group(parser)
    return parser
def create_parser(product_choices=None):
    from mozlog import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="""Runner for web-platform-tests tests.""",
                                     usage="""%(prog)s [OPTION]... [TEST]...

TEST is either the full path to a test file to run, or the URL of a test excluding
scheme host and port.""")
    parser.add_argument("--manifest-update", action="store_true", default=None,
                        help="Regenerate the test manifest.")
    parser.add_argument("--no-manifest-update", action="store_false", dest="manifest_update",
                        help="Prevent regeneration of the test manifest.")
    parser.add_argument("--manifest-download", action="store_true", default=None,
                        help="Attempt to download a preexisting manifest when updating.")

    parser.add_argument("--timeout-multiplier", action="store", type=float, default=None,
                        help="Multiplier relative to standard test timeout to use")
    parser.add_argument("--run-by-dir", type=int, nargs="?", default=False,
                        help="Split run into groups by directories. With a parameter,"
                        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
                        "directory")
    parser.add_argument("--processes", action="store", type=int, default=None,
                        help="Number of simultaneous processes to use")

    parser.add_argument("--no-capture-stdio", action="store_true", default=False,
                        help="Don't capture stdio and write to logging")
    parser.add_argument("--no-fail-on-unexpected", action="store_false",
                        default=True,
                        dest="fail_on_unexpected",
                        help="Exit with status code 0 when test expectations are violated")

    mode_group = parser.add_argument_group("Mode")
    mode_group.add_argument("--list-test-groups", action="store_true",
                            default=False,
                            help="List the top level directories containing tests that will run.")
    mode_group.add_argument("--list-disabled", action="store_true",
                            default=False,
                            help="List the tests that are disabled on the current platform")
    mode_group.add_argument("--list-tests", action="store_true",
                            default=False,
                            help="List all tests that will run")
    mode_group.add_argument("--verify", action="store_true",
                            default=False,
                            help="Run a stability check on the selected tests")
    mode_group.add_argument("--verify-log-full", action="store_true",
                            default=False,
                            help="Output per-iteration test results when running verify")
    mode_group.add_argument("--verify-repeat-loop", action="store",
                            default=10,
                            help="Number of iterations for a run that reloads each test without restart.",
                            type=int)
    mode_group.add_argument("--verify-repeat-restart", action="store",
                            default=5,
                            help="Number of iterations, for a run that restarts the runner between each iteration",
                            type=int)
    chaos_mode_group = mode_group.add_mutually_exclusive_group()
    chaos_mode_group.add_argument("--verify-no-chaos-mode", action="store_false",
                                  default=True,
                                  dest="verify_chaos_mode",
                                  help="Disable chaos mode when running on Firefox")
    chaos_mode_group.add_argument("--verify-chaos-mode", action="store_true",
                                  default=True,
                                  dest="verify_chaos_mode",
                                  help="Enable chaos mode when running on Firefox")
    mode_group.add_argument("--verify-max-time", action="store",
                            default=None,
                            help="The maximum number of minutes for the job to run",
                            type=lambda x: timedelta(minutes=float(x)))
    output_results_group = mode_group.add_mutually_exclusive_group()
    output_results_group.add_argument("--verify-no-output-results", action="store_false",
                                      dest="verify_output_results",
                                      default=True,
                                      help="Prints individuals test results and messages")
    output_results_group.add_argument("--verify-output-results", action="store_true",
                                      dest="verify_output_results",
                                      default=True,
                                      help="Disable printing individuals test results and messages")

    test_selection_group = parser.add_argument_group("Test Selection")
    test_selection_group.add_argument("--test-types", action="store",
                                      nargs="*", default=wpttest.enabled_tests,
                                      choices=wpttest.enabled_tests,
                                      help="Test types to run")
    test_selection_group.add_argument("--include", action="append",
                                      help="URL prefix to include")
    test_selection_group.add_argument("--exclude", action="append",
                                      help="URL prefix to exclude")
    test_selection_group.add_argument("--include-manifest", type=abs_path,
                                      help="Path to manifest listing tests to include")
    test_selection_group.add_argument("--skip-timeout", action="store_true",
                                      help="Skip tests that are expected to time out")
    test_selection_group.add_argument("--tag", action="append", dest="tags",
                                      help="Labels applied to tests to include in the run. "
                                           "Labels starting dir: are equivalent to top-level directories.")

    debugging_group = parser.add_argument_group("Debugging")
    debugging_group.add_argument('--debugger', const="__default__", nargs="?",
                                 help="run under a debugger, e.g. gdb or valgrind")
    debugging_group.add_argument('--debugger-args', help="arguments to the debugger")
    debugging_group.add_argument("--rerun", action="store", type=int, default=1,
                                 help="Number of times to re run each test without restarts")
    debugging_group.add_argument("--repeat", action="store", type=int, default=1,
                                 help="Number of times to run the tests, restarting between each run")
    debugging_group.add_argument("--repeat-until-unexpected", action="store_true", default=None,
                                 help="Run tests in a loop until one returns an unexpected result")
    debugging_group.add_argument('--pause-after-test', action="store_true", default=None,
                                 help="Halt the test runner after each test (this happens by default if only a single test is run)")
    debugging_group.add_argument('--no-pause-after-test', dest="pause_after_test", action="store_false",
                                 help="Don't halt the test runner irrespective of the number of tests run")

    debugging_group.add_argument('--pause-on-unexpected', action="store_true",
                                 help="Halt the test runner when an unexpected result is encountered")
    debugging_group.add_argument('--no-restart-on-unexpected', dest="restart_on_unexpected",
                                 default=True, action="store_false",
                                 help="Don't restart on an unexpected result")

    debugging_group.add_argument("--symbols-path", action="store", type=url_or_path,
                                 help="Path or url to symbols file used to analyse crash minidumps.")
    debugging_group.add_argument("--stackwalk-binary", action="store", type=abs_path,
                                 help="Path to stackwalker program used to analyse minidumps.")

    debugging_group.add_argument("--pdb", action="store_true",
                                 help="Drop into pdb on python exception")

    config_group = parser.add_argument_group("Configuration")
    config_group.add_argument("--binary", action="store",
                              type=abs_path, help="Binary to run tests against")
    config_group.add_argument('--binary-arg',
                              default=[], action="append", dest="binary_args",
                              help="Extra argument for the binary")
    config_group.add_argument("--webdriver-binary", action="store", metavar="BINARY",
                              type=abs_path, help="WebDriver server binary to use")
    config_group.add_argument('--webdriver-arg',
                              default=[], action="append", dest="webdriver_args",
                              help="Extra argument for the WebDriver binary")

    config_group.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                              help="Path to root directory containing test metadata"),
    config_group.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                              help="Path to root directory containing test files"),
    config_group.add_argument("--manifest", action="store", type=abs_path, dest="manifest_path",
                              help="Path to test manifest (default is ${metadata_root}/MANIFEST.json)")
    config_group.add_argument("--run-info", action="store", type=abs_path,
                              help="Path to directory containing extra json files to add to run info")
    config_group.add_argument("--product", action="store", choices=product_choices,
                              default=None, help="Browser against which to run tests")
    config_group.add_argument("--config", action="store", type=abs_path, dest="config",
                              help="Path to config file")
    config_group.add_argument("--install-fonts", action="store_true",
                              default=None,
                              help="Allow the wptrunner to install fonts on your system")
    config_group.add_argument("--font-dir", action="store", type=abs_path, dest="font_dir",
                              help="Path to local font installation directory", default=None)

    build_type = parser.add_mutually_exclusive_group()
    build_type.add_argument("--debug-build", dest="debug", action="store_true",
                            default=None,
                            help="Build is a debug build (overrides any mozinfo file)")
    build_type.add_argument("--release-build", dest="debug", action="store_false",
                            default=None,
                            help="Build is a release (overrides any mozinfo file)")


    chunking_group = parser.add_argument_group("Test Chunking")
    chunking_group.add_argument("--total-chunks", action="store", type=int, default=1,
                                help="Total number of chunks to use")
    chunking_group.add_argument("--this-chunk", action="store", type=int, default=1,
                                help="Chunk number to run")
    chunking_group.add_argument("--chunk-type", action="store", choices=["none", "equal_time", "hash", "dir_hash"],
                                default=None, help="Chunking type to use")

    ssl_group = parser.add_argument_group("SSL/TLS")
    ssl_group.add_argument("--ssl-type", action="store", default=None,
                        choices=["openssl", "pregenerated", "none"],
                        help="Type of ssl support to enable (running without ssl may lead to spurious errors)")

    ssl_group.add_argument("--openssl-binary", action="store",
                        help="Path to openssl binary", default="openssl")
    ssl_group.add_argument("--certutil-binary", action="store",
                        help="Path to certutil binary for use with Firefox + ssl")

    ssl_group.add_argument("--ca-cert-path", action="store", type=abs_path,
                        help="Path to ca certificate when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-key-path", action="store", type=abs_path,
                        help="Path to host private key when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-cert-path", action="store", type=abs_path,
                        help="Path to host certificate when using pregenerated ssl certificates")

    gecko_group = parser.add_argument_group("Gecko-specific")
    gecko_group.add_argument("--prefs-root", dest="prefs_root", action="store", type=abs_path,
                             help="Path to the folder containing browser prefs")
    gecko_group.add_argument("--disable-e10s", dest="gecko_e10s", action="store_false", default=True,
                             help="Run tests without electrolysis preferences")
    gecko_group.add_argument("--stackfix-dir", dest="stackfix_dir", action="store",
                             help="Path to directory containing assertion stack fixing scripts")
    gecko_group.add_argument("--setpref", dest="extra_prefs", action='append',
                             default=[], metavar="PREF=VALUE",
                             help="Defines an extra user preference (overrides those in prefs_root)")
    gecko_group.add_argument("--leak-check", dest="leak_check", action="store_true",
                             help="Enable leak checking")
    gecko_group.add_argument("--stylo-threads", action="store", type=int, default=1,
                             help="Number of parallel threads to use for stylo")
    gecko_group.add_argument("--reftest-internal", dest="reftest_internal", action="store_true",
                             default=None, help="Enable reftest runner implemented inside Marionette")
    gecko_group.add_argument("--reftest-external", dest="reftest_internal", action="store_false",
                             help="Disable reftest runner implemented inside Marionette")
    gecko_group.add_argument("--reftest-screenshot", dest="reftest_screenshot", action="store",
                             choices=["always", "fail", "unexpected"], default="unexpected",
                             help="With --reftest-internal, when to take a screenshot")
    gecko_group.add_argument("--chaos", dest="chaos_mode_flags", action="store",
                             nargs="?", const=0xFFFFFFFF, type=int,
                             help="Enable chaos mode with the specified feature flag "
                             "(see http://searchfox.org/mozilla-central/source/mfbt/ChaosMode.h for "
                             "details). If no value is supplied, all features are activated")

    servo_group = parser.add_argument_group("Servo-specific")
    servo_group.add_argument("--user-stylesheet",
                             default=[], action="append", dest="user_stylesheets",
                             help="Inject a user CSS stylesheet into every test.")

    sauce_group = parser.add_argument_group("Sauce Labs-specific")
    sauce_group.add_argument("--sauce-browser", dest="sauce_browser",
                             help="Sauce Labs browser name")
    sauce_group.add_argument("--sauce-platform", dest="sauce_platform",
                             help="Sauce Labs OS platform")
    sauce_group.add_argument("--sauce-version", dest="sauce_version",
                             help="Sauce Labs browser version")
    sauce_group.add_argument("--sauce-build", dest="sauce_build",
                             help="Sauce Labs build identifier")
    sauce_group.add_argument("--sauce-tags", dest="sauce_tags", nargs="*",
                             help="Sauce Labs identifying tag", default=[])
    sauce_group.add_argument("--sauce-tunnel-id", dest="sauce_tunnel_id",
                             help="Sauce Connect tunnel identifier")
    sauce_group.add_argument("--sauce-user", dest="sauce_user",
                             help="Sauce Labs user name")
    sauce_group.add_argument("--sauce-key", dest="sauce_key",
                             default=os.environ.get("SAUCE_ACCESS_KEY"),
                             help="Sauce Labs access key")
    sauce_group.add_argument("--sauce-connect-binary",
                             dest="sauce_connect_binary",
                             help="Path to Sauce Connect binary")

    webkit_group = parser.add_argument_group("WebKit-specific")
    webkit_group.add_argument("--webkit-port", dest="webkit_port",
                             help="WebKit port")

    parser.add_argument("test_list", nargs="*",
                        help="List of URLs for tests to run, or paths including tests to run. "
                             "(equivalent to --include)")

    commandline.log_formatters["wptreport"] = (formatters.WptreportFormatter, "wptreport format")

    commandline.add_logging_group(parser)
    return parser
Beispiel #5
0
def create_parser(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="Runner for web-platform-tests tests.")
    parser.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                        help="Path to web-platform-tests"),
    parser.add_argument("--prefs-root", dest="prefs_root", action="store", type=abs_path,
                        help="Path to the folder containing browser prefs"),
    parser.add_argument("--config", action="store", type=abs_path,
                        help="Path to config file")
    parser.add_argument("--binary", action="store",
                        type=abs_path, help="Binary to run tests against")
    parser.add_argument("--test-types", action="store",
                        nargs="*", default=["testharness", "reftest"],
                        choices=["testharness", "reftest"],
                        help="Test types to run")
    parser.add_argument("--processes", action="store", type=int, default=1,
                        help="Number of simultaneous processes to use")
    parser.add_argument("--include", action="append", type=slash_prefixed,
                        help="URL prefix to include")
    parser.add_argument("--exclude", action="append", type=slash_prefixed,
                        help="URL prefix to exclude")
    parser.add_argument("--include-manifest", type=abs_path,
                        help="Path to manifest listing tests to include")

    parser.add_argument("--run-by-dir", type=int, nargs="?", default=False,
                        help="Split run into groups by directories. With a parameter,"
                        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
                        "directory")

    parser.add_argument("--total-chunks", action="store", type=int, default=1,
                        help="Total number of chunks to use")
    parser.add_argument("--this-chunk", action="store", type=int, default=1,
                        help="Chunk number to run")
    parser.add_argument("--chunk-type", action="store", choices=["none", "equal_time", "hash"],
                        default=None, help="Chunking type to use")

    parser.add_argument("--list-test-groups", action="store_true",
                        default=False,
                        help="List the top level directories containing tests that will run.")
    parser.add_argument("--list-disabled", action="store_true",
                        default=False,
                        help="List the tests that are disabled on the current platform")

    parser.add_argument("--timeout-multiplier", action="store", type=float, default=None,
                        help="Multiplier relative to standard test timeout to use")
    parser.add_argument("--repeat", action="store", type=int, default=1,
                        help="Number of times to run the tests")

    parser.add_argument("--no-capture-stdio", action="store_true", default=False,
                        help="Don't capture stdio and write to logging")

    parser.add_argument("--product", action="store", choices=product_choices,
                        default="firefox", help="Browser against which to run tests")

    parser.add_argument('--debugger',
                        help="run under a debugger, e.g. gdb or valgrind")
    parser.add_argument('--debugger-args', help="arguments to the debugger")
    parser.add_argument('--pause-on-unexpected', action="store_true",
                        help="Halt the test runner when an unexpected result is encountered")

    parser.add_argument("--symbols-path", action="store", type=url_or_path,
                        help="Path or url to symbols file used to analyse crash minidumps.")
    parser.add_argument("--stackwalk-binary", action="store", type=abs_path,
                        help="Path to stackwalker program used to analyse minidumps.")

    parser.add_argument("--b2g-no-backup", action="store_true", default=False,
                        help="Don't backup device before testrun with --product=b2g")

    commandline.add_logging_group(parser)
    return parser
Beispiel #6
0
def create_parser(product_choices=None):
    from mozlog import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(
        description="""Runner for web-platform-tests tests.""",
        usage="""%(prog)s [OPTION]... [TEST]...

TEST is either the full path to a test file to run, or the URL of a test excluding
scheme host and port.""")
    parser.add_argument("--manifest-update",
                        action="store_true",
                        default=None,
                        help="Regenerate the test manifest.")
    parser.add_argument("--no-manifest-update",
                        action="store_false",
                        dest="manifest_update",
                        help="Prevent regeneration of the test manifest.")
    parser.add_argument(
        "--manifest-download",
        action="store_true",
        default=None,
        help="Attempt to download a preexisting manifest when updating.")

    parser.add_argument(
        "--timeout-multiplier",
        action="store",
        type=float,
        default=None,
        help="Multiplier relative to standard test timeout to use")
    parser.add_argument(
        "--run-by-dir",
        type=int,
        nargs="?",
        default=False,
        help="Split run into groups by directories. With a parameter,"
        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
        "directory")
    parser.add_argument("--processes",
                        action="store",
                        type=int,
                        default=None,
                        help="Number of simultaneous processes to use")

    parser.add_argument("--no-capture-stdio",
                        action="store_true",
                        default=False,
                        help="Don't capture stdio and write to logging")
    parser.add_argument(
        "--no-fail-on-unexpected",
        action="store_false",
        default=True,
        dest="fail_on_unexpected",
        help="Exit with status code 0 when test expectations are violated")

    mode_group = parser.add_argument_group("Mode")
    mode_group.add_argument(
        "--list-test-groups",
        action="store_true",
        default=False,
        help="List the top level directories containing tests that will run.")
    mode_group.add_argument(
        "--list-disabled",
        action="store_true",
        default=False,
        help="List the tests that are disabled on the current platform")
    mode_group.add_argument("--list-tests",
                            action="store_true",
                            default=False,
                            help="List all tests that will run")
    stability_group = mode_group.add_mutually_exclusive_group()
    stability_group.add_argument(
        "--verify",
        action="store_true",
        default=False,
        help="Run a stability check on the selected tests")
    stability_group.add_argument("--stability",
                                 action="store_true",
                                 default=False,
                                 help=argparse.SUPPRESS)
    mode_group.add_argument(
        "--verify-log-full",
        action="store_true",
        default=False,
        help="Output per-iteration test results when running verify")
    mode_group.add_argument(
        "--verify-repeat-loop",
        action="store",
        default=10,
        help=
        "Number of iterations for a run that reloads each test without restart.",
        type=int)
    mode_group.add_argument(
        "--verify-repeat-restart",
        action="store",
        default=5,
        help=
        "Number of iterations, for a run that restarts the runner between each iteration",
        type=int)
    chaos_mode_group = mode_group.add_mutually_exclusive_group()
    chaos_mode_group.add_argument(
        "--verify-no-chaos-mode",
        action="store_false",
        default=True,
        dest="verify_chaos_mode",
        help="Disable chaos mode when running on Firefox")
    chaos_mode_group.add_argument(
        "--verify-chaos-mode",
        action="store_true",
        default=True,
        dest="verify_chaos_mode",
        help="Enable chaos mode when running on Firefox")
    mode_group.add_argument(
        "--verify-max-time",
        action="store",
        default=None,
        help="The maximum number of minutes for the job to run",
        type=lambda x: timedelta(minutes=float(x)))
    output_results_group = mode_group.add_mutually_exclusive_group()
    output_results_group.add_argument(
        "--verify-no-output-results",
        action="store_false",
        dest="verify_output_results",
        default=True,
        help="Prints individuals test results and messages")
    output_results_group.add_argument(
        "--verify-output-results",
        action="store_true",
        dest="verify_output_results",
        default=True,
        help="Disable printing individuals test results and messages")

    test_selection_group = parser.add_argument_group("Test Selection")
    test_selection_group.add_argument("--test-types",
                                      action="store",
                                      nargs="*",
                                      default=wpttest.enabled_tests,
                                      choices=wpttest.enabled_tests,
                                      help="Test types to run")
    test_selection_group.add_argument("--include",
                                      action="append",
                                      help="URL prefix to include")
    test_selection_group.add_argument("--exclude",
                                      action="append",
                                      help="URL prefix to exclude")
    test_selection_group.add_argument(
        "--include-manifest",
        type=abs_path,
        help="Path to manifest listing tests to include")
    test_selection_group.add_argument(
        "--skip-timeout",
        action="store_true",
        help="Skip tests that are expected to time out")
    test_selection_group.add_argument(
        "--tag",
        action="append",
        dest="tags",
        help="Labels applied to tests to include in the run. "
        "Labels starting dir: are equivalent to top-level directories.")

    debugging_group = parser.add_argument_group("Debugging")
    debugging_group.add_argument(
        '--debugger',
        const="__default__",
        nargs="?",
        help="run under a debugger, e.g. gdb or valgrind")
    debugging_group.add_argument('--debugger-args',
                                 help="arguments to the debugger")
    debugging_group.add_argument(
        "--rerun",
        action="store",
        type=int,
        default=1,
        help="Number of times to re run each test without restarts")
    debugging_group.add_argument(
        "--repeat",
        action="store",
        type=int,
        default=1,
        help="Number of times to run the tests, restarting between each run")
    debugging_group.add_argument(
        "--repeat-until-unexpected",
        action="store_true",
        default=None,
        help="Run tests in a loop until one returns an unexpected result")
    debugging_group.add_argument(
        '--pause-after-test',
        action="store_true",
        default=None,
        help=
        "Halt the test runner after each test (this happens by default if only a single test is run)"
    )
    debugging_group.add_argument(
        '--no-pause-after-test',
        dest="pause_after_test",
        action="store_false",
        help=
        "Don't halt the test runner irrespective of the number of tests run")

    debugging_group.add_argument(
        '--pause-on-unexpected',
        action="store_true",
        help="Halt the test runner when an unexpected result is encountered")
    debugging_group.add_argument('--no-restart-on-unexpected',
                                 dest="restart_on_unexpected",
                                 default=True,
                                 action="store_false",
                                 help="Don't restart on an unexpected result")

    debugging_group.add_argument(
        "--symbols-path",
        action="store",
        type=url_or_path,
        help="Path or url to symbols file used to analyse crash minidumps.")
    debugging_group.add_argument(
        "--stackwalk-binary",
        action="store",
        type=abs_path,
        help="Path to stackwalker program used to analyse minidumps.")

    debugging_group.add_argument("--pdb",
                                 action="store_true",
                                 help="Drop into pdb on python exception")

    config_group = parser.add_argument_group("Configuration")
    config_group.add_argument("--binary",
                              action="store",
                              type=abs_path,
                              help="Desktop binary to run tests against")
    config_group.add_argument('--binary-arg',
                              default=[],
                              action="append",
                              dest="binary_args",
                              help="Extra argument for the binary")
    config_group.add_argument("--webdriver-binary",
                              action="store",
                              metavar="BINARY",
                              type=abs_path,
                              help="WebDriver server binary to use")
    config_group.add_argument('--webdriver-arg',
                              default=[],
                              action="append",
                              dest="webdriver_args",
                              help="Extra argument for the WebDriver binary")
    config_group.add_argument("--package-name",
                              action="store",
                              help="Android package name to run tests against")
    config_group.add_argument(
        "--device-serial",
        action="store",
        help="Running Android instance to connect to, if not emulator-5554")
    config_group.add_argument(
        "--metadata",
        action="store",
        type=abs_path,
        dest="metadata_root",
        help="Path to root directory containing test metadata"),
    config_group.add_argument(
        "--tests",
        action="store",
        type=abs_path,
        dest="tests_root",
        help="Path to root directory containing test files"),
    config_group.add_argument(
        "--manifest",
        action="store",
        type=abs_path,
        dest="manifest_path",
        help="Path to test manifest (default is ${metadata_root}/MANIFEST.json)"
    )
    config_group.add_argument(
        "--run-info",
        action="store",
        type=abs_path,
        help="Path to directory containing extra json files to add to run info"
    )
    config_group.add_argument("--product",
                              action="store",
                              choices=product_choices,
                              default=None,
                              help="Browser against which to run tests")
    config_group.add_argument(
        "--browser-version",
        action="store",
        default=None,
        help="Informative string detailing the browser "
        "release version. This is included in the run_info data.")
    config_group.add_argument(
        "--browser-channel",
        action="store",
        default=None,
        help="Informative string detailing the browser "
        "release channel. This is included in the run_info data.")
    config_group.add_argument("--config",
                              action="store",
                              type=abs_path,
                              dest="config",
                              help="Path to config file")
    config_group.add_argument(
        "--install-fonts",
        action="store_true",
        default=None,
        help="Allow the wptrunner to install fonts on your system")
    config_group.add_argument("--font-dir",
                              action="store",
                              type=abs_path,
                              dest="font_dir",
                              help="Path to local font installation directory",
                              default=None)
    config_group.add_argument("--headless",
                              action="store_true",
                              help="Run browser in headless mode",
                              default=None)
    config_group.add_argument("--no-headless",
                              action="store_false",
                              dest="headless",
                              help="Don't run browser in headless mode")

    build_type = parser.add_mutually_exclusive_group()
    build_type.add_argument(
        "--debug-build",
        dest="debug",
        action="store_true",
        default=None,
        help="Build is a debug build (overrides any mozinfo file)")
    build_type.add_argument(
        "--release-build",
        dest="debug",
        action="store_false",
        default=None,
        help="Build is a release (overrides any mozinfo file)")

    chunking_group = parser.add_argument_group("Test Chunking")
    chunking_group.add_argument("--total-chunks",
                                action="store",
                                type=int,
                                default=1,
                                help="Total number of chunks to use")
    chunking_group.add_argument("--this-chunk",
                                action="store",
                                type=int,
                                default=1,
                                help="Chunk number to run")
    chunking_group.add_argument(
        "--chunk-type",
        action="store",
        choices=["none", "equal_time", "hash", "dir_hash"],
        default=None,
        help="Chunking type to use")

    ssl_group = parser.add_argument_group("SSL/TLS")
    ssl_group.add_argument(
        "--ssl-type",
        action="store",
        default=None,
        choices=["openssl", "pregenerated", "none"],
        help=
        "Type of ssl support to enable (running without ssl may lead to spurious errors)"
    )

    ssl_group.add_argument("--openssl-binary",
                           action="store",
                           help="Path to openssl binary",
                           default="openssl")
    ssl_group.add_argument(
        "--certutil-binary",
        action="store",
        help="Path to certutil binary for use with Firefox + ssl")

    ssl_group.add_argument(
        "--ca-cert-path",
        action="store",
        type=abs_path,
        help="Path to ca certificate when using pregenerated ssl certificates")
    ssl_group.add_argument(
        "--host-key-path",
        action="store",
        type=abs_path,
        help="Path to host private key when using pregenerated ssl certificates"
    )
    ssl_group.add_argument(
        "--host-cert-path",
        action="store",
        type=abs_path,
        help="Path to host certificate when using pregenerated ssl certificates"
    )

    gecko_group = parser.add_argument_group("Gecko-specific")
    gecko_group.add_argument(
        "--prefs-root",
        dest="prefs_root",
        action="store",
        type=abs_path,
        help="Path to the folder containing browser prefs")
    gecko_group.add_argument("--disable-e10s",
                             dest="gecko_e10s",
                             action="store_false",
                             default=True,
                             help="Run tests without electrolysis preferences")
    gecko_group.add_argument(
        "--stackfix-dir",
        dest="stackfix_dir",
        action="store",
        help="Path to directory containing assertion stack fixing scripts")
    gecko_group.add_argument(
        "--setpref",
        dest="extra_prefs",
        action='append',
        default=[],
        metavar="PREF=VALUE",
        help="Defines an extra user preference (overrides those in prefs_root)"
    )
    gecko_group.add_argument(
        "--leak-check",
        dest="leak_check",
        action="store_true",
        default=None,
        help="Enable leak checking (enabled by default for debug builds, "
        "silently ignored for opt)")
    gecko_group.add_argument("--no-leak-check",
                             dest="leak_check",
                             action="store_false",
                             default=None,
                             help="Disable leak checking")
    gecko_group.add_argument(
        "--stylo-threads",
        action="store",
        type=int,
        default=1,
        help="Number of parallel threads to use for stylo")
    gecko_group.add_argument(
        "--reftest-internal",
        dest="reftest_internal",
        action="store_true",
        default=None,
        help="Enable reftest runner implemented inside Marionette")
    gecko_group.add_argument(
        "--reftest-external",
        dest="reftest_internal",
        action="store_false",
        help="Disable reftest runner implemented inside Marionette")
    gecko_group.add_argument(
        "--reftest-screenshot",
        dest="reftest_screenshot",
        action="store",
        choices=["always", "fail", "unexpected"],
        default="unexpected",
        help="With --reftest-internal, when to take a screenshot")
    gecko_group.add_argument(
        "--chaos",
        dest="chaos_mode_flags",
        action="store",
        nargs="?",
        const=0xFFFFFFFF,
        type=int,
        help="Enable chaos mode with the specified feature flag "
        "(see http://searchfox.org/mozilla-central/source/mfbt/ChaosMode.h for "
        "details). If no value is supplied, all features are activated")

    servo_group = parser.add_argument_group("Servo-specific")
    servo_group.add_argument(
        "--user-stylesheet",
        default=[],
        action="append",
        dest="user_stylesheets",
        help="Inject a user CSS stylesheet into every test.")

    sauce_group = parser.add_argument_group("Sauce Labs-specific")
    sauce_group.add_argument("--sauce-browser",
                             dest="sauce_browser",
                             help="Sauce Labs browser name")
    sauce_group.add_argument("--sauce-platform",
                             dest="sauce_platform",
                             help="Sauce Labs OS platform")
    sauce_group.add_argument("--sauce-version",
                             dest="sauce_version",
                             help="Sauce Labs browser version")
    sauce_group.add_argument("--sauce-build",
                             dest="sauce_build",
                             help="Sauce Labs build identifier")
    sauce_group.add_argument("--sauce-tags",
                             dest="sauce_tags",
                             nargs="*",
                             help="Sauce Labs identifying tag",
                             default=[])
    sauce_group.add_argument("--sauce-tunnel-id",
                             dest="sauce_tunnel_id",
                             help="Sauce Connect tunnel identifier")
    sauce_group.add_argument("--sauce-user",
                             dest="sauce_user",
                             help="Sauce Labs user name")
    sauce_group.add_argument("--sauce-key",
                             dest="sauce_key",
                             default=os.environ.get("SAUCE_ACCESS_KEY"),
                             help="Sauce Labs access key")
    sauce_group.add_argument("--sauce-connect-binary",
                             dest="sauce_connect_binary",
                             help="Path to Sauce Connect binary")
    sauce_group.add_argument("--sauce-init-timeout",
                             action="store",
                             type=int,
                             default=30,
                             help="Number of seconds to wait for Sauce "
                             "Connect tunnel to be available before "
                             "aborting")
    sauce_group.add_argument("--sauce-connect-arg",
                             action="append",
                             default=[],
                             dest="sauce_connect_args",
                             help="Command-line argument to forward to the "
                             "Sauce Connect binary (repeatable)")

    webkit_group = parser.add_argument_group("WebKit-specific")
    webkit_group.add_argument("--webkit-port",
                              dest="webkit_port",
                              help="WebKit port")

    parser.add_argument(
        "test_list",
        nargs="*",
        help="List of URLs for tests to run, or paths including tests to run. "
        "(equivalent to --include)")

    commandline.log_formatters["wptreport"] = (formatters.WptreportFormatter,
                                               "wptreport format")

    commandline.add_logging_group(parser)
    return parser
Beispiel #7
0
def create_parser_update(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(
        "web-platform-tests-update",
        description="Update script for web-platform-tests tests.")
    parser.add_argument("--product",
                        action="store",
                        choices=product_choices,
                        default=None,
                        help="Browser for which metadata is being updated")
    parser.add_argument("--config",
                        action="store",
                        type=abs_path,
                        help="Path to config file")
    parser.add_argument("--metadata",
                        action="store",
                        type=abs_path,
                        dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests",
                        action="store",
                        type=abs_path,
                        dest="tests_root",
                        help="Path to web-platform-tests"),
    parser.add_argument(
        "--sync-path",
        action="store",
        type=abs_path,
        help="Path to store git checkout of web-platform-tests during update"),
    parser.add_argument(
        "--remote_url",
        action="store",
        help="URL of web-platfrom-tests repository to sync against"),
    parser.add_argument("--branch",
                        action="store",
                        type=abs_path,
                        help="Remote branch to sync against")
    parser.add_argument("--rev", action="store", help="Revision to sync to")
    parser.add_argument(
        "--no-patch",
        action="store_true",
        help="Don't create an mq patch or git commit containing the changes.")
    parser.add_argument("--sync",
                        dest="sync",
                        action="store_true",
                        default=False,
                        help="Sync the tests with the latest from upstream")
    parser.add_argument(
        "--ignore-existing",
        action="store_true",
        help=
        "When updating test results only consider results from the logfiles provided, not existing expectations."
    )
    parser.add_argument(
        "--continue",
        action="store_true",
        help="Continue a previously started run of the update script")
    parser.add_argument(
        "--abort",
        action="store_true",
        help="Clear state from a previous incomplete run of the update script")
    # Should make this required iff run=logfile
    parser.add_argument("run_log",
                        nargs="*",
                        type=abs_path,
                        help="Log file from run of tests")
    commandline.add_logging_group(parser)
    return parser
Beispiel #8
0
def create_parser(product_choices=None):
    from mozlog import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(
        description="""Runner for web-platform-tests tests.""",
        usage="""%(prog)s [OPTION]... [TEST]...

TEST is either the full path to a test file to run, or the URL of a test excluding
scheme host and port.""")
    parser.add_argument("--manifest-update",
                        action="store_true",
                        default=False,
                        help="Regenerate the test manifest.")

    parser.add_argument(
        "--timeout-multiplier",
        action="store",
        type=float,
        default=None,
        help="Multiplier relative to standard test timeout to use")
    parser.add_argument(
        "--run-by-dir",
        type=int,
        nargs="?",
        default=False,
        help="Split run into groups by directories. With a parameter,"
        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
        "directory")
    parser.add_argument("--processes",
                        action="store",
                        type=int,
                        default=None,
                        help="Number of simultaneous processes to use")

    parser.add_argument("--no-capture-stdio",
                        action="store_true",
                        default=False,
                        help="Don't capture stdio and write to logging")

    mode_group = parser.add_argument_group("Mode")
    mode_group.add_argument(
        "--list-test-groups",
        action="store_true",
        default=False,
        help="List the top level directories containing tests that will run.")
    mode_group.add_argument(
        "--list-disabled",
        action="store_true",
        default=False,
        help="List the tests that are disabled on the current platform")

    test_selection_group = parser.add_argument_group("Test Selection")
    test_selection_group.add_argument("--test-types",
                                      action="store",
                                      nargs="*",
                                      default=wpttest.enabled_tests,
                                      choices=wpttest.enabled_tests,
                                      help="Test types to run")
    test_selection_group.add_argument("--include",
                                      action="append",
                                      help="URL prefix to include")
    test_selection_group.add_argument("--exclude",
                                      action="append",
                                      help="URL prefix to exclude")
    test_selection_group.add_argument(
        "--include-manifest",
        type=abs_path,
        help="Path to manifest listing tests to include")
    test_selection_group.add_argument(
        "--tag",
        action="append",
        dest="tags",
        help=
        "Labels applied to tests to include in the run. Labels starting dir: are equivalent to top-level directories."
    )

    debugging_group = parser.add_argument_group("Debugging")
    debugging_group.add_argument(
        '--debugger',
        const="__default__",
        nargs="?",
        help="run under a debugger, e.g. gdb or valgrind")
    debugging_group.add_argument('--debugger-args',
                                 help="arguments to the debugger")
    debugging_group.add_argument("--repeat",
                                 action="store",
                                 type=int,
                                 default=1,
                                 help="Number of times to run the tests")
    debugging_group.add_argument(
        "--repeat-until-unexpected",
        action="store_true",
        default=None,
        help="Run tests in a loop until one returns an unexpected result")
    debugging_group.add_argument(
        '--pause-after-test',
        action="store_true",
        default=None,
        help=
        "Halt the test runner after each test (this happens by default if only a single test is run)"
    )
    debugging_group.add_argument(
        '--no-pause-after-test',
        dest="pause_after_test",
        action="store_false",
        help=
        "Don't halt the test runner irrespective of the number of tests run")

    debugging_group.add_argument(
        '--pause-on-unexpected',
        action="store_true",
        help="Halt the test runner when an unexpected result is encountered")

    debugging_group.add_argument(
        "--symbols-path",
        action="store",
        type=url_or_path,
        help="Path or url to symbols file used to analyse crash minidumps.")
    debugging_group.add_argument(
        "--stackwalk-binary",
        action="store",
        type=abs_path,
        help="Path to stackwalker program used to analyse minidumps.")

    debugging_group.add_argument("--pdb",
                                 action="store_true",
                                 help="Drop into pdb on python exception")

    config_group = parser.add_argument_group("Configuration")
    config_group.add_argument("--binary",
                              action="store",
                              type=abs_path,
                              help="Binary to run tests against")
    config_group.add_argument('--binary-arg',
                              default=[],
                              action="append",
                              dest="binary_args",
                              help="Extra argument for the binary (servo)")
    config_group.add_argument("--webdriver-binary",
                              action="store",
                              metavar="BINARY",
                              type=abs_path,
                              help="WebDriver server binary to use")

    config_group.add_argument(
        "--metadata",
        action="store",
        type=abs_path,
        dest="metadata_root",
        help="Path to root directory containing test metadata"),
    config_group.add_argument(
        "--tests",
        action="store",
        type=abs_path,
        dest="tests_root",
        help="Path to root directory containing test files"),
    config_group.add_argument(
        "--run-info",
        action="store",
        type=abs_path,
        help="Path to directory containing extra json files to add to run info"
    )
    config_group.add_argument("--product",
                              action="store",
                              choices=product_choices,
                              default=None,
                              help="Browser against which to run tests")
    config_group.add_argument("--config",
                              action="store",
                              type=abs_path,
                              dest="config",
                              help="Path to config file")

    build_type = parser.add_mutually_exclusive_group()
    build_type.add_argument(
        "--debug-build",
        dest="debug",
        action="store_true",
        default=None,
        help="Build is a debug build (overrides any mozinfo file)")
    build_type.add_argument(
        "--release-build",
        dest="debug",
        action="store_false",
        default=None,
        help="Build is a release (overrides any mozinfo file)")

    chunking_group = parser.add_argument_group("Test Chunking")
    chunking_group.add_argument("--total-chunks",
                                action="store",
                                type=int,
                                default=1,
                                help="Total number of chunks to use")
    chunking_group.add_argument("--this-chunk",
                                action="store",
                                type=int,
                                default=1,
                                help="Chunk number to run")
    chunking_group.add_argument(
        "--chunk-type",
        action="store",
        choices=["none", "equal_time", "hash", "dir_hash"],
        default=None,
        help="Chunking type to use")

    ssl_group = parser.add_argument_group("SSL/TLS")
    ssl_group.add_argument(
        "--ssl-type",
        action="store",
        default=None,
        choices=["openssl", "pregenerated", "none"],
        help=
        "Type of ssl support to enable (running without ssl may lead to spurious errors)"
    )

    ssl_group.add_argument("--openssl-binary",
                           action="store",
                           help="Path to openssl binary",
                           default="openssl")
    ssl_group.add_argument(
        "--certutil-binary",
        action="store",
        help="Path to certutil binary for use with Firefox + ssl")

    ssl_group.add_argument(
        "--ca-cert-path",
        action="store",
        type=abs_path,
        help="Path to ca certificate when using pregenerated ssl certificates")
    ssl_group.add_argument(
        "--host-key-path",
        action="store",
        type=abs_path,
        help="Path to host private key when using pregenerated ssl certificates"
    )
    ssl_group.add_argument(
        "--host-cert-path",
        action="store",
        type=abs_path,
        help="Path to host certificate when using pregenerated ssl certificates"
    )

    gecko_group = parser.add_argument_group("Gecko-specific")
    gecko_group.add_argument(
        "--prefs-root",
        dest="prefs_root",
        action="store",
        type=abs_path,
        help="Path to the folder containing browser prefs")
    gecko_group.add_argument("--disable-e10s",
                             dest="gecko_e10s",
                             action="store_false",
                             default=True,
                             help="Run tests without electrolysis preferences")

    b2g_group = parser.add_argument_group("B2G-specific")
    b2g_group.add_argument(
        "--b2g-no-backup",
        action="store_true",
        default=False,
        help="Don't backup device before testrun with --product=b2g")

    servo_group = parser.add_argument_group("Servo-specific")
    servo_group.add_argument(
        "--user-stylesheet",
        default=[],
        action="append",
        dest="user_stylesheets",
        help="Inject a user CSS stylesheet into every test.")
    servo_group.add_argument("--servo-backend",
                             default="cpu",
                             choices=["cpu", "webrender"],
                             help="Rendering backend to use with Servo.")

    parser.add_argument(
        "test_list",
        nargs="*",
        help="List of URLs for tests to run, or paths including tests to run. "
        "(equivalent to --include)")

    commandline.add_logging_group(parser)
    return parser
Beispiel #9
0
def create_parser_update(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(
        "web-platform-tests-update",
        description="Update script for web-platform-tests tests.")
    parser.add_argument("--product",
                        action="store",
                        choices=product_choices,
                        default=None,
                        help="Browser for which metadata is being updated")
    parser.add_argument("--config",
                        action="store",
                        type=abs_path,
                        help="Path to config file")
    parser.add_argument("--metadata",
                        action="store",
                        type=abs_path,
                        dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests",
                        action="store",
                        type=abs_path,
                        dest="tests_root",
                        help="Path to web-platform-tests"),
    parser.add_argument(
        "--manifest",
        action="store",
        type=abs_path,
        dest="manifest_path",
        help="Path to test manifest (default is ${metadata_root}/MANIFEST.json)"
    )
    parser.add_argument(
        "--sync-path",
        action="store",
        type=abs_path,
        help="Path to store git checkout of web-platform-tests during update"),
    parser.add_argument(
        "--remote_url",
        action="store",
        help="URL of web-platfrom-tests repository to sync against"),
    parser.add_argument("--branch",
                        action="store",
                        type=abs_path,
                        help="Remote branch to sync against")
    parser.add_argument("--rev", action="store", help="Revision to sync to")
    parser.add_argument("--patch",
                        action="store_true",
                        dest="patch",
                        default=None,
                        help="Create a VCS commit containing the changes.")
    parser.add_argument(
        "--no-patch",
        action="store_false",
        dest="patch",
        help="Don't create a VCS commit containing the changes.")
    parser.add_argument(
        "--sync",
        dest="sync",
        action="store_true",
        default=False,
        help="Sync the tests with the latest from upstream (implies --patch)")
    parser.add_argument(
        "--ignore-existing",
        action="store_true",
        help=
        "When updating test results only consider results from the logfiles provided, not existing expectations."
    )
    parser.add_argument(
        "--stability",
        nargs="?",
        action="store",
        const="unstable",
        default=None,
        help=
        ("Reason for disabling tests. When updating test results, disable tests that have "
         "inconsistent results across many runs with the given reason."))
    parser.add_argument(
        "--no-remove-obsolete",
        action="store_false",
        dest="remove_obsolete",
        default=True,
        help=
        ("Don't remove metadata files that no longer correspond to a test file"
         ))
    parser.add_argument(
        "--no-store-state",
        action="store_false",
        dest="store_state",
        help="Store state so that steps can be resumed after failure")
    parser.add_argument(
        "--continue",
        action="store_true",
        help="Continue a previously started run of the update script")
    parser.add_argument(
        "--abort",
        action="store_true",
        help="Clear state from a previous incomplete run of the update script")
    parser.add_argument(
        "--exclude",
        action="store",
        nargs="*",
        help="List of glob-style paths to exclude when syncing tests")
    parser.add_argument(
        "--include",
        action="store",
        nargs="*",
        help=
        "List of glob-style paths to include which would otherwise be excluded when syncing tests"
    )
    parser.add_argument(
        "--extra-property",
        action="append",
        default=[],
        help="Extra property from run_info.json to use in metadata update")
    # Should make this required iff run=logfile
    parser.add_argument("run_log",
                        nargs="*",
                        type=abs_path,
                        help="Log file from run of tests")
    commandline.add_logging_group(parser)
    return parser
Beispiel #10
0
def create_parser(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="Runner for web-platform-tests tests.")
    parser.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                        help="Path to test files"),
    parser.add_argument("--run-info", action="store", type=abs_path,
                        help="Path to directory containing extra json files to add to run info")
    parser.add_argument("--config", action="store", type=abs_path, dest="config",
                        help="Path to config file")

    parser.add_argument("--manifest-update", action="store_true", default=False,
                        help="Force regeneration of the test manifest")

    parser.add_argument("--binary", action="store",
                        type=abs_path, help="Binary to run tests against")
    parser.add_argument("--webdriver-binary", action="store", metavar="BINARY",
                        type=abs_path, help="WebDriver server binary to use")
    parser.add_argument("--processes", action="store", type=int, default=None,
                        help="Number of simultaneous processes to use")

    parser.add_argument("--run-by-dir", type=int, nargs="?", default=False,
                        help="Split run into groups by directories. With a parameter,"
                        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
                        "directory")

    parser.add_argument("--timeout-multiplier", action="store", type=float, default=None,
                        help="Multiplier relative to standard test timeout to use")
    parser.add_argument("--repeat", action="store", type=int, default=1,
                        help="Number of times to run the tests")

    parser.add_argument("--no-capture-stdio", action="store_true", default=False,
                        help="Don't capture stdio and write to logging")

    parser.add_argument("--product", action="store", choices=product_choices,
                        default=None, help="Browser against which to run tests")

    parser.add_argument("--list-test-groups", action="store_true",
                        default=False,
                        help="List the top level directories containing tests that will run.")
    parser.add_argument("--list-disabled", action="store_true",
                        default=False,
                        help="List the tests that are disabled on the current platform")

    test_selection_group = parser.add_argument_group("Test Selection")
    test_selection_group.add_argument("--test-types", action="store",
                                      nargs="*", default=["testharness", "reftest"],
                                      choices=["testharness", "reftest"],
                                      help="Test types to run")
    test_selection_group.add_argument("--include", action="append",
                                      help="URL prefix to include")
    test_selection_group.add_argument("--exclude", action="append",
                                      help="URL prefix to exclude")
    test_selection_group.add_argument("--include-manifest", type=abs_path,
                                      help="Path to manifest listing tests to include")

    debugging_group = parser.add_argument_group("Debugging")
    debugging_group.add_argument('--debugger', const="__default__", nargs="?",
                                 help="run under a debugger, e.g. gdb or valgrind")
    debugging_group.add_argument('--debugger-args', help="arguments to the debugger")

    debugging_group.add_argument('--pause-after-test', action="store_true", default=None,
                                 help="Halt the test runner after each test (this happens by default if only a single test is run)")
    debugging_group.add_argument('--no-pause-after-test', dest="pause_after_test", action="store_false",
                                 help="Don't halt the test runner irrespective of the number of tests run")

    debugging_group.add_argument('--pause-on-unexpected', action="store_true",
                                 help="Halt the test runner when an unexpected result is encountered")

    debugging_group.add_argument("--symbols-path", action="store", type=url_or_path,
                                 help="Path or url to symbols file used to analyse crash minidumps.")
    debugging_group.add_argument("--stackwalk-binary", action="store", type=abs_path,
                                 help="Path to stackwalker program used to analyse minidumps.")

    chunking_group = parser.add_argument_group("Test Chunking")
    chunking_group.add_argument("--total-chunks", action="store", type=int, default=1,
                                help="Total number of chunks to use")
    chunking_group.add_argument("--this-chunk", action="store", type=int, default=1,
                                help="Chunk number to run")
    chunking_group.add_argument("--chunk-type", action="store", choices=["none", "equal_time", "hash"],
                                default=None, help="Chunking type to use")

    ssl_group = parser.add_argument_group("SSL/TLS")
    ssl_group.add_argument("--ssl-type", action="store", default=None,
                        choices=["openssl", "pregenerated", "none"],
                        help="Type of ssl support to enable (running without ssl may lead to spurious errors)")

    ssl_group.add_argument("--openssl-binary", action="store",
                        help="Path to openssl binary", default="openssl")
    ssl_group.add_argument("--certutil-binary", action="store",
                        help="Path to certutil binary for use with Firefox + ssl")

    ssl_group.add_argument("--ca-cert-path", action="store", type=abs_path,
                        help="Path to ca certificate when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-key-path", action="store", type=abs_path,
                        help="Path to host private key when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-cert-path", action="store", type=abs_path,
                        help="Path to host certificate when using pregenerated ssl certificates")

    gecko_group = parser.add_argument_group("Gecko-specific")
    gecko_group.add_argument("--prefs-root", dest="prefs_root", action="store", type=abs_path,
                             help="Path to the folder containing browser prefs")

    b2g_group = parser.add_argument_group("B2G-specific")
    b2g_group.add_argument("--b2g-no-backup", action="store_true", default=False,
                           help="Don't backup device before testrun with --product=b2g")

    parser.add_argument("test_list", nargs="*",
                        help="List of URLs for tests to run, or paths including tests to run. "
                             "(equivalent to --include)")

    commandline.add_logging_group(parser)
    return parser
Beispiel #11
0
def create_parser(product_choices=None):
    from mozlog import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="""Runner for web-platform-tests tests.""",
                                     usage="""%(prog)s [OPTION]... [TEST]...

TEST is either the full path to a test file to run, or the URL of a test excluding
scheme host and port.""")
    parser.add_argument("--manifest-update", action="store_true", default=False,
                        help="Regenerate the test manifest.")

    parser.add_argument("--timeout-multiplier", action="store", type=float, default=None,
                        help="Multiplier relative to standard test timeout to use")
    parser.add_argument("--run-by-dir", type=int, nargs="?", default=False,
                        help="Split run into groups by directories. With a parameter,"
                        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
                        "directory")
    parser.add_argument("--processes", action="store", type=int, default=None,
                        help="Number of simultaneous processes to use")

    parser.add_argument("--no-capture-stdio", action="store_true", default=False,
                        help="Don't capture stdio and write to logging")

    mode_group = parser.add_argument_group("Mode")
    mode_group.add_argument("--list-test-groups", action="store_true",
                            default=False,
                            help="List the top level directories containing tests that will run.")
    mode_group.add_argument("--list-disabled", action="store_true",
                            default=False,
                            help="List the tests that are disabled on the current platform")

    test_selection_group = parser.add_argument_group("Test Selection")
    test_selection_group.add_argument("--test-types", action="store",
                                      nargs="*", default=wpttest.enabled_tests,
                                      choices=wpttest.enabled_tests,
                                      help="Test types to run")
    test_selection_group.add_argument("--include", action="append",
                                      help="URL prefix to include")
    test_selection_group.add_argument("--exclude", action="append",
                                      help="URL prefix to exclude")
    test_selection_group.add_argument("--include-manifest", type=abs_path,
                                      help="Path to manifest listing tests to include")
    test_selection_group.add_argument("--tag", action="append", dest="tags",
                                      help="Labels applied to tests to include in the run. Labels starting dir: are equivalent to top-level directories.")

    debugging_group = parser.add_argument_group("Debugging")
    debugging_group.add_argument('--debugger', const="__default__", nargs="?",
                                 help="run under a debugger, e.g. gdb or valgrind")
    debugging_group.add_argument('--debugger-args', help="arguments to the debugger")
    debugging_group.add_argument("--repeat", action="store", type=int, default=1,
                                 help="Number of times to run the tests")
    debugging_group.add_argument("--repeat-until-unexpected", action="store_true", default=None,
                                 help="Run tests in a loop until one returns an unexpected result")
    debugging_group.add_argument('--pause-after-test', action="store_true", default=None,
                                 help="Halt the test runner after each test (this happens by default if only a single test is run)")
    debugging_group.add_argument('--no-pause-after-test', dest="pause_after_test", action="store_false",
                                 help="Don't halt the test runner irrespective of the number of tests run")

    debugging_group.add_argument('--pause-on-unexpected', action="store_true",
                                 help="Halt the test runner when an unexpected result is encountered")
    debugging_group.add_argument('--no-restart-on-unexpected', dest="restart_on_unexpected",
                                 default=True, action="store_false",
                                 help="Don't restart on an unexpected result")

    debugging_group.add_argument("--symbols-path", action="store", type=url_or_path,
                                 help="Path or url to symbols file used to analyse crash minidumps.")
    debugging_group.add_argument("--stackwalk-binary", action="store", type=abs_path,
                                 help="Path to stackwalker program used to analyse minidumps.")

    debugging_group.add_argument("--pdb", action="store_true",
                                 help="Drop into pdb on python exception")

    config_group = parser.add_argument_group("Configuration")
    config_group.add_argument("--binary", action="store",
                              type=abs_path, help="Binary to run tests against")
    config_group.add_argument('--binary-arg',
                              default=[], action="append", dest="binary_args",
                              help="Extra argument for the binary")
    config_group.add_argument("--webdriver-binary", action="store", metavar="BINARY",
                              type=abs_path, help="WebDriver server binary to use")
    config_group.add_argument('--webdriver-arg',
                              default=[], action="append", dest="webdriver_args",
                              help="Extra argument for the WebDriver binary")

    config_group.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                              help="Path to root directory containing test metadata"),
    config_group.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                              help="Path to root directory containing test files"),
    config_group.add_argument("--run-info", action="store", type=abs_path,
                              help="Path to directory containing extra json files to add to run info")
    config_group.add_argument("--product", action="store", choices=product_choices,
                              default=None, help="Browser against which to run tests")
    config_group.add_argument("--config", action="store", type=abs_path, dest="config",
                              help="Path to config file")

    build_type = parser.add_mutually_exclusive_group()
    build_type.add_argument("--debug-build", dest="debug", action="store_true",
                            default=None,
                            help="Build is a debug build (overrides any mozinfo file)")
    build_type.add_argument("--release-build", dest="debug", action="store_false",
                            default=None,
                            help="Build is a release (overrides any mozinfo file)")


    chunking_group = parser.add_argument_group("Test Chunking")
    chunking_group.add_argument("--total-chunks", action="store", type=int, default=1,
                                help="Total number of chunks to use")
    chunking_group.add_argument("--this-chunk", action="store", type=int, default=1,
                                help="Chunk number to run")
    chunking_group.add_argument("--chunk-type", action="store", choices=["none", "equal_time", "hash", "dir_hash"],
                                default=None, help="Chunking type to use")

    ssl_group = parser.add_argument_group("SSL/TLS")
    ssl_group.add_argument("--ssl-type", action="store", default=None,
                        choices=["openssl", "pregenerated", "none"],
                        help="Type of ssl support to enable (running without ssl may lead to spurious errors)")

    ssl_group.add_argument("--openssl-binary", action="store",
                        help="Path to openssl binary", default="openssl")
    ssl_group.add_argument("--certutil-binary", action="store",
                        help="Path to certutil binary for use with Firefox + ssl")

    ssl_group.add_argument("--ca-cert-path", action="store", type=abs_path,
                        help="Path to ca certificate when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-key-path", action="store", type=abs_path,
                        help="Path to host private key when using pregenerated ssl certificates")
    ssl_group.add_argument("--host-cert-path", action="store", type=abs_path,
                        help="Path to host certificate when using pregenerated ssl certificates")

    gecko_group = parser.add_argument_group("Gecko-specific")
    gecko_group.add_argument("--prefs-root", dest="prefs_root", action="store", type=abs_path,
                             help="Path to the folder containing browser prefs")
    gecko_group.add_argument("--disable-e10s", dest="gecko_e10s", action="store_false", default=True,
                             help="Run tests without electrolysis preferences")
    gecko_group.add_argument("--stackfix-dir", dest="stackfix_dir", action="store",
                             help="Path to directory containing assertion stack fixing scripts")
    gecko_group.add_argument("--setpref", dest="extra_prefs", action='append',
                             default=[], metavar="PREF=VALUE",
                             help="Defines an extra user preference (overrides those in prefs_root)")
    gecko_group.add_argument("--leak-check", dest="leak_check", action="store_true",
                             help="Enable leak checking")

    servo_group = parser.add_argument_group("Servo-specific")
    servo_group.add_argument("--user-stylesheet",
                             default=[], action="append", dest="user_stylesheets",
                             help="Inject a user CSS stylesheet into every test.")

    sauce_group = parser.add_argument_group("Sauce Labs-specific")
    sauce_group.add_argument("--sauce-browser", dest="sauce_browser",
                             help="Sauce Labs browser name")
    sauce_group.add_argument("--sauce-platform", dest="sauce_platform",
                             help="Sauce Labs OS platform")
    sauce_group.add_argument("--sauce-version", dest="sauce_version",
                             help="Sauce Labs browser version")
    sauce_group.add_argument("--sauce-build", dest="sauce_build",
                             help="Sauce Labs build identifier")
    sauce_group.add_argument("--sauce-tags", dest="sauce_tags", nargs="*",
                             help="Sauce Labs identifying tag", default=[])
    sauce_group.add_argument("--sauce-tunnel-id", dest="sauce_tunnel_id",
                             help="Sauce Connect tunnel identifier")
    sauce_group.add_argument("--sauce-user", dest="sauce_user",
                             help="Sauce Labs user name")
    sauce_group.add_argument("--sauce-key", dest="sauce_key",
                             default=os.environ.get("SAUCE_ACCESS_KEY"),
                             help="Sauce Labs access key")
    sauce_group.add_argument("--sauce-connect-binary",
                             dest="sauce_connect_binary",
                             help="Path to Sauce Connect binary")

    parser.add_argument("test_list", nargs="*",
                        help="List of URLs for tests to run, or paths including tests to run. "
                             "(equivalent to --include)")

    commandline.add_logging_group(parser)
    return parser
Beispiel #12
0
def create_parser(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="Runner for web-platform-tests tests.")
    parser.add_argument("--metadata", action="store", type=abs_path, dest="metadata_root",
                        help="Path to the folder containing test metadata"),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root",
                        help="Path to test files"),
    parser.add_argument("--prefs-root", dest="prefs_root", action="store", type=abs_path,
                        help="Path to the folder containing browser prefs"),
    parser.add_argument("--serve-root", action="store", type=abs_path, dest="serve_root",
                        help="Path to web-platform-tests checkout containing serve.py and manifest.py"
                        " (defaults to test_root)")
    parser.add_argument("--run-info", action="store", type=abs_path,
                        help="Path to directory containing extra json files to add to run info")
    parser.add_argument("--config", action="store", type=abs_path, dest="config",
                        help="Path to config file")

    parser.add_argument("--manifest-update", action="store_true", default=False,
                        help="Force regeneration of the test manifest")

    parser.add_argument("--binary", action="store",
                        type=abs_path, help="Binary to run tests against")
    parser.add_argument("--test-types", action="store",
                        nargs="*", default=["testharness", "reftest"],
                        choices=["testharness", "reftest"],
                        help="Test types to run")
    parser.add_argument("--processes", action="store", type=int, default=1,
                        help="Number of simultaneous processes to use")
    parser.add_argument("--include", action="append", type=slash_prefixed,
                        help="URL prefix to include")
    parser.add_argument("--exclude", action="append", type=slash_prefixed,
                        help="URL prefix to exclude")
    parser.add_argument("--include-manifest", type=abs_path,
                        help="Path to manifest listing tests to include")

    parser.add_argument("--run-by-dir", type=int, nargs="?", default=False,
                        help="Split run into groups by directories. With a parameter,"
                        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
                        "directory")

    parser.add_argument("--total-chunks", action="store", type=int, default=1,
                        help="Total number of chunks to use")
    parser.add_argument("--this-chunk", action="store", type=int, default=1,
                        help="Chunk number to run")
    parser.add_argument("--chunk-type", action="store", choices=["none", "equal_time", "hash"],
                        default=None, help="Chunking type to use")

    parser.add_argument("--list-test-groups", action="store_true",
                        default=False,
                        help="List the top level directories containing tests that will run.")
    parser.add_argument("--list-disabled", action="store_true",
                        default=False,
                        help="List the tests that are disabled on the current platform")

    parser.add_argument("--timeout-multiplier", action="store", type=float, default=None,
                        help="Multiplier relative to standard test timeout to use")
    parser.add_argument("--repeat", action="store", type=int, default=1,
                        help="Number of times to run the tests")

    parser.add_argument("--no-capture-stdio", action="store_true", default=False,
                        help="Don't capture stdio and write to logging")

    parser.add_argument("--product", action="store", choices=product_choices,
                        default="firefox", help="Browser against which to run tests")

    parser.add_argument('--debugger',
                        help="run under a debugger, e.g. gdb or valgrind")
    parser.add_argument('--debugger-args', help="arguments to the debugger")
    parser.add_argument('--pause-on-unexpected', action="store_true",
                        help="Halt the test runner when an unexpected result is encountered")

    parser.add_argument("--symbols-path", action="store", type=url_or_path,
                        help="Path or url to symbols file used to analyse crash minidumps.")
    parser.add_argument("--stackwalk-binary", action="store", type=abs_path,
                        help="Path to stackwalker program used to analyse minidumps.")

    parser.add_argument("--b2g-no-backup", action="store_true", default=False,
                        help="Don't backup device before testrun with --product=b2g")

    commandline.add_logging_group(parser)
    return parser
Beispiel #13
0
def create_parser(product_choices=None):
    from mozlog.structured import commandline

    import products

    if product_choices is None:
        config_data = config.load()
        product_choices = products.products_enabled(config_data)

    parser = argparse.ArgumentParser(description="Runner for web-platform-tests tests.")
    parser.add_argument(
        "--metadata",
        action="store",
        type=abs_path,
        dest="metadata_root",
        help="Path to the folder containing test metadata",
    ),
    parser.add_argument("--tests", action="store", type=abs_path, dest="tests_root", help="Path to test files"),
    parser.add_argument(
        "--prefs-root",
        dest="prefs_root",
        action="store",
        type=abs_path,
        help="Path to the folder containing browser prefs",
    ),
    parser.add_argument(
        "--serve-root",
        action="store",
        type=abs_path,
        dest="serve_root",
        help="Path to web-platform-tests checkout containing serve.py and manifest.py" " (defaults to test_root)",
    )
    parser.add_argument(
        "--run-info",
        action="store",
        type=abs_path,
        help="Path to directory containing extra json files to add to run info",
    )
    parser.add_argument("--config", action="store", type=abs_path, dest="config", help="Path to config file")

    parser.add_argument(
        "--manifest-update", action="store_true", default=False, help="Force regeneration of the test manifest"
    )

    parser.add_argument("--binary", action="store", type=abs_path, help="Binary to run tests against")
    parser.add_argument(
        "--webdriver-binary", action="store", metavar="BINARY", type=abs_path, help="WebDriver server binary to use"
    )
    parser.add_argument(
        "--test-types",
        action="store",
        nargs="*",
        default=["testharness", "reftest"],
        choices=["testharness", "reftest"],
        help="Test types to run",
    )
    parser.add_argument(
        "--processes", action="store", type=int, default=1, help="Number of simultaneous processes to use"
    )
    parser.add_argument("--include", action="append", type=slash_prefixed, help="URL prefix to include")
    parser.add_argument("--exclude", action="append", type=slash_prefixed, help="URL prefix to exclude")
    parser.add_argument("--include-manifest", type=abs_path, help="Path to manifest listing tests to include")

    parser.add_argument(
        "--run-by-dir",
        type=int,
        nargs="?",
        default=False,
        help="Split run into groups by directories. With a parameter,"
        "limit the depth of splits e.g. --run-by-dir=1 to split by top-level"
        "directory",
    )

    parser.add_argument("--total-chunks", action="store", type=int, default=1, help="Total number of chunks to use")
    parser.add_argument("--this-chunk", action="store", type=int, default=1, help="Chunk number to run")
    parser.add_argument(
        "--chunk-type",
        action="store",
        choices=["none", "equal_time", "hash"],
        default=None,
        help="Chunking type to use",
    )

    parser.add_argument(
        "--list-test-groups",
        action="store_true",
        default=False,
        help="List the top level directories containing tests that will run.",
    )
    parser.add_argument(
        "--list-disabled",
        action="store_true",
        default=False,
        help="List the tests that are disabled on the current platform",
    )

    parser.add_argument(
        "--timeout-multiplier",
        action="store",
        type=float,
        default=None,
        help="Multiplier relative to standard test timeout to use",
    )
    parser.add_argument("--repeat", action="store", type=int, default=1, help="Number of times to run the tests")

    parser.add_argument(
        "--no-capture-stdio", action="store_true", default=False, help="Don't capture stdio and write to logging"
    )

    parser.add_argument(
        "--product",
        action="store",
        choices=product_choices,
        default="firefox",
        help="Browser against which to run tests",
    )

    parser.add_argument("--debugger", help="run under a debugger, e.g. gdb or valgrind")
    parser.add_argument("--debugger-args", help="arguments to the debugger")
    parser.add_argument(
        "--pause-on-unexpected",
        action="store_true",
        help="Halt the test runner when an unexpected result is encountered",
    )

    parser.add_argument(
        "--symbols-path",
        action="store",
        type=url_or_path,
        help="Path or url to symbols file used to analyse crash minidumps.",
    )
    parser.add_argument(
        "--stackwalk-binary",
        action="store",
        type=abs_path,
        help="Path to stackwalker program used to analyse minidumps.",
    )

    parser.add_argument(
        "--ssl-type",
        action="store",
        default=None,
        choices=["openssl", "pregenerated", "none"],
        help="Type of ssl support to enable (running without ssl may lead to spurious errors)",
    )

    parser.add_argument("--openssl-binary", action="store", help="Path to openssl binary", default="openssl")
    parser.add_argument("--certutil-binary", action="store", help="Path to certutil binary for use with Firefox + ssl")

    parser.add_argument(
        "--ca-cert-path",
        action="store",
        type=abs_path,
        help="Path to ca certificate when using pregenerated ssl certificates",
    )
    parser.add_argument(
        "--host-key-path",
        action="store",
        type=abs_path,
        help="Path to host private key when using pregenerated ssl certificates",
    )
    parser.add_argument(
        "--host-cert-path",
        action="store",
        type=abs_path,
        help="Path to host certificate when using pregenerated ssl certificates",
    )

    parser.add_argument(
        "--b2g-no-backup",
        action="store_true",
        default=False,
        help="Don't backup device before testrun with --product=b2g",
    )

    commandline.add_logging_group(parser)
    return parser