Class CompilerTable

source code

         object --+            
                  |            
extension.Extension --+        
                      |        
      runnable.Runnable --+    
                          |    
          resource.Resource --+
                              |
                             CompilerTable

A map from programming languages to 'Compiler's.

The 'CompilerTable' resource uses the context to determine which
compilers the user wants to test.  Test databases containing
compiler tests should arrange for the tests they compain to depend
on a 'CompilerTable' resource.

The first context variable which is examined is
'CompilerTable.languages'.  The value should be a
whitespace-separated list of programming language names.  (See
below for standardized names for some languages.)

Then, for each language 'l' in the list of languages, the
following context variables are examined:

- 'CompilerTable.l_kind'

  The kind of compiler (e.g., "GCC" or "EDG") used to compile
  programs of language 'l'.  The 'kind' must name a class derived
  from 'Compiler'.

- 'CompilerTable.l_path'

  The path to the compiler for language 'l'.  This path may be
  either absolute or relative.

- 'CompilerTable.l_options'

  A whitespace-separated list of command-line options to provide
  to the compiler for language 'l'.  These options are passed to
  the constructor for the 'Compiler' object; generally, all tests
  are run with these options, followed by any test-specific
  options.  For example, if the user wants to test the compiler
  when run with '-O2', the user would put '-O2' in the 'l_options'
  context variable.

The 'CompilerTable' resource provides the following context
variables to all tests that depend upon the resource:

- 'CompilerTable.compilers'

   The 'compilers' variable is a map from language names to
   instances of 'Compiler'.  Test classes should obtain the
   'Compiler' to use when compiling source files by using this
   map.

- 'CompilerTable.target'

   An instance of 'Host' that can be used to run compiler
   programs.