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

Diff of /eclass/python.eclass

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

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

Legend:
Removed from v.1.72  
changed lines
  Added in v.1.97

  ViewVC Help
Powered by ViewVC 1.1.20