1#!/usr/bin/env python
2# encoding: utf-8
3# Matthias Jahn jahn dôt matthias ât freenet dôt de 2007 (pmarat)
4
5"""
6Try to detect a C++ compiler from the list of supported compilers (g++, msvc, etc)::
7
8	def options(opt):
9		opt.load('compiler_cxx')
10	def configure(cnf):
11		cnf.load('compiler_cxx')
12	def build(bld):
13		bld.program(source='main.cpp', target='app')
14
15The compilers are associated to platforms in :py:attr:`waflib.Tools.compiler_cxx.cxx_compiler`. To register
16a new C++ compiler named *cfoo* (assuming the tool ``waflib/extras/cfoo.py`` exists), use::
17
18	from waflib.Tools.compiler_cxx import cxx_compiler
19	cxx_compiler['win32'] = ['cfoo', 'msvc', 'gcc']
20
21	def options(opt):
22		opt.load('compiler_cxx')
23	def configure(cnf):
24		cnf.load('compiler_cxx')
25	def build(bld):
26		bld.program(source='main.c', target='app')
27
28Not all compilers need to have a specific tool. For example, the clang compilers can be detected by the gcc tools when using::
29
30	$ CXX=clang waf configure
31"""
32
33
34import re
35from waflib.Tools import ccroot
36from waflib import Utils
37from waflib.Logs import debug
38
39cxx_compiler = {
40'win32':  ['msvc', 'g++', 'clang++'],
41'cygwin': ['g++'],
42'darwin': ['clang++', 'g++'],
43'aix':    ['xlc++', 'g++', 'clang++'],
44'linux':  ['g++', 'clang++', 'icpc'],
45'sunos':  ['sunc++', 'g++'],
46'irix':   ['g++'],
47'hpux':   ['g++'],
48'osf1V':  ['g++'],
49'gnu':    ['g++', 'clang++'],
50'java':   ['g++', 'msvc', 'clang++', 'icpc'],
51'default': ['clang++', 'g++']
52}
53"""
54Dict mapping the platform names to Waf tools finding specific C++ compilers::
55
56	from waflib.Tools.compiler_cxx import cxx_compiler
57	cxx_compiler['linux'] = ['gxx', 'icpc', 'suncxx']
58"""
59
60def default_compilers():
61	build_platform = Utils.unversioned_sys_platform()
62	possible_compiler_list = cxx_compiler.get(build_platform, cxx_compiler['default'])
63	return ' '.join(possible_compiler_list)
64
65def configure(conf):
66	"""
67	Detects a suitable C++ compiler
68
69	:raises: :py:class:`waflib.Errors.ConfigurationError` when no suitable compiler is found
70	"""
71	try:
72		test_for_compiler = conf.options.check_cxx_compiler or default_compilers()
73	except AttributeError:
74		conf.fatal("Add options(opt): opt.load('compiler_cxx')")
75
76	for compiler in re.split('[ ,]+', test_for_compiler):
77		conf.env.stash()
78		conf.start_msg('Checking for %r (C++ compiler)' % compiler)
79		try:
80			conf.load(compiler)
81		except conf.errors.ConfigurationError as e:
82			conf.env.revert()
83			conf.end_msg(False)
84			debug('compiler_cxx: %r', e)
85		else:
86			if conf.env.CXX:
87				conf.end_msg(conf.env.get_flat('CXX'))
88				conf.env.COMPILER_CXX = compiler
89				conf.env.commit()
90				break
91			conf.env.revert()
92			conf.end_msg(False)
93	else:
94		conf.fatal('could not configure a C++ compiler!')
95
96def options(opt):
97	"""
98	This is how to provide compiler preferences on the command-line::
99
100		$ waf configure --check-cxx-compiler=gxx
101	"""
102	test_for_compiler = default_compilers()
103	opt.load_special_tools('cxx_*.py')
104	cxx_compiler_opts = opt.add_option_group('Configuration options')
105	cxx_compiler_opts.add_option('--check-cxx-compiler', default=None,
106		help='list of C++ compilers to try [%s]' % test_for_compiler,
107		dest="check_cxx_compiler")
108
109	for x in test_for_compiler.split():
110		opt.load('%s' % x)
111
112