# This Source Code Form is subject to the terms of the Mozilla Public # License, v. 2.0. If a copy of the MPL was not distributed with this # file, You can obtain one at http://mozilla.org/MPL/2.0/. from __future__ import absolute_import, print_function, unicode_literals import argparse import os import sys from mach.decorators import ( CommandProvider, Command, SettingsProvider, SubCommand, ) from mozbuild.base import BuildEnvironmentNotFoundException, MachCommandBase CONFIG_ENVIRONMENT_NOT_FOUND = ''' No config environment detected. This means we are unable to properly detect test files in the specified paths or tags. Please run: $ mach configure and try again. '''.lstrip() def syntax_parser(): from tryselect.selectors.syntax import SyntaxParser parser = SyntaxParser() return parser def fuzzy_parser(): from tryselect.selectors.fuzzy import FuzzyParser return FuzzyParser() def empty_parser(): from tryselect.selectors.empty import EmptyParser return EmptyParser() def generic_parser(): from tryselect.cli import BaseTryParser parser = BaseTryParser() parser.add_argument('argv', nargs=argparse.REMAINDER) return parser @SettingsProvider class TryConfig(object): @classmethod def config_settings(cls): from mach.registrar import Registrar desc = "The default selector to use when running `mach try` without a subcommand." choices = Registrar.command_handlers['try'].subcommand_handlers.keys() return [('try.default', 'string', desc, 'syntax', {'choices': choices})] @CommandProvider class TrySelect(MachCommandBase): @Command('try', category='ci', description='Push selected tasks to the try server', parser=generic_parser) def try_default(self, argv, **kwargs): """Push selected tests to the try server. The |mach try| command is a frontend for scheduling tasks to run on try server using selectors. A selector is a subcommand that provides its own set of command line arguments and are listed below. If no subcommand is specified, the `syntax` selector is run by default. Run |mach try syntax --help| for more information on scheduling with the `syntax` selector. """ from tryselect import preset if kwargs['mod_presets']: getattr(preset, kwargs['mod_presets'])() return # We do special handling of presets here so that `./mach try --preset foo` # works no matter what subcommand 'foo' was saved with. sub = self._mach_context.settings['try']['default'] if kwargs['preset']: _, section = preset.load(kwargs['preset']) sub = 'syntax' if section == 'try' else section return self._mach_context.commands.dispatch( 'try', subcommand=sub, context=self._mach_context, argv=argv, **kwargs) @SubCommand('try', 'fuzzy', description='Select tasks on try using a fuzzy finder', parser=fuzzy_parser) def try_fuzzy(self, **kwargs): """Select which tasks to use with fzf. This selector runs all task labels through a fuzzy finding interface. All selected task labels and their dependencies will be scheduled on try. Keyboard Shortcuts ------------------ When in the fuzzy finder interface, start typing to filter down the task list. Then use the following keyboard shortcuts to select tasks: accept: cancel: or cursor-up: or cursor-down: or toggle-select-down: toggle-select-up: select-all: deselect-all: toggle-all: clear-input: There are many more shortcuts enabled by default, you can also define your own shortcuts by setting `--bind` in the $FZF_DEFAULT_OPTS environment variable. See `man fzf` for more info. Extended Search --------------- When typing in search terms, the following modifiers can be applied: 'word: exact match (line must contain the literal string "word") ^word: exact prefix match (line must start with literal "word") word$: exact suffix match (line must end with literal "word") !word: exact negation match (line must not contain literal "word") 'a | 'b: OR operator (joins two exact match operators together) For example: ^start 'exact | !ignore fuzzy end$ """ from tryselect.selectors.fuzzy import run_fuzzy_try return run_fuzzy_try(**kwargs) @SubCommand('try', 'empty', description='Push to try without scheduling any tasks.', parser=empty_parser) def try_empty(self, **kwargs): """Push to try, running no builds or tests This selector does not prompt you to run anything, it just pushes your patches to try, running no builds or tests by default. After the push finishes, you can manually add desired jobs to your push via Treeherder's Add New Jobs feature, located in the per-push menu. """ from tryselect.selectors.empty import run_empty_try return run_empty_try(**kwargs) @SubCommand('try', 'syntax', description='Select tasks on try using try syntax', parser=syntax_parser) def try_syntax(self, **kwargs): """Push the current tree to try, with the specified syntax. Build options, platforms and regression tests may be selected using the usual try options (-b, -p and -u respectively). In addition, tests in a given directory may be automatically selected by passing that directory as a positional argument to the command. For example: mach try -b d -p linux64 dom testing/web-platform/tests/dom would schedule a try run for linux64 debug consisting of all tests under dom/ and testing/web-platform/tests/dom. Test selection using positional arguments is available for mochitests, reftests, xpcshell tests and web-platform-tests. Tests may be also filtered by passing --tag to the command, which will run only tests marked as having the specified tags e.g. mach try -b d -p win64 --tag media would run all tests tagged 'media' on Windows 64. If both positional arguments or tags and -u are supplied, the suites in -u will be run in full. Where tests are selected by positional argument they will be run in a single chunk. If no build option is selected, both debug and opt will be scheduled. If no platform is selected a default is taken from the AUTOTRY_PLATFORM_HINT environment variable, if set. The command requires either its own mercurial extension ("push-to-try", installable from mach mercurial-setup) or a git repo using git-cinnabar (available at https://github.com/glandium/git-cinnabar). """ from tryselect.selectors.syntax import AutoTry try: if self.substs.get("MOZ_ARTIFACT_BUILDS"): kwargs['local_artifact_build'] = True except BuildEnvironmentNotFoundException: # If we don't have a build locally, we can't tell whether # an artifact build is desired, but we still want the # command to succeed, if possible. pass config_status = os.path.join(self.topobjdir, 'config.status') if (kwargs['paths'] or kwargs['tags']) and not config_status: print(CONFIG_ENVIRONMENT_NOT_FOUND) sys.exit(1) at = AutoTry(self.topsrcdir, self._mach_context) return at.run(**kwargs)