1 ## ------------------------ -*- Autoconf -*-
2 ## Python file handling
4 ## Updated by James Henstridge
5 ## ------------------------
6 # Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2008, 2009
7 # Free Software Foundation, Inc.
9 # This file is free software; the Free Software Foundation
10 # gives unlimited permission to copy and/or distribute it,
11 # 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.0 python2.5 python2.4 python2.3 python2.2 dnl
44 dnl No version check is needed.
45 # Find any Python interpreter.
46 if test -z "$PYTHON"; then
47 AC_PATH_PROGS([PYTHON], _AM_PYTHON_INTERPRETER_LIST, :)
49 am_display_PYTHON=python
51 dnl A version check is needed.
52 if test -n "$PYTHON"; then
53 # If the user set $PYTHON, use it and don't search something else.
54 AC_MSG_CHECKING([whether $PYTHON version >= $1])
55 AM_PYTHON_CHECK_VERSION([$PYTHON], [$1],
57 [AC_MSG_ERROR(too old)])
58 am_display_PYTHON=$PYTHON
60 # Otherwise, try each interpreter until we find one that satisfies
62 AC_CACHE_CHECK([for a Python interpreter with version >= $1],
63 [am_cv_pathless_PYTHON],[
64 for am_cv_pathless_PYTHON in _AM_PYTHON_INTERPRETER_LIST none; do
65 test "$am_cv_pathless_PYTHON" = none && break
66 AM_PYTHON_CHECK_VERSION([$am_cv_pathless_PYTHON], [$1], [break])
68 # Set $PYTHON to the absolute path of $am_cv_pathless_PYTHON.
69 if test "$am_cv_pathless_PYTHON" = none; then
72 AC_PATH_PROG([PYTHON], [$am_cv_pathless_PYTHON])
74 am_display_PYTHON=$am_cv_pathless_PYTHON
78 if test "$PYTHON" = :; then
79 dnl Run any user-specified action, or abort.
80 m4_default([$3], [AC_MSG_ERROR([no suitable Python interpreter found])])
83 dnl Query Python for its version number. Getting [:3] seems to be
84 dnl the best way to do this; it's what "site.py" does in the standard
87 AC_CACHE_CHECK([for $am_display_PYTHON version], [am_cv_python_version],
88 [am_cv_python_version=`$PYTHON -c "import sys; sys.stdout.write(sys.version[[:3]])"`])
89 AC_SUBST([PYTHON_VERSION], [$am_cv_python_version])
91 dnl Use the values of $prefix and $exec_prefix for the corresponding
92 dnl values of PYTHON_PREFIX and PYTHON_EXEC_PREFIX. These are made
93 dnl distinct variables so they can be overridden if need be. However,
94 dnl general consensus is that you shouldn't need this ability.
96 AC_SUBST([PYTHON_PREFIX], ['${prefix}'])
97 AC_SUBST([PYTHON_EXEC_PREFIX], ['${exec_prefix}'])
99 dnl At times (like when building shared libraries) you may want
100 dnl to know which OS platform Python thinks this is.
102 AC_CACHE_CHECK([for $am_display_PYTHON platform], [am_cv_python_platform],
103 [am_cv_python_platform=`$PYTHON -c "import sys; sys.stdout.write(sys.platform)"`])
104 AC_SUBST([PYTHON_PLATFORM], [$am_cv_python_platform])
107 dnl Set up 4 directories:
109 dnl pythondir -- where to install python scripts. This is the
110 dnl site-packages directory, not the python standard library
111 dnl directory like in previous automake betas. This behavior
112 dnl is more consistent with lispdir.m4 for example.
113 dnl Query distutils for this directory. distutils does not exist in
114 dnl Python 1.5, so we fall back to the hardcoded directory if it
116 AC_CACHE_CHECK([for $am_display_PYTHON script directory],
117 [am_cv_python_pythondir],
118 [if test "x$prefix" = xNONE
120 am_py_prefix=$ac_default_prefix
124 am_cv_python_pythondir=`$PYTHON -c "import sys; from distutils import sysconfig; sys.stdout.write(sysconfig.get_python_lib(0,0,prefix='$am_py_prefix'))" 2>/dev/null ||
125 echo "$PYTHON_PREFIX/lib/python$PYTHON_VERSION/site-packages"`
126 case $am_cv_python_pythondir in
128 am__strip_prefix=`echo "$am_py_prefix" | sed 's|.|.|g'`
129 am_cv_python_pythondir=`echo "$am_cv_python_pythondir" | sed "s,^$am__strip_prefix,$PYTHON_PREFIX,"`
132 case $am_py_prefix in
135 am_cv_python_pythondir=$PYTHON_PREFIX/lib/python$PYTHON_VERSION/site-packages
141 AC_SUBST([pythondir], [$am_cv_python_pythondir])
143 dnl pkgpythondir -- $PACKAGE directory under pythondir. Was
144 dnl PYTHON_SITE_PACKAGE in previous betas, but this naming is
145 dnl more consistent with the rest of automake.
147 AC_SUBST([pkgpythondir], [\${pythondir}/$PACKAGE])
149 dnl pyexecdir -- directory for installing python extension modules
150 dnl (shared libraries)
151 dnl Query distutils for this directory. distutils does not exist in
152 dnl Python 1.5, so we fall back to the hardcoded directory if it
154 AC_CACHE_CHECK([for $am_display_PYTHON extension module directory],
155 [am_cv_python_pyexecdir],
156 [if test "x$exec_prefix" = xNONE
158 am_py_exec_prefix=$am_py_prefix
160 am_py_exec_prefix=$exec_prefix
162 am_cv_python_pyexecdir=`$PYTHON -c "import sys; from distutils import sysconfig; sys.stdout.write(sysconfig.get_python_lib(1,0,prefix='$am_py_exec_prefix'))" 2>/dev/null ||
163 echo "$PYTHON_EXEC_PREFIX/lib/python$PYTHON_VERSION/site-packages"`
164 case $am_cv_python_pyexecdir in
166 am__strip_prefix=`echo "$am_py_exec_prefix" | sed 's|.|.|g'`
167 am_cv_python_pyexecdir=`echo "$am_cv_python_pyexecdir" | sed "s,^$am__strip_prefix,$PYTHON_EXEC_PREFIX,"`
170 case $am_py_exec_prefix in
173 am_cv_python_pyexecdir=$PYTHON_EXEC_PREFIX/lib/python$PYTHON_VERSION/site-packages
179 AC_SUBST([pyexecdir], [$am_cv_python_pyexecdir])
181 dnl pkgpyexecdir -- $(pyexecdir)/$(PACKAGE)
183 AC_SUBST([pkgpyexecdir], [\${pyexecdir}/$PACKAGE])
185 dnl Run any user-specified action.
192 # AM_PYTHON_CHECK_VERSION(PROG, VERSION, [ACTION-IF-TRUE], [ACTION-IF-FALSE])
193 # ---------------------------------------------------------------------------
194 # Run ACTION-IF-TRUE if the Python interpreter PROG has version >= VERSION.
195 # Run ACTION-IF-FALSE otherwise.
196 # This test uses sys.hexversion instead of the string equivalent (first
197 # word of sys.version), in order to cope with versions such as 2.2c1.
198 # This supports Python 2.0 or higher. (2.0 was released on October 16, 2000).
199 AC_DEFUN([AM_PYTHON_CHECK_VERSION],
201 # split strings by '.' and convert to numeric. Append some zeros
202 # because we need at least 4 digits for the hex conversion.
203 # map returns an iterator in Python 3.0 and a list in 2.x
204 minver = list(map(int, '$2'.split('.'))) + [[0, 0, 0]]
206 # xrange is not present in Python 3.0 and range returns an iterator
207 for i in list(range(0, 4)): minverhex = (minverhex << 8) + minver[[i]]
208 sys.exit(sys.hexversion < minverhex)"
209 AS_IF([AM_RUN_LOG([$1 -c "$prog"])], [$3], [$4])])