spack/lib/spack/docs
Tamara Dahlgren 9a37c8fcb1
Stand-alone testing: make recipe support and processing spack-/pytest-like (#34236)
This is a refactor of Spack's stand-alone test process to be more spack- and pytest-like. 

It is more spack-like in that test parts are no longer "hidden" in a package's run_test()
method and pytest-like in that any package method whose name starts test_ 
(i.e., a "test" method) is a test part. We also support the ability to embed test parts in a
test method when that makes sense.

Test methods are now implicit test parts. The docstring is the purpose for the test part. 
The name of the method is the name of the test part. The working directory is the active
spec's test stage directory. You can embed test parts using the test_part context manager.

Functionality added by this commit:
* Adds support for multiple test_* stand-alone package test methods, each of which is 
   an implicit test_part for execution and reporting purposes;
* Deprecates package use of run_test();
* Exposes some functionality from run_test() as optional helper methods;
* Adds a SkipTest exception that can be used to flag stand-alone tests as being skipped;
* Updates the packaging guide section on stand-alone tests to provide more examples;
* Restores the ability to run tests "inherited" from provided virtual packages;
* Prints the test log path (like we currently do for build log paths);
* Times and reports the post-install process (since it can include post-install tests);
* Corrects context-related error message to distinguish test recipes from build recipes.
2023-05-10 11:34:54 +02:00
..
_gh_pages_redirect
_static
build_systems docs: mention cuda multi-arch capability (#36321) 2023-03-22 16:52:53 -04:00
example_files
images Allow for packages with multiple build-systems (#30738) 2022-10-26 20:17:32 +02:00
tables Getting Started: Python 2 is no longer supported (#33927) 2022-11-16 08:36:49 +01:00
.gitignore Fix broken links in docs (#35582) 2023-02-20 09:21:18 +01:00
basic_usage.rst Improve version, version range, and version list syntax and behavior (#36273) 2023-05-05 22:04:41 -06:00
binary_caches.rst Add spack buildcache push (alias to buildcache create) (#34861) 2023-05-05 19:54:26 +02:00
bootstrapping.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
build_settings.rst Add a "requires" directive, extend functionality of package requirements (#36286) 2023-05-08 10:12:26 -07:00
build_systems.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
chain.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
command_index.in
conf.py Stand-alone testing: make recipe support and processing spack-/pytest-like (#34236) 2023-05-10 11:34:54 +02:00
config_yaml.rst Fix broken links in docs (#35582) 2023-02-20 09:21:18 +01:00
configuration.rst Relax environment manifest filename requirements and lockfile identification criteria (#37413) 2023-05-05 07:40:49 -05:00
containers.rst Add 'zypper' to the valid container.os_packages options (#36681) 2023-05-03 13:05:14 +02:00
contribution_guide.rst Fix broken links in docs (#35582) 2023-02-20 09:21:18 +01:00
developer_guide.rst Fix case spelling for Lmod and Tcl (#36215) 2023-03-19 01:42:50 +00:00
environments.rst Relax environment manifest filename requirements and lockfile identification criteria (#37413) 2023-05-05 07:40:49 -05:00
extensions.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
features.rst Add a maintainers directive (#35083) 2023-01-27 07:51:24 +01:00
getting_started.rst docs: update RHEL/CentOS system prerequisites (#36720) 2023-05-03 19:04:16 +02:00
index.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
Makefile
mirrors.rst Relax environment manifest filename requirements and lockfile identification criteria (#37413) 2023-05-05 07:40:49 -05:00
module_file_generation.svg
module_file_support.rst modules tcl: switch default all:autoload from none to direct (#36269) 2023-03-23 07:49:17 +01:00
package_list.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
packaging_guide.rst Stand-alone testing: make recipe support and processing spack-/pytest-like (#34236) 2023-05-10 11:34:54 +02:00
pipelines.rst Ci backwards compat (#36045) 2023-04-10 16:46:45 -05:00
replace_conda_homebrew.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
repositories.rst Allow choosing the name of the packages subdirectory in repositories (#36643) 2023-05-04 23:36:21 +02:00
requirements.txt Place an upper bound on urllib3 to build docs (#37433) 2023-05-04 19:40:43 +02:00
spack.yaml license year bump (#34921) 2023-01-18 14:30:17 -08:00