How to test a Spack package on AWS
==================================

Follow this guide to validate a Spack package on AWS once the package is already loaded. This guide
focuses on running the package smoke tests with Spack.

Related
-------

- :doc:`How to load Spack modules on AWS <aws-load-spack-modules>`
- :doc:`How to start an interactive compute node on AWS <aws-interactive-compute-node>`
- `Accessing the clusters (Confluence)
  <https://confluence.skatelescope.org/display/SE/Accessing+the+clusters>`_

Prerequisites
-------------

- Access to the SDP AWS environment (headnode or interactive compute node).
- A loaded SDP Spack environment (``module load ska-sdp-spack``)
- The package to test is already loaded (``module load <package_to_test>``)

Steps
-----

1. Log in to AWS and start an interactive compute node if needed for heavier tests.
2. Check that the package is available in the loaded Spack environment.

   .. code-block:: bash

       spack find <package_to_test>

3. Run the package smoke tests.

   .. code-block:: bash

       spack test run <package_to_test>

4. Optionally, inspect recent test logs for additional details.

   .. code-block:: bash

       spack test list
       spack test results

Verification
------------

The test is successful when:

- ``spack test run <package_to_test>`` starts and finishes successfully.
- ``spack test results`` shows passing status for the package test suite.