• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ===========================================================================
2#      http://www.gnu.org/software/autoconf-archive/ax_python_devel.html
3# ===========================================================================
4#
5# SYNOPSIS
6#
7#   AX_PYTHON_DEVEL([version])
8#
9# DESCRIPTION
10#
11#   Note: Defines as a precious variable "PYTHON_VERSION". Don't override it
12#   in your configure.ac.
13#
14#   This macro checks for Python and tries to get the include path to
15#   'Python.h'. It provides the $(PYTHON_CPPFLAGS) and $(PYTHON_LDFLAGS)
16#   output variables. It also exports $(PYTHON_EXTRA_LIBS) and
17#   $(PYTHON_EXTRA_LDFLAGS) for embedding Python in your code.
18#
19#   You can search for some particular version of Python by passing a
20#   parameter to this macro, for example ">= '2.3.1'", or "== '2.4'". Please
21#   note that you *have* to pass also an operator along with the version to
22#   match, and pay special attention to the single quotes surrounding the
23#   version number. Don't use "PYTHON_VERSION" for this: that environment
24#   variable is declared as precious and thus reserved for the end-user.
25#
26#   This macro should work for all versions of Python >= 2.1.0. As an end
27#   user, you can disable the check for the python version by setting the
28#   PYTHON_NOVERSIONCHECK environment variable to something else than the
29#   empty string.
30#
31#   If you need to use this macro for an older Python version, please
32#   contact the authors. We're always open for feedback.
33#
34# LICENSE
35#
36#   Copyright (c) 2009 Sebastian Huber <sebastian-huber@web.de>
37#   Copyright (c) 2009 Alan W. Irwin <irwin@beluga.phys.uvic.ca>
38#   Copyright (c) 2009 Rafael Laboissiere <rafael@laboissiere.net>
39#   Copyright (c) 2009 Andrew Collier <colliera@ukzn.ac.za>
40#   Copyright (c) 2009 Matteo Settenvini <matteo@member.fsf.org>
41#   Copyright (c) 2009 Horst Knorr <hk_classes@knoda.org>
42#
43#   This program is free software: you can redistribute it and/or modify it
44#   under the terms of the GNU General Public License as published by the
45#   Free Software Foundation, either version 3 of the License, or (at your
46#   option) any later version.
47#
48#   This program is distributed in the hope that it will be useful, but
49#   WITHOUT ANY WARRANTY; without even the implied warranty of
50#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
51#   Public License for more details.
52#
53#   You should have received a copy of the GNU General Public License along
54#   with this program. If not, see <http://www.gnu.org/licenses/>.
55#
56#   As a special exception, the respective Autoconf Macro's copyright owner
57#   gives unlimited permission to copy, distribute and modify the configure
58#   scripts that are the output of Autoconf when processing the Macro. You
59#   need not follow the terms of the GNU General Public License when using
60#   or distributing such scripts, even though portions of the text of the
61#   Macro appear in them. The GNU General Public License (GPL) does govern
62#   all other use of the material that constitutes the Autoconf Macro.
63#
64#   This special exception to the GPL applies to versions of the Autoconf
65#   Macro released by the Autoconf Archive. When you make and distribute a
66#   modified version of the Autoconf Macro, you may extend this special
67#   exception to the GPL to apply to your modified version as well.
68
69#serial 8
70
71AU_ALIAS([AC_PYTHON_DEVEL], [AX_PYTHON_DEVEL])
72AC_DEFUN([AX_PYTHON_DEVEL],[
73	#
74	# Allow the use of a (user set) custom python version
75	#
76	AC_ARG_VAR([PYTHON_VERSION],[The installed Python
77		version to use, for example '2.3'. This string
78		will be appended to the Python interpreter
79		canonical name.])
80
81	AC_PATH_PROG([PYTHON],[python[$PYTHON_VERSION]])
82	if test -z "$PYTHON"; then
83	   AC_MSG_ERROR([Cannot find python$PYTHON_VERSION in your system path])
84	   PYTHON_VERSION=""
85	fi
86
87	#
88	# Check for a version of Python >= 2.1.0
89	#
90	AC_MSG_CHECKING([for a version of Python >= '2.1.0'])
91	ac_supports_python_ver=`$PYTHON -c "import sys; \
92		ver = sys.version.split ()[[0]]; \
93		print (ver >= '2.1.0')"`
94	if test "$ac_supports_python_ver" != "True"; then
95		if test -z "$PYTHON_NOVERSIONCHECK"; then
96			AC_MSG_RESULT([no])
97			AC_MSG_FAILURE([
98This version of the AC@&t@_PYTHON_DEVEL macro
99doesn't work properly with versions of Python before
1002.1.0. You may need to re-run configure, setting the
101variables PYTHON_CPPFLAGS, PYTHON_LDFLAGS, PYTHON_SITE_PKG,
102PYTHON_EXTRA_LIBS and PYTHON_EXTRA_LDFLAGS by hand.
103Moreover, to disable this check, set PYTHON_NOVERSIONCHECK
104to something else than an empty string.
105])
106		else
107			AC_MSG_RESULT([skip at user request])
108		fi
109	else
110		AC_MSG_RESULT([yes])
111	fi
112
113	#
114	# if the macro parameter ``version'' is set, honour it
115	#
116	if test -n "$1"; then
117		AC_MSG_CHECKING([for a version of Python $1])
118		ac_supports_python_ver=`$PYTHON -c "import sys; \
119			ver = sys.version.split ()[[0]]; \
120			print (ver $1)"`
121		if test "$ac_supports_python_ver" = "True"; then
122		   AC_MSG_RESULT([yes])
123		else
124			AC_MSG_RESULT([no])
125			AC_MSG_ERROR([this package requires Python $1.
126If you have it installed, but it isn't the default Python
127interpreter in your system path, please pass the PYTHON_VERSION
128variable to configure. See ``configure --help'' for reference.
129])
130			PYTHON_VERSION=""
131		fi
132	fi
133
134	#
135	# Check if you have distutils, else fail
136	#
137	AC_MSG_CHECKING([for the distutils Python package])
138	ac_distutils_result=`$PYTHON -c "import distutils" 2>&1`
139	if test -z "$ac_distutils_result"; then
140		AC_MSG_RESULT([yes])
141	else
142		AC_MSG_RESULT([no])
143		AC_MSG_ERROR([cannot import Python module "distutils".
144Please check your Python installation. The error was:
145$ac_distutils_result])
146		PYTHON_VERSION=""
147	fi
148
149	#
150	# Check for Python include path
151	#
152	AC_MSG_CHECKING([for Python include path])
153	if test -z "$PYTHON_CPPFLAGS"; then
154		python_path=`$PYTHON -c "import distutils.sysconfig; \
155			print (distutils.sysconfig.get_python_inc ());"`
156		if test -n "${python_path}"; then
157			python_path="-I$python_path"
158		fi
159		PYTHON_CPPFLAGS=$python_path
160	fi
161	AC_MSG_RESULT([$PYTHON_CPPFLAGS])
162	AC_SUBST([PYTHON_CPPFLAGS])
163
164	#
165	# Check for Python library path
166	#
167	AC_MSG_CHECKING([for Python library path])
168	if test -z "$PYTHON_LDFLAGS"; then
169		# (makes two attempts to ensure we've got a version number
170		# from the interpreter)
171		ac_python_version=`cat<<EOD | $PYTHON -
172
173# join all versioning strings, on some systems
174# major/minor numbers could be in different list elements
175from distutils.sysconfig import *
176ret = ''
177for e in get_config_vars ('VERSION'):
178	if (e != None):
179		ret += e
180print (ret)
181EOD`
182
183		if test -z "$ac_python_version"; then
184			if test -n "$PYTHON_VERSION"; then
185				ac_python_version=$PYTHON_VERSION
186			else
187				ac_python_version=`$PYTHON -c "import sys; \
188					print (sys.version[[:3]])"`
189			fi
190		fi
191
192		# Make the versioning information available to the compiler
193		AC_DEFINE_UNQUOTED([HAVE_PYTHON], ["$ac_python_version"],
194                                   [If available, contains the Python version number currently in use.])
195
196		# First, the library directory:
197		ac_python_libdir=`cat<<EOD | $PYTHON -
198
199# There should be only one
200import distutils.sysconfig
201for e in distutils.sysconfig.get_config_vars ('LIBDIR'):
202	if e != None:
203		print (e)
204		break
205EOD`
206
207		# Before checking for libpythonX.Y, we need to know
208		# the extension the OS we're on uses for libraries
209		# (we take the first one, if there's more than one fix me!):
210		ac_python_soext=`$PYTHON -c \
211		  "import distutils.sysconfig; \
212		  print (distutils.sysconfig.get_config_vars('SO')[[0]])"`
213
214		# Now, for the library:
215		ac_python_soname=`$PYTHON -c \
216		  "import distutils.sysconfig; \
217		  print (distutils.sysconfig.get_config_vars('LDLIBRARY')[[0]])"`
218
219		# Strip away extension from the end to canonicalize its name:
220		ac_python_library=`echo "$ac_python_soname" | sed "s/${ac_python_soext}$//"`
221
222		# This small piece shamelessly adapted from PostgreSQL python macro;
223		# credits goes to momjian, I think. I'd like to put the right name
224		# in the credits, if someone can point me in the right direction... ?
225		#
226		if test -n "$ac_python_libdir" -a -n "$ac_python_library" \
227			-a x"$ac_python_library" != x"$ac_python_soname"
228		then
229			# use the official shared library
230			ac_python_library=`echo "$ac_python_library" | sed "s/^lib//"`
231			PYTHON_LDFLAGS="-L$ac_python_libdir -l$ac_python_library"
232		else
233			# old way: use libpython from python_configdir
234			ac_python_libdir=`$PYTHON -c \
235			  "from distutils.sysconfig import get_python_lib as f; \
236			  import os; \
237			  print (os.path.join(f(plat_specific=1, standard_lib=1), 'config'));"`
238			PYTHON_LDFLAGS="-L$ac_python_libdir -lpython$ac_python_version"
239		fi
240
241		if test -z "PYTHON_LDFLAGS"; then
242			AC_MSG_ERROR([
243  Cannot determine location of your Python DSO. Please check it was installed with
244  dynamic libraries enabled, or try setting PYTHON_LDFLAGS by hand.
245			])
246		fi
247	fi
248	AC_MSG_RESULT([$PYTHON_LDFLAGS])
249	AC_SUBST([PYTHON_LDFLAGS])
250
251	#
252	# Check for site packages
253	#
254	AC_MSG_CHECKING([for Python site-packages path])
255	if test -z "$PYTHON_SITE_PKG"; then
256		PYTHON_SITE_PKG=`$PYTHON -c "import distutils.sysconfig; \
257			print (distutils.sysconfig.get_python_lib(0,0));"`
258	fi
259	AC_MSG_RESULT([$PYTHON_SITE_PKG])
260	AC_SUBST([PYTHON_SITE_PKG])
261
262	#
263	# libraries which must be linked in when embedding
264	#
265	AC_MSG_CHECKING(python extra libraries)
266	if test -z "$PYTHON_EXTRA_LIBS"; then
267	   PYTHON_EXTRA_LIBS=`$PYTHON -c "import distutils.sysconfig; \
268                conf = distutils.sysconfig.get_config_var; \
269                print (conf('LOCALMODLIBS') + ' ' + conf('LIBS'))"`
270	fi
271	AC_MSG_RESULT([$PYTHON_EXTRA_LIBS])
272	AC_SUBST(PYTHON_EXTRA_LIBS)
273
274	#
275	# linking flags needed when embedding
276	#
277	AC_MSG_CHECKING(python extra linking flags)
278	if test -z "$PYTHON_EXTRA_LDFLAGS"; then
279		PYTHON_EXTRA_LDFLAGS=`$PYTHON -c "import distutils.sysconfig; \
280			conf = distutils.sysconfig.get_config_var; \
281			print (conf('LINKFORSHARED'))"`
282	fi
283	AC_MSG_RESULT([$PYTHON_EXTRA_LDFLAGS])
284	AC_SUBST(PYTHON_EXTRA_LDFLAGS)
285
286	#
287	# final check to see if everything compiles alright
288	#
289	AC_MSG_CHECKING([consistency of all components of python development environment])
290	# save current global flags
291	ac_save_LIBS="$LIBS"
292	ac_save_CPPFLAGS="$CPPFLAGS"
293	LIBS="$ac_save_LIBS $PYTHON_LDFLAGS $PYTHON_EXTRA_LDFLAGS $PYTHON_EXTRA_LIBS"
294	CPPFLAGS="$ac_save_CPPFLAGS $PYTHON_CPPFLAGS"
295	AC_LANG_PUSH([C])
296	AC_LINK_IFELSE([
297		AC_LANG_PROGRAM([[#include <Python.h>]],
298				[[Py_Initialize();]])
299		],[pythonexists=yes],[pythonexists=no])
300	AC_LANG_POP([C])
301	# turn back to default flags
302	CPPFLAGS="$ac_save_CPPFLAGS"
303	LIBS="$ac_save_LIBS"
304
305	AC_MSG_RESULT([$pythonexists])
306
307        if test ! "x$pythonexists" = "xyes"; then
308	   AC_MSG_FAILURE([
309  Could not link test program to Python. Maybe the main Python library has been
310  installed in some non-standard library path. If so, pass it to configure,
311  via the LDFLAGS environment variable.
312  Example: ./configure LDFLAGS="-L/usr/non-standard-path/python/lib"
313  ============================================================================
314   ERROR!
315   You probably have to install the development version of the Python package
316   for your distribution.  The exact name of this package varies among them.
317  ============================================================================
318	   ])
319	  PYTHON_VERSION=""
320	fi
321
322	#
323	# all done!
324	#
325])
326