Python 3.6 or higher. Python 2 is not supported.
The required Python packages are the following:
argcomplete==1.12.3 coverage==5.5 importlib_metadata==4.0.1; python_version < '3.8' jsonschema==3.2.0 lxml==4.6.3 pytest==6.2.3 pytest-forked==1.3.0 pytest-parallel==0.1.0 PyYAML==5.4.1 requests==2.25.1 semver==2.13.0 setuptools==56.0.0 wcwidth==0.2.5 #+pygelf%pygelf==0.4.0
Changed in version 3.0: Support for Python 3.5 has been dropped.
Getting the Framework¶
Stable ReFrame releases are available through different channels.
ReFrame is available as a Spack package:
spack install reframe
There are the following variants available:
+docs: This will install the man pages of ReFrame.
+gelf: This will install the bindings for handling Graylog log messages.
ReFrame is available as an EasyBuild package:
eb ReFrame-VERSION.eb -r
This will install the man pages as well as the Graylog bindings.
ReFrame is available as a PyPI package:
pip install reframe-hpc
This is a bare installation of the framework. It will not install the documentation, the tutorial examples or the bindings for handling Graylog log messages.
Any ReFrame version can be very easily installed directly from Github:
pushd /path/to/install/prefix git clone -q --depth 1 --branch VERSION_TAG https://github.com/eth-cscs/reframe.git pushd reframe && ./bootstrap.sh && popd export PATH=$(pwd)/bin:$PATH popd
VERSION_TAG is the version number prefixed by
./bootstrap.sh script will fetch ReFrame’s requirements under its installation prefix.
It will not set the
PYTHONPATH, so it will not affect the user’s Python installation.
./bootstrap.sh has two additional variant options:
+docs: This will also build the documentation.
+pygelf: This will install the bindings for handling Graylog log messages.
New in version 3.1: The bootstrap script for ReFrame was added.
For previous ReFrame versions you should install its requirements using
pip install -r requirements.txt in a Python virtual environment.
New in version 3.4.1.
You can enable auto-completion for ReFrame by sourcing in your shell the corresponding script in
Auto-completion is supported for Bash, Tcsh and Fish shells.
Changed in version 3.4.2: The shell completion scripts have been moved under
Where to Go from Here¶
The easiest way to start with ReFrame is to go through Tutorial 1: Getting Started with ReFrame, which will guide you step-by-step in both writing your first tests and in configuring ReFrame. The Configuring ReFrame for Your Site page provides more details on the basic configuration aspects of ReFrame. Advanced Topics explain different aspects of the framework whereas ReFrame Manuals provide complete reference guides for the command line interface, the configuration parameters and the programming APIs for writing tests.