Ben Murdoch | 097c5b2 | 2016-05-18 11:27:45 +0100 | [diff] [blame] | 1 | # Copyright (c) 2011 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 an target to create a unittest that |
| 6 | # invokes a set of no-compile tests. A no-compile test is a test that asserts |
| 7 | # a particular construct will not compile. |
| 8 | # |
| 9 | # Also see: |
| 10 | # http://dev.chromium.org/developers/testing/no-compile-tests |
| 11 | # |
| 12 | # To use this, create a gyp target with the following form: |
| 13 | # |
| 14 | # import("//build/nocompile.gni") |
| 15 | # nocompile_test("my_module_nc_unittests") { |
| 16 | # sources = [ |
| 17 | # 'nc_testset_1.nc', |
| 18 | # 'nc_testset_2.nc', |
| 19 | # ] |
| 20 | # } |
| 21 | # |
| 22 | # The .nc files are C++ files that contain code we wish to assert will not |
| 23 | # compile. Each individual test case in the file should be put in its own |
| 24 | # #ifdef section. The expected output should be appended with a C++-style |
| 25 | # comment that has a python list of regular expressions. This will likely |
| 26 | # be greater than 80-characters. Giving a solid expected output test is |
| 27 | # important so that random compile failures do not cause the test to pass. |
| 28 | # |
| 29 | # Example .nc file: |
| 30 | # |
| 31 | # #if defined(TEST_NEEDS_SEMICOLON) // [r"expected ',' or ';' at end of input"] |
| 32 | # |
| 33 | # int a = 1 |
| 34 | # |
| 35 | # #elif defined(TEST_NEEDS_CAST) // [r"invalid conversion from 'void*' to 'char*'"] |
| 36 | # |
| 37 | # void* a = NULL; |
| 38 | # char* b = a; |
| 39 | # |
| 40 | # #endif |
| 41 | # |
| 42 | # If we needed disable TEST_NEEDS_SEMICOLON, then change the define to: |
| 43 | # |
| 44 | # DISABLE_TEST_NEEDS_SEMICOLON |
| 45 | # TEST_NEEDS_CAST |
| 46 | # |
| 47 | # The lines above are parsed by a regexp so avoid getting creative with the |
| 48 | # formatting or ifdef logic; it will likely just not work. |
| 49 | # |
| 50 | # Implementation notes: |
| 51 | # The .nc files are actually processed by a python script which executes the |
| 52 | # compiler and generates a .cc file that is empty on success, or will have a |
| 53 | # series of #error lines on failure, and a set of trivially passing gunit |
| 54 | # TEST() functions on success. This allows us to fail at the compile step when |
| 55 | # something goes wrong, and know during the unittest run that the test was at |
| 56 | # least processed when things go right. |
| 57 | |
| 58 | import("//testing/test.gni") |
| 59 | |
| 60 | declare_args() { |
| 61 | # TODO(crbug.com/105388): Disabled until http://crbug.com/105388 is resolved. |
| 62 | enable_nocompile_tests = false |
| 63 | } |
| 64 | |
| 65 | if (enable_nocompile_tests) { |
| 66 | template("nocompile_test") { |
| 67 | nocompile_target = target_name + "_run_nocompile" |
| 68 | |
| 69 | action_foreach(nocompile_target) { |
| 70 | script = "//tools/nocompile_driver.py" |
| 71 | sources = invoker.sources |
| 72 | |
| 73 | result_path = "$target_gen_dir/{{source_name_part}}_nc.cc" |
| 74 | depfile = "${result_path}.d" |
| 75 | outputs = [ |
| 76 | result_path, |
| 77 | ] |
| 78 | args = [ |
| 79 | "4", # number of compilers to invoke in parallel. |
| 80 | "{{source}}", |
| 81 | "-Wall -Werror -Wfatal-errors " + "-I" + |
| 82 | rebase_path("//", root_build_dir), |
| 83 | "{{output}}", |
| 84 | ] |
| 85 | } |
| 86 | |
| 87 | test(target_name) { |
| 88 | deps = invoker.deps + [ ":$nocompile_target" ] |
| 89 | sources = get_target_outputs(":$nocompile_target") |
| 90 | } |
| 91 | } |
| 92 | } |