/[gentoo-x86]/eclass/python.eclass
Gentoo

Diff of /eclass/python.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.82 Revision 1.95
1# Copyright 1999-2009 Gentoo Foundation 1# Copyright 1999-2010 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/python.eclass,v 1.82 2009/12/23 23:43:42 arfrever Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/python.eclass,v 1.95 2010/03/20 17:59:40 arfrever Exp $
4 4
5# @ECLASS: python.eclass 5# @ECLASS: python.eclass
6# @MAINTAINER: 6# @MAINTAINER:
7# python@gentoo.org 7# Gentoo Python Project <python@gentoo.org>
8# @BLURB: A utility eclass that should be inherited by anything that deals with Python or Python modules. 8# @BLURB: Eclass for Python packages
9# @DESCRIPTION: 9# @DESCRIPTION:
10# Some useful functions for dealing with Python. 10# The python eclass contains miscellaneous, useful functions for Python packages.
11 11
12inherit multilib 12inherit multilib
13 13
14if [[ -n "${NEED_PYTHON}" ]]; then 14if ! has "${EAPI:-0}" 0 1 2 3; then
15 PYTHON_ATOM=">=dev-lang/python-${NEED_PYTHON}" 15 die "API of python.eclass in EAPI=\"${EAPI}\" not established"
16 DEPEND="${PYTHON_ATOM}" 16fi
17
18_CPYTHON2_SUPPORTED_ABIS=(2.4 2.5 2.6 2.7)
19_CPYTHON3_SUPPORTED_ABIS=(3.0 3.1 3.2)
20_JYTHON_SUPPORTED_ABIS=(2.5-jython)
21
22# @ECLASS-VARIABLE: PYTHON_DEPEND
23# @DESCRIPTION:
24# Specification of dependency on dev-lang/python.
25# Syntax:
26# PYTHON_DEPEND: [[!]USE_flag? ]<version_components_group>[ version_components_group]
27# version_components_group: <major_version[:[minimal_version][:maximal_version]]>
28# major_version: <2|3|*>
29# minimal_version: <minimal_major_version.minimal_minor_version>
30# maximal_version: <maximal_major_version.maximal_minor_version>
31
32_parse_PYTHON_DEPEND() {
33 local major_version maximal_version minimal_version python_all="0" python_maximal_version python_minimal_version python_versions=() python2="0" python2_maximal_version python2_minimal_version python3="0" python3_maximal_version python3_minimal_version USE_flag= version_components_group version_components_group_regex version_components_groups
34
35 version_components_group_regex="(2|3|\*)(:([[:digit:]]+\.[[:digit:]]+)?(:([[:digit:]]+\.[[:digit:]]+)?)?)?"
36 version_components_groups="${PYTHON_DEPEND}"
37
38 if [[ "${version_components_groups}" =~ ^((\!)?[[:alnum:]_-]+\?\ )?${version_components_group_regex}(\ ${version_components_group_regex})?$ ]]; then
39 if [[ "${version_components_groups}" =~ ^(\!)?[[:alnum:]_-]+\? ]]; then
40 USE_flag="${version_components_groups%\? *}"
41 version_components_groups="${version_components_groups#* }"
42 fi
43 if [[ "${version_components_groups}" =~ ("*".*" "|" *"|^2.*\ (2|\*)|^3.*\ (3|\*)) ]]; then
44 die "Invalid syntax of PYTHON_DEPEND: Incorrectly specified groups of versions"
45 fi
46
47 version_components_groups="${version_components_groups// /$'\n'}"
48 while read version_components_group; do
49 major_version="${version_components_group:0:1}"
50 minimal_version="${version_components_group:2}"
51 minimal_version="${minimal_version%:*}"
52 maximal_version="${version_components_group:$((3 + ${#minimal_version}))}"
53
54 if [[ "${major_version}" =~ ^(2|3)$ ]]; then
55 if [[ -n "${minimal_version}" && "${major_version}" != "${minimal_version:0:1}" ]]; then
56 die "Invalid syntax of PYTHON_DEPEND: Minimal version '${minimal_version}' not in specified group of versions"
57 fi
58 if [[ -n "${maximal_version}" && "${major_version}" != "${maximal_version:0:1}" ]]; then
59 die "Invalid syntax of PYTHON_DEPEND: Maximal version '${maximal_version}' not in specified group of versions"
60 fi
61 fi
62
63 if [[ "${major_version}" == "2" ]]; then
64 python2="1"
65 python_versions=("${_CPYTHON2_SUPPORTED_ABIS[@]}")
66 python2_minimal_version="${minimal_version}"
67 python2_maximal_version="${maximal_version}"
68 elif [[ "${major_version}" == "3" ]]; then
69 python3="1"
70 python_versions=("${_CPYTHON3_SUPPORTED_ABIS[@]}")
71 python3_minimal_version="${minimal_version}"
72 python3_maximal_version="${maximal_version}"
73 else
74 python_all="1"
75 python_versions=("${_CPYTHON2_SUPPORTED_ABIS[@]}" "${_CPYTHON3_SUPPORTED_ABIS[@]}")
76 python_minimal_version="${minimal_version}"
77 python_maximal_version="${maximal_version}"
78 fi
79
80 if [[ -n "${minimal_version}" ]] && ! has "${minimal_version}" "${python_versions[@]}"; then
81 die "Invalid syntax of PYTHON_DEPEND: Unrecognized minimal version '${minimal_version}'"
82 fi
83 if [[ -n "${maximal_version}" ]] && ! has "${maximal_version}" "${python_versions[@]}"; then
84 die "Invalid syntax of PYTHON_DEPEND: Unrecognized maximal version '${maximal_version}'"
85 fi
86
87 if [[ -n "${minimal_version}" && -n "${maximal_version}" && "${minimal_version}" > "${maximal_version}" ]]; then
88 die "Invalid syntax of PYTHON_DEPEND: Minimal version '${minimal_version}' greater than maximal version '${maximal_version}'"
89 fi
90 done <<< "${version_components_groups}"
91
92 _PYTHON_ATOMS=()
93
94 _append_accepted_versions_range() {
95 local accepted_version="0" i
96 for ((i = "${#python_versions[@]}"; i >= 0; i--)); do
97 if [[ "${python_versions[${i}]}" == "${python_maximal_version}" ]]; then
98 accepted_version="1"
99 fi
100 if [[ "${accepted_version}" == "1" ]]; then
101 _PYTHON_ATOMS+=("=dev-lang/python-${python_versions[${i}]}*")
102 fi
103 if [[ "${python_versions[${i}]}" == "${python_minimal_version}" ]]; then
104 accepted_version="0"
105 fi
106 done
107 }
108
109 if [[ "${python_all}" == "1" ]]; then
110 if [[ -z "${python_minimal_version}" && -z "${python_maximal_version}" ]]; then
111 _PYTHON_ATOMS+=("dev-lang/python")
112 else
113 python_versions=("${_CPYTHON2_SUPPORTED_ABIS[@]}" "${_CPYTHON3_SUPPORTED_ABIS[@]}")
114 python_minimal_version="${python_minimal_version:-${python_versions[0]}}"
115 python_maximal_version="${python_maximal_version:-${python_versions[${#python_versions[@]}-1]}}"
116 _append_accepted_versions_range
117 fi
118 else
119 if [[ "${python3}" == "1" ]]; then
120 if [[ -z "${python3_minimal_version}" && -z "${python3_maximal_version}" ]]; then
121 _PYTHON_ATOMS+=("=dev-lang/python-3*")
122 else
123 python_versions=("${_CPYTHON3_SUPPORTED_ABIS[@]}")
124 python_minimal_version="${python3_minimal_version:-${python_versions[0]}}"
125 python_maximal_version="${python3_maximal_version:-${python_versions[${#python_versions[@]}-1]}}"
126 _append_accepted_versions_range
127 fi
128 fi
129 if [[ "${python2}" == "1" ]]; then
130 if [[ -z "${python2_minimal_version}" && -z "${python2_maximal_version}" ]]; then
131 _PYTHON_ATOMS+=("=dev-lang/python-2*")
132 else
133 python_versions=("${_CPYTHON2_SUPPORTED_ABIS[@]}")
134 python_minimal_version="${python2_minimal_version:-${python_versions[0]}}"
135 python_maximal_version="${python2_maximal_version:-${python_versions[${#python_versions[@]}-1]}}"
136 _append_accepted_versions_range
137 fi
138 fi
139 fi
140
141 unset -f _append_accepted_versions_range
142
143 if [[ "${#_PYTHON_ATOMS[@]}" -gt 1 ]]; then
144 DEPEND+="${DEPEND:+ }${USE_flag}${USE_flag:+? ( }|| ( ${_PYTHON_ATOMS[@]} )${USE_flag:+ )}"
145 RDEPEND+="${RDEPEND:+ }${USE_flag}${USE_flag:+? ( }|| ( ${_PYTHON_ATOMS[@]} )${USE_flag:+ )}"
146 else
147 DEPEND+="${DEPEND:+ }${USE_flag}${USE_flag:+? ( }${_PYTHON_ATOMS[@]}${USE_flag:+ )}"
148 RDEPEND+="${RDEPEND:+ }${USE_flag}${USE_flag:+? ( }${_PYTHON_ATOMS[@]}${USE_flag:+ )}"
149 fi
150 else
151 die "Invalid syntax of PYTHON_DEPEND"
152 fi
153}
154
155DEPEND=">=app-admin/eselect-python-20091230"
17 RDEPEND="${DEPEND}" 156RDEPEND="${DEPEND}"
157
158if [[ -n "${PYTHON_DEPEND}" && -n "${NEED_PYTHON}" ]]; then
159 die "PYTHON_DEPEND and NEED_PYTHON cannot be set simultaneously"
160elif [[ -n "${PYTHON_DEPEND}" ]]; then
161 _parse_PYTHON_DEPEND
162elif [[ -n "${NEED_PYTHON}" ]]; then
163 if ! has "${EAPI:-0}" 0 1 2; then
164 eerror "Use PYTHON_DEPEND instead of NEED_PYTHON."
165 die "NEED_PYTHON cannot be used in this EAPI"
166 fi
167 _PYTHON_ATOMS=(">=dev-lang/python-${NEED_PYTHON}")
168 DEPEND+="${DEPEND:+ }${_PYTHON_ATOMS[@]}"
169 RDEPEND+="${RDEPEND:+ }${_PYTHON_ATOMS[@]}"
18else 170else
19 PYTHON_ATOM="dev-lang/python" 171 _PYTHON_ATOMS=("dev-lang/python")
20fi 172fi
21 173
22DEPEND+=" >=app-admin/eselect-python-20090804 174# @ECLASS-VARIABLE: PYTHON_USE_WITH
23 >=app-shells/bash-3.2" 175# @DESCRIPTION:
176# Set this to a space separated list of USE flags the Python slot in use must be built with.
24 177
25__python_eclass_test() { 178# @ECLASS-VARIABLE: PYTHON_USE_WITH_OR
26 __python_version_extract 2.3 179# @DESCRIPTION:
27 echo -n "2.3 -> PYVER: $PYVER PYVER_MAJOR: $PYVER_MAJOR" 180# Set this to a space separated list of USE flags of which one must be turned on for the slot in use.
28 echo " PYVER_MINOR: $PYVER_MINOR PYVER_MICRO: $PYVER_MICRO"
29 __python_version_extract 2.3.4
30 echo -n "2.3.4 -> PYVER: $PYVER PYVER_MAJOR: $PYVER_MAJOR"
31 echo " PYVER_MINOR: $PYVER_MINOR PYVER_MICRO: $PYVER_MICRO"
32 __python_version_extract 2.3.5
33 echo -n "2.3.5 -> PYVER: $PYVER PYVER_MAJOR: $PYVER_MAJOR"
34 echo " PYVER_MINOR: $PYVER_MINOR PYVER_MICRO: $PYVER_MICRO"
35 __python_version_extract 2.4
36 echo -n "2.4 -> PYVER: $PYVER PYVER_MAJOR: $PYVER_MAJOR"
37 echo " PYVER_MINOR: $PYVER_MINOR PYVER_MICRO: $PYVER_MICRO"
38 __python_version_extract 2.5b3
39 echo -n "2.5b3 -> PYVER: $PYVER PYVER_MAJOR: $PYVER_MAJOR"
40 echo " PYVER_MINOR: $PYVER_MINOR PYVER_MICRO: $PYVER_MICRO"
41}
42 181
182# @ECLASS-VARIABLE: PYTHON_USE_WITH_OPT
183# @DESCRIPTION:
184# Set this to a name of a USE flag if you need to make either PYTHON_USE_WITH or
185# PYTHON_USE_WITH_OR atoms conditional under a USE flag.
186
43# @FUNCTION: python_version 187# @FUNCTION: python_pkg_setup
44# @DESCRIPTION: 188# @DESCRIPTION:
45# Run without arguments and it will export the version of python 189# Makes sure PYTHON_USE_WITH or PYTHON_USE_WITH_OR listed use flags
46# currently in use as $PYVER; sets PYVER/PYVER_MAJOR/PYVER_MINOR 190# are respected. Only exported if one of those variables is set.
47__python_version_extract() { 191if ! has "${EAPI:-0}" 0 1 && [[ -n ${PYTHON_USE_WITH} || -n ${PYTHON_USE_WITH_OR} ]]; then
48 local verstr=$1 192 python_pkg_setup() {
49 export PYVER_MAJOR=${verstr:0:1} 193 # Check if phase is pkg_setup().
50 export PYVER_MINOR=${verstr:2:1} 194 [[ "${EBUILD_PHASE}" != "setup" ]] && die "${FUNCNAME}() can be used only in pkg_setup() phase"
51 if [[ ${verstr:3:1} == . ]]; then 195
52 export PYVER_MICRO=${verstr:4} 196 python_pkg_setup_fail() {
197 eerror "${1}"
198 die "${1}"
199 }
200
201 if [[ "${PYTHON_USE_WITH_OPT}" ]]; then
202 if [[ "${PYTHON_USE_WITH_OPT}" == !* ]]; then
203 use ${PYTHON_USE_WITH_OPT#!} && return
204 else
205 use !${PYTHON_USE_WITH_OPT} && return
206 fi
53 fi 207 fi
54 export PYVER="${PYVER_MAJOR}.${PYVER_MINOR}"
55}
56 208
57python_version() { 209 python_pkg_setup_check_USE_flags() {
58 [[ -n "${PYVER}" ]] && return 0 210 local pyatom use
59 local tmpstr 211 pyatom="$(python_get_implementational_package)"
60 python=${python:-/usr/bin/python}
61 tmpstr="$(EPYTHON= ${python} -V 2>&1 )"
62 export PYVER_ALL="${tmpstr#Python }"
63 __python_version_extract $PYVER_ALL
64}
65 212
66# @FUNCTION: PYTHON 213 for use in ${PYTHON_USE_WITH}; do
67# @USAGE: [-2] [-3] [-A|--only-ABI] [-a|--absolute-path] [-f|--final-ABI] [--] <Python_ABI="${PYTHON_ABI}"> 214 if ! has_version "${pyatom}[${use}]"; then
68# @DESCRIPTION: 215 python_pkg_setup_fail "Please rebuild ${pyatom} with the following USE flags enabled: ${PYTHON_USE_WITH}"
69# Get Python interpreter filename for specified Python ABI. If Python_ABI argument
70# is ommitted, then PYTHON_ABI environment variable must be set and is used.
71# If -2 option is specified, then active version of Python 2 is used.
72# If -3 option is specified, then active version of Python 3 is used.
73# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
74# -2, -3 and --final-ABI options and Python_ABI argument cannot be specified simultaneously.
75# If --only-ABI option is specified, then only specified Python ABI is printed instead of
76# Python interpreter filename.
77# --only-ABI and --absolute-path options cannot be specified simultaneously.
78PYTHON() {
79 local absolute_path="0" final_ABI="0" only_ABI="0" python2="0" python3="0" slot=
80
81 while (($#)); do
82 case "$1" in
83 -2)
84 python2="1"
85 ;;
86 -3)
87 python3="1"
88 ;;
89 -A|--only-ABI)
90 only_ABI="1"
91 ;;
92 -a|--absolute-path)
93 absolute_path="1"
94 ;;
95 -f|--final-ABI)
96 final_ABI="1"
97 ;;
98 --)
99 break
100 ;;
101 -*)
102 die "${FUNCNAME}(): Unrecognized option '$1'"
103 ;;
104 *)
105 break
106 ;;
107 esac
108 shift
109 done
110
111 if [[ "${only_ABI}" == "1" && "${absolute_path}" == "1" ]]; then
112 die "${FUNCNAME}(): '--only-ABI and '--absolute-path' options cannot be specified simultaneously"
113 fi
114
115 if [[ "$((${python2} + ${python3} + ${final_ABI}))" -gt "1" ]]; then
116 die "${FUNCNAME}(): '-2', '-3' or '--final-ABI' options cannot be specified simultaneously"
117 fi
118
119 if [[ "$#" -eq "0" ]]; then
120 if [[ "${final_ABI}" == "1" ]]; then
121 validate_PYTHON_ABIS
122 slot="${PYTHON_ABIS##* }"
123 elif [[ "${python2}" == "1" ]]; then
124 slot="$(eselect python show --python2)"
125 if [[ -z "${slot}" ]]; then
126 die "${FUNCNAME}(): Active Python 2 interpreter not set"
127 elif [[ "${slot}" != "python2."* ]]; then
128 die "${FUNCNAME}(): Internal error in \`eselect python show --python2\`"
129 fi 216 fi
130 slot="${slot#python}" 217 done
131 elif [[ "${python3}" == "1" ]]; then 218
132 slot="$(eselect python show --python3)" 219 for use in ${PYTHON_USE_WITH_OR}; do
133 if [[ -z "${slot}" ]]; then 220 if has_version "${pyatom}[${use}]"; then
134 die "${FUNCNAME}(): Active Python 3 interpreter not set" 221 return
135 elif [[ "${slot}" != "python3."* ]]; then
136 die "${FUNCNAME}(): Internal error in \`eselect python show --python3\`"
137 fi 222 fi
138 slot="${slot#python}" 223 done
139 elif [[ -n "${PYTHON_ABI}" ]]; then 224
140 slot="${PYTHON_ABI}" 225 if [[ ${PYTHON_USE_WITH_OR} ]]; then
226 python_pkg_setup_fail "Please rebuild ${pyatom} with at least one of the following USE flags enabled: ${PYTHON_USE_WITH_OR}"
227 fi
228 }
229
230 if _python_package_supporting_installation_for_multiple_python_abis; then
231 python_execute_function -q python_pkg_setup_check_USE_flags
141 else 232 else
142 die "${FUNCNAME}(): Invalid usage" 233 python_pkg_setup_check_USE_flags
234 fi
235
236 unset -f python_pkg_setup_check_USE_flags python_pkg_setup_fail
237 }
238
239 EXPORT_FUNCTIONS pkg_setup
240
241 _PYTHON_USE_WITH_ATOMS_ARRAY=()
242 if [[ -n "${PYTHON_USE_WITH}" ]]; then
243 for _PYTHON_ATOM in "${_PYTHON_ATOMS[@]}"; do
244 _PYTHON_USE_WITH_ATOMS_ARRAY+=("${_PYTHON_ATOM}[${PYTHON_USE_WITH/ /,}]")
245 done
246 elif [[ -n "${PYTHON_USE_WITH_OR}" ]]; then
247 for _USE_flag in ${PYTHON_USE_WITH_OR}; do
248 for _PYTHON_ATOM in "${_PYTHON_ATOMS[@]}"; do
249 _PYTHON_USE_WITH_ATOMS_ARRAY+=("${_PYTHON_ATOM}[${_USE_flag}]")
250 done
251 done
252 unset _USE_flag
143 fi 253 fi
144 elif [[ "$#" -eq "1" ]]; then 254 if [[ "${#_PYTHON_USE_WITH_ATOMS_ARRAY[@]}" -gt 1 ]]; then
145 if [[ "${final_ABI}" == "1" ]]; then 255 _PYTHON_USE_WITH_ATOMS="|| ( ${_PYTHON_USE_WITH_ATOMS_ARRAY[@]} )"
146 die "${FUNCNAME}(): '--final-ABI' option and Python ABI cannot be specified simultaneously"
147 fi
148 if [[ "${python2}" == "1" ]]; then
149 die "${FUNCNAME}(): '-2' option and Python ABI cannot be specified simultaneously"
150 fi
151 if [[ "${python3}" == "1" ]]; then
152 die "${FUNCNAME}(): '-3' option and Python ABI cannot be specified simultaneously"
153 fi
154 slot="$1"
155 else 256 else
156 die "${FUNCNAME}(): Invalid usage" 257 _PYTHON_USE_WITH_ATOMS="${_PYTHON_USE_WITH_ATOMS_ARRAY[@]}"
258 fi
259 if [[ -n "${PYTHON_USE_WITH_OPT}" ]]; then
260 _PYTHON_USE_WITH_ATOMS="${PYTHON_USE_WITH_OPT}? ( ${_PYTHON_USE_WITH_ATOMS} )"
261 fi
262 DEPEND+=" ${_PYTHON_USE_WITH_ATOMS}"
263 RDEPEND+=" ${_PYTHON_USE_WITH_ATOMS}"
264 unset _PYTHON_ATOM _PYTHON_USE_WITH_ATOMS _PYTHON_USE_WITH_ATOMS_ARRAY
265fi
266
267unset _PYTHON_ATOMS
268
269# ================================================================================================
270# =========== FUNCTIONS FOR PACKAGES SUPPORTING INSTALLATION FOR MULTIPLE PYTHON ABIS ============
271# ================================================================================================
272
273# @ECLASS-VARIABLE: SUPPORT_PYTHON_ABIS
274# @DESCRIPTION:
275# Set this in EAPI <= 4 to indicate that current package supports installation for
276# multiple Python ABIs.
277
278# @ECLASS-VARIABLE: PYTHON_EXPORT_PHASE_FUNCTIONS
279# @DESCRIPTION:
280# Set this to export phase functions for the following ebuild phases:
281# src_prepare, src_configure, src_compile, src_test, src_install.
282if ! has "${EAPI:-0}" 0 1; then
283 python_src_prepare() {
284 if ! _python_package_supporting_installation_for_multiple_python_abis; then
285 die "${FUNCNAME}() cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
157 fi 286 fi
158 287
159 if [[ "${only_ABI}" == "1" ]]; then 288 python_copy_sources
160 echo -n "${slot}" 289 }
161 return
162 elif [[ "${absolute_path}" == "1" ]]; then
163 echo -n "/usr/bin/python${slot}"
164 else
165 echo -n "python${slot}"
166 fi
167 290
168 if [[ -n "${ABI}" && "${ABI}" != "${DEFAULT_ABI}" && "${DEFAULT_ABI}" != "default" ]]; then 291 for python_default_function in src_configure src_compile src_test src_install; do
169 echo -n "-${ABI}" 292 eval "python_${python_default_function}() {
170 fi 293 if ! _python_package_supporting_installation_for_multiple_python_abis; then
171} 294 die \"\${FUNCNAME}() cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs\"
172
173# @FUNCTION: python_set_active_version
174# @USAGE: <Python_ABI|2|3>
175# @DESCRIPTION:
176# Set active version of Python.
177python_set_active_version() {
178 if [[ "$#" -ne "1" ]]; then
179 die "${FUNCNAME}() requires 1 argument"
180 fi
181
182 if [[ "$1" =~ ^[[:digit:]]+\.[[:digit:]]+$ ]]; then
183 if ! has_version "dev-lang/python:$1"; then
184 die "${FUNCNAME}(): 'dev-lang/python:$1' isn't installed"
185 fi 295 fi
186 export EPYTHON="$(PYTHON "$1")" 296
187 elif [[ "$1" == "2" ]]; then 297 python_execute_function -d -s \"\$@\"
188 if ! has_version "=dev-lang/python-2*"; then 298 }"
189 die "${FUNCNAME}(): '=dev-lang/python-2*' isn't installed" 299 done
300 unset python_default_function
301
302 if [[ -n "${PYTHON_EXPORT_PHASE_FUNCTIONS}" ]]; then
303 EXPORT_FUNCTIONS src_prepare src_configure src_compile src_test src_install
190 fi 304 fi
191 export EPYTHON="$(PYTHON -2)"
192 elif [[ "$1" == "3" ]]; then
193 if ! has_version "=dev-lang/python-3*"; then
194 die "${FUNCNAME}(): '=dev-lang/python-3*' isn't installed"
195 fi
196 export EPYTHON="$(PYTHON -3)"
197 else
198 die "${FUNCNAME}(): Unrecognized argument '$1'"
199 fi 305fi
200
201 # PYTHON_ABI variable is intended to be used only in ebuilds/eclasses,
202 # so it doesn't need to be exported to subprocesses.
203 PYTHON_ABI="${EPYTHON#python}"
204 PYTHON_ABI="${PYTHON_ABI%%-*}"
205}
206 306
207unset PYTHON_ABIS 307unset PYTHON_ABIS
208unset PYTHON_ABIS_SANITY_CHECKS
209 308
210# @FUNCTION: validate_PYTHON_ABIS 309# @FUNCTION: validate_PYTHON_ABIS
211# @DESCRIPTION: 310# @DESCRIPTION:
212# Ensure that PYTHON_ABIS variable has valid value. 311# Ensure that PYTHON_ABIS variable has valid value.
312# This function usually should not be directly called in ebuilds.
213validate_PYTHON_ABIS() { 313validate_PYTHON_ABIS() {
214 # Ensure that some functions cannot be accidentally successfully used in EAPI <= 2 without setting SUPPORT_PYTHON_ABIS variable. 314 if ! _python_package_supporting_installation_for_multiple_python_abis; then
215 if has "${EAPI:-0}" 0 1 2 && [[ -z "${SUPPORT_PYTHON_ABIS}" ]]; then 315 die "${FUNCNAME}() cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
216 die "${FUNCNAME}() cannot be used in this EAPI without setting SUPPORT_PYTHON_ABIS variable"
217 fi 316 fi
218 317
219 # Ensure that /usr/bin/python and /usr/bin/python-config are valid. 318 _python_initial_sanity_checks
220 if [[ "$(readlink /usr/bin/python)" != "python-wrapper" ]]; then
221 die "'/usr/bin/python' isn't valid symlink"
222 fi
223 if [[ "$(</usr/bin/python-config)" != *"Gentoo python-config wrapper script"* ]]; then
224 die "'/usr/bin/python-config' isn't valid script"
225 fi
226 319
227 # USE_${ABI_TYPE^^} and RESTRICT_${ABI_TYPE^^}_ABIS variables hopefully will be included in EAPI >= 5. 320 # USE_${ABI_TYPE^^} and RESTRICT_${ABI_TYPE^^}_ABIS variables hopefully will be included in EAPI >= 5.
228 if [[ "$(declare -p PYTHON_ABIS 2> /dev/null)" != "declare -x PYTHON_ABIS="* ]] && has "${EAPI:-0}" 0 1 2 3 4; then 321 if [[ "$(declare -p PYTHON_ABIS 2> /dev/null)" != "declare -x PYTHON_ABIS="* ]] && has "${EAPI:-0}" 0 1 2 3 4; then
229 local PYTHON_ABI python2_supported_versions python3_supported_versions restricted_ABI support_ABI supported_PYTHON_ABIS= 322 local PYTHON_ABI restricted_ABI support_ABI supported_PYTHON_ABIS=
230 PYTHON_ABI_SUPPORTED_VALUES="2.4 2.5 2.6 2.7 3.0 3.1 3.2" 323 PYTHON_ABI_SUPPORTED_VALUES="${_CPYTHON2_SUPPORTED_ABIS[@]} ${_CPYTHON3_SUPPORTED_ABIS[@]} ${_JYTHON_SUPPORTED_ABIS[@]}"
231 python2_supported_versions="2.4 2.5 2.6 2.7"
232 python3_supported_versions="3.0 3.1 3.2"
233 324
234 if [[ "$(declare -p USE_PYTHON 2> /dev/null)" == "declare -x USE_PYTHON="* ]]; then 325 if [[ "$(declare -p USE_PYTHON 2> /dev/null)" == "declare -x USE_PYTHON="* ]]; then
235 local python2_enabled="0" python3_enabled="0" 326 local cpython_enabled="0"
236 327
237 if [[ -z "${USE_PYTHON}" ]]; then 328 if [[ -z "${USE_PYTHON}" ]]; then
238 die "USE_PYTHON variable is empty" 329 die "USE_PYTHON variable is empty"
239 fi 330 fi
240 331
241 for PYTHON_ABI in ${USE_PYTHON}; do 332 for PYTHON_ABI in ${USE_PYTHON}; do
242 if ! has "${PYTHON_ABI}" ${PYTHON_ABI_SUPPORTED_VALUES}; then 333 if ! has "${PYTHON_ABI}" ${PYTHON_ABI_SUPPORTED_VALUES}; then
243 die "USE_PYTHON variable contains invalid value '${PYTHON_ABI}'" 334 die "USE_PYTHON variable contains invalid value '${PYTHON_ABI}'"
244 fi 335 fi
245 336
246 if has "${PYTHON_ABI}" ${python2_supported_versions}; then 337 if has "${PYTHON_ABI}" "${_CPYTHON2_SUPPORTED_ABIS[@]}" "${_CPYTHON3_SUPPORTED_ABIS[@]}"; then
247 python2_enabled="1" 338 cpython_enabled="1"
248 fi
249 if has "${PYTHON_ABI}" ${python3_supported_versions}; then
250 python3_enabled="1"
251 fi 339 fi
252 340
253 support_ABI="1" 341 support_ABI="1"
254 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do 342 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do
255 if [[ "${PYTHON_ABI}" == ${restricted_ABI} ]]; then 343 if [[ "${PYTHON_ABI}" == ${restricted_ABI} ]]; then
259 done 347 done
260 [[ "${support_ABI}" == "1" ]] && export PYTHON_ABIS+="${PYTHON_ABIS:+ }${PYTHON_ABI}" 348 [[ "${support_ABI}" == "1" ]] && export PYTHON_ABIS+="${PYTHON_ABIS:+ }${PYTHON_ABI}"
261 done 349 done
262 350
263 if [[ -z "${PYTHON_ABIS//[${IFS}]/}" ]]; then 351 if [[ -z "${PYTHON_ABIS//[${IFS}]/}" ]]; then
264 die "USE_PYTHON variable doesn't enable any version of Python supported by ${CATEGORY}/${PF}" 352 die "USE_PYTHON variable does not enable any Python ABI supported by ${CATEGORY}/${PF}"
265 fi 353 fi
266 354
267 if [[ "${python2_enabled}" == "0" ]]; then 355 if [[ "${cpython_enabled}" == "0" ]]; then
268 ewarn "USE_PYTHON variable doesn't enable any version of Python 2. This configuration is unsupported." 356 die "USE_PYTHON variable does not enable any CPython ABI"
269 fi
270 if [[ "${python3_enabled}" == "0" ]]; then
271 ewarn "USE_PYTHON variable doesn't enable any version of Python 3. This configuration is unsupported."
272 fi 357 fi
273 else 358 else
274 local python_version python2_version= python3_version= support_python_major_version 359 local python_version python2_version= python3_version= support_python_major_version
275 360
276 python_version="$(/usr/bin/python -c 'from sys import version_info; print(".".join([str(x) for x in version_info[:2]]))')" 361 python_version="$("${EPREFIX}/usr/bin/python" -c 'from sys import version_info; print(".".join(str(x) for x in version_info[:2]))')"
277 362
278 if has_version "=dev-lang/python-2*"; then 363 if has_version "=dev-lang/python-2*"; then
279 if [[ "$(readlink /usr/bin/python2)" != "python2."* ]]; then 364 if [[ "$(readlink "${EPREFIX}/usr/bin/python2")" != "python2."* ]]; then
280 die "'/usr/bin/python2' isn't valid symlink" 365 die "'${EPREFIX}/usr/bin/python2' is not valid symlink"
281 fi 366 fi
282 367
283 python2_version="$(/usr/bin/python2 -c 'from sys import version_info; print(".".join([str(x) for x in version_info[:2]]))')" 368 python2_version="$("${EPREFIX}/usr/bin/python2" -c 'from sys import version_info; print(".".join(str(x) for x in version_info[:2]))')"
284 369
285 for PYTHON_ABI in ${python2_supported_versions}; do 370 for PYTHON_ABI in "${_CPYTHON2_SUPPORTED_ABIS[@]}"; do
286 support_python_major_version="1" 371 support_python_major_version="1"
287 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do 372 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do
288 if [[ "${PYTHON_ABI}" == ${restricted_ABI} ]]; then 373 if [[ "${PYTHON_ABI}" == ${restricted_ABI} ]]; then
289 support_python_major_version="0" 374 support_python_major_version="0"
290 fi 375 fi
292 [[ "${support_python_major_version}" == "1" ]] && break 377 [[ "${support_python_major_version}" == "1" ]] && break
293 done 378 done
294 if [[ "${support_python_major_version}" == "1" ]]; then 379 if [[ "${support_python_major_version}" == "1" ]]; then
295 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do 380 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do
296 if [[ "${python2_version}" == ${restricted_ABI} ]]; then 381 if [[ "${python2_version}" == ${restricted_ABI} ]]; then
297 die "Active version of Python 2 isn't supported by ${CATEGORY}/${PF}" 382 die "Active version of Python 2 is not supported by ${CATEGORY}/${PF}"
298 fi 383 fi
299 done 384 done
300 else 385 else
301 python2_version="" 386 python2_version=""
302 fi 387 fi
303 fi 388 fi
304 389
305 if has_version "=dev-lang/python-3*"; then 390 if has_version "=dev-lang/python-3*"; then
306 if [[ "$(readlink /usr/bin/python3)" != "python3."* ]]; then 391 if [[ "$(readlink "${EPREFIX}/usr/bin/python3")" != "python3."* ]]; then
307 die "'/usr/bin/python3' isn't valid symlink" 392 die "'${EPREFIX}/usr/bin/python3' is not valid symlink"
308 fi 393 fi
309 394
310 python3_version="$(/usr/bin/python3 -c 'from sys import version_info; print(".".join([str(x) for x in version_info[:2]]))')" 395 python3_version="$("${EPREFIX}/usr/bin/python3" -c 'from sys import version_info; print(".".join(str(x) for x in version_info[:2]))')"
311 396
312 for PYTHON_ABI in ${python3_supported_versions}; do 397 for PYTHON_ABI in "${_CPYTHON3_SUPPORTED_ABIS[@]}"; do
313 support_python_major_version="1" 398 support_python_major_version="1"
314 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do 399 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do
315 if [[ "${PYTHON_ABI}" == ${restricted_ABI} ]]; then 400 if [[ "${PYTHON_ABI}" == ${restricted_ABI} ]]; then
316 support_python_major_version="0" 401 support_python_major_version="0"
317 fi 402 fi
319 [[ "${support_python_major_version}" == "1" ]] && break 404 [[ "${support_python_major_version}" == "1" ]] && break
320 done 405 done
321 if [[ "${support_python_major_version}" == "1" ]]; then 406 if [[ "${support_python_major_version}" == "1" ]]; then
322 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do 407 for restricted_ABI in ${RESTRICT_PYTHON_ABIS}; do
323 if [[ "${python3_version}" == ${restricted_ABI} ]]; then 408 if [[ "${python3_version}" == ${restricted_ABI} ]]; then
324 die "Active version of Python 3 isn't supported by ${CATEGORY}/${PF}" 409 die "Active version of Python 3 is not supported by ${CATEGORY}/${PF}"
325 fi 410 fi
326 done 411 done
327 else 412 else
328 python3_version="" 413 python3_version=""
329 fi 414 fi
330 fi 415 fi
331 416
332 if [[ -n "${python2_version}" && "${python_version}" == "2."* && "${python_version}" != "${python2_version}" ]]; then 417 if [[ -n "${python2_version}" && "${python_version}" == "2."* && "${python_version}" != "${python2_version}" ]]; then
333 eerror "Python wrapper is configured incorrectly or /usr/bin/python2 symlink" 418 eerror "Python wrapper is configured incorrectly or '${EPREFIX}/usr/bin/python2' symlink"
334 eerror "is set incorrectly. Use \`eselect python\` to fix configuration." 419 eerror "is set incorrectly. Use \`eselect python\` to fix configuration."
335 die "Incorrect configuration of Python" 420 die "Incorrect configuration of Python"
336 fi 421 fi
337 if [[ -n "${python3_version}" && "${python_version}" == "3."* && "${python_version}" != "${python3_version}" ]]; then 422 if [[ -n "${python3_version}" && "${python_version}" == "3."* && "${python_version}" != "${python3_version}" ]]; then
338 eerror "Python wrapper is configured incorrectly or /usr/bin/python3 symlink" 423 eerror "Python wrapper is configured incorrectly or '${EPREFIX}/usr/bin/python3' symlink"
339 eerror "is set incorrectly. Use \`eselect python\` to fix configuration." 424 eerror "is set incorrectly. Use \`eselect python\` to fix configuration."
340 die "Incorrect configuration of Python" 425 die "Incorrect configuration of Python"
341 fi 426 fi
342 427
343 PYTHON_ABIS="${python2_version} ${python3_version}" 428 PYTHON_ABIS="${python2_version} ${python3_version}"
344 PYTHON_ABIS="${PYTHON_ABIS# }" 429 PYTHON_ABIS="${PYTHON_ABIS# }"
345 export PYTHON_ABIS="${PYTHON_ABIS% }" 430 export PYTHON_ABIS="${PYTHON_ABIS% }"
346 fi 431 fi
347 fi 432 fi
348 433
349 if [[ "$(declare -p PYTHON_ABIS_SANITY_CHECKS 2> /dev/null)" != "declare -- PYTHON_ABIS_SANITY_CHECKS="* ]]; then 434 _python_final_sanity_checks
350 local PYTHON_ABI
351 for PYTHON_ABI in ${PYTHON_ABIS}; do
352 # Ensure that appropriate version of Python is installed.
353 if ! has_version "dev-lang/python:${PYTHON_ABI}"; then
354 die "dev-lang/python:${PYTHON_ABI} isn't installed"
355 fi
356
357 # Ensure that EPYTHON variable is respected.
358 if [[ "$(EPYTHON="$(PYTHON)" python -c 'from sys import version_info; print(".".join([str(x) for x in version_info[:2]]))')" != "${PYTHON_ABI}" ]]; then
359 eerror "python: '$(type -p python)'"
360 eerror "ABI: '${ABI}'"
361 eerror "DEFAULT_ABI: '${DEFAULT_ABI}'"
362 eerror "EPYTHON: '$(PYTHON)'"
363 eerror "PYTHON_ABI: '${PYTHON_ABI}'"
364 eerror "Version of enabled Python: '$(EPYTHON="$(PYTHON)" python -c 'from sys import version_info; print(".".join([str(x) for x in version_info[:2]]))')'"
365 die "'python' doesn't respect EPYTHON variable"
366 fi
367 done
368 PYTHON_ABIS_SANITY_CHECKS="1"
369 fi
370}
371
372# @FUNCTION: python_copy_sources
373# @USAGE: [--no-link] [--] [directory]
374# @DESCRIPTION:
375# Copy unpacked sources of given package for each Python ABI.
376python_copy_sources() {
377 local dir dirs=() no_link="0" PYTHON_ABI
378
379 while (($#)); do
380 case "$1" in
381 --no-link)
382 no_link="1"
383 ;;
384 --)
385 break
386 ;;
387 -*)
388 die "${FUNCNAME}(): Unrecognized option '$1'"
389 ;;
390 *)
391 break
392 ;;
393 esac
394 shift
395 done
396
397 if [[ "$#" -eq "0" ]]; then
398 if [[ "${WORKDIR}" == "${S}" ]]; then
399 die "${FUNCNAME}() cannot be used"
400 fi
401 dirs="${S}"
402 else
403 dirs="$@"
404 fi
405
406 validate_PYTHON_ABIS
407 for PYTHON_ABI in ${PYTHON_ABIS}; do
408 for dir in "${dirs[@]}"; do
409 if [[ "${no_link}" == "1" ]]; then
410 cp -pr "${dir}" "${dir}-${PYTHON_ABI}" > /dev/null || die "Copying of sources failed"
411 else
412 cp -lpr "${dir}" "${dir}-${PYTHON_ABI}" > /dev/null || die "Copying of sources failed"
413 fi
414 done
415 done
416}
417
418# @FUNCTION: python_set_build_dir_symlink
419# @USAGE: [directory="build"]
420# @DESCRIPTION:
421# Create build directory symlink.
422python_set_build_dir_symlink() {
423 local dir="$1"
424
425 [[ -z "${PYTHON_ABI}" ]] && die "PYTHON_ABI variable not set"
426 [[ -z "${dir}" ]] && dir="build"
427
428 # Don't delete preexistent directories.
429 rm -f "${dir}" || die "Deletion of '${dir}' failed"
430 ln -s "${dir}-${PYTHON_ABI}" "${dir}" || die "Creation of '${dir}' directory symlink failed"
431} 435}
432 436
433# @FUNCTION: python_execute_function 437# @FUNCTION: python_execute_function
434# @USAGE: [--action-message message] [-d|--default-function] [--failure-message message] [--nonfatal] [-q|--quiet] [-s|--separate-build-dirs] [--source-dir source_directory] [--] <function> [arguments] 438# @USAGE: [--action-message message] [-d|--default-function] [--failure-message message] [-f|--final-ABI] [--nonfatal] [-q|--quiet] [-s|--separate-build-dirs] [--source-dir source_directory] [--] <function> [arguments]
435# @DESCRIPTION: 439# @DESCRIPTION:
436# Execute specified function for each value of PYTHON_ABIS, optionally passing additional 440# Execute specified function for each value of PYTHON_ABIS, optionally passing additional
437# arguments. The specified function can use PYTHON_ABI and BUILDDIR variables. 441# arguments. The specified function can use PYTHON_ABI and BUILDDIR variables.
438python_execute_function() { 442python_execute_function() {
439 local action action_message action_message_template= default_function="0" failure_message failure_message_template= function nonfatal="0" previous_directory previous_directory_stack previous_directory_stack_length PYTHON_ABI quiet="0" separate_build_dirs="0" source_dir= 443 if ! _python_package_supporting_installation_for_multiple_python_abis; then
444 die "${FUNCNAME}() cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
445 fi
446
447 _python_set_color_variables
448
449 local action action_message action_message_template= default_function="0" failure_message failure_message_template= final_ABI="0" function i iterated_PYTHON_ABIS nonfatal="0" previous_directory previous_directory_stack previous_directory_stack_length PYTHON_ABI quiet="0" separate_build_dirs="0" source_dir=
440 450
441 while (($#)); do 451 while (($#)); do
442 case "$1" in 452 case "$1" in
443 --action-message) 453 --action-message)
444 action_message_template="$2" 454 action_message_template="$2"
449 ;; 459 ;;
450 --failure-message) 460 --failure-message)
451 failure_message_template="$2" 461 failure_message_template="$2"
452 shift 462 shift
453 ;; 463 ;;
464 -f|--final-ABI)
465 final_ABI="1"
466 ;;
454 --nonfatal) 467 --nonfatal)
455 nonfatal="1" 468 nonfatal="1"
456 ;; 469 ;;
457 -q|--quiet) 470 -q|--quiet)
458 quiet="1" 471 quiet="1"
463 --source-dir) 476 --source-dir)
464 source_dir="$2" 477 source_dir="$2"
465 shift 478 shift
466 ;; 479 ;;
467 --) 480 --)
481 shift
468 break 482 break
469 ;; 483 ;;
470 -*) 484 -*)
471 die "${FUNCNAME}(): Unrecognized option '$1'" 485 die "${FUNCNAME}(): Unrecognized option '$1'"
472 ;; 486 ;;
480 if [[ -n "${source_dir}" && "${separate_build_dirs}" == 0 ]]; then 494 if [[ -n "${source_dir}" && "${separate_build_dirs}" == 0 ]]; then
481 die "${FUNCNAME}(): '--source-dir' option can be specified only with '--separate-build-dirs' option" 495 die "${FUNCNAME}(): '--source-dir' option can be specified only with '--separate-build-dirs' option"
482 fi 496 fi
483 497
484 if [[ "${default_function}" == "0" ]]; then 498 if [[ "${default_function}" == "0" ]]; then
485 if [[ "$#" -eq "0" ]]; then 499 if [[ "$#" -eq 0 ]]; then
486 die "${FUNCNAME}(): Missing function name" 500 die "${FUNCNAME}(): Missing function name"
487 fi 501 fi
488 function="$1" 502 function="$1"
489 shift 503 shift
490 504
491 if [[ -z "$(type -t "${function}")" ]]; then 505 if [[ -z "$(type -t "${function}")" ]]; then
492 die "${FUNCNAME}(): '${function}' function isn't defined" 506 die "${FUNCNAME}(): '${function}' function is not defined"
493 fi 507 fi
494 else 508 else
495 if [[ "$#" -ne "0" ]]; then
496 die "${FUNCNAME}(): '--default-function' option and function name cannot be specified simultaneously"
497 fi
498 if has "${EAPI:-0}" 0 1; then 509 if has "${EAPI:-0}" 0 1; then
499 die "${FUNCNAME}(): '--default-function' option cannot be used in this EAPI" 510 die "${FUNCNAME}(): '--default-function' option cannot be used in this EAPI"
500 fi 511 fi
501 512
502 if [[ "${EBUILD_PHASE}" == "configure" ]]; then 513 if [[ "${EBUILD_PHASE}" == "configure" ]]; then
503 if has "${EAPI}" 2 3; then 514 if has "${EAPI}" 2 3; then
504 python_default_function() { 515 python_default_function() {
505 econf 516 econf "$@"
506 } 517 }
507 else 518 else
508 python_default_function() { 519 python_default_function() {
509 nonfatal econf 520 nonfatal econf "$@"
510 } 521 }
511 fi 522 fi
512 elif [[ "${EBUILD_PHASE}" == "compile" ]]; then 523 elif [[ "${EBUILD_PHASE}" == "compile" ]]; then
513 python_default_function() { 524 python_default_function() {
514 emake 525 emake "$@"
515 } 526 }
516 elif [[ "${EBUILD_PHASE}" == "test" ]]; then 527 elif [[ "${EBUILD_PHASE}" == "test" ]]; then
517 python_default_function() { 528 python_default_function() {
518 if emake -j1 -n check &> /dev/null; then 529 if emake -j1 -n check &> /dev/null; then
519 emake -j1 check 530 emake -j1 check "$@"
520 elif emake -j1 -n test &> /dev/null; then 531 elif emake -j1 -n test &> /dev/null; then
521 emake -j1 test 532 emake -j1 test "$@"
522 fi 533 fi
523 } 534 }
524 elif [[ "${EBUILD_PHASE}" == "install" ]]; then 535 elif [[ "${EBUILD_PHASE}" == "install" ]]; then
525 python_default_function() { 536 python_default_function() {
526 emake DESTDIR="${D}" install 537 emake DESTDIR="${D}" install "$@"
527 } 538 }
528 else 539 else
529 die "${FUNCNAME}(): '--default-function' option cannot be used in this ebuild phase" 540 die "${FUNCNAME}(): '--default-function' option cannot be used in this ebuild phase"
530 fi 541 fi
531 function="python_default_function" 542 function="python_default_function"
532 fi 543 fi
544
545 # Ensure that python_execute_function() cannot be directly or indirectly called by python_execute_function().
546 for ((i = 1; i < "${#FUNCNAME[@]}"; i++)); do
547 if [[ "${FUNCNAME[${i}]}" == "${FUNCNAME}" ]]; then
548 die "${FUNCNAME}(): Invalid call stack"
549 fi
550 done
533 551
534 if [[ "${quiet}" == "0" ]]; then 552 if [[ "${quiet}" == "0" ]]; then
535 [[ "${EBUILD_PHASE}" == "setup" ]] && action="Setting up" 553 [[ "${EBUILD_PHASE}" == "setup" ]] && action="Setting up"
536 [[ "${EBUILD_PHASE}" == "unpack" ]] && action="Unpacking" 554 [[ "${EBUILD_PHASE}" == "unpack" ]] && action="Unpacking"
537 [[ "${EBUILD_PHASE}" == "prepare" ]] && action="Preparation" 555 [[ "${EBUILD_PHASE}" == "prepare" ]] && action="Preparation"
543 [[ "${EBUILD_PHASE}" == "postinst" ]] && action="Postinstallation" 561 [[ "${EBUILD_PHASE}" == "postinst" ]] && action="Postinstallation"
544 [[ "${EBUILD_PHASE}" == "prerm" ]] && action="Preuninstallation" 562 [[ "${EBUILD_PHASE}" == "prerm" ]] && action="Preuninstallation"
545 [[ "${EBUILD_PHASE}" == "postrm" ]] && action="Postuninstallation" 563 [[ "${EBUILD_PHASE}" == "postrm" ]] && action="Postuninstallation"
546 fi 564 fi
547 565
548 local RED GREEN BLUE NORMAL 566 validate_PYTHON_ABIS
549 if [[ "${NOCOLOR:-false}" =~ ^(false|no)$ ]]; then 567 if [[ "${final_ABI}" == "1" ]]; then
550 RED=$'\e[1;31m' 568 iterated_PYTHON_ABIS="$(PYTHON -f --ABI)"
551 GREEN=$'\e[1;32m'
552 BLUE=$'\e[1;34m'
553 NORMAL=$'\e[0m'
554 else 569 else
555 RED= 570 iterated_PYTHON_ABIS="${PYTHON_ABIS}"
556 GREEN=
557 BLUE=
558 NORMAL=
559 fi 571 fi
560
561 validate_PYTHON_ABIS
562 for PYTHON_ABI in ${PYTHON_ABIS}; do 572 for PYTHON_ABI in ${iterated_PYTHON_ABIS}; do
563 if [[ "${quiet}" == "0" ]]; then 573 if [[ "${quiet}" == "0" ]]; then
564 if [[ -n "${action_message_template}" ]]; then 574 if [[ -n "${action_message_template}" ]]; then
565 action_message="$(eval echo -n "${action_message_template}")" 575 action_message="$(eval echo -n "${action_message_template}")"
566 else 576 else
567 action_message="${action} of ${CATEGORY}/${PF} with Python ${PYTHON_ABI}..." 577 action_message="${action} of ${CATEGORY}/${PF} with $(python_get_implementation) $(python_get_version)..."
568 fi 578 fi
569 echo " ${GREEN}*${NORMAL} ${BLUE}${action_message}${NORMAL}" 579 echo " ${_GREEN}*${_NORMAL} ${_BLUE}${action_message}${_NORMAL}"
570 fi 580 fi
571 581
572 if [[ "${separate_build_dirs}" == "1" ]]; then 582 if [[ "${separate_build_dirs}" == "1" ]]; then
573 if [[ -n "${source_dir}" ]]; then 583 if [[ -n "${source_dir}" ]]; then
574 export BUILDDIR="${S}/${source_dir}-${PYTHON_ABI}" 584 export BUILDDIR="${S}/${source_dir}-${PYTHON_ABI}"
592 602
593 if [[ "$?" != "0" ]]; then 603 if [[ "$?" != "0" ]]; then
594 if [[ -n "${failure_message_template}" ]]; then 604 if [[ -n "${failure_message_template}" ]]; then
595 failure_message="$(eval echo -n "${failure_message_template}")" 605 failure_message="$(eval echo -n "${failure_message_template}")"
596 else 606 else
597 failure_message="${action} failed with Python ${PYTHON_ABI} in ${function}() function" 607 failure_message="${action} failed with $(python_get_implementation) $(python_get_version) in ${function}() function"
598 fi 608 fi
599 609
600 if [[ "${nonfatal}" == "1" ]]; then 610 if [[ "${nonfatal}" == "1" ]]; then
601 if [[ "${quiet}" == "0" ]]; then 611 if [[ "${quiet}" == "0" ]]; then
602 ewarn "${RED}${failure_message}${NORMAL}" 612 ewarn "${_RED}${failure_message}${_NORMAL}"
603 fi 613 fi
604 elif has "${PYTHON_ABI}" ${FAILURE_TOLERANT_PYTHON_ABIS}; then 614 elif [[ "${final_ABI}" == "0" ]] && has "${PYTHON_ABI}" ${FAILURE_TOLERANT_PYTHON_ABIS}; then
605 if [[ "${EBUILD_PHASE}" != "test" ]] || ! has test-fail-continue ${FEATURES}; then 615 if [[ "${EBUILD_PHASE}" != "test" ]] || ! has test-fail-continue ${FEATURES}; then
606 local enabled_PYTHON_ABIS= other_PYTHON_ABI 616 local enabled_PYTHON_ABIS= other_PYTHON_ABI
607 for other_PYTHON_ABI in ${PYTHON_ABIS}; do 617 for other_PYTHON_ABI in ${PYTHON_ABIS}; do
608 [[ "${other_PYTHON_ABI}" != "${PYTHON_ABI}" ]] && enabled_PYTHON_ABIS+="${enabled_PYTHON_ABIS:+ }${other_PYTHON_ABI}" 618 [[ "${other_PYTHON_ABI}" != "${PYTHON_ABI}" ]] && enabled_PYTHON_ABIS+="${enabled_PYTHON_ABIS:+ }${other_PYTHON_ABI}"
609 done 619 done
610 export PYTHON_ABIS="${enabled_PYTHON_ABIS}" 620 export PYTHON_ABIS="${enabled_PYTHON_ABIS}"
611 fi 621 fi
612 if [[ "${quiet}" == "0" ]]; then 622 if [[ "${quiet}" == "0" ]]; then
613 ewarn "${RED}${failure_message}${NORMAL}" 623 ewarn "${_RED}${failure_message}${_NORMAL}"
614 fi 624 fi
615 if [[ -z "${PYTHON_ABIS}" ]]; then 625 if [[ -z "${PYTHON_ABIS}" ]]; then
616 die "${function}() function failed with all enabled versions of Python" 626 die "${function}() function failed with all enabled Python ABIs"
617 fi 627 fi
618 else 628 else
619 die "${failure_message}" 629 die "${failure_message}"
620 fi 630 fi
621 fi 631 fi
622 632
623 # Ensure that directory stack hasn't been decreased. 633 # Ensure that directory stack has not been decreased.
624 if [[ "$(dirs -p | wc -l)" -lt "${previous_directory_stack_length}" ]]; then 634 if [[ "$(dirs -p | wc -l)" -lt "${previous_directory_stack_length}" ]]; then
625 die "Directory stack decreased illegally" 635 die "Directory stack decreased illegally"
626 fi 636 fi
627 637
628 # Avoid side effects of earlier returning from the specified function. 638 # Avoid side effects of earlier returning from the specified function.
629 while [[ "$(dirs -p | wc -l)" -gt "${previous_directory_stack_length}" ]]; do 639 while [[ "$(dirs -p | wc -l)" -gt "${previous_directory_stack_length}" ]]; do
630 popd > /dev/null || die "popd failed" 640 popd > /dev/null || die "popd failed"
631 done 641 done
632 642
633 # Ensure that the bottom part of directory stack hasn't been changed. Restore 643 # Ensure that the bottom part of directory stack has not been changed. Restore
634 # previous directory (from before running of the specified function) before 644 # previous directory (from before running of the specified function) before
635 # comparison of directory stacks to avoid mismatch of directory stacks after 645 # comparison of directory stacks to avoid mismatch of directory stacks after
636 # potential using of 'cd' to change current directory. Restoration of previous 646 # potential using of 'cd' to change current directory. Restoration of previous
637 # directory allows to safely use 'cd' to change current directory in the 647 # directory allows to safely use 'cd' to change current directory in the
638 # specified function without changing it back to original directory. 648 # specified function without changing it back to original directory.
650 if [[ "${default_function}" == "1" ]]; then 660 if [[ "${default_function}" == "1" ]]; then
651 unset -f python_default_function 661 unset -f python_default_function
652 fi 662 fi
653} 663}
654 664
655# @FUNCTION: python_convert_shebangs 665# @FUNCTION: python_copy_sources
656# @USAGE: [-q|--quiet] [-r|--recursive] [-x|--only-executables] [--] <Python_version> <file|directory> [files|directories] 666# @USAGE: <directory="${S}"> [directory]
657# @DESCRIPTION: 667# @DESCRIPTION:
658# Convert shebangs in specified files. Directories can be specified only with --recursive option. 668# Copy unpacked sources of current package to separate build directory for each Python ABI.
659python_convert_shebangs() { 669python_copy_sources() {
660 local argument file files=() only_executables="0" python_version quiet="0" recursive="0" 670 if ! _python_package_supporting_installation_for_multiple_python_abis; then
671 die "${FUNCNAME}() cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
672 fi
661 673
662 while (($#)); do 674 local dir dirs=() PYTHON_ABI
663 case "$1" in
664 -r|--recursive)
665 recursive="1"
666 ;;
667 -q|--quiet)
668 quiet="1"
669 ;;
670 -x|--only-executables)
671 only_executables="1"
672 ;;
673 --)
674 break
675 ;;
676 -*)
677 die "${FUNCNAME}(): Unrecognized option '$1'"
678 ;;
679 *)
680 break
681 ;;
682 esac
683 shift
684 done
685 675
686 if [[ "$#" -eq 0 ]]; then 676 if [[ "$#" -eq 0 ]]; then
687 die "${FUNCNAME}(): Missing Python version and files or directories" 677 if [[ "${WORKDIR}" == "${S}" ]]; then
688 elif [[ "$#" -eq 1 ]]; then 678 die "${FUNCNAME}() cannot be used"
689 die "${FUNCNAME}(): Missing files or directories"
690 fi
691
692 python_version="$1"
693 shift
694
695 for argument in "$@"; do
696 if [[ ! -e "${argument}" ]]; then
697 die "${FUNCNAME}(): '${argument}' doesn't exist"
698 elif [[ -f "${argument}" ]]; then
699 files+=("${argument}")
700 elif [[ -d "${argument}" ]]; then
701 if [[ "${recursive}" == "1" ]]; then
702 if [[ "${only_executables}" == "1" ]]; then
703 files+=($(find "${argument}" -perm /111 -type f))
704 else
705 files+=($(find "${argument}" -type f))
706 fi
707 else
708 die "${FUNCNAME}(): '${argument}' isn't a regular file"
709 fi 679 fi
680 dirs=("${S%/}")
710 else 681 else
711 die "${FUNCNAME}(): '${argument}' isn't a regular file or a directory" 682 dirs=("$@")
712 fi 683 fi
684
685 validate_PYTHON_ABIS
686 for PYTHON_ABI in ${PYTHON_ABIS}; do
687 for dir in "${dirs[@]}"; do
688 cp -pr "${dir}" "${dir}-${PYTHON_ABI}" > /dev/null || die "Copying of sources failed"
713 done 689 done
714
715 for file in "${files[@]}"; do
716 file="${file#./}"
717 [[ "${only_executables}" == "1" && ! -x "${file}" ]] && continue
718
719 if [[ "$(head -n1 "${file}")" =~ ^'#!'.*python ]]; then
720 if [[ "${quiet}" == "0" ]]; then
721 einfo "Converting shebang in '${file}'"
722 fi
723 sed -e "1s/python\([[:digit:]]\+\(\.[[:digit:]]\+\)\?\)\?/python${python_version}/" -i "${file}" || die "Conversion of shebang in '${file}' failed"
724
725 # Delete potential whitespace after "#!".
726 sed -e '1s/\(^#!\)[[:space:]]*/\1/' -i "${file}" || die "sed '${file}' failed"
727 fi
728 done 690 done
729} 691}
730 692
731# @FUNCTION: python_generate_wrapper_scripts 693# @FUNCTION: python_generate_wrapper_scripts
732# @USAGE: [-E|--respect-EPYTHON] [-f|--force] [-q|--quiet] [--] <file> [files] 694# @USAGE: [-E|--respect-EPYTHON] [-f|--force] [-q|--quiet] [--] <file> [files]
733# @DESCRIPTION: 695# @DESCRIPTION:
734# Generate wrapper scripts. Existing files are overwritten only with --force option. 696# Generate wrapper scripts. Existing files are overwritten only with --force option.
735# If --respect-EPYTHON option is specified, then generated wrapper scripts will 697# If --respect-EPYTHON option is specified, then generated wrapper scripts will
736# respect EPYTHON variable at run time. 698# respect EPYTHON variable at run time.
737python_generate_wrapper_scripts() { 699python_generate_wrapper_scripts() {
700 if ! _python_package_supporting_installation_for_multiple_python_abis; then
701 die "${FUNCNAME}() cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
702 fi
703
704 _python_initialize_prefix_variables
705
738 local eselect_python_option file force="0" quiet="0" PYTHON_ABI python2_enabled="0" python2_supported_versions python3_enabled="0" python3_supported_versions respect_EPYTHON="0" 706 local eselect_python_option file force="0" quiet="0" PYTHON_ABI python2_enabled="0" python3_enabled="0" respect_EPYTHON="0"
739 python2_supported_versions="2.4 2.5 2.6 2.7"
740 python3_supported_versions="3.0 3.1 3.2"
741 707
742 while (($#)); do 708 while (($#)); do
743 case "$1" in 709 case "$1" in
744 -E|--respect-EPYTHON) 710 -E|--respect-EPYTHON)
745 respect_EPYTHON="1" 711 respect_EPYTHON="1"
749 ;; 715 ;;
750 -q|--quiet) 716 -q|--quiet)
751 quiet="1" 717 quiet="1"
752 ;; 718 ;;
753 --) 719 --)
720 shift
754 break 721 break
755 ;; 722 ;;
756 -*) 723 -*)
757 die "${FUNCNAME}(): Unrecognized option '$1'" 724 die "${FUNCNAME}(): Unrecognized option '$1'"
758 ;; 725 ;;
766 if [[ "$#" -eq 0 ]]; then 733 if [[ "$#" -eq 0 ]]; then
767 die "${FUNCNAME}(): Missing arguments" 734 die "${FUNCNAME}(): Missing arguments"
768 fi 735 fi
769 736
770 validate_PYTHON_ABIS 737 validate_PYTHON_ABIS
771 for PYTHON_ABI in ${python2_supported_versions}; do 738 for PYTHON_ABI in "${_CPYTHON2_SUPPORTED_ABIS[@]}"; do
772 if has "${PYTHON_ABI}" ${PYTHON_ABIS}; then 739 if has "${PYTHON_ABI}" ${PYTHON_ABIS}; then
773 python2_enabled="1" 740 python2_enabled="1"
774 fi 741 fi
775 done 742 done
776 for PYTHON_ABI in ${python3_supported_versions}; do 743 for PYTHON_ABI in "${_CPYTHON3_SUPPORTED_ABIS[@]}"; do
777 if has "${PYTHON_ABI}" ${PYTHON_ABIS}; then 744 if has "${PYTHON_ABI}" ${PYTHON_ABIS}; then
778 python3_enabled="1" 745 python3_enabled="1"
779 fi 746 fi
780 done 747 done
781 748
793 if [[ -f "${file}" && "${force}" == "0" ]]; then 760 if [[ -f "${file}" && "${force}" == "0" ]]; then
794 die "${FUNCNAME}(): '$1' already exists" 761 die "${FUNCNAME}(): '$1' already exists"
795 fi 762 fi
796 763
797 if [[ "${quiet}" == "0" ]]; then 764 if [[ "${quiet}" == "0" ]]; then
798 einfo "Generating '${file#${D%/}}' wrapper script" 765 einfo "Generating '${file#${ED%/}}' wrapper script"
799 fi 766 fi
800 767
801 cat << EOF > "${file}" 768 cat << EOF > "${file}"
802#!/usr/bin/env python 769#!/usr/bin/env python
803# Gentoo '${file##*/}' wrapper script 770# Gentoo '${file##*/}' wrapper script generated by python_generate_wrapper_scripts()
804 771
805import os 772import os
806import re 773import re
807import subprocess 774import subprocess
808import sys 775import sys
809 776
810EPYTHON_re = re.compile(r"^python(\d+\.\d+)$") 777EPYTHON_re = re.compile(r"^python(\d+\.\d+)$")
778python_shebang_re = re.compile(r"^#! *(${EPREFIX}/usr/bin/python|(${EPREFIX})?/usr/bin/env +(${EPREFIX}/usr/bin/)?python)")
779python_verification_output_re = re.compile("^GENTOO_PYTHON_TARGET_SCRIPT_PATH supported\n$")
811 780
812EOF 781EOF
813 if [[ "$?" != "0" ]]; then 782 if [[ "$?" != "0" ]]; then
814 die "${FUNCNAME}(): Generation of '$1' failed" 783 die "${FUNCNAME}(): Generation of '$1' failed"
815 fi 784 fi
823 else: 792 else:
824 sys.stderr.write("EPYTHON variable has unrecognized value '%s'\n" % EPYTHON) 793 sys.stderr.write("EPYTHON variable has unrecognized value '%s'\n" % EPYTHON)
825 sys.exit(1) 794 sys.exit(1)
826else: 795else:
827 try: 796 try:
828 eselect_process = subprocess.Popen(["/usr/bin/eselect", "python", "show"${eselect_python_option:+, $(echo "\"")}${eselect_python_option}${eselect_python_option:+$(echo "\"")}], stdout=subprocess.PIPE) 797 eselect_process = subprocess.Popen(["${EPREFIX}/usr/bin/eselect", "python", "show"${eselect_python_option:+, $(echo "\"")}${eselect_python_option}${eselect_python_option:+$(echo "\"")}], stdout=subprocess.PIPE)
829 if eselect_process.wait() != 0: 798 if eselect_process.wait() != 0:
830 raise ValueError 799 raise ValueError
831 except (OSError, ValueError): 800 except (OSError, ValueError):
832 sys.stderr.write("Execution of 'eselect python show${eselect_python_option:+ }${eselect_python_option}' failed\n") 801 sys.stderr.write("Execution of 'eselect python show${eselect_python_option:+ }${eselect_python_option}' failed\n")
833 sys.exit(1) 802 sys.exit(1)
834 803
835 eselect_output = eselect_process.stdout.read() 804 EPYTHON = eselect_process.stdout.read()
836 if not isinstance(eselect_output, str): 805 if not isinstance(EPYTHON, str):
837 # Python 3 806 # Python 3
838 eselect_output = eselect_output.decode() 807 EPYTHON = EPYTHON.decode()
808 EPYTHON = EPYTHON.rstrip("\n")
839 809
840 EPYTHON_matched = EPYTHON_re.match(eselect_output) 810 EPYTHON_matched = EPYTHON_re.match(EPYTHON)
841 if EPYTHON_matched: 811 if EPYTHON_matched:
842 PYTHON_ABI = EPYTHON_matched.group(1) 812 PYTHON_ABI = EPYTHON_matched.group(1)
843 else: 813 else:
844 sys.stderr.write("'eselect python show${eselect_python_option:+ }${eselect_python_option}' printed unrecognized value '%s" % eselect_output) 814 sys.stderr.write("'eselect python show${eselect_python_option:+ }${eselect_python_option}' printed unrecognized value '%s'\n" % EPYTHON)
845 sys.exit(1) 815 sys.exit(1)
846EOF 816EOF
847 if [[ "$?" != "0" ]]; then 817 if [[ "$?" != "0" ]]; then
848 die "${FUNCNAME}(): Generation of '$1' failed" 818 die "${FUNCNAME}(): Generation of '$1' failed"
849 fi 819 fi
850 else 820 else
851 cat << EOF >> "${file}" 821 cat << EOF >> "${file}"
852try: 822try:
853 eselect_process = subprocess.Popen(["/usr/bin/eselect", "python", "show"${eselect_python_option:+, $(echo "\"")}${eselect_python_option}${eselect_python_option:+$(echo "\"")}], stdout=subprocess.PIPE) 823 eselect_process = subprocess.Popen(["${EPREFIX}/usr/bin/eselect", "python", "show"${eselect_python_option:+, $(echo "\"")}${eselect_python_option}${eselect_python_option:+$(echo "\"")}], stdout=subprocess.PIPE)
854 if eselect_process.wait() != 0: 824 if eselect_process.wait() != 0:
855 raise ValueError 825 raise ValueError
856except (OSError, ValueError): 826except (OSError, ValueError):
857 sys.stderr.write("Execution of 'eselect python show${eselect_python_option:+ }${eselect_python_option}' failed\n") 827 sys.stderr.write("Execution of 'eselect python show${eselect_python_option:+ }${eselect_python_option}' failed\n")
858 sys.exit(1) 828 sys.exit(1)
859 829
860eselect_output = eselect_process.stdout.read() 830EPYTHON = eselect_process.stdout.read()
861if not isinstance(eselect_output, str): 831if not isinstance(EPYTHON, str):
862 # Python 3 832 # Python 3
863 eselect_output = eselect_output.decode() 833 EPYTHON = EPYTHON.decode()
834EPYTHON = EPYTHON.rstrip("\n")
864 835
865EPYTHON_matched = EPYTHON_re.match(eselect_output) 836EPYTHON_matched = EPYTHON_re.match(EPYTHON)
866if EPYTHON_matched: 837if EPYTHON_matched:
867 PYTHON_ABI = EPYTHON_matched.group(1) 838 PYTHON_ABI = EPYTHON_matched.group(1)
868else: 839else:
869 sys.stderr.write("'eselect python show${eselect_python_option:+ }${eselect_python_option}' printed unrecognized value '%s" % eselect_output) 840 sys.stderr.write("'eselect python show${eselect_python_option:+ }${eselect_python_option}' printed unrecognized value '%s'\n" % EPYTHON)
870 sys.exit(1) 841 sys.exit(1)
871EOF 842EOF
872 if [[ "$?" != "0" ]]; then 843 if [[ "$?" != "0" ]]; then
873 die "${FUNCNAME}(): Generation of '$1' failed" 844 die "${FUNCNAME}(): Generation of '$1' failed"
874 fi 845 fi
875 fi 846 fi
876 cat << EOF >> "${file}" 847 cat << EOF >> "${file}"
877 848
878target_executable = "%s-%s" % (sys.argv[0], PYTHON_ABI) 849wrapper_script_path = os.path.realpath(sys.argv[0])
850target_executable_path = "%s-%s" % (wrapper_script_path, PYTHON_ABI)
851os.environ["GENTOO_PYTHON_WRAPPER_SCRIPT_PATH"] = sys.argv[0]
852os.environ["GENTOO_PYTHON_TARGET_SCRIPT_PATH"] = target_executable_path
879if not os.path.exists(target_executable): 853if not os.path.exists(target_executable_path):
880 sys.stderr.write("'%s' does not exist\n" % target_executable) 854 sys.stderr.write("'%s' does not exist\n" % target_executable_path)
881 sys.exit(1) 855 sys.exit(1)
882 856
857target_executable = open(target_executable_path, "rb")
858target_executable_first_line = target_executable.readline()
859if not isinstance(target_executable_first_line, str):
860 # Python 3
861 target_executable_first_line = target_executable_first_line.decode("utf_8", "replace")
862
863python_shebang_matched = python_shebang_re.match(target_executable_first_line)
864target_executable.close()
865
866if python_shebang_matched:
867 try:
868 python_interpreter_path = "${EPREFIX}/usr/bin/%s" % EPYTHON
869 os.environ["GENTOO_PYTHON_TARGET_SCRIPT_PATH_VERIFICATION"] = "1"
870 python_verification_process = subprocess.Popen([python_interpreter_path, "-c", "pass"], stdout=subprocess.PIPE)
871 del os.environ["GENTOO_PYTHON_TARGET_SCRIPT_PATH_VERIFICATION"]
872 if python_verification_process.wait() != 0:
873 raise ValueError
874
875 python_verification_output = python_verification_process.stdout.read()
876 if not isinstance(python_verification_output, str):
877 # Python 3
878 python_verification_output = python_verification_output.decode()
879
880 if not python_verification_output_re.match(python_verification_output):
881 raise ValueError
882
883 os.execv(python_interpreter_path, [python_interpreter_path] + sys.argv)
884 except:
885 pass
886 if "GENTOO_PYTHON_TARGET_SCRIPT_PATH_VERIFICATION" in os.environ:
887 del os.environ["GENTOO_PYTHON_TARGET_SCRIPT_PATH_VERIFICATION"]
888
883os.execv(target_executable, sys.argv) 889os.execv(target_executable_path, sys.argv)
884EOF 890EOF
885 if [[ "$?" != "0" ]]; then 891 if [[ "$?" != "0" ]]; then
886 die "${FUNCNAME}(): Generation of '$1' failed" 892 die "${FUNCNAME}(): Generation of '$1' failed"
887 fi 893 fi
888 fperms +x "${file#${D%/}}" || die "fperms '${file}' failed" 894 fperms +x "${file#${ED%/}}" || die "fperms '${file}' failed"
889 done 895 done
890} 896}
891 897
892# @ECLASS-VARIABLE: PYTHON_USE_WITH 898# ================================================================================================
893# @DESCRIPTION: 899# ========= FUNCTIONS FOR PACKAGES NOT SUPPORTING INSTALLATION FOR MULTIPLE PYTHON ABIS ==========
894# Set this to a space separated list of use flags 900# ================================================================================================
895# the python slot in use must be built with.
896 901
897# @ECLASS-VARIABLE: PYTHON_USE_WITH_OR 902# @FUNCTION: python_set_active_version
903# @USAGE: <CPython_ABI|2|3>
898# @DESCRIPTION: 904# @DESCRIPTION:
899# Set this to a space separated list of use flags 905# Set specified version of CPython as active version of Python.
900# of which one must be turned on for the slot of 906python_set_active_version() {
901# in use. 907 if _python_package_supporting_installation_for_multiple_python_abis; then
908 die "${FUNCNAME}() cannot be used in ebuilds of packages supporting installation for multiple Python ABIs"
909 fi
902 910
903# @ECLASS-VARIABLE: PYTHON_USE_WITH_OPT 911 if [[ "$#" -ne 1 ]]; then
904# @DESCRIPTION: 912 die "${FUNCNAME}() requires 1 argument"
905# Set this if you need to make either PYTHON_USE_WITH or 913 fi
906# PYTHON_USE_WITH_OR atoms conditional under a use flag.
907 914
915 _python_initial_sanity_checks
916
917 if [[ "$1" =~ ^[[:digit:]]+\.[[:digit:]]+$ ]]; then
918 if ! _python_implementation && ! has_version "dev-lang/python:$1"; then
919 die "${FUNCNAME}(): 'dev-lang/python:$1' is not installed"
920 fi
921 export EPYTHON="$(PYTHON "$1")"
922 elif [[ "$1" == "2" ]]; then
923 if ! _python_implementation && ! has_version "=dev-lang/python-2*"; then
924 die "${FUNCNAME}(): '=dev-lang/python-2*' is not installed"
925 fi
926 export EPYTHON="$(PYTHON -2)"
927 elif [[ "$1" == "3" ]]; then
928 if ! _python_implementation && ! has_version "=dev-lang/python-3*"; then
929 die "${FUNCNAME}(): '=dev-lang/python-3*' is not installed"
930 fi
931 export EPYTHON="$(PYTHON -3)"
932 else
933 die "${FUNCNAME}(): Unrecognized argument '$1'"
934 fi
935
936 # PYTHON_ABI variable is intended to be used only in ebuilds/eclasses,
937 # so it does not need to be exported to subprocesses.
938 PYTHON_ABI="${EPYTHON#python}"
939 PYTHON_ABI="${PYTHON_ABI%%-*}"
940
941 _python_final_sanity_checks
942
943 # python-updater checks PYTHON_REQUESTED_ACTIVE_VERSION variable.
944 PYTHON_REQUESTED_ACTIVE_VERSION="$1"
945}
946
908# @FUNCTION: python_pkg_setup 947# @FUNCTION: python_need_rebuild
909# @DESCRIPTION: 948# @DESCRIPTION: Mark current package for rebuilding by python-updater after
910# Makes sure PYTHON_USE_WITH or PYTHON_USE_WITH_OR listed use flags 949# switching of active version of Python.
911# are respected. Only exported if one of those variables is set. 950python_need_rebuild() {
912if ! has "${EAPI:-0}" 0 1 && [[ -n ${PYTHON_USE_WITH} || -n ${PYTHON_USE_WITH_OR} ]]; then 951 if _python_package_supporting_installation_for_multiple_python_abis; then
913 python_pkg_setup() { 952 die "${FUNCNAME}() cannot be used in ebuilds of packages supporting installation for multiple Python ABIs"
914 python_pkg_setup_fail() { 953 fi
915 eerror "${1}"
916 die "${1}"
917 }
918 954
919 [[ ${PYTHON_USE_WITH_OPT} ]] && use !${PYTHON_USE_WITH_OPT} && return 955 export PYTHON_NEED_REBUILD="$(PYTHON --ABI)"
956}
920 957
921 python_pkg_setup_check_USE_flags() { 958# ================================================================================================
922 local pyatom use 959# ======================================= GETTER FUNCTIONS =======================================
960# ================================================================================================
961
962_PYTHON_ABI_EXTRACTION_COMMAND='import platform
963import sys
964sys.stdout.write(".".join(str(x) for x in sys.version_info[:2]))
965if platform.system()[:4] == "Java":
966 sys.stdout.write("-jython")'
967
968_python_get_implementation() {
969 if [[ "$#" -ne 1 ]]; then
970 die "${FUNCNAME}() requires 1 argument"
971 fi
972
973 if [[ "$1" =~ ^[[:digit:]]+\.[[:digit:]]+$ ]]; then
974 echo "CPython"
975 elif [[ "$1" =~ ^[[:digit:]]+\.[[:digit:]]+-jython$ ]]; then
976 echo "Jython"
977 else
978 die "${FUNCNAME}(): Unrecognized Python ABI '$1'"
979 fi
980}
981
982# @FUNCTION: PYTHON
983# @USAGE: [-2] [-3] [--ABI] [-a|--absolute-path] [-f|--final-ABI] [--] <Python_ABI="${PYTHON_ABI}">
984# @DESCRIPTION:
985# Print filename of Python interpreter for specified Python ABI. If Python_ABI argument
986# is ommitted, then PYTHON_ABI environment variable must be set and is used.
987# If -2 option is specified, then active version of Python 2 is used.
988# If -3 option is specified, then active version of Python 3 is used.
989# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
990# -2, -3 and --final-ABI options and Python_ABI argument cannot be specified simultaneously.
991# If --ABI option is specified, then only specified Python ABI is printed instead of
992# filename of Python interpreter.
993# If --absolute-path option is specified, then absolute path to Python interpreter is printed.
994# --ABI and --absolute-path options cannot be specified simultaneously.
995PYTHON() {
996 local ABI_output="0" absolute_path_output="0" final_ABI="0" PYTHON_ABI="${PYTHON_ABI}" python_interpreter python2="0" python3="0"
997
998 while (($#)); do
999 case "$1" in
1000 -2)
1001 python2="1"
1002 ;;
1003 -3)
1004 python3="1"
1005 ;;
1006 --ABI)
1007 ABI_output="1"
1008 ;;
1009 -a|--absolute-path)
1010 absolute_path_output="1"
1011 ;;
1012 -f|--final-ABI)
1013 final_ABI="1"
1014 ;;
1015 --)
1016 shift
1017 break
1018 ;;
1019 -*)
1020 die "${FUNCNAME}(): Unrecognized option '$1'"
1021 ;;
1022 *)
1023 break
1024 ;;
1025 esac
1026 shift
1027 done
1028
1029 if [[ "${ABI_output}" == "1" && "${absolute_path_output}" == "1" ]]; then
1030 die "${FUNCNAME}(): '--ABI and '--absolute-path' options cannot be specified simultaneously"
1031 fi
1032
1033 if [[ "$((${python2} + ${python3} + ${final_ABI}))" -gt 1 ]]; then
1034 die "${FUNCNAME}(): '-2', '-3' or '--final-ABI' options cannot be specified simultaneously"
1035 fi
1036
1037 if [[ "$#" -eq 0 ]]; then
1038 if [[ "${final_ABI}" == "1" ]]; then
1039 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1040 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1041 fi
1042 validate_PYTHON_ABIS
1043 PYTHON_ABI="${PYTHON_ABIS##* }"
1044 elif [[ "${python2}" == "1" ]]; then
1045 PYTHON_ABI="$(eselect python show --python2 --ABI)"
923 if [[ -n "${PYTHON_ABI}" ]]; then 1046 if [[ -z "${PYTHON_ABI}" ]]; then
1047 die "${FUNCNAME}(): Active Python 2 interpreter not set"
1048 elif [[ "${PYTHON_ABI}" != "2."* ]]; then
1049 die "${FUNCNAME}(): Internal error in \`eselect python show --python2\`"
1050 fi
1051 elif [[ "${python3}" == "1" ]]; then
1052 PYTHON_ABI="$(eselect python show --python3 --ABI)"
1053 if [[ -z "${PYTHON_ABI}" ]]; then
1054 die "${FUNCNAME}(): Active Python 3 interpreter not set"
1055 elif [[ "${PYTHON_ABI}" != "3."* ]]; then
1056 die "${FUNCNAME}(): Internal error in \`eselect python show --python3\`"
1057 fi
1058 elif ! _python_package_supporting_installation_for_multiple_python_abis; then
1059 PYTHON_ABI="$("${EPREFIX}/usr/bin/python" -c "${_PYTHON_ABI_EXTRACTION_COMMAND}")"
1060 elif [[ -z "${PYTHON_ABI}" ]]; then
1061 die "${FUNCNAME}(): Invalid usage: ${FUNCNAME}() should be used in ABI-specific local scope"
1062 fi
1063 elif [[ "$#" -eq 1 ]]; then
1064 if [[ "${final_ABI}" == "1" ]]; then
1065 die "${FUNCNAME}(): '--final-ABI' option and Python ABI cannot be specified simultaneously"
1066 fi
1067 if [[ "${python2}" == "1" ]]; then
1068 die "${FUNCNAME}(): '-2' option and Python ABI cannot be specified simultaneously"
1069 fi
1070 if [[ "${python3}" == "1" ]]; then
1071 die "${FUNCNAME}(): '-3' option and Python ABI cannot be specified simultaneously"
1072 fi
1073 PYTHON_ABI="$1"
1074 else
1075 die "${FUNCNAME}(): Invalid usage"
1076 fi
1077
1078 if [[ "${ABI_output}" == "1" ]]; then
1079 echo -n "${PYTHON_ABI}"
1080 return
1081 else
1082 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "CPython" ]]; then
1083 python_interpreter="python${PYTHON_ABI}"
1084 elif [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "Jython" ]]; then
1085 python_interpreter="jython-${PYTHON_ABI%-jython}"
1086 fi
1087
1088 if [[ "${absolute_path_output}" == "1" ]]; then
1089 echo -n "${EPREFIX}/usr/bin/${python_interpreter}"
1090 else
1091 echo -n "${python_interpreter}"
1092 fi
1093 fi
1094
1095 if [[ -n "${ABI}" && "${ABI}" != "${DEFAULT_ABI}" && "${DEFAULT_ABI}" != "default" ]]; then
1096 echo -n "-${ABI}"
1097 fi
1098}
1099
1100# @FUNCTION: python_get_implementation
1101# @USAGE: [-f|--final-ABI]
1102# @DESCRIPTION:
1103# Print name of Python implementation.
1104# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1105python_get_implementation() {
1106 local final_ABI="0" PYTHON_ABI="${PYTHON_ABI}"
1107
1108 while (($#)); do
1109 case "$1" in
1110 -f|--final-ABI)
1111 final_ABI="1"
1112 ;;
1113 -*)
1114 die "${FUNCNAME}(): Unrecognized option '$1'"
1115 ;;
1116 *)
1117 die "${FUNCNAME}(): Invalid usage"
1118 ;;
1119 esac
1120 shift
1121 done
1122
1123 if [[ "${final_ABI}" == "1" ]]; then
1124 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1125 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1126 fi
1127 PYTHON_ABI="$(PYTHON -f --ABI)"
1128 elif [[ -z "${PYTHON_ABI}" ]]; then
1129 PYTHON_ABI="$(PYTHON --ABI)"
1130 fi
1131
1132 echo "$(_python_get_implementation "${PYTHON_ABI}")"
1133}
1134
1135# @FUNCTION: python_get_implementational_package
1136# @USAGE: [-f|--final-ABI]
1137# @DESCRIPTION:
1138# Print category, name and slot of package providing Python implementation.
1139# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1140python_get_implementational_package() {
1141 local final_ABI="0" PYTHON_ABI="${PYTHON_ABI}"
1142
1143 while (($#)); do
1144 case "$1" in
1145 -f|--final-ABI)
1146 final_ABI="1"
1147 ;;
1148 -*)
1149 die "${FUNCNAME}(): Unrecognized option '$1'"
1150 ;;
1151 *)
1152 die "${FUNCNAME}(): Invalid usage"
1153 ;;
1154 esac
1155 shift
1156 done
1157
1158 if [[ "${final_ABI}" == "1" ]]; then
1159 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1160 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1161 fi
1162 PYTHON_ABI="$(PYTHON -f --ABI)"
1163 elif [[ -z "${PYTHON_ABI}" ]]; then
1164 PYTHON_ABI="$(PYTHON --ABI)"
1165 fi
1166
1167 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "CPython" ]]; then
924 pyatom="dev-lang/python:${PYTHON_ABI}" 1168 echo "dev-lang/python:${PYTHON_ABI}"
1169 elif [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "Jython" ]]; then
1170 echo "dev-java/jython:${PYTHON_ABI%-jython}"
1171 fi
1172}
1173
1174# @FUNCTION: python_get_includedir
1175# @USAGE: [-f|--final-ABI]
1176# @DESCRIPTION:
1177# Print path to Python include directory.
1178# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1179python_get_includedir() {
1180 local final_ABI="0" PYTHON_ABI="${PYTHON_ABI}"
1181
1182 while (($#)); do
1183 case "$1" in
1184 -f|--final-ABI)
1185 final_ABI="1"
1186 ;;
1187 -*)
1188 die "${FUNCNAME}(): Unrecognized option '$1'"
1189 ;;
1190 *)
1191 die "${FUNCNAME}(): Invalid usage"
1192 ;;
1193 esac
1194 shift
1195 done
1196
1197 if [[ "${final_ABI}" == "1" ]]; then
1198 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1199 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1200 fi
1201 PYTHON_ABI="$(PYTHON -f --ABI)"
1202 elif [[ -z "${PYTHON_ABI}" ]]; then
1203 PYTHON_ABI="$(PYTHON --ABI)"
1204 fi
1205
1206 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "CPython" ]]; then
1207 echo "/usr/include/python${PYTHON_ABI}"
1208 elif [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "Jython" ]]; then
1209 echo "/usr/share/jython-${PYTHON_ABI%-jython}/Include"
1210 fi
1211}
1212
1213# @FUNCTION: python_get_libdir
1214# @USAGE: [-f|--final-ABI]
1215# @DESCRIPTION:
1216# Print path to Python library directory.
1217# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1218python_get_libdir() {
1219 local final_ABI="0" PYTHON_ABI="${PYTHON_ABI}"
1220
1221 while (($#)); do
1222 case "$1" in
1223 -f|--final-ABI)
1224 final_ABI="1"
1225 ;;
1226 -*)
1227 die "${FUNCNAME}(): Unrecognized option '$1'"
1228 ;;
1229 *)
1230 die "${FUNCNAME}(): Invalid usage"
1231 ;;
1232 esac
1233 shift
1234 done
1235
1236 if [[ "${final_ABI}" == "1" ]]; then
1237 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1238 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1239 fi
1240 PYTHON_ABI="$(PYTHON -f --ABI)"
1241 elif [[ -z "${PYTHON_ABI}" ]]; then
1242 PYTHON_ABI="$(PYTHON --ABI)"
1243 fi
1244
1245 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "CPython" ]]; then
1246 echo "/usr/$(get_libdir)/python${PYTHON_ABI}"
1247 elif [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "Jython" ]]; then
1248 echo "/usr/share/jython-${PYTHON_ABI%-jython}/Lib"
1249 fi
1250}
1251
1252# @FUNCTION: python_get_sitedir
1253# @USAGE: [-f|--final-ABI]
1254# @DESCRIPTION:
1255# Print path to Python site-packages directory.
1256# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1257python_get_sitedir() {
1258 local options=()
1259
1260 while (($#)); do
1261 case "$1" in
1262 -f|--final-ABI)
1263 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1264 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1265 fi
1266 options+=("$1")
1267 ;;
1268 -*)
1269 die "${FUNCNAME}(): Unrecognized option '$1'"
1270 ;;
1271 *)
1272 die "${FUNCNAME}(): Invalid usage"
1273 ;;
1274 esac
1275 shift
1276 done
1277
1278 echo "$(python_get_libdir "${options[@]}")/site-packages"
1279}
1280
1281# @FUNCTION: python_get_library
1282# @USAGE: [-f|--final-ABI] [-l|--linker-option]
1283# @DESCRIPTION:
1284# Print path to Python library.
1285# If --linker-option is specified, then "-l${library}" linker option is printed.
1286# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1287python_get_library() {
1288 local final_ABI="0" linker_option="0" PYTHON_ABI="${PYTHON_ABI}"
1289
1290 while (($#)); do
1291 case "$1" in
1292 -f|--final-ABI)
1293 final_ABI="1"
1294 ;;
1295 -l|--linker-option)
1296 linker_option="1"
1297 ;;
1298 -*)
1299 die "${FUNCNAME}(): Unrecognized option '$1'"
1300 ;;
1301 *)
1302 die "${FUNCNAME}(): Invalid usage"
1303 ;;
1304 esac
1305 shift
1306 done
1307
1308 if [[ "${final_ABI}" == "1" ]]; then
1309 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1310 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1311 fi
1312 PYTHON_ABI="$(PYTHON -f --ABI)"
1313 elif [[ -z "${PYTHON_ABI}" ]]; then
1314 PYTHON_ABI="$(PYTHON --ABI)"
1315 fi
1316
1317 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "CPython" ]]; then
1318 if [[ "${linker_option}" == "1" ]]; then
1319 echo "-lpython${PYTHON_ABI}"
1320 else
1321 echo "/usr/$(get_libdir)/libpython${PYTHON_ABI}$(get_libname)"
1322 fi
1323 elif [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "Jython" ]]; then
1324 die "${FUNCNAME}(): Jython does not have shared library"
1325 fi
1326}
1327
1328# @FUNCTION: python_get_version
1329# @USAGE: [-f|--final-ABI] [--full] [--major] [--minor] [--micro]
1330# @DESCRIPTION:
1331# Print Python version.
1332# --full, --major, --minor and --micro options cannot be specified simultaneously.
1333# If --full, --major, --minor and --micro options are not specified, then "${major_version}.${minor_version}" is printed.
1334# If --final-ABI option is specified, then final ABI from the list of enabled ABIs is used.
1335python_get_version() {
1336 local final_ABI="0" full="0" major="0" minor="0" micro="0" python_command
1337
1338 while (($#)); do
1339 case "$1" in
1340 -f|--final-ABI)
1341 final_ABI="1"
1342 ;;
1343 --full)
1344 full="1"
1345 ;;
1346 --major)
1347 major="1"
1348 ;;
1349 --minor)
1350 minor="1"
1351 ;;
1352 --micro)
1353 micro="1"
1354 ;;
1355 -*)
1356 die "${FUNCNAME}(): Unrecognized option '$1'"
1357 ;;
1358 *)
1359 die "${FUNCNAME}(): Invalid usage"
1360 ;;
1361 esac
1362 shift
1363 done
1364
1365 if [[ "$((${full} + ${major} + ${minor} + ${micro}))" -gt 1 ]]; then
1366 die "${FUNCNAME}(): '--full', '--major', '--minor' or '--micro' options cannot be specified simultaneously"
1367 fi
1368
1369 if [[ "${full}" == "1" ]]; then
1370 python_command="from sys import version_info; print('.'.join(str(x) for x in version_info[:3]))"
1371 elif [[ "${major}" == "1" ]]; then
1372 python_command="from sys import version_info; print(version_info[0])"
1373 elif [[ "${minor}" == "1" ]]; then
1374 python_command="from sys import version_info; print(version_info[1])"
1375 elif [[ "${micro}" == "1" ]]; then
1376 python_command="from sys import version_info; print(version_info[2])"
1377 else
1378 if [[ -n "${PYTHON_ABI}" && "${final_ABI}" == "0" ]]; then
1379 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "CPython" ]]; then
1380 echo "${PYTHON_ABI}"
1381 elif [[ "$(_python_get_implementation "${PYTHON_ABI}")" == "Jython" ]]; then
1382 echo "${PYTHON_ABI%-jython}"
1383 fi
1384 return
1385 fi
1386 python_command="from sys import version_info; print('.'.join(str(x) for x in version_info[:2]))"
1387 fi
1388
1389 if [[ "${final_ABI}" == "1" ]]; then
1390 if ! _python_package_supporting_installation_for_multiple_python_abis; then
1391 die "${FUNCNAME}(): '--final-ABI' option cannot be used in ebuilds of packages not supporting installation for multiple Python ABIs"
1392 fi
1393 "$(PYTHON -f)" -c "${python_command}"
1394 else
1395 "$(PYTHON ${PYTHON_ABI})" -c "${python_command}"
1396 fi
1397}
1398
1399# ================================================================================================
1400# =================================== MISCELLANEOUS FUNCTIONS ====================================
1401# ================================================================================================
1402
1403_python_implementation() {
1404 if [[ "${CATEGORY}/${PN}" == "dev-lang/python" ]]; then
1405 return 0
1406 elif [[ "${CATEGORY}/${PN}" == "dev-java/jython" ]]; then
1407 return 0
1408 else
1409 return 1
1410 fi
1411}
1412
1413_python_package_supporting_installation_for_multiple_python_abis() {
1414 if [[ "${EBUILD_PHASE}" == "depend" ]]; then
1415 die "${FUNCNAME}() cannot be used in global scope"
1416 fi
1417
1418 if has "${EAPI:-0}" 0 1 2 3 4; then
1419 if [[ -n "${SUPPORT_PYTHON_ABIS}" ]]; then
1420 return 0
1421 else
1422 return 1
1423 fi
1424 else
1425 die "${FUNCNAME}(): Support for EAPI=\"${EAPI}\" not implemented"
1426 fi
1427}
1428
1429_python_initialize_prefix_variables() {
1430 if has "${EAPI:-0}" 0 1 2; then
1431 if [[ -n "${ROOT}" && -z "${EROOT}" ]]; then
1432 EROOT="${ROOT%/}${EPREFIX}/"
1433 fi
1434 if [[ -n "${D}" && -z "${ED}" ]]; then
1435 ED="${D%/}${EPREFIX}/"
1436 fi
1437 fi
1438}
1439
1440unset PYTHON_SANITY_CHECKS
1441
1442_python_initial_sanity_checks() {
1443 if [[ "$(declare -p PYTHON_SANITY_CHECKS 2> /dev/null)" != "declare -- PYTHON_SANITY_CHECKS="* ]]; then
1444 # Ensure that /usr/bin/python and /usr/bin/python-config are valid.
1445 if [[ "$(readlink "${EPREFIX}/usr/bin/python")" != "python-wrapper" ]]; then
1446 eerror "'${EPREFIX}/usr/bin/python' is not valid symlink."
1447 eerror "Use \`eselect python set \${python_interpreter}\` to fix this problem."
1448 die "'${EPREFIX}/usr/bin/python' is not valid symlink"
1449 fi
1450 if [[ "$(<"${EPREFIX}/usr/bin/python-config")" != *"Gentoo python-config wrapper script"* ]]; then
1451 eerror "'${EPREFIX}/usr/bin/python-config' is not valid script"
1452 eerror "Use \`eselect python set \${python_interpreter}\` to fix this problem."
1453 die "'${EPREFIX}/usr/bin/python-config' is not valid script"
1454 fi
1455 fi
1456}
1457
1458_python_final_sanity_checks() {
1459 if ! _python_implementation && [[ "$(declare -p PYTHON_SANITY_CHECKS 2> /dev/null)" != "declare -- PYTHON_SANITY_CHECKS="* ]]; then
1460 local PYTHON_ABI="${PYTHON_ABI}"
1461 for PYTHON_ABI in ${PYTHON_ABIS-${PYTHON_ABI}}; do
1462 # Ensure that appropriate version of Python is installed.
1463 if ! has_version "$(python_get_implementational_package)"; then
1464 die "$(python_get_implementational_package) is not installed"
1465 fi
1466
1467 # Ensure that EPYTHON variable is respected.
1468 if [[ "$(EPYTHON="$(PYTHON)" python -c "${_PYTHON_ABI_EXTRACTION_COMMAND}")" != "${PYTHON_ABI}" ]]; then
1469 eerror "python: '$(type -p python)'"
1470 eerror "ABI: '${ABI}'"
1471 eerror "DEFAULT_ABI: '${DEFAULT_ABI}'"
1472 eerror "EPYTHON: '$(PYTHON)'"
1473 eerror "PYTHON_ABI: '${PYTHON_ABI}'"
1474 eerror "Version of enabled Python: '$(EPYTHON="$(PYTHON)" python -c "${_PYTHON_ABI_EXTRACTION_COMMAND}")'"
1475 die "'python' does not respect EPYTHON variable"
1476 fi
1477 done
1478 fi
1479 PYTHON_SANITY_CHECKS="1"
1480}
1481
1482_python_set_color_variables() {
1483 if [[ "${NOCOLOR:-false}" =~ ^(false|no)$ ]]; then
1484 _BOLD=$'\e[1m'
1485 _RED=$'\e[1;31m'
1486 _GREEN=$'\e[1;32m'
1487 _BLUE=$'\e[1;34m'
1488 _CYAN=$'\e[1;36m'
1489 _NORMAL=$'\e[0m'
1490 else
1491 _BOLD=
1492 _RED=
1493 _GREEN=
1494 _BLUE=
1495 _CYAN=
1496 _NORMAL=
1497 fi
1498}
1499
1500# @FUNCTION: python_convert_shebangs
1501# @USAGE: [-q|--quiet] [-r|--recursive] [-x|--only-executables] [--] <Python_version> <file|directory> [files|directories]
1502# @DESCRIPTION:
1503# Convert shebangs in specified files. Directories can be specified only with --recursive option.
1504python_convert_shebangs() {
1505 local argument file files=() only_executables="0" python_version quiet="0" recursive="0"
1506
1507 while (($#)); do
1508 case "$1" in
1509 -r|--recursive)
1510 recursive="1"
1511 ;;
1512 -q|--quiet)
1513 quiet="1"
1514 ;;
1515 -x|--only-executables)
1516 only_executables="1"
1517 ;;
1518 --)
1519 shift
1520 break
1521 ;;
1522 -*)
1523 die "${FUNCNAME}(): Unrecognized option '$1'"
1524 ;;
1525 *)
1526 break
1527 ;;
1528 esac
1529 shift
1530 done
1531
1532 if [[ "$#" -eq 0 ]]; then
1533 die "${FUNCNAME}(): Missing Python version and files or directories"
1534 elif [[ "$#" -eq 1 ]]; then
1535 die "${FUNCNAME}(): Missing files or directories"
1536 fi
1537
1538 python_version="$1"
1539 shift
1540
1541 for argument in "$@"; do
1542 if [[ ! -e "${argument}" ]]; then
1543 die "${FUNCNAME}(): '${argument}' does not exist"
1544 elif [[ -f "${argument}" ]]; then
1545 files+=("${argument}")
1546 elif [[ -d "${argument}" ]]; then
1547 if [[ "${recursive}" == "1" ]]; then
1548 while read -d $'\0' -r file; do
1549 files+=("${file}")
1550 done < <(find "${argument}" $([[ "${only_executables}" == "1" ]] && echo -perm /111) -type f -print0)
925 else 1551 else
926 python_version 1552 die "${FUNCNAME}(): '${argument}' is not a regular file"
927 pyatom="dev-lang/python:${PYVER}"
928 fi
929
930 for use in ${PYTHON_USE_WITH}; do
931 if ! has_version "${pyatom}[${use}]"; then
932 python_pkg_setup_fail "Please rebuild ${pyatom} with the following USE flags enabled: ${PYTHON_USE_WITH}"
933 fi 1553 fi
934 done
935
936 for use in ${PYTHON_USE_WITH_OR}; do
937 if has_version "${pyatom}[${use}]"; then
938 return
939 fi
940 done
941
942 if [[ ${PYTHON_USE_WITH_OR} ]]; then
943 python_pkg_setup_fail "Please rebuild ${pyatom} with at least one of the following USE flags enabled: ${PYTHON_USE_WITH_OR}"
944 fi
945 }
946
947 if ! has "${EAPI:-0}" 0 1 2 || [[ -n "${SUPPORT_PYTHON_ABIS}" ]]; then
948 python_execute_function -q python_pkg_setup_check_USE_flags
949 else 1554 else
950 python_pkg_setup_check_USE_flags 1555 die "${FUNCNAME}(): '${argument}' is not a regular file or a directory"
1556 fi
1557 done
1558
1559 for file in "${files[@]}"; do
1560 file="${file#./}"
1561 [[ "${only_executables}" == "1" && ! -x "${file}" ]] && continue
1562
1563 if [[ "$(head -n1 "${file}")" =~ ^'#!'.*python ]]; then
1564 [[ "$(sed -ne "2p" "${file}")" =~ ^"# Gentoo '".*"' wrapper script generated by python_generate_wrapper_scripts()"$ ]] && continue
1565
1566 if [[ "${quiet}" == "0" ]]; then
1567 einfo "Converting shebang in '${file}'"
951 fi 1568 fi
1569
1570 sed -e "1s/python\([[:digit:]]\+\(\.[[:digit:]]\+\)\?\)\?/python${python_version}/" -i "${file}" || die "Conversion of shebang in '${file}' failed"
1571
1572 # Delete potential whitespace after "#!".
1573 sed -e '1s/\(^#!\)[[:space:]]*/\1/' -i "${file}" || die "sed '${file}' failed"
1574 fi
1575 done
1576}
1577
1578# @FUNCTION: python_clean_sitedirs
1579# @DESCRIPTION:
1580# Delete needless files in site-packages directories in ${ED}.
1581python_clean_sitedirs() {
1582 _python_initialize_prefix_variables
1583
1584 find "${ED}"usr/$(get_libdir)/python*/site-packages "(" -name "*.c" -o -name "*.h" -o -name "*.la" ")" -type f -print0 | xargs -0 rm -f
1585}
1586
1587# ================================================================================================
1588# ================================ FUNCTIONS FOR RUNNING OF TESTS ================================
1589# ================================================================================================
1590
1591# @ECLASS-VARIABLE: PYTHON_TEST_VERBOSITY
1592# @DESCRIPTION:
1593# User-configurable verbosity of tests of Python modules.
1594# Supported values: 0, 1, 2, 3, 4.
1595PYTHON_TEST_VERBOSITY="${PYTHON_TEST_VERBOSITY:-1}"
1596
1597_python_test_hook() {
1598 if [[ "$#" -ne 1 ]]; then
1599 die "${FUNCNAME}() requires 1 argument"
1600 fi
1601
1602 if _python_package_supporting_installation_for_multiple_python_abis && [[ "$(type -t "${FUNCNAME[3]}_$1_hook")" == "function" ]]; then
1603 "${FUNCNAME[3]}_$1_hook"
1604 fi
1605}
1606
1607# @FUNCTION: python_execute_nosetests
1608# @USAGE: [-P|--PYTHONPATH PYTHONPATH] [-s|--separate-build-dirs] [--] [arguments]
1609# @DESCRIPTION:
1610# Execute nosetests for all enabled Python ABIs.
1611# In ebuilds of packages supporting installation for multiple Python ABIs, this function calls
1612# python_execute_nosetests_pre_hook() and python_execute_nosetests_post_hook(), if they are defined.
1613python_execute_nosetests() {
1614 _python_set_color_variables
1615
1616 local PYTHONPATH_template= separate_build_dirs=
1617
1618 while (($#)); do
1619 case "$1" in
1620 -P|--PYTHONPATH)
1621 PYTHONPATH_template="$2"
1622 shift
1623 ;;
1624 -s|--separate-build-dirs)
1625 separate_build_dirs="1"
1626 ;;
1627 --)
1628 shift
1629 break
1630 ;;
1631 -*)
1632 die "${FUNCNAME}(): Unrecognized option '$1'"
1633 ;;
1634 *)
1635 break
1636 ;;
1637 esac
1638 shift
1639 done
1640
1641 python_test_function() {
1642 local evaluated_PYTHONPATH=
1643
1644 if [[ -n "${PYTHONPATH_template}" ]]; then
1645 evaluated_PYTHONPATH="$(eval echo -n "${PYTHONPATH_template}")"
1646 if [[ ! -e "${evaluated_PYTHONPATH}" ]]; then
1647 unset evaluated_PYTHONPATH
1648 fi
1649 fi
1650
1651 _python_test_hook pre
1652
1653 if [[ -n "${evaluated_PYTHONPATH}" ]]; then
1654 echo ${_BOLD}PYTHONPATH="${evaluated_PYTHONPATH}" nosetests --verbosity="${PYTHON_TEST_VERBOSITY}" "$@"${_NORMAL}
1655 PYTHONPATH="${evaluated_PYTHONPATH}" nosetests --verbosity="${PYTHON_TEST_VERBOSITY}" "$@" || return "$?"
1656 else
1657 echo ${_BOLD}nosetests --verbosity="${PYTHON_TEST_VERBOSITY}" "$@"${_NORMAL}
1658 nosetests --verbosity="${PYTHON_TEST_VERBOSITY}" "$@" || return "$?"
1659 fi
1660
1661 _python_test_hook post
952 } 1662 }
1663 if _python_package_supporting_installation_for_multiple_python_abis; then
1664 python_execute_function ${separate_build_dirs:+-s} python_test_function "$@"
1665 else
1666 if [[ -n "${separate_build_dirs}" ]]; then
1667 die "${FUNCNAME}(): Invalid usage"
1668 fi
1669 python_test_function "$@" || die "Testing failed"
1670 fi
953 1671
954 EXPORT_FUNCTIONS pkg_setup 1672 unset -f python_test_function
1673}
955 1674
956 if [[ -n "${PYTHON_USE_WITH}" ]]; then 1675# @FUNCTION: python_execute_py.test
957 PYTHON_USE_WITH_ATOM="${PYTHON_ATOM}[${PYTHON_USE_WITH/ /,}]" 1676# @USAGE: [-P|--PYTHONPATH PYTHONPATH] [-s|--separate-build-dirs] [--] [arguments]
958 elif [[ -n "${PYTHON_USE_WITH_OR}" ]]; then 1677# @DESCRIPTION:
959 PYTHON_USE_WITH_ATOM="|| ( " 1678# Execute py.test for all enabled Python ABIs.
960 for use in ${PYTHON_USE_WITH_OR}; do 1679# In ebuilds of packages supporting installation for multiple Python ABIs, this function calls
961 PYTHON_USE_WITH_ATOM+=" ${PYTHON_ATOM}[${use}]" 1680# python_execute_py.test_pre_hook() and python_execute_py.test_post_hook(), if they are defined.
1681python_execute_py.test() {
1682 _python_set_color_variables
1683
1684 local PYTHONPATH_template= separate_build_dirs=
1685
1686 while (($#)); do
1687 case "$1" in
1688 -P|--PYTHONPATH)
1689 PYTHONPATH_template="$2"
1690 shift
1691 ;;
1692 -s|--separate-build-dirs)
1693 separate_build_dirs="1"
1694 ;;
1695 --)
1696 shift
1697 break
1698 ;;
1699 -*)
1700 die "${FUNCNAME}(): Unrecognized option '$1'"
1701 ;;
1702 *)
1703 break
1704 ;;
1705 esac
1706 shift
962 done 1707 done
963 unset use 1708
964 PYTHON_USE_WITH_ATOM+=" )" 1709 python_test_function() {
1710 local evaluated_PYTHONPATH=
1711
1712 if [[ -n "${PYTHONPATH_template}" ]]; then
1713 evaluated_PYTHONPATH="$(eval echo -n "${PYTHONPATH_template}")"
1714 if [[ ! -e "${evaluated_PYTHONPATH}" ]]; then
1715 unset evaluated_PYTHONPATH
1716 fi
965 fi 1717 fi
966 if [[ -n "${PYTHON_USE_WITH_OPT}" ]]; then 1718
967 PYTHON_USE_WITH_ATOM="${PYTHON_USE_WITH_OPT}? ( ${PYTHON_USE_WITH_ATOM} )" 1719 _python_test_hook pre
1720
1721 if [[ -n "${evaluated_PYTHONPATH}" ]]; then
1722 echo ${_BOLD}PYTHONPATH="${evaluated_PYTHONPATH}" py.test $([[ "${PYTHON_TEST_VERBOSITY}" -ge 2 ]] && echo -v) "$@"${_NORMAL}
1723 PYTHONPATH="${evaluated_PYTHONPATH}" py.test $([[ "${PYTHON_TEST_VERBOSITY}" -ge 2 ]] && echo -v) "$@" || return "$?"
1724 else
1725 echo ${_BOLD}py.test $([[ "${PYTHON_TEST_VERBOSITY}" -gt 1 ]] && echo -v) "$@"${_NORMAL}
1726 py.test $([[ "${PYTHON_TEST_VERBOSITY}" -gt 1 ]] && echo -v) "$@" || return "$?"
968 fi 1727 fi
969 DEPEND+=" ${PYTHON_USE_WITH_ATOM}"
970 RDEPEND+=" ${PYTHON_USE_WITH_ATOM}"
971fi
972 1728
973# @ECLASS-VARIABLE: PYTHON_DEFINE_DEFAULT_FUNCTIONS 1729 _python_test_hook post
974# @DESCRIPTION:
975# Set this to define default functions for the following ebuild phases:
976# src_prepare, src_configure, src_compile, src_test, src_install.
977if ! has "${EAPI:-0}" 0 1 && [[ -n "${PYTHON_DEFINE_DEFAULT_FUNCTIONS}" ]]; then
978 python_src_prepare() {
979 python_copy_sources
980 } 1730 }
1731 if _python_package_supporting_installation_for_multiple_python_abis; then
1732 python_execute_function ${separate_build_dirs:+-s} python_test_function "$@"
1733 else
1734 if [[ -n "${separate_build_dirs}" ]]; then
1735 die "${FUNCNAME}(): Invalid usage"
1736 fi
1737 python_test_function "$@" || die "Testing failed"
1738 fi
981 1739
982 for python_default_function in src_configure src_compile src_test src_install; do
983 eval "python_${python_default_function}() { python_execute_function -d -s; }"
984 done
985 unset python_default_function 1740 unset -f python_test_function
1741}
986 1742
987 EXPORT_FUNCTIONS src_prepare src_configure src_compile src_test src_install 1743# @FUNCTION: python_execute_trial
1744# @USAGE: [-P|--PYTHONPATH PYTHONPATH] [-s|--separate-build-dirs] [--] [arguments]
1745# @DESCRIPTION:
1746# Execute trial for all enabled Python ABIs.
1747# In ebuilds of packages supporting installation for multiple Python ABIs, this function
1748# calls python_execute_trial_pre_hook() and python_execute_trial_post_hook(), if they are defined.
1749python_execute_trial() {
1750 _python_set_color_variables
1751
1752 local PYTHONPATH_template= separate_build_dirs=
1753
1754 while (($#)); do
1755 case "$1" in
1756 -P|--PYTHONPATH)
1757 PYTHONPATH_template="$2"
1758 shift
1759 ;;
1760 -s|--separate-build-dirs)
1761 separate_build_dirs="1"
1762 ;;
1763 --)
1764 shift
1765 break
1766 ;;
1767 -*)
1768 die "${FUNCNAME}(): Unrecognized option '$1'"
1769 ;;
1770 *)
1771 break
1772 ;;
1773 esac
1774 shift
1775 done
1776
1777 python_test_function() {
1778 local evaluated_PYTHONPATH=
1779
1780 if [[ -n "${PYTHONPATH_template}" ]]; then
1781 evaluated_PYTHONPATH="$(eval echo -n "${PYTHONPATH_template}")"
1782 if [[ ! -e "${evaluated_PYTHONPATH}" ]]; then
1783 unset evaluated_PYTHONPATH
1784 fi
1785 fi
1786
1787 _python_test_hook pre
1788
1789 if [[ -n "${evaluated_PYTHONPATH}" ]]; then
1790 echo ${_BOLD}PYTHONPATH="${evaluated_PYTHONPATH}" trial $([[ "${PYTHON_TEST_VERBOSITY}" -ge 4 ]] && echo --spew) "$@"${_NORMAL}
1791 PYTHONPATH="${evaluated_PYTHONPATH}" trial $([[ "${PYTHON_TEST_VERBOSITY}" -ge 4 ]] && echo --spew) "$@" || return "$?"
1792 else
1793 echo ${_BOLD}trial $([[ "${PYTHON_TEST_VERBOSITY}" -ge 4 ]] && echo --spew) "$@"${_NORMAL}
1794 trial $([[ "${PYTHON_TEST_VERBOSITY}" -ge 4 ]] && echo --spew) "$@" || return "$?"
1795 fi
1796
1797 _python_test_hook post
1798 }
1799 if _python_package_supporting_installation_for_multiple_python_abis; then
1800 python_execute_function ${separate_build_dirs:+-s} python_test_function "$@"
1801 else
1802 if [[ -n "${separate_build_dirs}" ]]; then
1803 die "${FUNCNAME}(): Invalid usage"
1804 fi
1805 python_test_function "$@" || die "Testing failed"
988fi 1806 fi
989 1807
990# @FUNCTION: python_disable_pyc 1808 unset -f python_test_function
991# @DESCRIPTION:
992# Tell Python not to automatically recompile modules to .pyc/.pyo
993# even if the timestamps/version stamps don't match. This is done
994# to protect sandbox.
995python_disable_pyc() {
996 export PYTHONDONTWRITEBYTECODE="1"
997} 1809}
1810
1811# ================================================================================================
1812# ======================= FUNCTIONS FOR HANDLING OF BYTE-COMPILED MODULES ========================
1813# ================================================================================================
998 1814
999# @FUNCTION: python_enable_pyc 1815# @FUNCTION: python_enable_pyc
1000# @DESCRIPTION: 1816# @DESCRIPTION:
1001# Tell Python to automatically recompile modules to .pyc/.pyo if the 1817# Tell Python to automatically recompile modules to .pyc/.pyo if the
1002# timestamps/version stamps have changed. 1818# timestamps/version stamps have changed.
1003python_enable_pyc() { 1819python_enable_pyc() {
1004 unset PYTHONDONTWRITEBYTECODE 1820 unset PYTHONDONTWRITEBYTECODE
1005} 1821}
1006 1822
1007# @FUNCTION: python_need_rebuild
1008# @DESCRIPTION: Run without arguments, specifies that the package should be
1009# rebuilt after a python upgrade.
1010python_need_rebuild() {
1011 python_version
1012 export PYTHON_NEED_REBUILD=${PYVER}
1013}
1014
1015# @FUNCTION: python_get_includedir
1016# @DESCRIPTION:
1017# Run without arguments, returns the Python include directory.
1018python_get_includedir() {
1019 if [[ -n "${PYTHON_ABI}" ]]; then
1020 echo "/usr/include/python${PYTHON_ABI}"
1021 else
1022 python_version
1023 echo "/usr/include/python${PYVER}"
1024 fi
1025}
1026
1027# @FUNCTION: python_get_libdir
1028# @DESCRIPTION:
1029# Run without arguments, returns the Python library directory.
1030python_get_libdir() {
1031 if [[ -n "${PYTHON_ABI}" ]]; then
1032 echo "/usr/$(get_libdir)/python${PYTHON_ABI}"
1033 else
1034 python_version
1035 echo "/usr/$(get_libdir)/python${PYVER}"
1036 fi
1037}
1038
1039# @FUNCTION: python_get_sitedir
1040# @DESCRIPTION:
1041# Run without arguments, returns the Python site-packages directory.
1042python_get_sitedir() {
1043 echo "$(python_get_libdir)/site-packages"
1044}
1045
1046# @FUNCTION: python_tkinter_exists
1047# @DESCRIPTION:
1048# Run without arguments, checks if python was compiled with Tkinter
1049# support. If not, prints an error message and dies.
1050python_tkinter_exists() {
1051 if ! python -c "import Tkinter" >/dev/null 2>&1; then
1052 eerror "You need to recompile python with Tkinter support."
1053 eerror "Try adding: 'dev-lang/python tk'"
1054 eerror "in to /etc/portage/package.use"
1055 echo
1056 die "missing tkinter support with installed python"
1057 fi
1058}
1059
1060# @FUNCTION: python_mod_exists
1061# @USAGE: <module>
1062# @DESCRIPTION:
1063# Run with the module name as an argument. it will check if a
1064# python module is installed and loadable. it will return
1065# TRUE(0) if the module exists, and FALSE(1) if the module does
1066# not exist.
1067#
1068# Example:
1069# if python_mod_exists gtk; then
1070# echo "gtk support enabled"
1071# fi
1072python_mod_exists() {
1073 [[ "$1" ]] || die "${FUNCNAME} requires an argument!"
1074 python -c "import $1" &>/dev/null
1075}
1076
1077# @FUNCTION: python_mod_compile 1823# @FUNCTION: python_disable_pyc
1078# @USAGE: <file> [more files ...]
1079# @DESCRIPTION: 1824# @DESCRIPTION:
1080# Given filenames, it will pre-compile the module's .pyc and .pyo. 1825# Tell Python not to automatically recompile modules to .pyc/.pyo
1081# This function should only be run in pkg_postinst() 1826# even if the timestamps/version stamps do not match. This is done
1082# 1827# to protect sandbox.
1083# Example: 1828python_disable_pyc() {
1084# python_mod_compile /usr/lib/python2.3/site-packages/pygoogle.py 1829 export PYTHONDONTWRITEBYTECODE="1"
1085#
1086python_mod_compile() {
1087 if ! has "${EAPI:-0}" 0 1 2 || [[ -n "${SUPPORT_PYTHON_ABIS}" ]]; then
1088 die "${FUNCNAME}() cannot be used in this EAPI"
1089 fi
1090
1091 local f myroot myfiles=()
1092
1093 # Check if phase is pkg_postinst()
1094 [[ ${EBUILD_PHASE} != postinst ]] &&\
1095 die "${FUNCNAME} should only be run in pkg_postinst()"
1096
1097 if [[ -n "${PYTHON_ABI}" ]]; then
1098 PYVER="${PYTHON_ABI}"
1099 else
1100 python_version
1101 fi
1102
1103 # strip trailing slash
1104 myroot="${ROOT%/}"
1105
1106 # respect ROOT
1107 for f in "$@"; do
1108 [[ -f "${myroot}/${f}" ]] && myfiles+=("${myroot}/${f}")
1109 done
1110
1111 if ((${#myfiles[@]})); then
1112 python${PYVER} ${myroot}/usr/$(get_libdir)/python${PYVER}/py_compile.py "${myfiles[@]}"
1113 python${PYVER} -O ${myroot}/usr/$(get_libdir)/python${PYVER}/py_compile.py "${myfiles[@]}" &> /dev/null
1114 else
1115 ewarn "No files to compile!"
1116 fi
1117} 1830}
1118 1831
1119# @FUNCTION: python_mod_optimize 1832# @FUNCTION: python_mod_optimize
1120# @USAGE: [options] [directory|file] 1833# @USAGE: [options] [directory|file]
1121# @DESCRIPTION: 1834# @DESCRIPTION:
1122# If no arguments supplied, it will recompile not recursively all modules 1835# If no arguments supplied, it will recompile not recursively all modules
1123# under sys.path (eg. /usr/lib/python2.6, /usr/lib/python2.6/site-packages). 1836# under sys.path (eg. /usr/lib/python2.6, /usr/lib/python2.6/site-packages).
1124# 1837#
1125# If supplied with arguments, it will recompile all modules recursively 1838# If supplied with arguments, it will recompile all modules recursively
1126# in the supplied directory. 1839# in the supplied directory.
1127# This function should only be run in pkg_postinst().
1128# 1840#
1129# Options passed to this function are passed to compileall.py. 1841# Options passed to this function are passed to compileall.py.
1130# 1842#
1131# Example: 1843# This function can be used only in pkg_postinst() phase.
1132# python_mod_optimize ctypesgencore
1133python_mod_optimize() { 1844python_mod_optimize() {
1845 _python_initialize_prefix_variables
1846
1134 # Check if phase is pkg_postinst(). 1847 # Check if phase is pkg_postinst().
1135 [[ ${EBUILD_PHASE} != "postinst" ]] && die "${FUNCNAME} should only be run in pkg_postinst()" 1848 [[ "${EBUILD_PHASE}" != "postinst" ]] && die "${FUNCNAME}() can be used only in pkg_postinst() phase"
1136 1849
1137 if ! has "${EAPI:-0}" 0 1 2 || [[ -n "${SUPPORT_PYTHON_ABIS}" ]]; then 1850 if ! has "${EAPI:-0}" 0 1 2 || _python_package_supporting_installation_for_multiple_python_abis; then
1138 local dir file options=() other_dirs=() other_files=() PYTHON_ABI return_code root site_packages_absolute_dirs=() site_packages_dirs=() site_packages_absolute_files=() site_packages_files=() 1851 local dir file options=() other_dirs=() other_files=() previous_PYTHON_ABI="${PYTHON_ABI}" PYTHON_ABI="${PYTHON_ABI}" return_code root site_packages_absolute_dirs=() site_packages_dirs=() site_packages_absolute_files=() site_packages_files=()
1139 1852
1140 # Strip trailing slash from ROOT. 1853 # Strip trailing slash from ROOT.
1141 root="${ROOT%/}" 1854 root="${EROOT%/}"
1142 1855
1143 # Respect ROOT and options passed to compileall.py. 1856 # Respect ROOT and options passed to compileall.py.
1144 while (($#)); do 1857 while (($#)); do
1145 case "$1" in 1858 case "$1" in
1146 -l|-f|-q) 1859 -l|-f|-q)
1149 -d|-x) 1862 -d|-x)
1150 options+=("$1" "$2") 1863 options+=("$1" "$2")
1151 shift 1864 shift
1152 ;; 1865 ;;
1153 -*) 1866 -*)
1154 ewarn "${FUNCNAME}: Ignoring compile option $1" 1867 ewarn "${FUNCNAME}(): Ignoring option '$1'"
1155 ;; 1868 ;;
1156 *) 1869 *)
1157 if [[ "$1" =~ ^/usr/lib(32|64)?/python[[:digit:]]+\.[[:digit:]]+ ]]; then 1870 if ! _python_implementation && [[ "$1" =~ ^"${EPREFIX}"/usr/lib(32|64)?/python[[:digit:]]+\.[[:digit:]]+ ]]; then
1158 die "${FUNCNAME} doesn't support absolute paths of directories/files in site-packages directories" 1871 die "${FUNCNAME}() does not support absolute paths of directories/files in site-packages directories"
1159 elif [[ "$1" =~ ^/ ]]; then 1872 elif [[ "$1" =~ ^/ ]]; then
1160 if [[ -d "${root}/$1" ]]; then 1873 if [[ -d "${root}/$1" ]]; then
1161 other_dirs+=("${root}/$1") 1874 other_dirs+=("${root}/$1")
1162 elif [[ -f "${root}/$1" ]]; then 1875 elif [[ -f "${root}/$1" ]]; then
1163 other_files+=("${root}/$1") 1876 other_files+=("${root}/$1")
1164 elif [[ -e "${root}/$1" ]]; then 1877 elif [[ -e "${root}/$1" ]]; then
1165 ewarn "'${root}/$1' is not a file or a directory!" 1878 ewarn "'${root}/$1' is not a file or a directory!"
1166 else 1879 else
1167 ewarn "'${root}/$1' doesn't exist!" 1880 ewarn "'${root}/$1' does not exist!"
1168 fi 1881 fi
1169 else 1882 else
1170 for PYTHON_ABI in ${PYTHON_ABIS}; do 1883 for PYTHON_ABI in ${PYTHON_ABIS-${PYTHON_ABI:-$(PYTHON --ABI)}}; do
1171 if [[ -d "${root}$(python_get_sitedir)/$1" ]]; then 1884 if [[ -d "${root}$(python_get_sitedir)/$1" ]]; then
1172 site_packages_dirs+=("$1") 1885 site_packages_dirs+=("$1")
1173 break 1886 break
1174 elif [[ -f "${root}$(python_get_sitedir)/$1" ]]; then 1887 elif [[ -f "${root}$(python_get_sitedir)/$1" ]]; then
1175 site_packages_files+=("$1") 1888 site_packages_files+=("$1")
1176 break 1889 break
1177 elif [[ -e "${root}$(python_get_sitedir)/$1" ]]; then 1890 elif [[ -e "${root}$(python_get_sitedir)/$1" ]]; then
1178 ewarn "'$1' is not a file or a directory!" 1891 ewarn "'$1' is not a file or a directory!"
1179 else 1892 else
1180 ewarn "'$1' doesn't exist!" 1893 ewarn "'$1' does not exist!"
1181 fi 1894 fi
1182 done 1895 done
1183 fi 1896 fi
1184 ;; 1897 ;;
1185 esac 1898 esac
1187 done 1900 done
1188 1901
1189 # Set additional options. 1902 # Set additional options.
1190 options+=("-q") 1903 options+=("-q")
1191 1904
1192 for PYTHON_ABI in ${PYTHON_ABIS}; do 1905 for PYTHON_ABI in ${PYTHON_ABIS-${PYTHON_ABI:-$(PYTHON --ABI)}}; do
1193 if ((${#site_packages_dirs[@]})) || ((${#site_packages_files[@]})); then 1906 if ((${#site_packages_dirs[@]})) || ((${#site_packages_files[@]})); then
1194 return_code="0" 1907 return_code="0"
1195 ebegin "Compilation and optimization of Python modules for Python ${PYTHON_ABI}" 1908 ebegin "Compilation and optimization of Python modules for $(python_get_implementation) $(python_get_version)"
1196 if ((${#site_packages_dirs[@]})); then 1909 if ((${#site_packages_dirs[@]})); then
1197 for dir in "${site_packages_dirs[@]}"; do 1910 for dir in "${site_packages_dirs[@]}"; do
1198 site_packages_absolute_dirs+=("${root}$(python_get_sitedir)/${dir}") 1911 site_packages_absolute_dirs+=("${root}$(python_get_sitedir)/${dir}")
1199 done 1912 done
1200 "$(PYTHON)" "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${site_packages_absolute_dirs[@]}" || return_code="1" 1913 "$(PYTHON)" "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${site_packages_absolute_dirs[@]}" || return_code="1"
1914 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" != "Jython" ]]; then
1201 "$(PYTHON)" -O "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${site_packages_absolute_dirs[@]}" &> /dev/null || return_code="1" 1915 "$(PYTHON)" -O "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${site_packages_absolute_dirs[@]}" &> /dev/null || return_code="1"
1916 fi
1202 fi 1917 fi
1203 if ((${#site_packages_files[@]})); then 1918 if ((${#site_packages_files[@]})); then
1204 for file in "${site_packages_files[@]}"; do 1919 for file in "${site_packages_files[@]}"; do
1205 site_packages_absolute_files+=("${root}$(python_get_sitedir)/${file}") 1920 site_packages_absolute_files+=("${root}$(python_get_sitedir)/${file}")
1206 done 1921 done
1207 "$(PYTHON)" "${root}$(python_get_libdir)/py_compile.py" "${site_packages_absolute_files[@]}" || return_code="1" 1922 "$(PYTHON)" "${root}$(python_get_libdir)/py_compile.py" "${site_packages_absolute_files[@]}" || return_code="1"
1923 if [[ "$(_python_get_implementation "${PYTHON_ABI}")" != "Jython" ]]; then
1208 "$(PYTHON)" -O "${root}$(python_get_libdir)/py_compile.py" "${site_packages_absolute_files[@]}" &> /dev/null || return_code="1" 1924 "$(PYTHON)" -O "${root}$(python_get_libdir)/py_compile.py" "${site_packages_absolute_files[@]}" &> /dev/null || return_code="1"
1925 fi
1209 fi 1926 fi
1210 eend "${return_code}" 1927 eend "${return_code}"
1211 fi 1928 fi
1212 unset site_packages_absolute_dirs site_packages_absolute_files 1929 unset site_packages_absolute_dirs site_packages_absolute_files
1213 done 1930 done
1214 1931
1215 # Don't use PYTHON_ABI in next calls to python_get_libdir(). 1932 # Restore previous value of PYTHON_ABI.
1933 if [[ -n "${previous_PYTHON_ABI}" ]]; then
1934 PYTHON_ABI="${previous_PYTHON_ABI}"
1935 else
1216 unset PYTHON_ABI 1936 unset PYTHON_ABI
1937 fi
1217 1938
1218 if ((${#other_dirs[@]})) || ((${#other_files[@]})); then 1939 if ((${#other_dirs[@]})) || ((${#other_files[@]})); then
1219 return_code="0" 1940 return_code="0"
1220 ebegin "Compilation and optimization of Python modules placed outside of site-packages directories for Python ${PYVER}" 1941 ebegin "Compilation and optimization of Python modules placed outside of site-packages directories for $(python_get_implementation) $(python_get_version)"
1221 if ((${#other_dirs[@]})); then 1942 if ((${#other_dirs[@]})); then
1222 python${PYVER} "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${other_dirs[@]}" || return_code="1" 1943 "$(PYTHON ${PYTHON_ABI})" "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${other_dirs[@]}" || return_code="1"
1944 if [[ "$(_python_get_implementation "${PYTHON_ABI-$(PYTHON --ABI)}")" != "Jython" ]]; then
1223 python${PYVER} -O "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${other_dirs[@]}" &> /dev/null || return_code="1" 1945 "$(PYTHON ${PYTHON_ABI})" -O "${root}$(python_get_libdir)/compileall.py" "${options[@]}" "${other_dirs[@]}" &> /dev/null || return_code="1"
1946 fi
1224 fi 1947 fi
1225 if ((${#other_files[@]})); then 1948 if ((${#other_files[@]})); then
1226 python${PYVER} "${root}$(python_get_libdir)/py_compile.py" "${other_files[@]}" || return_code="1" 1949 "$(PYTHON ${PYTHON_ABI})" "${root}$(python_get_libdir)/py_compile.py" "${other_files[@]}" || return_code="1"
1950 if [[ "$(_python_get_implementation "${PYTHON_ABI-$(PYTHON --ABI)}")" != "Jython" ]]; then
1227 python${PYVER} -O "${root}$(python_get_libdir)/py_compile.py" "${other_files[@]}" &> /dev/null || return_code="1" 1951 "$(PYTHON ${PYTHON_ABI})" -O "${root}$(python_get_libdir)/py_compile.py" "${other_files[@]}" &> /dev/null || return_code="1"
1952 fi
1228 fi 1953 fi
1229 eend "${return_code}" 1954 eend "${return_code}"
1230 fi 1955 fi
1231 else 1956 else
1232 local myroot mydirs=() myfiles=() myopts=() return_code="0" 1957 local myroot mydirs=() myfiles=() myopts=() return_code="0"
1233 1958
1234 # strip trailing slash 1959 # strip trailing slash
1235 myroot="${ROOT%/}" 1960 myroot="${EROOT%/}"
1236 1961
1237 # respect ROOT and options passed to compileall.py 1962 # respect ROOT and options passed to compileall.py
1238 while (($#)); do 1963 while (($#)); do
1239 case "$1" in 1964 case "$1" in
1240 -l|-f|-q) 1965 -l|-f|-q)
1243 -d|-x) 1968 -d|-x)
1244 myopts+=("$1" "$2") 1969 myopts+=("$1" "$2")
1245 shift 1970 shift
1246 ;; 1971 ;;
1247 -*) 1972 -*)
1248 ewarn "${FUNCNAME}: Ignoring compile option $1" 1973 ewarn "${FUNCNAME}(): Ignoring option '$1'"
1249 ;; 1974 ;;
1250 *) 1975 *)
1251 if [[ -d "${myroot}"/$1 ]]; then 1976 if [[ -d "${myroot}"/$1 ]]; then
1252 mydirs+=("${myroot}/$1") 1977 mydirs+=("${myroot}/$1")
1253 elif [[ -f "${myroot}"/$1 ]]; then 1978 elif [[ -f "${myroot}"/$1 ]]; then
1254 # Files are passed to python_mod_compile which is ROOT-aware 1979 # Files are passed to python_mod_compile which is ROOT-aware
1255 myfiles+=("$1") 1980 myfiles+=("$1")
1256 elif [[ -e "${myroot}/$1" ]]; then 1981 elif [[ -e "${myroot}/$1" ]]; then
1257 ewarn "${myroot}/$1 is not a file or directory!" 1982 ewarn "${myroot}/$1 is not a file or directory!"
1258 else 1983 else
1259 ewarn "${myroot}/$1 doesn't exist!" 1984 ewarn "${myroot}/$1 does not exist!"
1260 fi 1985 fi
1261 ;; 1986 ;;
1262 esac 1987 esac
1263 shift 1988 shift
1264 done 1989 done
1265 1990
1266 if [[ -n "${PYTHON_ABI}" ]]; then
1267 PYVER="${PYTHON_ABI}"
1268 else
1269 python_version
1270 fi
1271
1272 # set additional opts 1991 # set additional opts
1273 myopts+=(-q) 1992 myopts+=(-q)
1274 1993
1275 ebegin "Compilation and optimization of Python modules for Python ${PYVER}" 1994 ebegin "Compilation and optimization of Python modules for $(python_get_implementation) $(python_get_version)"
1276 if ((${#mydirs[@]})); then 1995 if ((${#mydirs[@]})); then
1277 python${PYVER} \ 1996 "$(PYTHON ${PYTHON_ABI})" "${myroot}$(python_get_libdir)/compileall.py" "${myopts[@]}" "${mydirs[@]}" || return_code="1"
1278 "${myroot}"/usr/$(get_libdir)/python${PYVER}/compileall.py \ 1997 "$(PYTHON ${PYTHON_ABI})" -O "${myroot}$(python_get_libdir)/compileall.py" "${myopts[@]}" "${mydirs[@]}" &> /dev/null || return_code="1"
1279 "${myopts[@]}" "${mydirs[@]}" || return_code="1"
1280 python${PYVER} -O \
1281 "${myroot}"/usr/$(get_libdir)/python${PYVER}/compileall.py \
1282 "${myopts[@]}" "${mydirs[@]}" &> /dev/null || return_code="1"
1283 fi 1998 fi
1284 1999
1285 if ((${#myfiles[@]})); then 2000 if ((${#myfiles[@]})); then
1286 python_mod_compile "${myfiles[@]}" 2001 python_mod_compile "${myfiles[@]}"
1287 fi 2002 fi
1298# 2013#
1299# It will recursively scan all compiled Python modules in the directories and 2014# It will recursively scan all compiled Python modules in the directories and
1300# determine if they are orphaned (i.e. their corresponding .py files are missing.) 2015# determine if they are orphaned (i.e. their corresponding .py files are missing.)
1301# If they are, then it will remove their corresponding .pyc and .pyo files. 2016# If they are, then it will remove their corresponding .pyc and .pyo files.
1302# 2017#
1303# This function should only be run in pkg_postrm(). 2018# This function can be used only in pkg_postrm() phase.
1304python_mod_cleanup() { 2019python_mod_cleanup() {
2020 _python_initialize_prefix_variables
2021 _python_set_color_variables
2022
1305 local path py_file PYTHON_ABI SEARCH_PATH=() root 2023 local path py_file PYTHON_ABI="${PYTHON_ABI}" SEARCH_PATH=() root
1306 2024
1307 # Check if phase is pkg_postrm(). 2025 # Check if phase is pkg_postrm().
1308 [[ ${EBUILD_PHASE} != "postrm" ]] && die "${FUNCNAME} should only be run in pkg_postrm()" 2026 [[ "${EBUILD_PHASE}" != "postrm" ]] && die "${FUNCNAME}() can be used only in pkg_postrm() phase"
1309 2027
1310 # Strip trailing slash from ROOT. 2028 # Strip trailing slash from ROOT.
1311 root="${ROOT%/}" 2029 root="${EROOT%/}"
1312 2030
1313 if (($#)); then 2031 if (($#)); then
1314 if ! has "${EAPI:-0}" 0 1 2 || [[ -n "${SUPPORT_PYTHON_ABIS}" ]]; then 2032 if ! has "${EAPI:-0}" 0 1 2 || _python_package_supporting_installation_for_multiple_python_abis; then
1315 while (($#)); do 2033 while (($#)); do
1316 if [[ "$1" =~ ^/usr/lib(32|64)?/python[[:digit:]]+\.[[:digit:]]+ ]]; then 2034 if ! _python_implementation && [[ "$1" =~ ^"${EPREFIX}"/usr/lib(32|64)?/python[[:digit:]]+\.[[:digit:]]+ ]]; then
1317 die "${FUNCNAME} doesn't support absolute paths of directories/files in site-packages directories" 2035 die "${FUNCNAME}() does not support absolute paths of directories/files in site-packages directories"
1318 elif [[ "$1" =~ ^/ ]]; then 2036 elif [[ "$1" =~ ^/ ]]; then
1319 SEARCH_PATH+=("${root}/${1#/}") 2037 SEARCH_PATH+=("${root}/${1#/}")
1320 else 2038 else
1321 for PYTHON_ABI in ${PYTHON_ABIS}; do 2039 for PYTHON_ABI in ${PYTHON_ABIS-${PYTHON_ABI:-$(PYTHON --ABI)}}; do
1322 SEARCH_PATH+=("${root}$(python_get_sitedir)/$1") 2040 SEARCH_PATH+=("${root}$(python_get_sitedir)/$1")
1323 done 2041 done
1324 fi 2042 fi
1325 shift 2043 shift
1326 done 2044 done
1337 SEARCH_PATH+=("${sitedir}") 2055 SEARCH_PATH+=("${sitedir}")
1338 fi 2056 fi
1339 done 2057 done
1340 fi 2058 fi
1341 done 2059 done
2060 for sitedir in "${root}"/usr/share/jython-*/Lib/site-packages; do
2061 if [[ -d "${sitedir}" ]]; then
2062 SEARCH_PATH+=("${sitedir}")
1342 fi 2063 fi
1343 2064 done
1344 local BLUE CYAN NORMAL
1345 if [[ "${NOCOLOR:-false}" =~ ^(false|no)$ ]]; then
1346 BLUE=$'\e[1;34m'
1347 CYAN=$'\e[1;36m'
1348 NORMAL=$'\e[0m'
1349 else
1350 BLUE=
1351 CYAN=
1352 NORMAL=
1353 fi 2065 fi
1354 2066
1355 for path in "${SEARCH_PATH[@]}"; do 2067 for path in "${SEARCH_PATH[@]}"; do
1356 if [[ -d "${path}" ]]; then 2068 if [[ -d "${path}" ]]; then
1357 find "${path}" -name '*.py[co]' -print0 | while read -rd ''; do 2069 find "${path}" "(" -name "*.py[co]" -o -name "*\$py.class" ")" -print0 | while read -rd ''; do
2070 if [[ "${REPLY}" == *[co] ]]; then
1358 py_file="${REPLY%[co]}" 2071 py_file="${REPLY%[co]}"
1359 [[ -f "${py_file}" || (! -f "${py_file}c" && ! -f "${py_file}o") ]] && continue 2072 [[ -f "${py_file}" || (! -f "${py_file}c" && ! -f "${py_file}o") ]] && continue
1360 einfo "${BLUE}<<< ${py_file}[co]${NORMAL}" 2073 echo "${_BLUE}<<< ${py_file}[co]${_NORMAL}"
1361 rm -f "${py_file}"[co] 2074 rm -f "${py_file}"[co]
2075 elif [[ "${REPLY}" == *\$py.class ]]; then
2076 py_file="${REPLY%\$py.class}.py"
2077 [[ -f "${py_file}" || ! -f "${py_file%.py}\$py.class" ]] && continue
2078 echo "${_BLUE}<<< ${py_file%.py}\$py.class${_NORMAL}"
2079 rm -f "${py_file%.py}\$py.class"
2080 fi
1362 done 2081 done
1363 2082
1364 # Attempt to delete directories, which may be empty. 2083 # Attempt to delete directories, which may be empty.
1365 find "${path}" -type d | sort -r | while read -r dir; do 2084 find "${path}" -type d | sort -r | while read -r dir; do
1366 rmdir "${dir}" 2>/dev/null && einfo "${CYAN}<<< ${dir}${NORMAL}" 2085 rmdir "${dir}" 2>/dev/null && echo "${_CYAN}<<< ${dir}${_NORMAL}"
1367 done 2086 done
1368 elif [[ "${path}" == *.py && ! -f "${path}" && (-f "${path}c" || -f "${path}o") ]]; then 2087 elif [[ "${path}" == *.py && ! -f "${path}" ]]; then
2088 if [[ (-f "${path}c" || -f "${path}o") ]]; then
1369 einfo "${BLUE}<<< ${path}[co]${NORMAL}" 2089 echo "${_BLUE}<<< ${path}[co]${_NORMAL}"
1370 rm -f "${path}"[co] 2090 rm -f "${path}"[co]
1371 fi 2091 fi
2092 if [[ -f "${path%.py}\$py.class" ]]; then
2093 echo "${_BLUE}<<< ${path%.py}\$py.class${_NORMAL}"
2094 rm -f "${path%.py}\$py.class"
2095 fi
2096 fi
1372 done 2097 done
1373} 2098}
2099
2100# ================================================================================================
2101# ===================================== DEPRECATED FUNCTIONS =====================================
2102# ================================================================================================
2103
2104# @FUNCTION: python_version
2105# @DESCRIPTION:
2106# Run without arguments and it will export the version of python
2107# currently in use as $PYVER; sets PYVER/PYVER_MAJOR/PYVER_MINOR
2108python_version() {
2109 if ! has "${EAPI:-0}" 0 1 2 || _python_package_supporting_installation_for_multiple_python_abis; then
2110 eerror "Use PYTHON() and/or python_get_*() instead of ${FUNCNAME}()."
2111 die "${FUNCNAME}() cannot be used in this EAPI"
2112 fi
2113
2114 _python_set_color_variables
2115
2116 if [[ "${FUNCNAME[1]}" != "distutils_python_version" ]]; then
2117 echo
2118 echo " ${_RED}*${_NORMAL} ${_RED}Deprecation Warning: ${FUNCNAME}() is deprecated and will be banned on 2010-07-01.${_NORMAL}"
2119 echo " ${_RED}*${_NORMAL} ${_RED}Use PYTHON() instead of python variable. Use python_get_*() instead of PYVER* variables.${_NORMAL}"
2120 echo " ${_RED}*${_NORMAL} ${_RED}The ebuild needs to be fixed. Please report a bug, if it has not been already reported.${_NORMAL}"
2121 echo
2122
2123 einfo &> /dev/null
2124 einfo "Deprecation Warning: ${FUNCNAME}() is deprecated and will be banned on 2010-07-01." &> /dev/null
2125 einfo "Use PYTHON() instead of python variable. Use python_get_*() instead of PYVER* variables." &> /dev/null
2126 einfo "The ebuild needs to be fixed. Please report a bug, if it has not been already reported." &> /dev/null
2127 einfo &> /dev/null
2128 fi
2129
2130 [[ -n "${PYVER}" ]] && return 0
2131 local tmpstr
2132 python="${python:-${EPREFIX}/usr/bin/python}"
2133 tmpstr="$(EPYTHON= ${python} -V 2>&1 )"
2134 export PYVER_ALL="${tmpstr#Python }"
2135 export PYVER_MAJOR="${PYVER_ALL:0:1}"
2136 export PYVER_MINOR="${PYVER_ALL:2:1}"
2137 if [[ "${PYVER_ALL:3:1}" == "." ]]; then
2138 export PYVER_MICRO="${PYVER_ALL:4}"
2139 fi
2140 export PYVER="${PYVER_MAJOR}.${PYVER_MINOR}"
2141}
2142
2143# @FUNCTION: python_mod_exists
2144# @USAGE: <module>
2145# @DESCRIPTION:
2146# Run with the module name as an argument. It will check if a
2147# Python module is installed and loadable. It will return
2148# TRUE(0) if the module exists, and FALSE(1) if the module does
2149# not exist.
2150#
2151# Example:
2152# if python_mod_exists gtk; then
2153# echo "gtk support enabled"
2154# fi
2155python_mod_exists() {
2156 if ! has "${EAPI:-0}" 0 1 2 || _python_package_supporting_installation_for_multiple_python_abis; then
2157 eerror "Use USE dependencies and/or has_version() instead of ${FUNCNAME}()."
2158 die "${FUNCNAME}() cannot be used in this EAPI"
2159 fi
2160
2161 echo
2162 echo " ${_RED}*${_NORMAL} ${_RED}Deprecation Warning: ${FUNCNAME}() is deprecated and will be banned on 2010-07-01.${_NORMAL}"
2163 echo " ${_RED}*${_NORMAL} ${_RED}Use USE dependencies and/or has_version() instead of ${FUNCNAME}().${_NORMAL}"
2164 echo " ${_RED}*${_NORMAL} ${_RED}The ebuild needs to be fixed. Please report a bug, if it has not been already reported.${_NORMAL}"
2165 echo
2166
2167 einfo &> /dev/null
2168 einfo "Deprecation Warning: ${FUNCNAME}() is deprecated and will be banned on 2010-07-01." &> /dev/null
2169 einfo "Use USE dependencies and/or has_version() instead of ${FUNCNAME}()." &> /dev/null
2170 einfo "The ebuild needs to be fixed. Please report a bug, if it has not been already reported." &> /dev/null
2171 einfo &> /dev/null
2172
2173 if [[ "$#" -ne 1 ]]; then
2174 die "${FUNCNAME}() requires 1 argument"
2175 fi
2176 "$(PYTHON ${PYTHON_ABI})" -c "import $1" &> /dev/null
2177}
2178
2179# @FUNCTION: python_tkinter_exists
2180# @DESCRIPTION:
2181# Run without arguments, checks if Python was compiled with Tkinter
2182# support. If not, prints an error message and dies.
2183python_tkinter_exists() {
2184 if ! has "${EAPI:-0}" 0 1 2 || _python_package_supporting_installation_for_multiple_python_abis; then
2185 eerror "Use PYTHON_USE_WITH=\"xml\" and python_pkg_setup() instead of ${FUNCNAME}()."
2186 die "${FUNCNAME}() cannot be used in this EAPI"
2187 fi
2188
2189 if [[ "${FUNCNAME[1]}" != "distutils_python_tkinter" ]]; then
2190 echo
2191 echo " ${_RED}*${_NORMAL} ${_RED}Deprecation Warning: ${FUNCNAME}() is deprecated and will be banned on 2010-07-01.${_NORMAL}"
2192 echo " ${_RED}*${_NORMAL} ${_RED}Use PYTHON_USE_WITH=\"xml\" and python_pkg_setup() instead of ${FUNCNAME}().${_NORMAL}"
2193 echo " ${_RED}*${_NORMAL} ${_RED}The ebuild needs to be fixed. Please report a bug, if it has not been already reported.${_NORMAL}"
2194 echo
2195
2196 einfo &> /dev/null
2197 einfo "Deprecation Warning: ${FUNCNAME}() is deprecated and will be banned on 2010-07-01." &> /dev/null
2198 einfo "Use PYTHON_USE_WITH=\"xml\" and python_pkg_setup() instead of ${FUNCNAME}()." &> /dev/null
2199 einfo "The ebuild needs to be fixed. Please report a bug, if it has not been already reported." &> /dev/null
2200 einfo &> /dev/null
2201 fi
2202
2203 if ! "$(PYTHON ${PYTHON_ABI})" -c "from sys import version_info
2204if version_info[0] == 3:
2205 import tkinter
2206else:
2207 import Tkinter" &> /dev/null; then
2208 eerror "Python needs to be rebuilt with tkinter support enabled."
2209 eerror "Add the following line to '${EPREFIX}/etc/portage/package.use' and rebuild Python"
2210 eerror "dev-lang/python tk"
2211 die "Python installed without support for tkinter"
2212 fi
2213}
2214
2215# @FUNCTION: python_mod_compile
2216# @USAGE: <file> [more files ...]
2217# @DESCRIPTION:
2218# Given filenames, it will pre-compile the module's .pyc and .pyo.
2219# This function can be used only in pkg_postinst() phase.
2220#
2221# Example:
2222# python_mod_compile /usr/lib/python2.3/site-packages/pygoogle.py
2223#
2224python_mod_compile() {
2225 if ! has "${EAPI:-0}" 0 1 2 || _python_package_supporting_installation_for_multiple_python_abis; then
2226 eerror "Use python_mod_optimize() instead of ${FUNCNAME}()."
2227 die "${FUNCNAME}() cannot be used in this EAPI"
2228 fi
2229
2230 _python_initialize_prefix_variables
2231
2232 local f myroot myfiles=()
2233
2234 # Check if phase is pkg_postinst()
2235 [[ "${EBUILD_PHASE}" != "postinst" ]] && die "${FUNCNAME}() can be used only in pkg_postinst() phase"
2236
2237 # strip trailing slash
2238 myroot="${EROOT%/}"
2239
2240 # respect ROOT
2241 for f in "$@"; do
2242 [[ -f "${myroot}/${f}" ]] && myfiles+=("${myroot}/${f}")
2243 done
2244
2245 if ((${#myfiles[@]})); then
2246 "$(PYTHON ${PYTHON_ABI})" "${myroot}$(python_get_libdir)/py_compile.py" "${myfiles[@]}"
2247 "$(PYTHON ${PYTHON_ABI})" -O "${myroot}$(python_get_libdir)/py_compile.py" "${myfiles[@]}" &> /dev/null
2248 else
2249 ewarn "No files to compile!"
2250 fi
2251}

Legend:
Removed from v.1.82  
changed lines
  Added in v.1.95

  ViewVC Help
Powered by ViewVC 1.1.20