isolate: add run_isolated, deprecate runtest

scripts/slave/recipe_modules/isolate/example.py

 # Copyright 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 DEPS = [
   'chromium',
   'isolate',
   'json',
   'path',
   'properties',
@@ skipping 22 matching lines @@
   # TODO(vadimsh): This step doesn't actually make any sense when the recipe
   # is running for real via run_recipe.py.
   api.isolate.find_isolated_tests(api.path['build'], expected_targets)
 
   # Code coverage for 'isolate_tests'. 'isolated_test' doesn't support discovery
   # of isolated targets in build directory, so skip if 'expected_targets' is
   # None.
   if expected_targets is not None:
     api.isolate.isolate_tests(api.path['build'], expected_targets)
 
+  # Code coverage for 'run_isolated'.
+  # TODO(phajdan.jr): Remove once used by other recipes.
+  api.isolate.run_isolated(
+      'base_unittests', '7b28d637ab6bb2516584c21e1098736682457f11')
+
 
 def GenTests(api):
   def make_test(name, expected_targets, discovered_targets):
     missing = set(expected_targets or []) - set(discovered_targets or [])
     output = (
         api.test(name) +
         api.step_data(
             'read test spec', stdout=api.json.output(expected_targets)) +
         api.override_step_data(
             'find isolated tests', api.isolate.output_json(discovered_targets))
@@ skipping 10 matching lines @@
   # No expectations, just discovering what's there returned by default mock.
   yield make_test('discover', None, None)
   # Found more than expected.
   yield make_test('extra', ['test1', 'test2'], ['test1', 'test2', 'extra_test'])
   # Didn't find something.
   yield (
       make_test('missing', ['test1', 'test2'], ['test1']) +
       api.properties.generic(buildername='Windows Swarm Test'))
   # No expectations, and nothing has been found, produces warning.
   yield make_test('none', None, [])