1#!/usr/bin/env python
2# encoding: utf-8
3# Thomas Nagy, 2007-2015 (ita)
4# Gustavo Carneiro (gjc), 2007
5
6"""
7Support for Python, detect the headers and libraries and provide
8*use* variables to link C/C++ programs against them::
9
10	def options(opt):
11		opt.load('compiler_c python')
12	def configure(conf):
13		conf.load('compiler_c python')
14		conf.check_python_version((2,4,2))
15		conf.check_python_headers()
16	def build(bld):
17		bld.program(features='pyembed', source='a.c', target='myprog')
18		bld.shlib(features='pyext', source='b.c', target='mylib')
19"""
20
21import os, sys
22from waflib import Errors, Logs, Node, Options, Task, Utils
23from waflib.TaskGen import extension, before_method, after_method, feature
24from waflib.Configure import conf
25
26FRAG = '''
27#include <Python.h>
28#ifdef __cplusplus
29extern "C" {
30#endif
31	void Py_Initialize(void);
32	void Py_Finalize(void);
33#ifdef __cplusplus
34}
35#endif
36int main(int argc, char **argv)
37{
38   (void)argc; (void)argv;
39   Py_Initialize();
40   Py_Finalize();
41   return 0;
42}
43'''
44"""
45Piece of C/C++ code used in :py:func:`waflib.Tools.python.check_python_headers`
46"""
47
48INST = '''
49import sys, py_compile
50py_compile.compile(sys.argv[1], sys.argv[2], sys.argv[3], True)
51'''
52"""
53Piece of Python code used in :py:class:`waflib.Tools.python.pyo` and :py:class:`waflib.Tools.python.pyc` for byte-compiling python files
54"""
55
56DISTUTILS_IMP = ['from distutils.sysconfig import get_config_var, get_python_lib']
57
58@before_method('process_source')
59@feature('py')
60def feature_py(self):
61	"""
62	Create tasks to byte-compile .py files and install them, if requested
63	"""
64	self.install_path = getattr(self, 'install_path', '${PYTHONDIR}')
65	install_from = getattr(self, 'install_from', None)
66	if install_from and not isinstance(install_from, Node.Node):
67		install_from = self.path.find_dir(install_from)
68	self.install_from = install_from
69
70	ver = self.env.PYTHON_VERSION
71	if not ver:
72		self.bld.fatal('Installing python files requires PYTHON_VERSION, try conf.check_python_version')
73
74	if int(ver.replace('.', '')) > 31:
75		self.install_32 = True
76
77@extension('.py')
78def process_py(self, node):
79	"""
80	Add signature of .py file, so it will be byte-compiled when necessary
81	"""
82	assert(hasattr(self, 'install_path')), 'add features="py"'
83
84	# where to install the python file
85	if self.install_path:
86		if self.install_from:
87			self.add_install_files(install_to=self.install_path, install_from=node, cwd=self.install_from, relative_trick=True)
88		else:
89			self.add_install_files(install_to=self.install_path, install_from=node, relative_trick=True)
90
91	lst = []
92	if self.env.PYC:
93		lst.append('pyc')
94	if self.env.PYO:
95		lst.append('pyo')
96
97	if self.install_path:
98		if self.install_from:
99			pyd = Utils.subst_vars("%s/%s" % (self.install_path, node.path_from(self.install_from)), self.env)
100		else:
101			pyd = Utils.subst_vars("%s/%s" % (self.install_path, node.path_from(self.path)), self.env)
102	else:
103		pyd = node.abspath()
104
105	for ext in lst:
106		if self.env.PYTAG and not self.env.NOPYCACHE:
107			# __pycache__ installation for python 3.2 - PEP 3147
108			name = node.name[:-3]
109			pyobj = node.parent.get_bld().make_node('__pycache__').make_node("%s.%s.%s" % (name, self.env.PYTAG, ext))
110			pyobj.parent.mkdir()
111		else:
112			pyobj = node.change_ext(".%s" % ext)
113
114		tsk = self.create_task(ext, node, pyobj)
115		tsk.pyd = pyd
116
117		if self.install_path:
118			self.add_install_files(install_to=os.path.dirname(pyd), install_from=pyobj, cwd=node.parent.get_bld(), relative_trick=True)
119
120class pyc(Task.Task):
121	"""
122	Byte-compiling python files
123	"""
124	color = 'PINK'
125	def __str__(self):
126		node = self.outputs[0]
127		return node.path_from(node.ctx.launch_node())
128	def run(self):
129		cmd = [Utils.subst_vars('${PYTHON}', self.env), '-c', INST, self.inputs[0].abspath(), self.outputs[0].abspath(), self.pyd]
130		ret = self.generator.bld.exec_command(cmd)
131		return ret
132
133class pyo(Task.Task):
134	"""
135	Byte-compiling python files
136	"""
137	color = 'PINK'
138	def __str__(self):
139		node = self.outputs[0]
140		return node.path_from(node.ctx.launch_node())
141	def run(self):
142		cmd = [Utils.subst_vars('${PYTHON}', self.env), Utils.subst_vars('${PYFLAGS_OPT}', self.env), '-c', INST, self.inputs[0].abspath(), self.outputs[0].abspath(), self.pyd]
143		ret = self.generator.bld.exec_command(cmd)
144		return ret
145
146@feature('pyext')
147@before_method('propagate_uselib_vars', 'apply_link')
148@after_method('apply_bundle')
149def init_pyext(self):
150	"""
151	Change the values of *cshlib_PATTERN* and *cxxshlib_PATTERN* to remove the
152	*lib* prefix from library names.
153	"""
154	self.uselib = self.to_list(getattr(self, 'uselib', []))
155	if not 'PYEXT' in self.uselib:
156		self.uselib.append('PYEXT')
157	# override shlib_PATTERN set by the osx module
158	self.env.cshlib_PATTERN = self.env.cxxshlib_PATTERN = self.env.macbundle_PATTERN = self.env.pyext_PATTERN
159	self.env.fcshlib_PATTERN = self.env.dshlib_PATTERN = self.env.pyext_PATTERN
160
161	try:
162		if not self.install_path:
163			return
164	except AttributeError:
165		self.install_path = '${PYTHONARCHDIR}'
166
167@feature('pyext')
168@before_method('apply_link', 'apply_bundle')
169def set_bundle(self):
170	"""Mac-specific pyext extension that enables bundles from c_osx.py"""
171	if Utils.unversioned_sys_platform() == 'darwin':
172		self.mac_bundle = True
173
174@before_method('propagate_uselib_vars')
175@feature('pyembed')
176def init_pyembed(self):
177	"""
178	Add the PYEMBED variable.
179	"""
180	self.uselib = self.to_list(getattr(self, 'uselib', []))
181	if not 'PYEMBED' in self.uselib:
182		self.uselib.append('PYEMBED')
183
184@conf
185def get_python_variables(self, variables, imports=None):
186	"""
187	Spawn a new python process to dump configuration variables
188
189	:param variables: variables to print
190	:type variables: list of string
191	:param imports: one import by element
192	:type imports: list of string
193	:return: the variable values
194	:rtype: list of string
195	"""
196	if not imports:
197		try:
198			imports = self.python_imports
199		except AttributeError:
200			imports = DISTUTILS_IMP
201
202	program = list(imports) # copy
203	program.append('')
204	for v in variables:
205		program.append("print(repr(%s))" % v)
206	os_env = dict(os.environ)
207	try:
208		del os_env['MACOSX_DEPLOYMENT_TARGET'] # see comments in the OSX tool
209	except KeyError:
210		pass
211
212	try:
213		out = self.cmd_and_log(self.env.PYTHON + ['-c', '\n'.join(program)], env=os_env)
214	except Errors.WafError:
215		self.fatal('The distutils module is unusable: install "python-devel"?')
216	self.to_log(out)
217	return_values = []
218	for s in out.splitlines():
219		s = s.strip()
220		if not s:
221			continue
222		if s == 'None':
223			return_values.append(None)
224		elif (s[0] == "'" and s[-1] == "'") or (s[0] == '"' and s[-1] == '"'):
225			return_values.append(eval(s))
226		elif s[0].isdigit():
227			return_values.append(int(s))
228		else: break
229	return return_values
230
231@conf
232def test_pyembed(self, mode, msg='Testing pyembed configuration'):
233	self.check(header_name='Python.h', define_name='HAVE_PYEMBED', msg=msg,
234		fragment=FRAG, errmsg='Could not build a python embedded interpreter',
235		features='%s %sprogram pyembed' % (mode, mode))
236
237@conf
238def test_pyext(self, mode, msg='Testing pyext configuration'):
239	self.check(header_name='Python.h', define_name='HAVE_PYEXT', msg=msg,
240		fragment=FRAG, errmsg='Could not build python extensions',
241		features='%s %sshlib pyext' % (mode, mode))
242
243@conf
244def python_cross_compile(self, features='pyembed pyext'):
245	"""
246	For cross-compilation purposes, it is possible to bypass the normal detection and set the flags that you want:
247	PYTHON_VERSION='3.4' PYTAG='cpython34' pyext_PATTERN="%s.so" PYTHON_LDFLAGS='-lpthread -ldl' waf configure
248
249	The following variables are used:
250	PYTHON_VERSION    required
251	PYTAG             required
252	PYTHON_LDFLAGS    required
253	pyext_PATTERN     required
254	PYTHON_PYEXT_LDFLAGS
255	PYTHON_PYEMBED_LDFLAGS
256	"""
257	features = Utils.to_list(features)
258	if not ('PYTHON_LDFLAGS' in self.environ or 'PYTHON_PYEXT_LDFLAGS' in self.environ or 'PYTHON_PYEMBED_LDFLAGS' in self.environ):
259		return False
260
261	for x in 'PYTHON_VERSION PYTAG pyext_PATTERN'.split():
262		if not x in self.environ:
263			self.fatal('Please set %s in the os environment' % x)
264		else:
265			self.env[x] = self.environ[x]
266
267	xx = self.env.CXX_NAME and 'cxx' or 'c'
268	if 'pyext' in features:
269		flags = self.environ.get('PYTHON_PYEXT_LDFLAGS', self.environ.get('PYTHON_LDFLAGS'))
270		if flags is None:
271			self.fatal('No flags provided through PYTHON_PYEXT_LDFLAGS as required')
272		else:
273			self.parse_flags(flags, 'PYEXT')
274		self.test_pyext(xx)
275	if 'pyembed' in features:
276		flags = self.environ.get('PYTHON_PYEMBED_LDFLAGS', self.environ.get('PYTHON_LDFLAGS'))
277		if flags is None:
278			self.fatal('No flags provided through PYTHON_PYEMBED_LDFLAGS as required')
279		else:
280			self.parse_flags(flags, 'PYEMBED')
281		self.test_pyembed(xx)
282	return True
283
284@conf
285def check_python_headers(conf, features='pyembed pyext'):
286	"""
287	Check for headers and libraries necessary to extend or embed python by using the module *distutils*.
288	On success the environment variables xxx_PYEXT and xxx_PYEMBED are added:
289
290	* PYEXT: for compiling python extensions
291	* PYEMBED: for embedding a python interpreter
292	"""
293	features = Utils.to_list(features)
294	assert ('pyembed' in features) or ('pyext' in features), "check_python_headers features must include 'pyembed' and/or 'pyext'"
295	env = conf.env
296	if not env.CC_NAME and not env.CXX_NAME:
297		conf.fatal('load a compiler first (gcc, g++, ..)')
298
299	# bypass all the code below for cross-compilation
300	if conf.python_cross_compile(features):
301		return
302
303	if not env.PYTHON_VERSION:
304		conf.check_python_version()
305
306	pybin = env.PYTHON
307	if not pybin:
308		conf.fatal('Could not find the python executable')
309
310	# so we actually do all this for compatibility reasons and for obtaining pyext_PATTERN below
311	v = 'prefix SO LDFLAGS LIBDIR LIBPL INCLUDEPY Py_ENABLE_SHARED MACOSX_DEPLOYMENT_TARGET LDSHARED CFLAGS LDVERSION'.split()
312	try:
313		lst = conf.get_python_variables(["get_config_var('%s') or ''" % x for x in v])
314	except RuntimeError:
315		conf.fatal("Python development headers not found (-v for details).")
316
317	vals = ['%s = %r' % (x, y) for (x, y) in zip(v, lst)]
318	conf.to_log("Configuration returned from %r:\n%s\n" % (pybin, '\n'.join(vals)))
319
320	dct = dict(zip(v, lst))
321	x = 'MACOSX_DEPLOYMENT_TARGET'
322	if dct[x]:
323		env[x] = conf.environ[x] = dct[x]
324	env.pyext_PATTERN = '%s' + dct['SO'] # not a mistake
325
326
327	# Try to get pythonX.Y-config
328	num = '.'.join(env.PYTHON_VERSION.split('.')[:2])
329	conf.find_program([''.join(pybin) + '-config', 'python%s-config' % num, 'python-config-%s' % num, 'python%sm-config' % num], var='PYTHON_CONFIG', msg="python-config", mandatory=False)
330
331	if env.PYTHON_CONFIG:
332		# python2.6-config requires 3 runs
333		all_flags = [['--cflags', '--libs', '--ldflags']]
334		if sys.hexversion < 0x2070000:
335			all_flags = [[k] for k in all_flags[0]]
336
337		xx = env.CXX_NAME and 'cxx' or 'c'
338
339		if 'pyembed' in features:
340			for flags in all_flags:
341				conf.check_cfg(msg='Asking python-config for pyembed %r flags' % ' '.join(flags), path=env.PYTHON_CONFIG, package='', uselib_store='PYEMBED', args=flags)
342
343			try:
344				conf.test_pyembed(xx)
345			except conf.errors.ConfigurationError:
346				# python bug 7352
347				if dct['Py_ENABLE_SHARED'] and dct['LIBDIR']:
348					env.append_unique('LIBPATH_PYEMBED', [dct['LIBDIR']])
349					conf.test_pyembed(xx)
350				else:
351					raise
352
353		if 'pyext' in features:
354			for flags in all_flags:
355				conf.check_cfg(msg='Asking python-config for pyext %r flags' % ' '.join(flags), path=env.PYTHON_CONFIG, package='', uselib_store='PYEXT', args=flags)
356
357			try:
358				conf.test_pyext(xx)
359			except conf.errors.ConfigurationError:
360				# python bug 7352
361				if dct['Py_ENABLE_SHARED'] and dct['LIBDIR']:
362					env.append_unique('LIBPATH_PYEXT', [dct['LIBDIR']])
363					conf.test_pyext(xx)
364				else:
365					raise
366
367		conf.define('HAVE_PYTHON_H', 1)
368		return
369
370	# No python-config, do something else on windows systems
371	all_flags = dct['LDFLAGS'] + ' ' + dct['CFLAGS']
372	conf.parse_flags(all_flags, 'PYEMBED')
373
374	all_flags = dct['LDFLAGS'] + ' ' + dct['LDSHARED'] + ' ' + dct['CFLAGS']
375	conf.parse_flags(all_flags, 'PYEXT')
376
377	result = None
378	if not dct["LDVERSION"]:
379		dct["LDVERSION"] = env.PYTHON_VERSION
380
381	# further simplification will be complicated
382	for name in ('python' + dct['LDVERSION'], 'python' + env.PYTHON_VERSION + 'm', 'python' + env.PYTHON_VERSION.replace('.', '')):
383
384		# LIBPATH_PYEMBED is already set; see if it works.
385		if not result and env.LIBPATH_PYEMBED:
386			path = env.LIBPATH_PYEMBED
387			conf.to_log("\n\n# Trying default LIBPATH_PYEMBED: %r\n" % path)
388			result = conf.check(lib=name, uselib='PYEMBED', libpath=path, mandatory=False, msg='Checking for library %s in LIBPATH_PYEMBED' % name)
389
390		if not result and dct['LIBDIR']:
391			path = [dct['LIBDIR']]
392			conf.to_log("\n\n# try again with -L$python_LIBDIR: %r\n" % path)
393			result = conf.check(lib=name, uselib='PYEMBED', libpath=path, mandatory=False, msg='Checking for library %s in LIBDIR' % name)
394
395		if not result and dct['LIBPL']:
396			path = [dct['LIBPL']]
397			conf.to_log("\n\n# try again with -L$python_LIBPL (some systems don't install the python library in $prefix/lib)\n")
398			result = conf.check(lib=name, uselib='PYEMBED', libpath=path, mandatory=False, msg='Checking for library %s in python_LIBPL' % name)
399
400		if not result:
401			path = [os.path.join(dct['prefix'], "libs")]
402			conf.to_log("\n\n# try again with -L$prefix/libs, and pythonXY name rather than pythonX.Y (win32)\n")
403			result = conf.check(lib=name, uselib='PYEMBED', libpath=path, mandatory=False, msg='Checking for library %s in $prefix/libs' % name)
404
405		if result:
406			break # do not forget to set LIBPATH_PYEMBED
407
408	if result:
409		env.LIBPATH_PYEMBED = path
410		env.append_value('LIB_PYEMBED', [name])
411	else:
412		conf.to_log("\n\n### LIB NOT FOUND\n")
413
414	# under certain conditions, python extensions must link to
415	# python libraries, not just python embedding programs.
416	if Utils.is_win32 or dct['Py_ENABLE_SHARED']:
417		env.LIBPATH_PYEXT = env.LIBPATH_PYEMBED
418		env.LIB_PYEXT = env.LIB_PYEMBED
419
420	conf.to_log("Include path for Python extensions (found via distutils module): %r\n" % (dct['INCLUDEPY'],))
421	env.INCLUDES_PYEXT = [dct['INCLUDEPY']]
422	env.INCLUDES_PYEMBED = [dct['INCLUDEPY']]
423
424	# Code using the Python API needs to be compiled with -fno-strict-aliasing
425	if env.CC_NAME == 'gcc':
426		env.append_value('CFLAGS_PYEMBED', ['-fno-strict-aliasing'])
427		env.append_value('CFLAGS_PYEXT', ['-fno-strict-aliasing'])
428	if env.CXX_NAME == 'gcc':
429		env.append_value('CXXFLAGS_PYEMBED', ['-fno-strict-aliasing'])
430		env.append_value('CXXFLAGS_PYEXT', ['-fno-strict-aliasing'])
431
432	if env.CC_NAME == "msvc":
433		from distutils.msvccompiler import MSVCCompiler
434		dist_compiler = MSVCCompiler()
435		dist_compiler.initialize()
436		env.append_value('CFLAGS_PYEXT', dist_compiler.compile_options)
437		env.append_value('CXXFLAGS_PYEXT', dist_compiler.compile_options)
438		env.append_value('LINKFLAGS_PYEXT', dist_compiler.ldflags_shared)
439
440	# See if it compiles
441	conf.check(header_name='Python.h', define_name='HAVE_PYTHON_H', uselib='PYEMBED', fragment=FRAG, errmsg='Distutils not installed? Broken python installation? Get python-config now!')
442
443@conf
444def check_python_version(conf, minver=None):
445	"""
446	Check if the python interpreter is found matching a given minimum version.
447	minver should be a tuple, eg. to check for python >= 2.4.2 pass (2,4,2) as minver.
448
449	If successful, PYTHON_VERSION is defined as 'MAJOR.MINOR' (eg. '2.4')
450	of the actual python version found, and PYTHONDIR and PYTHONARCHDIR
451	are defined, pointing to the site-packages directories appropriate for
452	this python version, where modules/packages/extensions should be
453	installed.
454
455	:param minver: minimum version
456	:type minver: tuple of int
457	"""
458	assert minver is None or isinstance(minver, tuple)
459	pybin = conf.env.PYTHON
460	if not pybin:
461		conf.fatal('could not find the python executable')
462
463	# Get python version string
464	cmd = pybin + ['-c', 'import sys\nfor x in sys.version_info: print(str(x))']
465	Logs.debug('python: Running python command %r', cmd)
466	lines = conf.cmd_and_log(cmd).split()
467	assert len(lines) == 5, "found %r lines, expected 5: %r" % (len(lines), lines)
468	pyver_tuple = (int(lines[0]), int(lines[1]), int(lines[2]), lines[3], int(lines[4]))
469
470	# Compare python version with the minimum required
471	result = (minver is None) or (pyver_tuple >= minver)
472
473	if result:
474		# define useful environment variables
475		pyver = '.'.join([str(x) for x in pyver_tuple[:2]])
476		conf.env.PYTHON_VERSION = pyver
477
478		if 'PYTHONDIR' in conf.env:
479			# Check if --pythondir was specified
480			pydir = conf.env.PYTHONDIR
481		elif 'PYTHONDIR' in conf.environ:
482			# Check environment for PYTHONDIR
483			pydir = conf.environ['PYTHONDIR']
484		else:
485			# Finally, try to guess
486			if Utils.is_win32:
487				(python_LIBDEST, pydir) = conf.get_python_variables(
488					  ["get_config_var('LIBDEST') or ''",
489					   "get_python_lib(standard_lib=0) or ''"])
490			else:
491				python_LIBDEST = None
492				(pydir,) = conf.get_python_variables( ["get_python_lib(standard_lib=0, prefix=%r) or ''" % conf.env.PREFIX])
493			if python_LIBDEST is None:
494				if conf.env.LIBDIR:
495					python_LIBDEST = os.path.join(conf.env.LIBDIR, 'python' + pyver)
496				else:
497					python_LIBDEST = os.path.join(conf.env.PREFIX, 'lib', 'python' + pyver)
498
499		if 'PYTHONARCHDIR' in conf.env:
500			# Check if --pythonarchdir was specified
501			pyarchdir = conf.env.PYTHONARCHDIR
502		elif 'PYTHONARCHDIR' in conf.environ:
503			# Check environment for PYTHONDIR
504			pyarchdir = conf.environ['PYTHONARCHDIR']
505		else:
506			# Finally, try to guess
507			(pyarchdir, ) = conf.get_python_variables( ["get_python_lib(plat_specific=1, standard_lib=0, prefix=%r) or ''" % conf.env.PREFIX])
508			if not pyarchdir:
509				pyarchdir = pydir
510
511		if hasattr(conf, 'define'): # conf.define is added by the C tool, so may not exist
512			conf.define('PYTHONDIR', pydir)
513			conf.define('PYTHONARCHDIR', pyarchdir)
514
515		conf.env.PYTHONDIR = pydir
516		conf.env.PYTHONARCHDIR = pyarchdir
517
518	# Feedback
519	pyver_full = '.'.join(map(str, pyver_tuple[:3]))
520	if minver is None:
521		conf.msg('Checking for python version', pyver_full)
522	else:
523		minver_str = '.'.join(map(str, minver))
524		conf.msg('Checking for python version >= %s' % (minver_str,), pyver_full, color=result and 'GREEN' or 'YELLOW')
525
526	if not result:
527		conf.fatal('The python version is too old, expecting %r' % (minver,))
528
529PYTHON_MODULE_TEMPLATE = '''
530import %s as current_module
531version = getattr(current_module, '__version__', None)
532if version is not None:
533	print(str(version))
534else:
535	print('unknown version')
536'''
537
538@conf
539def check_python_module(conf, module_name, condition=''):
540	"""
541	Check if the selected python interpreter can import the given python module::
542
543		def configure(conf):
544			conf.check_python_module('pygccxml')
545			conf.check_python_module('re', condition="ver > num(2, 0, 4) and ver <= num(3, 0, 0)")
546
547	:param module_name: module
548	:type module_name: string
549	"""
550	msg = "Checking for python module %r" % module_name
551	if condition:
552		msg = '%s (%s)' % (msg, condition)
553	conf.start_msg(msg)
554	try:
555		ret = conf.cmd_and_log(conf.env.PYTHON + ['-c', PYTHON_MODULE_TEMPLATE % module_name])
556	except Errors.WafError:
557		conf.end_msg(False)
558		conf.fatal('Could not find the python module %r' % module_name)
559
560	ret = ret.strip()
561	if condition:
562		conf.end_msg(ret)
563		if ret == 'unknown version':
564			conf.fatal('Could not check the %s version' % module_name)
565
566		from distutils.version import LooseVersion
567		def num(*k):
568			if isinstance(k[0], int):
569				return LooseVersion('.'.join([str(x) for x in k]))
570			else:
571				return LooseVersion(k[0])
572		d = {'num': num, 'ver': LooseVersion(ret)}
573		ev = eval(condition, {}, d)
574		if not ev:
575			conf.fatal('The %s version does not satisfy the requirements' % module_name)
576	else:
577		if ret == 'unknown version':
578			conf.end_msg(True)
579		else:
580			conf.end_msg(ret)
581
582def configure(conf):
583	"""
584	Detect the python interpreter
585	"""
586	v = conf.env
587	if getattr(Options.options, 'pythondir', None):
588		v.PYTHONDIR = Options.options.pythondir
589	if getattr(Options.options, 'pythonarchdir', None):
590		v.PYTHONARCHDIR = Options.options.pythonarchdir
591	if getattr(Options.options, 'nopycache', None):
592		v.NOPYCACHE=Options.options.nopycache
593
594	if not v.PYTHON:
595		v.PYTHON = [getattr(Options.options, 'python', None) or sys.executable]
596	v.PYTHON = Utils.to_list(v.PYTHON)
597	conf.find_program('python', var='PYTHON')
598
599	v.PYFLAGS = ''
600	v.PYFLAGS_OPT = '-O'
601
602	v.PYC = getattr(Options.options, 'pyc', 1)
603	v.PYO = getattr(Options.options, 'pyo', 1)
604
605	try:
606		v.PYTAG = conf.cmd_and_log(conf.env.PYTHON + ['-c', "import imp;print(imp.get_tag())"]).strip()
607	except Errors.WafError:
608		pass
609
610def options(opt):
611	"""
612	Add python-specific options
613	"""
614	pyopt=opt.add_option_group("Python Options")
615	pyopt.add_option('--nopyc', dest = 'pyc', action='store_false', default=1,
616					 help = 'Do not install bytecode compiled .pyc files (configuration) [Default:install]')
617	pyopt.add_option('--nopyo', dest='pyo', action='store_false', default=1,
618					 help='Do not install optimised compiled .pyo files (configuration) [Default:install]')
619	pyopt.add_option('--nopycache',dest='nopycache', action='store_true',
620					 help='Do not use __pycache__ directory to install objects [Default:auto]')
621	pyopt.add_option('--python', dest="python",
622					 help='python binary to be used [Default: %s]' % sys.executable)
623	pyopt.add_option('--pythondir', dest='pythondir',
624					 help='Installation path for python modules (py, platform-independent .py and .pyc files)')
625	pyopt.add_option('--pythonarchdir', dest='pythonarchdir',
626					 help='Installation path for python extension (pyext, platform-dependent .so or .dylib files)')
627
628