Add an `EPYTEST_XDIST` variable that can be used to enable running
the test suite in parallel via the dev-python/pytest-xdist plugin.
This also includes user-facing `EPYTEST_JOBS` to control the job count
independently of `MAKEOPTS`.

Signed-off-by: Michał Górny <mgo...@gentoo.org>
---
 eclass/python-utils-r1.eclass | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/eclass/python-utils-r1.eclass b/eclass/python-utils-r1.eclass
index 4a538f9942f6..f2a8d4d0f65e 100644
--- a/eclass/python-utils-r1.eclass
+++ b/eclass/python-utils-r1.eclass
@@ -1307,6 +1307,19 @@ _python_check_occluded_packages() {
 # parameter, when calling epytest.  The listed files will be entirely
 # skipped from test collection.
 
+# @VARIABLE: EPYTEST_XDIST
+# @DEFAULT_UNSET
+# @DESCRIPTION:
+# If set to a non-empty value, enables running tests in parallel
+# via pytest-xdist plugin.
+
+# @VARIABLE: EPYTEST_JOBS
+# @USER_VARIABLE
+# @DEFAULT_UNSET
+# @DESCRIPTION:
+# Specifies the number of jobs for parallel (pytest-xdist) test runs.
+# When unset, defaults to -j from MAKEOPTS, or the current nproc.
+
 # @FUNCTION: epytest
 # @USAGE: [<args>...]
 # @DESCRIPTION:
@@ -1371,6 +1384,22 @@ epytest() {
                -p no:plus
                -p no:tavern
        )
+
+       if [[ ${EPYTEST_XDIST} ]]; then
+               local jobs=${EPYTEST_JOBS:-$(makeopts_jobs)}
+               if [[ ${jobs} -gt 1 ]]; then
+                       args+=(
+                               # explicitly enable the plugin, in case the 
ebuild was using
+                               # PYTEST_DISABLE_PLUGIN_AUTOLOAD=1
+                               -p xdist
+                               -n "${jobs}"
+                               # worksteal ensures that workers don't end up 
idle when heavy
+                               # jobs are unevenly distributed
+                               --dist=worksteal
+                       )
+               fi
+       fi
+
        local x
        for x in "${EPYTEST_DESELECT[@]}"; do
                args+=( --deselect "${x}" )
-- 
2.42.0


Reply via email to