pytest documentation

python/testing/pytest/README.md

@@ -25,6 +25,27 @@ To add configuration to `pytest` that is shared with any other usage of pytest (
 pre-commit, etc.), you can use the `pytest.ini` or `pyproject.toml` configuration files. Learn more
 about [pytest configuration](https://docs.pytest.org/en/stable/customize.html) files.
 
+## Multiple pytest Jobs in the same pipeline
+
+You can run this pytest job multiple times in the same pipeline (e.g. to test multiple python version
+or different namespaces) using extends GitLab keyword.
+
+```yaml
+stages:
+    - test
+
+include:
+    - remote: 'https://api.r2devops.io/job/r/gitlab/dorianturba/r2devops_catalog/pytest@latest.yaml'
+
+# Compatibility tests
+pytest_3.10:
+    extends: pytest
+    variables:
+        IMAGE_TAG: "3.10"
+```
+
+https://docs.r2devops.io/get-started/use-templates/#multiple-usage-of-the-same-job-template-in-your-pipeline
+
 ## Add a <a href="https://docs.pytest.org/en/latest/"><img alt="Tested with pytest" src="https://img.shields.io/badge/Tested%20with-pytest-green"></a> Badge to your project README.md
 
 To display the use of pytest in your project, you can add the following badge to your README.md: