blob: 249757fb8b9172ae01032e29927e50f3fbc9ba48 [file] [log] [blame] [edit]
# Copyright 1999-2012 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: /var/cvsroot/gentoo-x86/eclass/python-distutils-ng.eclass,v 1.29 2012/10/30 17:22:33 mgorny Exp $
# @ECLASS: python-distutils-ng
# @MAINTAINER:
# Python herd <python@gentoo.org>
# @AUTHOR:
# Author: Krzysztof Pawlik <nelchael@gentoo.org>
# @BLURB: Install Python packages using distutils.
# @DESCRIPTION:
# The Python eclass is designed to allow an easier installation of Python
# packages and their incorporation into the Gentoo Linux system.
#
# This eclass provides functions for following phases:
# - src_prepare - you can define python_prepare_all function that will be run
# before creating implementation-specific directory and python_prepare
# function that will be run for each implementation
# - src_configure - you can define python_configure function that will be run
# for each implementation
# - src_compile - you can define python_compile function that will be run for
# each implementation, default function will run `setup.py build'
# - src_test - you can define python_test function that will be run for each
# implementation
# - src_install - you can define python_install function that will be run for
# each implementation and python_install_all that will be run in original
# directory (so it will not contain any implementation-specific files)
# @ECLASS-VARIABLE: PYTHON_COMPAT
# @DEFAULT_UNSET
# @DESCRIPTION:
# This variable contains a space separated list of implementations (see above) a
# package is compatible to. It must be set before the `inherit' call. The
# default is to enable all implementations.
if [[ -z "${PYTHON_COMPAT}" ]]; then
# Default: pure python, support all implementations
PYTHON_COMPAT=" python2_5 python2_6 python2_7"
PYTHON_COMPAT+=" python3_1 python3_2"
PYTHON_COMPAT+=" jython2_5"
PYTHON_COMPAT+=" pypy1_8 pypy1_9"
fi
# @ECLASS-VARIABLE: PYTHON_OPTIONAL
# @DEFAULT_UNSET
# @DESCRIPTION:
# Set the value to "yes" to make the dependency on a Python interpreter
# optional.
# @ECLASS-VARIABLE: PYTHON_DISABLE_COMPILATION
# @DEFAULT_UNSET
# @DESCRIPTION:
# Set the value to "yes" to skip compilation and/or optimization of Python
# modules.
# @ECLASS-VARIABLE: PYTHON_DISABLE_SCRIPT_REDOS
# @DEFAULT_UNSET
# @DESCRIPTION:
# Set to any value to disable automatic reinstallation of scripts in bin
# directories. See python-distutils-ng_src_install function.
# @ECLASS-VARIABLE: PYTHON_USE
# @DEFAULT_UNSET
# @DESCRIPTION:
# Comma-separated list of useflags needed for all(!) allowed
# implementations. This is directly substituted into one or more of
# dev-lang/python[${PYTHON_USE}], dev-python/pypy[${PYTHON_USE}] and
# dev-java/jython[${PYTHON_USE}].
# @CODE
# example 1: PYTHON_USE="xml,sqlite"
# example 2: PYTHON_USE="xml?,threads?,-foo"
# @CODE
EXPORT_FUNCTIONS src_prepare src_configure src_compile src_test src_install
case "${EAPI}" in
0|1|2|3)
die "Unsupported EAPI=${EAPI} (too old) for python-distutils-ng.eclass" ;;
4|5)
# EAPI=4 needed for REQUIRED_USE
S="${S:-${WORKDIR}/${P}}"
;;
*)
die "Unsupported EAPI=${EAPI} (unknown) for python-distutils-ng.eclass" ;;
esac
DEPEND="${DEPEND} !<sys-apps/portage-2.1.10.58"
# @FUNCTION: _python-distutils-ng_get_binary_for_implementation
# @USAGE: implementation
# @RETURN: Full path to Python binary for given implementation.
# @DESCRIPTION:
# This function returns full path for Python binary for given implementation.
#
# Binary returned by this function should be used instead of simply calling
# `python'.
_python-distutils-ng_get_binary_for_implementation() {
local impl="${1/_/.}"
case "${impl}" in
python?.?|jython?.?)
echo "${EPREFIX}/usr/bin/${impl}" ;;
pypy?.?)
echo "${EPREFIX}/usr/bin/pypy-c${impl: -3}" ;;
*)
die "Unsupported implementation: ${1}" ;;
esac
}
required_use_str=""
for impl in ${PYTHON_COMPAT}; do
required_use_str+=" python_targets_${impl}"
done
required_use_str=" || ( ${required_use_str} )"
if [[ "${PYTHON_OPTIONAL}" = "yes" ]]; then
IUSE+=" python"
REQUIRED_USE+=" python? ( ${required_use_str} )"
else
REQUIRED_USE+=" ${required_use_str}"
fi
unset required_use_str
# avoid empty use deps
_PYTHON_USE="${PYTHON_USE:+[${PYTHON_USE}]}"
# set python DEPEND and RDEPEND
for impl in ${PYTHON_COMPAT}; do
IUSE+=" python_targets_${impl}"
dep_str="${impl/_/.}"
case "${dep_str}" in
python?.?)
dep_str="dev-lang/python:${dep_str: -3}${_PYTHON_USE}" ;;
jython?.?)
dep_str="dev-java/jython:${dep_str: -3}${_PYTHON_USE}" ;;
pypy?.?)
dep_str="dev-python/pypy:${dep_str: -3}${_PYTHON_USE}" ;;
*)
die "Unsupported implementation: ${impl}" ;;
esac
dep_str="python_targets_${impl}? ( ${dep_str} )"
if [[ "${PYTHON_OPTIONAL}" = "yes" ]]; then
RDEPEND="${RDEPEND} python? ( ${dep_str} )"
DEPEND="${DEPEND} python? ( ${dep_str} )"
else
RDEPEND="${RDEPEND} ${dep_str}"
DEPEND="${DEPEND} ${dep_str}"
fi
unset dep_str
done
_PACKAGE_SPECIFIC_S="${S#${WORKDIR}/}"
# @FUNCTION: _python-distutils-ng_run_for_impl
# @USAGE: implementation command_to_run
# @DESCRIPTION:
# Run command_to_run using specified Python implementation.
#
# This will run the command_to_run in implementation-specific working directory.
_python-distutils-ng_run_for_impl() {
local impl="${1}"
local command="${2}"
local S="${WORKDIR}/impl_${impl}/${_PACKAGE_SPECIFIC_S}"
PYTHON="$(_python-distutils-ng_get_binary_for_implementation "${impl}")"
EPYTHON="${impl/_/.}"
einfo "Running ${command} in ${S} for ${impl}"
pushd "${S}" &> /dev/null
"${command}" "${impl}" "${PYTHON}"
popd &> /dev/null
}
# @FUNCTION: _python-distutils-ng_run_for_each_impl
# @USAGE: command_to_run
# @DESCRIPTION:
# Run command_to_run for all enabled Python implementations.
#
# See also _python-distutils-ng_run_for_impl
_python-distutils-ng_run_for_each_impl() {
local command="${1}"
for impl in ${PYTHON_COMPAT}; do
use "python_targets_${impl}" ${PYTHON_COMPAT} || continue
_python-distutils-ng_run_for_impl "${impl}" "${command}"
done
}
# @FUNCTION: _python-distutils-ng_default_distutils_compile
# @DESCRIPTION:
# Default src_compile for distutils-based packages.
_python-distutils-ng_default_distutils_compile() {
"${PYTHON}" setup.py build || die
}
# @FUNCTION: _python-distutils-ng_default_distutils_install
# @DESCRIPTION:
# Default src_install for distutils-based packages.
_python-distutils-ng_default_distutils_install() {
local compile_flags="--compile -O2"
case "${1}" in
jython*)
# Jython does not support optimizations
compile_flags="--compile" ;;
esac
unset PYTHONDONTWRITEBYTECODE
[[ -n "${PYTHON_DISABLE_COMPILATION}" ]] && compile_flags="--no-compile"
"${PYTHON}" setup.py install ${compile_flags} --root="${D}" || die
}
# @FUNCTION: python-distutils-ng_rewrite_hashbang
# @USAGE: script_file_name implementation
# @DESCRIPTION:
# Rewrite #! line in named script, dies if #! line is not for Python or missing.
python-distutils-ng_rewrite_hashbang() {
[[ -n "${1}" ]] || die "Missing file name"
[[ -n "${2}" ]] || die "Missing implementation"
local file_name="${1}"
local binary="$(_python-distutils-ng_get_binary_for_implementation "${2}")"
[[ $(head -n 1 "${file_name}") == '#!'*(python|jython|pypy-c)* ]] || \
die "Missing or invalid #! line in ${file_name}"
sed -i -e "1c#!${binary}" "${file_name}" || die
}
# @FUNCTION: python-distutils-ng_redoscript
# @USAGE: script_file_path [destination_directory]
# @DESCRIPTION:
# Reinstall script installed already by setup.py. This works by first moving the
# script to ${T} directory and later running python-distutils-ng_doscript on it.
# script_file_path has to be a full path relative to ${D}.
# Warning: this function can be run automatically by the eclass in src_install,
# see python-distutils-ng_src_install and PYTHON_DISABLE_SCRIPT_REDOS variable.
python-distutils-ng_redoscript() {
local sbn="$(basename "${1}")"
mkdir -p "${T}/_${sbn}/" || die "failed to create directory"
mv "${D}${1}" "${T}/_${sbn}/${sbn}" || die "failed to move file"
python-distutils-ng_doscript "${T}/_${sbn}/${sbn}" "${2}"
}
# @FUNCTION: python-distutils-ng_doscript
# @USAGE: script_file_name [destination_directory]
# @DESCRIPTION:
# Install given script file in destination directory (for default value check
# python-distutils-ng_newscript) for all enabled implementations using original
# script name as a base name.
#
# See also python-distutils-ng_newscript for more details.
python-distutils-ng_doscript() {
python-distutils-ng_newscript "${1}" "$(basename "${1}")" "${2}"
}
# @FUNCTION: python-distutils-ng_newscript
# @USAGE: script_file_name new_file_name [destination_directory]
# @DESCRIPTION:
# Install given script file in destination directory for all enabled
# implementations using new_file_name as a base name.
#
# Destination directory defaults to /usr/bin.
#
# If only one Python implementation is enabled the script will be installed
# as-is. Otherwise each script copy will have the name mangled to
# "new_file_name-IMPLEMENTATION". For every installed script new hash-bang line
# will be inserted to reference specific Python interpreter.
#
# In case of multiple implementations there will be also a symlink with name
# equal to new_file_name that will be a symlink to default implementation, which
# defaults to value of PYTHON_DEFAULT_IMPLEMENTATION, if not specified the
# function will pick default implementation: it will the be first enabled one
# from the following list:
# python2_7, python2_6, python2_5, python3_2, python3_1, pypy1_8, pypy1_7, jython2_5
python-distutils-ng_newscript() {
[[ -n "${1}" ]] || die "Missing source file name"
[[ -n "${2}" ]] || die "Missing destination file name"
local source_file="${1}"
local destination_file="${2}"
local default_impl="${PYTHON_DEFAULT_IMPLEMENTATION}"
local enabled_impls=0
local destination_directory="/usr/bin"
[[ -n "${3}" ]] && destination_directory="${3}"
for impl in ${PYTHON_COMPAT}; do
use "python_targets_${impl}" || continue
enabled_impls=$((enabled_impls + 1))
done
if [[ -z "${default_impl}" ]]; then
for impl in python{2_7,2_6,2_5,3_2,3_1} pypy{1_9,1_8,1_7} jython2_5; do
use "python_targets_${impl}" || continue
default_impl="${impl}"
break
done
else
use "python_targets_${default_impl}" || \
die "default implementation ${default_impl} not enabled"
fi
[[ -n "${default_impl}" ]] || die "Could not select default implementation"
dodir "${destination_directory}"
insinto "${destination_directory}"
if [[ "${enabled_impls}" = "1" ]]; then
einfo "Installing ${source_file} for single implementation (${default_impl}) in ${destination_directory}"
newins "${source_file}" "${destination_file}"
fperms 755 "${destination_directory}/${destination_file}"
python-distutils-ng_rewrite_hashbang "${D}${destination_directory}/${destination_file}" "${default_impl}"
else
einfo "Installing ${source_file} for multiple implementations (default: ${default_impl}) in ${destination_directory}"
for impl in ${PYTHON_COMPAT}; do
use "python_targets_${impl}" ${PYTHON_COMPAT} || continue
newins "${source_file}" "${destination_file}-${impl}"
fperms 755 "${destination_directory}/${destination_file}-${impl}"
python-distutils-ng_rewrite_hashbang "${D}${destination_directory}/${destination_file}-${impl}" "${impl}"
done
dosym "${destination_file}-${default_impl}" "${destination_directory}/${destination_file}"
fi
}
# Phase function: src_prepare
python-distutils-ng_src_prepare() {
[[ "${PYTHON_OPTIONAL}" = "yes" ]] && { use python || return; }
# Try to run binary for each implementation:
for impl in ${PYTHON_COMPAT}; do
use "python_targets_${impl}" ${PYTHON_COMPAT} || continue
$(_python-distutils-ng_get_binary_for_implementation "${impl}") \
-c "import sys" || die
done
# Run prepare shared by all implementations:
if type python_prepare_all &> /dev/null; then
einfo "Running python_prepare_all in ${S} for all"
python_prepare_all
fi
# Create a copy of S for each implementation:
for impl in ${PYTHON_COMPAT}; do
use "python_targets_${impl}" ${PYTHON_COMPAT} || continue
einfo "Creating copy for ${impl} in ${WORKDIR}/impl_${impl}"
mkdir -p "${WORKDIR}/impl_${impl}" || die
cp -pr "${S}" "${WORKDIR}/impl_${impl}/${_PACKAGE_SPECIFIC_S}" || die
done
# Run python_prepare for each implementation:
if type python_prepare &> /dev/null; then
_python-distutils-ng_run_for_each_impl python_prepare
fi
}
# Phase function: src_configure
python-distutils-ng_src_configure() {
[[ "${PYTHON_OPTIONAL}" = "yes" ]] && { use python || return; }
if type python_configure &> /dev/null; then
_python-distutils-ng_run_for_each_impl python_configure
fi
}
# Phase function: src_compile
python-distutils-ng_src_compile() {
[[ "${PYTHON_OPTIONAL}" = "yes" ]] && { use python || return; }
if type python_compile &> /dev/null; then
_python-distutils-ng_run_for_each_impl python_compile
else
_python-distutils-ng_run_for_each_impl \
_python-distutils-ng_default_distutils_compile
fi
}
# Phase function: src_test
python-distutils-ng_src_test() {
[[ "${PYTHON_OPTIONAL}" = "yes" ]] && { use python || return; }
if type python_test &> /dev/null; then
_python-distutils-ng_run_for_each_impl python_test
fi
}
# Phase function: src_install
python-distutils-ng_src_install() {
[[ "${PYTHON_OPTIONAL}" = "yes" ]] && { use python || return; }
if type python_install &> /dev/null; then
_python-distutils-ng_run_for_each_impl python_install
else
_python-distutils-ng_run_for_each_impl \
_python-distutils-ng_default_distutils_install
fi
if type python_install_all &> /dev/null; then
einfo "Running python_install_all in ${S} for all"
pushd "${S}" &> /dev/null
python_install_all
popd &> /dev/null
fi
if [[ -z "${PYTHON_DISABLE_SCRIPT_REDOS}" ]]; then
for script_file in $(find "${ED}"{,usr/}{,s}bin/ -type f -executable 2> /dev/null); do
python-distutils-ng_redoscript "/${script_file#${D}}"
done
fi
}