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

Diff of /eclass/python.eclass

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

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

Legend:
Removed from v.1.91  
changed lines
  Added in v.1.105

  ViewVC Help
Powered by ViewVC 1.1.20