1 # Copyright (c) 2012 The Chromium Authors. All rights reserved. 2 # Use of this source code is governed by a BSD-style license that can be 3 # found in the LICENSE file. 4 5 # This file is meant to be included into a target to provide a rule 6 # to "build" .isolate files into a .isolated file. 7 # 8 # To use this, create a gyp target with the following form: 9 # 'conditions': [ 10 # ['test_isolation_mode != "noop"', { 11 # 'targets': [ 12 # { 13 # 'target_name': 'foo_test_run', 14 # 'type': 'none', 15 # 'dependencies': [ 16 # 'foo_test', 17 # ], 18 # 'includes': [ 19 # '../build/isolate.gypi', 20 # 'foo_test.isolate', 21 # ], 22 # 'sources': [ 23 # 'foo_test.isolate', 24 # ], 25 # }, 26 # ], 27 # }], 28 # ], 29 # 30 # Note: foo_test.isolate is included and a source file. It is an inherent 31 # property of the .isolate format. This permits to define GYP variables but is 32 # a stricter format than GYP so isolate.py can read it. 33 # 34 # The generated .isolated file will be: 35 # <(PRODUCT_DIR)/foo_test.isolated 36 37 { 38 'rules': [ 39 { 40 'rule_name': 'isolate', 41 'extension': 'isolate', 42 'inputs': [ 43 # Files that are known to be involved in this step. 44 '<(DEPTH)/tools/swarm_client/isolate.py', 45 '<(DEPTH)/tools/swarm_client/isolateserver_archive.py', 46 '<(DEPTH)/tools/swarm_client/run_isolated.py', 47 '<(DEPTH)/tools/swarm_client/googletest/run_test_cases.py', 48 '<(DEPTH)/tools/swarm_client/short_expression_finder.py', 49 '<(DEPTH)/tools/swarm_client/trace_inputs.py', 50 51 # Disable file tracking by the build driver for now. This means the 52 # project must have the proper build-time dependency for their runtime 53 # dependency. This improves the runtime of the build driver since it 54 # doesn't have to stat() all these files. 55 # 56 # More importantly, it means that even if a isolate_dependency_tracked 57 # file is missing, for example if a file was deleted and the .isolate 58 # file was not updated, that won't break the build, especially in the 59 # case where foo_tests_run is not built! This should be reenabled once 60 # the switch-over to running tests on Swarm is completed. 61 #'<@(isolate_dependency_tracked)', 62 ], 63 'outputs': [ 64 '<(PRODUCT_DIR)/<(RULE_INPUT_ROOT).isolated', 65 ], 66 'conditions': [ 67 ["test_isolation_outdir==''", { 68 'action': [ 69 'python', 70 '<(DEPTH)/tools/swarm_client/isolate.py', 71 '<(test_isolation_mode)', 72 # GYP will eliminate duplicate arguments so '<(PRODUCT_DIR)' cannot 73 # be provided twice. To work around this behavior, append '/'. 74 # 75 # Also have a space after <(PRODUCT_DIR) or visual studio will 76 # escape the argument wrappping " with the \ and merge it into 77 # the following arguments. 78 # 79 # Other variables should use the -V FOO=<(FOO) form so frequent 80 # values, like '0' or '1', aren't stripped out by GYP. 81 '--outdir', '<(PRODUCT_DIR)/ ', 82 '--variable', 'PRODUCT_DIR', '<(PRODUCT_DIR) ', 83 '--variable', 'OS=<(OS)', 84 '--result', '<@(_outputs)', 85 '--isolate', '<(RULE_INPUT_PATH)', 86 ], 87 }, { 88 'action': [ 89 'python', 90 '<(DEPTH)/tools/swarm_client/isolate.py', 91 '<(test_isolation_mode)', 92 '--outdir', '<(test_isolation_outdir)', 93 # See comment above. 94 '--variable', 'PRODUCT_DIR', '<(PRODUCT_DIR) ', 95 '--variable', 'OS=<(OS)', 96 '--result', '<@(_outputs)', 97 '--isolate', '<(RULE_INPUT_PATH)', 98 ], 99 }], 100 ['test_isolation_fail_on_missing == 0', { 101 'action': ['--ignore_broken_items'], 102 }, 103 ], 104 ], 105 106 'msvs_cygwin_shell': 0, 107 }, 108 ], 109 } 110