Merge branch 'master' into develop

vkarak · vkarak · commit 4b6f057fc3a2 · 2024-09-26T14:57:19.000+02:00
diff --git a/README.md b/README.md
@@ -97,3 +97,37 @@ Please join the community's [Slack channel](https://join.slack.com/t/reframetalk
 
 ReFrame is an open-source project and we welcome and encourage contributions!
 Check out our Contribution Guide [here](https://github.com/reframe-hpc/reframe/wiki/contributing-to-reframe).
+
+## Citing ReFrame
+
+You can cite ReFrame in publications as follows:
+
+> Vasileios Karakasis et al. "Enabling Continuous Testing of HPC Systems Using ReFrame". In: *Tools and Techniques for High Performance Computing. HUST - Annual Workshop on HPC User Support Tools* (Denver, Colorado, USA, Nov. 17–18, 2019). Ed. by Guido Juckeland and Sunita Chandrasekaran. Vol. 1190. Communications in Computer and Information Science. Cham, Switzerland: Springer International Publishing, Mar. 2020, pp. 49–68. isbn: 978-3-030-44728-1. doi: 10.1007/978-3-030-44728-1_3.
+
+The corresponding BibTeX entry is the following:
+
+```bibtex
+@InProceedings{karakasis20a,
+  author     = {Karakasis, Vasileios and Manitaras, Theofilos and Rusu, Victor Holanda and
+                Sarmiento-P{\'e}rez, Rafael and Bignamini, Christopher and Kraushaar, Matthias and
+                Jocksch, Andreas and Omlin, Samuel and Peretti-Pezzi, Guilherme and
+                Augusto, Jo{\~a}o P. S. C. and Friesen, Brian and He, Yun and Gerhardt, Lisa and
+                Cook, Brandon and You, Zhi-Qiang and Khuvis, Samuel and Tomko, Karen},
+  title      = {Enabling Continuous Testing of {HPC} Systems Using {ReFrame}},
+  booktitle  = {Tools and Techniques for High Performance Computing},
+  editor     = {Juckeland, Guido and Chandrasekaran, Sunita},
+  year       = {2020},
+  month      = mar,
+  series     = {Communications in Computer and Information Science},
+  volume     = {1190},
+  pages      = {49--68},
+  address    = {Cham, Switzerland},
+  publisher  = {Springer International Publishing},
+  doi        = {10.1007/978-3-030-44728-1_3},
+  venue      = {Denver, Colorado, USA},
+  eventdate  = {2019-11-17/2019-11-18},
+  eventtitle = {{HUST} - Annual Workshop on {HPC} User Support Tools},
+  isbn       = {978-3-030-44728-1},
+  issn       = {1865-0937},
+}
+```
diff --git a/README_minimal.md b/README_minimal.md
@@ -39,3 +39,37 @@ Please join the community's [Slack channel](https://reframe-slack.herokuapp.com)
 
 ReFrame is an open-source project and we welcome and encourage contributions!
 Check out our Contribution Guide [here](https://github.com/reframe-hpc/reframe/wiki/contributing-to-reframe).
+
+## Citing ReFrame
+
+You can cite ReFrame in publications as follows:
+
+> Vasileios Karakasis et al. “Enabling Continuous Testing of HPC Systems Using ReFrame”. In: *Tools and Techniques for High Performance Computing. HUST - Annual Workshop on HPC User Support Tools* (Denver, Colorado, USA, Nov. 17–18, 2019). Ed. by Guido Juckeland and Sunita Chandrasekaran. Vol. 1190. Communications in Computer and Information Science. Cham, Switzerland: Springer International Publishing, Mar. 2020, pp. 49–68. isbn: 978-3-030-44728-1. doi: 10.1007/978-3-030-44728-1_3.
+
+The corresponding BibTeX entry is the following:
+
+```bibtex
+@InProceedings{karakasis20a,
+  author     = {Karakasis, Vasileios and Manitaras, Theofilos and Rusu, Victor Holanda and
+                Sarmiento-P{\'e}rez, Rafael and Bignamini, Christopher and Kraushaar, Matthias and
+                Jocksch, Andreas and Omlin, Samuel and Peretti-Pezzi, Guilherme and
+                Augusto, Jo{\~a}o P. S. C. and Friesen, Brian and He, Yun and Gerhardt, Lisa and
+                Cook, Brandon and You, Zhi-Qiang and Khuvis, Samuel and Tomko, Karen},
+  title      = {Enabling Continuous Testing of {HPC} Systems Using {ReFrame}},
+  booktitle  = {Tools and Techniques for High Performance Computing},
+  editor     = {Juckeland, Guido and Chandrasekaran, Sunita},
+  year       = {2020},
+  month      = mar,
+  series     = {Communications in Computer and Information Science},
+  volume     = {1190},
+  pages      = {49--68},
+  address    = {Cham, Switzerland},
+  publisher  = {Springer International Publishing},
+  doi        = {10.1007/978-3-030-44728-1_3},
+  venue      = {Denver, Colorado, USA},
+  eventdate  = {2019-11-17/2019-11-18},
+  eventtitle = {{HUST} - Annual Workshop on {HPC} User Support Tools},
+  isbn       = {978-3-030-44728-1},
+  issn       = {1865-0937},
+}
+```
diff --git a/docs/index.rst b/docs/index.rst
@@ -18,6 +18,9 @@ Finally, ReFrame offers a powerful and efficient runtime for running and managin
 Publications
 ============
 
+Presentations & Talks
+---------------------
+
 * Slides [`pdf <https://users.ugent.be/~kehoste/eum24/008_eum24_ReFrame.pdf>`__][`talk <https://www.youtube.com/live/uSEeU-VJf6k?si=YB19mFpG6aAEBOgH>`__] @ `9th EasyBuild User Meeting 2024 <https://easybuild.io/eum24/>`__.
 * Slides [`part 1 <https://docs.google.com/presentation/d/1GmO2Uf29SaLg36bPB9g9eeaKMN-bLlDJ5IvLGLQJfD8/edit?usp=share_link>`__][`part 2 <https://drive.google.com/file/d/1gZwch0BPc1wDEkMwbM4vxCpMzWIx-Lo1/view?usp=sharing>`__][`talk <https://youtu.be/0ApEKc185Bw>`__] @ `8th EasyBuild User Meeting 2023 <https://easybuild.io/eum23/>`__.
 * Slides [`pdf <https://drive.google.com/file/d/1vmaWyRHgtq3DrYhSCVBzR8U5ErKbxGNf/view?usp=sharing>`__] @ `7th EasyBuild User Meeting 2022 <https://easybuild.io/eum22/>`__.
@@ -32,18 +35,26 @@ Publications
 * Slides [`pdf <https://github.com/eth-cscs/UserLabDay/blob/master/2018/slides/ci_and_regression/ReFrame_CI.pdf>`__] @ `CSCS User Lab Day 2018 <https://github.com/eth-cscs/UserLabDay>`__.
 * Slides [`pdf <https://drive.google.com/open?id=1sZhibvUlGlT670aOHPdMlWFffWptYzLX>`__] @ `HPC Advisory Council 2018 <http://www.hpcadvisorycouncil.com/events/2018/swiss-workshop/>`__.
 * Slides [`pdf <https://drive.google.com/open?id=1EyJ-siupkgLeVT54A4WlFpQtrJaU0xOy>`__] @ `SC17 <https://sc17.supercomputing.org/>`__.
-* Slides [`pdf <https://drive.google.com/open?id=18VrCy0MTplGo67uxVbzYZicQChor9VSY>`__] @ `CUG 2017 <https://cug.org/cug-2017/>`__.
+* Slides [`pdf <https://cug.org/proceedings/cug2017_proceedings/includes/files/pap122s2-file2.pdf>`__] @ `CUG 2017 <https://cug.org/cug-2017/>`__.
 
 
-Webinars and Tutorials
-======================
+Webinars & Tutorials
+--------------------
 
 * "ReFrame – Efficient System and Application Performance Testing," CSCS Webinar, Aug. 29, 2022 [`slides <https://drive.google.com/file/d/1nOS_daleR79ZB1IaToVdW5mDpJQYRcY2/view?usp=sharing>`__] [`recording <https://youtu.be/NDxlKATEcQk>`__] [`demo run <https://asciinema.org/a/517693>`__].
 * Tutorial at 6th EasyBuild User Meeting 2021 [`YouTube <https://youtube.com/playlist?list=PLhnGtSmEGEQjySVEPTUSLpewpOWwX5mjb>`__]
 
 
+Papers
+------
+
+- Vasileios Karakasis et al. "A regression framework for checking the health of large HPC systems". In: *Cray User Group 2017* (Redmond, Washington, USA, May 8--11, 2017). [`pdf <https://cug.org/proceedings/cug2017_proceedings/includes/files/pap122s2-file1.pdf>`__]
+
+- Vasileios Karakasis et al. "Enabling Continuous Testing of HPC Systems Using ReFrame". In: *Tools and Techniques for High Performance Computing. HUST -- Annual Workshop on HPC User Support Tools* (Denver, Colorado, USA, Nov. 17--18, 2019). Ed. by Guido Juckeland and Sunita Chandrasekaran. Vol. 1190. Communications in Computer and Information Science. Cham, Switzerland: Springer International Publishing, Mar. 2020, pp. 49--68. isbn: 978-3-030-44728-1. doi: `10.1007/978-3-030-44728-1_3 <https://doi.org/10.1007/978-3-030-44728-1_3>`__.
+
 
 .. toctree::
+   :maxdepth: 2
    :caption: Table of Contents
 
    started
diff --git a/docs/manpage.rst b/docs/manpage.rst
@@ -1003,7 +1003,7 @@ The way the tests are generated and how they interact with the test filtering op
    - ``avail``: Tests will run on all the nodes of their respective valid partitions that are available for running jobs.
      Note that if a node is currently allocated to another job it is still considered as "available."
    - ``NODESTATE``: Tests will run on all the nodes of their respective valid partitions that are exclusively in state ``NODESTATE``.
-     aIf ``NODESTATE`` is not specified, ``idle`` is assumed.
+     If ``NODESTATE`` is not specified, ``idle`` is assumed.
    - ``NODESTATE*``: Tests will run on all the nodes of their respective valid partitions that are at least in state ``NODESTATE``.
 
    The state of the nodes will be determined once, before beginning the
diff --git a/docs/started.rst b/docs/started.rst
@@ -20,8 +20,8 @@ Requirements
 
 
 .. warning::
-   Although ReFrame supports Python 3.6, you should note that Python 3.6 has reached its end-of-life and you are advised to use a newer Python version.
-   ReFrame installations on Python 3.6 may use out-of-date dependencies due to incompatibilities of their newer versions with Python 3.6.
+   Although ReFrame supports Python 3.6 and 3.7, you should note that these Python versions have reached end-of-life and you are strongly advised to use a newer version.
+   ReFrame installations on these Python versions may use out-of-date dependencies due to incompatibilities.
 
 
 Getting the Framework
diff --git a/reframe/frontend/cli.py b/reframe/frontend/cli.py
@@ -1180,6 +1180,7 @@ def print_infoline(param, value):
         'settings files',
         ', '.join(repr(x) for x in session_info['config_files'])
     )
+    print_infoline('selected system', repr(rt.system.name))
     print_infoline('check search path',
                    f"{'(R) ' if loader.recurse else ''}"
                    f"{':'.join(loader.load_path)!r}")

Original file line number	Diff line number	Diff line change
`@@ -1180,6 +1180,7 @@ def print_infoline(param, value):`
`1180`	`1180`	`'settings files',`
`1181`	`1181`	`', '.join(repr(x) for x in session_info['config_files'])`
`1182`	`1182`	`)`
	`1183`	`+ print_infoline('selected system', repr(rt.system.name))`
`1183`	`1184`	`print_infoline('check search path',`
`1184`	`1185`	`f"{'(R) ' if loader.recurse else ''}"`
`1185`	`1186`	`f"{':'.join(loader.load_path)!r}")`