docs/packaging guide: Reference test stage directory (#23707)

This commit is contained in:
Tamara Dahlgren 2021-05-18 17:56:38 -07:00 committed by GitHub
parent ce7516f25f
commit 5bd42d1b31
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -4192,9 +4192,11 @@ outputs can be added for use in these tests.
Configuring the test stage directory
""""""""""""""""""""""""""""""""""""
The default stand-alone test stage directory, ``~/.spack/test``, is
defined in :ref:`etc/spack/defaults/config.yaml <config-yaml>`.
You can change the location in the high-level ``config`` by adding
Stand-alone tests rely on a stage directory for building, running,
and tracking results.
The default directory, ``~/.spack/test``, is defined in
:ref:`etc/spack/defaults/config.yaml <config-yaml>`.
You can configure the location in the high-level ``config`` by adding
or changing the ``test_stage`` path in the appropriate ``config.yaml``
file such that:
@ -4203,6 +4205,16 @@ file such that:
config:
test_stage: /path/to/stage
The package can access this path **during test processing** using
`self.test_suite.stage`.
.. note::
The test stage path is established for the entire suite. That
means it is the root directory for all specs being installed
with the same `spack test run` command. Each spec gets its
own stage subdirectory.
"""""""""""""""""""""""""
Enabling test compilation
"""""""""""""""""""""""""