fixture tutorial, first iteration

Author: spjuhel

climada/test/common_test_fixtures.py

@@ -20,7 +20,9 @@
     "Writing tests is work. As a matter of facts, it can be a _lot_ of work, depending on the program often more than writing the original code.\\\n",
     "Luckily, it essentially follows always the same basic procedure and a there are a lot of tools and frameworks available to facilitate this work.\n",
     "\n",
-    "In CLIMADA we use the Python in-built _test runner_ [pytest](https://docs.pytest.org/en/7.1.x/index.html) for execution of the tests."
+    "In CLIMADA we use the Python in-built _test runner_ [pytest](https://docs.pytest.org/en/7.1.x/index.html) for execution of the tests.\n",
+    "\n",
+    "We now leverage `pytest` fixtures for defining the data and context used by tests. Please read [how to use fixtures for testing in CLIMADA](Guide_test_fixtures.ipynb)."
    ]
   },
   {
@@ -53,7 +55,6 @@
   },
   {
    "cell_type": "markdown",
-   "id": "5819e8c6",
    "metadata": {},
    "source": [
     "### Basic Test Procedure\n",
@@ -277,7 +278,9 @@
    "source": [
     "### Test Configuration\n",
     "\n",
-    "Use the configuration file `climada.config` in the installation directory to define file paths and external resources used during tests (see the [Constants and Configuration Guide](./Guide_Configuration.ipynb))."
+    "Integration tests should make use of the fixtures defined in `climada/test/conftest.py`. Learn how to do that in [how to use fixtures for testing in CLIMADA](Guide_test_fixtures.ipynb).\n",
+    "\n",
+    "Test data can also use paths defined in the configuration file `climada.config` (in the installation directory) which define file paths and external resources to be used during tests (see the [Constants and Configuration Guide](./Guide_Configuration.ipynb))."
    ]
   },
   {
@@ -334,9 +337,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "Python [conda env:climada_env_dev]",
    "language": "python",
-   "name": "python3"
+   "name": "conda-env-climada_env_dev-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -348,7 +351,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.6"
+   "version": "3.11.15"
   },
   "vscode": {
    "interpreter": {