1 ## ------------------------ -*- Autoconf -*-
2 ## Python file handling
4 ## Updated by James Henstridge
5 ## ------------------------
6 # Copyright (C) 1999-2012 Free Software Foundation, Inc.
8 # This file is free software; the Free Software Foundation
9 # gives unlimited permission to copy and/or distribute it,
10 # with or without modifications, as long as this notice is preserved.
13 # AM_PATH_PYTHON([MINIMUM-VERSION], [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
14 # ---------------------------------------------------------------------------
15 # Adds support for distributing Python modules and packages. To
16 # install modules, copy them to $(pythondir), using the python_PYTHON
17 # automake variable. To install a package with the same name as the
18 # automake package, install to $(pkgpythondir), or use the
19 # pkgpython_PYTHON automake variable.
21 # The variables $(pyexecdir) and $(pkgpyexecdir) are provided as
22 # locations to install python extension modules (shared libraries).
23 # Another macro is required to find the appropriate flags to compile
26 # If your package is configured with a different prefix to python,
27 # users will have to add the install directory to the PYTHONPATH
28 # environment variable, or create a .pth file (see the python
29 # documentation for details).
31 # If the MINIMUM-VERSION argument is passed, AM_PATH_PYTHON will
32 # cause an error if the version of python installed on the system
33 # doesn't meet the requirement. MINIMUM-VERSION should consist of
34 # numbers and dots only.
35 AC_DEFUN([AM_PATH_PYTHON],
37 dnl Find a Python interpreter. Python versions prior to 2.0 are not
38 dnl supported. (2.0 was released on October 16, 2000).
39 m4_define_default([_AM_PYTHON_INTERPRETER_LIST],
40 [python python2 python3 python3.3 python3.2 python3.1 python3.0 python2.7 dnl
41 python2.6 python2.5 python2.4 python2.3 python2.2 python2.1 python2.0])
43 AC_ARG_VAR([PYTHON], [the Python interpreter])
46 dnl No version check is needed.
47 # Find any Python interpreter.
48 if test -z "$PYTHON"; then
49 AC_PATH_PROGS([PYTHON], _AM_PYTHON_INTERPRETER_LIST, :)
51 am_display_PYTHON=python
53 dnl A version check is needed.
54 if test -n "$PYTHON"; then
55 # If the user set $PYTHON, use it and don't search something else.
56 AC_MSG_CHECKING([whether $PYTHON version is >= $1])
57 AM_PYTHON_CHECK_VERSION([$PYTHON], [$1],
58 [AC_MSG_RESULT([yes])],
60 AC_MSG_ERROR([Python interpreter is too old])])
61 am_display_PYTHON=$PYTHON
63 # Otherwise, try each interpreter until we find one that satisfies
65 AC_CACHE_CHECK([for a Python interpreter with version >= $1],
66 [am_cv_pathless_PYTHON],[
67 for am_cv_pathless_PYTHON in _AM_PYTHON_INTERPRETER_LIST none; do
68 test "$am_cv_pathless_PYTHON" = none && break
69 AM_PYTHON_CHECK_VERSION([$am_cv_pathless_PYTHON], [$1], [break])
71 # Set $PYTHON to the absolute path of $am_cv_pathless_PYTHON.
72 if test "$am_cv_pathless_PYTHON" = none; then
75 AC_PATH_PROG([PYTHON], [$am_cv_pathless_PYTHON])
77 am_display_PYTHON=$am_cv_pathless_PYTHON
81 if test "$PYTHON" = :; then
82 dnl Run any user-specified action, or abort.
83 m4_default([$3], [AC_MSG_ERROR([no suitable Python interpreter found])])
86 dnl Query Python for its version number. Getting [:3] seems to be
87 dnl the best way to do this; it's what "site.py" does in the standard
90 AC_CACHE_CHECK([for $am_display_PYTHON version], [am_cv_python_version],
91 [am_cv_python_version=`$PYTHON -c "import sys; sys.stdout.write(sys.version[[:3]])"`])
92 AC_SUBST([PYTHON_VERSION], [$am_cv_python_version])
94 dnl Use the values of $prefix and $exec_prefix for the corresponding
95 dnl values of PYTHON_PREFIX and PYTHON_EXEC_PREFIX. These are made
96 dnl distinct variables so they can be overridden if need be. However,
97 dnl general consensus is that you shouldn't need this ability.
99 AC_SUBST([PYTHON_PREFIX], ['${prefix}'])
100 AC_SUBST([PYTHON_EXEC_PREFIX], ['${exec_prefix}'])
102 dnl At times (like when building shared libraries) you may want
103 dnl to know which OS platform Python thinks this is.
105 AC_CACHE_CHECK([for $am_display_PYTHON platform], [am_cv_python_platform],
106 [am_cv_python_platform=`$PYTHON -c "import sys; sys.stdout.write(sys.platform)"`])
107 AC_SUBST([PYTHON_PLATFORM], [$am_cv_python_platform])
109 # Just factor out some code duplication.
110 am_python_setup_sysconfig="\
112 # Prefer sysconfig over distutils.sysconfig, for better compatibility
113 # with python 3.x. See automake bug#10227.
117 can_use_sysconfig = 0
119 can_use_sysconfig = 1
120 # Can't use sysconfig in CPython 2.7, since it's broken in virtualenvs:
121 # <https://github.com/pypa/virtualenv/issues/118>
123 from platform import python_implementation
124 if python_implementation() == 'CPython' and sys.version[[:3]] == '2.7':
125 can_use_sysconfig = 0
129 dnl Set up 4 directories:
131 dnl pythondir -- where to install python scripts. This is the
132 dnl site-packages directory, not the python standard library
133 dnl directory like in previous automake betas. This behavior
134 dnl is more consistent with lispdir.m4 for example.
135 dnl Query distutils for this directory.
136 AC_CACHE_CHECK([for $am_display_PYTHON script directory],
137 [am_cv_python_pythondir],
138 [if test "x$prefix" = xNONE
140 am_py_prefix=$ac_default_prefix
144 am_cv_python_pythondir=`$PYTHON -c "
145 $am_python_setup_sysconfig
146 if can_use_sysconfig:
147 sitedir = sysconfig.get_path('purelib', vars={'base':'$am_py_prefix'})
149 from distutils import sysconfig
150 sitedir = sysconfig.get_python_lib(0, 0, prefix='$am_py_prefix')
151 sys.stdout.write(sitedir)"`
152 case $am_cv_python_pythondir in
154 am__strip_prefix=`echo "$am_py_prefix" | sed 's|.|.|g'`
155 am_cv_python_pythondir=`echo "$am_cv_python_pythondir" | sed "s,^$am__strip_prefix,$PYTHON_PREFIX,"`
158 case $am_py_prefix in
161 am_cv_python_pythondir=$PYTHON_PREFIX/lib/python$PYTHON_VERSION/site-packages
167 AC_SUBST([pythondir], [$am_cv_python_pythondir])
169 dnl pkgpythondir -- $PACKAGE directory under pythondir. Was
170 dnl PYTHON_SITE_PACKAGE in previous betas, but this naming is
171 dnl more consistent with the rest of automake.
173 AC_SUBST([pkgpythondir], [\${pythondir}/$PACKAGE])
175 dnl pyexecdir -- directory for installing python extension modules
176 dnl (shared libraries)
177 dnl Query distutils for this directory.
178 AC_CACHE_CHECK([for $am_display_PYTHON extension module directory],
179 [am_cv_python_pyexecdir],
180 [if test "x$exec_prefix" = xNONE
182 am_py_exec_prefix=$am_py_prefix
184 am_py_exec_prefix=$exec_prefix
186 am_cv_python_pyexecdir=`$PYTHON -c "
187 $am_python_setup_sysconfig
188 if can_use_sysconfig:
189 sitedir = sysconfig.get_path('platlib', vars={'platbase':'$am_py_prefix'})
191 from distutils import sysconfig
192 sitedir = sysconfig.get_python_lib(1, 0, prefix='$am_py_prefix')
193 sys.stdout.write(sitedir)"`
194 case $am_cv_python_pyexecdir in
196 am__strip_prefix=`echo "$am_py_exec_prefix" | sed 's|.|.|g'`
197 am_cv_python_pyexecdir=`echo "$am_cv_python_pyexecdir" | sed "s,^$am__strip_prefix,$PYTHON_EXEC_PREFIX,"`
200 case $am_py_exec_prefix in
203 am_cv_python_pyexecdir=$PYTHON_EXEC_PREFIX/lib/python$PYTHON_VERSION/site-packages
209 AC_SUBST([pyexecdir], [$am_cv_python_pyexecdir])
211 dnl pkgpyexecdir -- $(pyexecdir)/$(PACKAGE)
213 AC_SUBST([pkgpyexecdir], [\${pyexecdir}/$PACKAGE])
215 dnl Run any user-specified action.
222 # AM_PYTHON_CHECK_VERSION(PROG, VERSION, [ACTION-IF-TRUE], [ACTION-IF-FALSE])
223 # ---------------------------------------------------------------------------
224 # Run ACTION-IF-TRUE if the Python interpreter PROG has version >= VERSION.
225 # Run ACTION-IF-FALSE otherwise.
226 # This test uses sys.hexversion instead of the string equivalent (first
227 # word of sys.version), in order to cope with versions such as 2.2c1.
228 # This supports Python 2.0 or higher. (2.0 was released on October 16, 2000).
229 AC_DEFUN([AM_PYTHON_CHECK_VERSION],
231 # split strings by '.' and convert to numeric. Append some zeros
232 # because we need at least 4 digits for the hex conversion.
233 # map returns an iterator in Python 3.0 and a list in 2.x
234 minver = list(map(int, '$2'.split('.'))) + [[0, 0, 0]]
236 # xrange is not present in Python 3.0 and range returns an iterator
237 for i in list(range(0, 4)): minverhex = (minverhex << 8) + minver[[i]]
238 sys.exit(sys.hexversion < minverhex)"
239 AS_IF([AM_RUN_LOG([$1 -c "$prog"])], [$3], [$4])])