zhangyiss/spack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
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
1 changed files with 15 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
lib/spack/docs/packaging_guide.rst
View File

@ -4192,9 +4192,11 @@ outputs can be added for use in these tests.
Configuring the test stage directory Configuring the test stage directory
"""""""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""""""
The default stand-alone test stage directory, ``~/.spack/test``, is Stand-alone tests rely on a stage directory for building, running,
defined in :ref:`etc/spack/defaults/config.yaml <config-yaml>`. and tracking results.
You can change the location in the high-level ``config`` by adding 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`` or changing the ``test_stage`` path in the appropriate ``config.yaml``
file such that: file such that:
@ -4203,6 +4205,16 @@ file such that:
config: config:
test_stage: /path/to/stage 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 Enabling test compilation
""""""""""""""""""""""""" """""""""""""""""""""""""