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

Diff of /eclass/python.eclass

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

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

Legend:
Removed from v.1.53  
changed lines
  Added in v.1.100

  ViewVC Help
Powered by ViewVC 1.1.20