build/nocompile.gypi

   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 #   'target_name': 'my_module_nc_unittests',
  15 #   'type': 'executable',
  16 #   'sources': [
  17 #     'nc_testset_1.nc',
  18 #     'nc_testset_2.nc',
  19 #   ],
  20 #   'includes': ['path/to/this/gypi/file'],
  21 # }
  22 #
  23 # The .nc files are C++ files that contain code we wish to assert will not
  24 # compile.  Each individual test case in the file should be put in its own
  25 # #ifdef section.  The expected output should be appended with a C++-style
  26 # comment that has a python list of regular expressions.  This will likely
  27 # be greater than 80-characters. Giving a solid expected output test is
  28 # important so that random compile failures do not cause the test to pass.
  29 #
  30 # Example .nc file:
  31 #
  32 #   #if defined(TEST_NEEDS_SEMICOLON)  // [r"expected ',' or ';' at end of input"]
  33 #
  34 #   int a = 1
  35 #
  36 #   #elif defined(TEST_NEEDS_CAST)  // [r"invalid conversion from 'void*' to 'char*'"]
  37 #
  38 #   void* a = NULL;
  39 #   char* b = a;
  40 #
  41 #   #endif
  42 #
  43 # If we needed disable TEST_NEEDS_SEMICOLON, then change the define to:
  44 #
  45 #   DISABLE_TEST_NEEDS_SEMICOLON
  46 #   TEST_NEEDS_CAST
  47 #
  48 # The lines above are parsed by a regexp so avoid getting creative with the
  49 # formatting or ifdef logic; it will likely just not work.
  50 #
  51 # Implementation notes:
  52 # The .nc files are actually processed by a python script which executes the
  53 # compiler and generates a .cc file that is empty on success, or will have a
  54 # series of #error lines on failure, and a set of trivially passing gunit
  55 # TEST() functions on success. This allows us to fail at the compile step when
  56 # something goes wrong, and know during the unittest run that the test was at
  57 # least processed when things go right.
  58
  59 {
  60   # TODO(awong): Disabled until http://crbug.com/105388 is resolved.
  61   'sources/': [['exclude', '\\.nc$']],
  62   'conditions': [
  63     [ 'OS!="win" and clang==1', {
  64       'rules': [
  65         {
  66           'variables': {
  67             'nocompile_driver': '<(DEPTH)/tools/nocompile_driver.py',
  68             'nc_result_path': ('<(INTERMEDIATE_DIR)/<(module_dir)/'
  69                                '<(RULE_INPUT_ROOT)_nc.cc'),
  70            },
  71           'rule_name': 'run_nocompile',
  72           'extension': 'nc',
  73           'inputs': [
  74             '<(nocompile_driver)',
  75           ],
  76           'outputs': [
  77             '<(nc_result_path)'
  78           ],
  79           'action': [
  80             'python',
  81             '<(nocompile_driver)',
  82             '4', # number of compilers to invoke in parallel.
  83             '<(RULE_INPUT_PATH)',
  84             '-Wall -Werror -Wfatal-errors -I<(DEPTH)',
  85             '<(nc_result_path)',
  86             ],
  87           'message': 'Generating no compile results for <(RULE_INPUT_PATH)',
  88           'process_outputs_as_sources': 1,
  89         },
  90       ],
  91     }, {
  92       'sources/': [['exclude', '\\.nc$']]
  93     }],  # 'OS!="win" and clang=="1"'
  94   ],
  95 }
  96