excel2moodle 0.6.1__tar.gz → 0.6.3__tar.gz

{excel2moodle-0.6.1/excel2moodle.egg-info → excel2moodle-0.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: excel2moodle
-Version: 0.6.1
+Version: 0.6.3
 Summary: A package for converting questions from a spreadsheet, to valid moodle-xml
 Author: Jakob Bosse
 License-Expression: GPL-3.0-or-later
@@ -17,16 +17,20 @@ Requires-Dist: lxml>=5.4.0
 Requires-Dist: asteval>=1.0.6
 Requires-Dist: python-calamine>=0.3.2
 Requires-Dist: pyside6-essentials>=6.8.0
+Requires-Dist: pyyaml>=6.0.2
 Dynamic: license-file
 
 # excel 2 Moodle
-![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=35%}
+![Logo](https://gitlab.com/jbosse3/-/blob/master/excel2moodleLogo.png "Logo excel2moodle"){width=35%}
 
-This Python program helps to create Moodle questions in less time.
-The idea is to write the questions data into a spreadsheet file, from which the program generates the moodle compliant xml Files. 
-All questions or a selection of questions can be exported into one xml file to be imported into moodle.
+*excel2moodle* helps to create Moodle questions in less time.
+The idea is to write the questions data into a spreadsheet file, from which the *excel2moodle* generates moodle compliant xml Files. 
+All questions or a selection of questions can then be imported into moodle.
 
 ## Concept
+At the heart the *excel2moodle* is a simple key-value-pair "syntax", where the key is set once in the first spreadsheet column.
+Each key can be provided with a value for each question in its column
+To enhance reusability, key values which are correct for more than one question can be set per category or for all questions.
 The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
 
 A `settings` sheet contains global settings to be used for all questions and categories.
@@ -41,33 +45,38 @@ If you already have python and uv installed, it is as easy as running `uv tool i
 
 ### [ Documentation ](https://jbosse3.gitlab.io/excel2moodle/index.html)
 Once excel2moodle is installed you can checkout the [example question sheet](https://gitlab.com/jbosse3/excel2moodle/-/tree/master/example?ref_type=heads) 
-in the repository.
+in the repository. You need to download all Files in the `example` directory and save them together.
 
-Some steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
+Most steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
 you can follow along.
 
 And please have a look into the [**user Reference**](https://jbosse3.gitlab.io/excel2moodle/userReference.html)
 of the documentation. 
-That part explains each part of defining a question.
+That part explains in more detail each part of defining a question.
 
 
-## Functionality
-* Equation Verification:
-    + this tool helps you to validate the correct equation for the parametrized Questions.
-* Question Preview:
+## Features
+- Fully parametrized numeric questions:
+    * Formulas for the calculated results can be coded into extensive python modules, which can be loaded.
+- Question Preview:
     + This helps you when selecting the correct questions for the export.
-* Export Options:
+- Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+- Variable Generation:
+    + You can generate variables for the parametric Question to easily create hundreds of different variants of the same question.
+- Export Options:
     + you can export the questions preserving the categories in moodle
 
 ### Question Types
-* Generate multiple Choice Questions:
-    + The answers can be pictures or normal text
-* Generate Numeric Questions
-* Generate parametrized numeric Questions
-* Generate parametrized cloze Questions
+- Generate multiple Choice Questions:
+    * The answers can be pictures or normal text
+- Generate Numeric Questions
+- Generate parametrized numeric Questions:
+    * With the parametrization *excel2moodle* calculats the numeric answer from a given formula based on a set of variables.
+- Generate parametrized cloze Questions
 
 
-![MainWindow](mainWindow.png "Logo excel2moodle"){width=80%}
+![MainWindow](https://gitlab.com/jbosse3/-/blob/master/mainWindow.png "Logo excel2moodle"){width=80%}
 
 ## Licensing and authorship
 excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
@@ -81,6 +90,44 @@ If You want to support my work as well, you can by me a [coffee](https://ko-fi.c
 
 # Changelogs
 
+## 0.6.3 (2025-08-03)
+Lots of small improvements made
+
+### improvement (3 changes)
+
+- [small logging improvements and error handling](https://gitlab.com/jbosse3/excel2moodle/-/commit/149f8e923a06d9d7077fe90c7005a3e1d5d2d42f)
+- [Make variable generator rules editable](https://gitlab.com/jbosse3/excel2moodle/-/commit/80ea32d97bdec16b77100bc870a0e0272a739dd4)
+- [Variable generator only generates unique sets.](https://gitlab.com/jbosse3/excel2moodle/-/commit/d347c91bbac66de1da157fee4f76faf8d4636557)
+
+### bugfix (3 changes)
+
+- [mixed parametric and non parametric Bullets are working now](https://gitlab.com/jbosse3/excel2moodle/-/commit/f094b13dffd4b6b7ac1a03fc7e34eec6e8d1bfa7)
+- [Loglevel setting is respected in spreadsheet file](https://gitlab.com/jbosse3/excel2moodle/-/commit/d6ef89beeec94f24782a00b7564883074badf72d)
+- [Treewidget variants count updated after variable generation](https://gitlab.com/jbosse3/excel2moodle/-/commit/c48a0d093a0cce85fd3e9c3c091eef936739c02b)
+
+### feature (2 changes)
+
+- [Category ID taken from any number in its name](https://gitlab.com/jbosse3/excel2moodle/-/commit/ac7e19af5f25ac2e576b63c478e7b07153e782ef)
+- [Implemented Update Check on Startup](https://gitlab.com/jbosse3/excel2moodle/-/commit/a143edd47f566c5e731c05612f4ac21dc7728eb7)
+
+## 0.6.2 (2025-08-02)
+Adding export options and fixing cloze points bug
+
+### feature (4 changes)
+
+- [Added export options to include all Question Variants and generate report](https://gitlab.com/jbosse3/excel2moodle/-/commit/6433615de23174451748b69669a9dce748dd5b4d)
+- [Implemented export dialog generator method](https://gitlab.com/jbosse3/excel2moodle/-/commit/a8eda982309bf9a6dae7ef2b261a59654f2c8910)
+- [Answer Feedback strings settable in sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/ad90da49ac60e429ad3243f54846b08f0caf5bc7)
+- [Inverted result and feedback for NFM & Cloze questions](https://gitlab.com/jbosse3/excel2moodle/-/commit/57d77c83a661398b0082f84d25e5447000df9096)
+
+### improvement (1 change)
+
+- [Missing `settings` sheet raises an error](https://gitlab.com/jbosse3/excel2moodle/-/commit/e1cc42c1d31981bf74582b23c24c6ac378e9256d)
+
+### bugfix (1 change)
+
+- [resolve cloze moodle import error due to float points](https://gitlab.com/jbosse3/excel2moodle/-/commit/f13b7b9df39df55d65b6063a9deb1fc1c72f5ebb)
+
 ## 0.6.1 (2025-07-12)
 Fixing import error caused by dumping pyside meta package
 

{excel2moodle-0.6.1 → excel2moodle-0.6.3}/README.md

@@ -1,11 +1,14 @@
 # excel 2 Moodle
-![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=35%}
+![Logo](https://gitlab.com/jbosse3/-/blob/master/excel2moodleLogo.png "Logo excel2moodle"){width=35%}
 
-This Python program helps to create Moodle questions in less time.
-The idea is to write the questions data into a spreadsheet file, from which the program generates the moodle compliant xml Files. 
-All questions or a selection of questions can be exported into one xml file to be imported into moodle.
+*excel2moodle* helps to create Moodle questions in less time.
+The idea is to write the questions data into a spreadsheet file, from which the *excel2moodle* generates moodle compliant xml Files. 
+All questions or a selection of questions can then be imported into moodle.
 
 ## Concept
+At the heart the *excel2moodle* is a simple key-value-pair "syntax", where the key is set once in the first spreadsheet column.
+Each key can be provided with a value for each question in its column
+To enhance reusability, key values which are correct for more than one question can be set per category or for all questions.
 The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
 
 A `settings` sheet contains global settings to be used for all questions and categories.
@@ -20,33 +23,38 @@ If you already have python and uv installed, it is as easy as running `uv tool i
 
 ### [ Documentation ](https://jbosse3.gitlab.io/excel2moodle/index.html)
 Once excel2moodle is installed you can checkout the [example question sheet](https://gitlab.com/jbosse3/excel2moodle/-/tree/master/example?ref_type=heads) 
-in the repository.
+in the repository. You need to download all Files in the `example` directory and save them together.
 
-Some steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
+Most steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
 you can follow along.
 
 And please have a look into the [**user Reference**](https://jbosse3.gitlab.io/excel2moodle/userReference.html)
 of the documentation. 
-That part explains each part of defining a question.
+That part explains in more detail each part of defining a question.
 
 
-## Functionality
-* Equation Verification:
-    + this tool helps you to validate the correct equation for the parametrized Questions.
-* Question Preview:
+## Features
+- Fully parametrized numeric questions:
+    * Formulas for the calculated results can be coded into extensive python modules, which can be loaded.
+- Question Preview:
     + This helps you when selecting the correct questions for the export.
-* Export Options:
+- Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+- Variable Generation:
+    + You can generate variables for the parametric Question to easily create hundreds of different variants of the same question.
+- Export Options:
     + you can export the questions preserving the categories in moodle
 
 ### Question Types
-* Generate multiple Choice Questions:
-    + The answers can be pictures or normal text
-* Generate Numeric Questions
-* Generate parametrized numeric Questions
-* Generate parametrized cloze Questions
+- Generate multiple Choice Questions:
+    * The answers can be pictures or normal text
+- Generate Numeric Questions
+- Generate parametrized numeric Questions:
+    * With the parametrization *excel2moodle* calculats the numeric answer from a given formula based on a set of variables.
+- Generate parametrized cloze Questions
 
 
-![MainWindow](mainWindow.png "Logo excel2moodle"){width=80%}
+![MainWindow](https://gitlab.com/jbosse3/-/blob/master/mainWindow.png "Logo excel2moodle"){width=80%}
 
 ## Licensing and authorship
 excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
@@ -60,6 +68,44 @@ If You want to support my work as well, you can by me a [coffee](https://ko-fi.c
 
 # Changelogs
 
+## 0.6.3 (2025-08-03)
+Lots of small improvements made
+
+### improvement (3 changes)
+
+- [small logging improvements and error handling](https://gitlab.com/jbosse3/excel2moodle/-/commit/149f8e923a06d9d7077fe90c7005a3e1d5d2d42f)
+- [Make variable generator rules editable](https://gitlab.com/jbosse3/excel2moodle/-/commit/80ea32d97bdec16b77100bc870a0e0272a739dd4)
+- [Variable generator only generates unique sets.](https://gitlab.com/jbosse3/excel2moodle/-/commit/d347c91bbac66de1da157fee4f76faf8d4636557)
+
+### bugfix (3 changes)
+
+- [mixed parametric and non parametric Bullets are working now](https://gitlab.com/jbosse3/excel2moodle/-/commit/f094b13dffd4b6b7ac1a03fc7e34eec6e8d1bfa7)
+- [Loglevel setting is respected in spreadsheet file](https://gitlab.com/jbosse3/excel2moodle/-/commit/d6ef89beeec94f24782a00b7564883074badf72d)
+- [Treewidget variants count updated after variable generation](https://gitlab.com/jbosse3/excel2moodle/-/commit/c48a0d093a0cce85fd3e9c3c091eef936739c02b)
+
+### feature (2 changes)
+
+- [Category ID taken from any number in its name](https://gitlab.com/jbosse3/excel2moodle/-/commit/ac7e19af5f25ac2e576b63c478e7b07153e782ef)
+- [Implemented Update Check on Startup](https://gitlab.com/jbosse3/excel2moodle/-/commit/a143edd47f566c5e731c05612f4ac21dc7728eb7)
+
+## 0.6.2 (2025-08-02)
+Adding export options and fixing cloze points bug
+
+### feature (4 changes)
+
+- [Added export options to include all Question Variants and generate report](https://gitlab.com/jbosse3/excel2moodle/-/commit/6433615de23174451748b69669a9dce748dd5b4d)
+- [Implemented export dialog generator method](https://gitlab.com/jbosse3/excel2moodle/-/commit/a8eda982309bf9a6dae7ef2b261a59654f2c8910)
+- [Answer Feedback strings settable in sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/ad90da49ac60e429ad3243f54846b08f0caf5bc7)
+- [Inverted result and feedback for NFM & Cloze questions](https://gitlab.com/jbosse3/excel2moodle/-/commit/57d77c83a661398b0082f84d25e5447000df9096)
+
+### improvement (1 change)
+
+- [Missing `settings` sheet raises an error](https://gitlab.com/jbosse3/excel2moodle/-/commit/e1cc42c1d31981bf74582b23c24c6ac378e9256d)
+
+### bugfix (1 change)
+
+- [resolve cloze moodle import error due to float points](https://gitlab.com/jbosse3/excel2moodle/-/commit/f13b7b9df39df55d65b6063a9deb1fc1c72f5ebb)
+
 ## 0.6.1 (2025-07-12)
 Fixing import error caused by dumping pyside meta package
 

{excel2moodle-0.6.1 → excel2moodle-0.6.3}/excel2moodle/__init__.py

@@ -45,6 +45,8 @@ if __package__ is not None:
         "documentation": "https://jbosse3.gitlab.io/excel2moodle",
         "homepage": meta["project-url"].split()[1],
         "issues": "https://gitlab.com/jbosse3/excel2moodle/issues",
+        "funding": "https://ko-fi.com/jbosse3",
+        "API_id": "jbosse3%2Fexcel2moodle",
     }
 
 

{excel2moodle-0.6.1 → excel2moodle-0.6.3}/excel2moodle/__main__.py

@@ -5,17 +5,20 @@ import signal
 import sys
 from pathlib import Path
 
+from PySide6.QtCore import QTimer
 from PySide6.QtWidgets import QApplication
 
 import excel2moodle
-from excel2moodle import e2mMetadata, mainLogger
+from excel2moodle import __version__, e2mMetadata, mainLogger
 from excel2moodle.core import dataStructure
 from excel2moodle.core.settings import Settings, Tags
+from excel2moodle.extra import updateQuery
 from excel2moodle.logger import loggerConfig
 from excel2moodle.ui import appUi as ui
 
 
 def main() -> None:
+    app = QApplication(sys.argv)
     excel2moodle.isMain = True
     settings = Settings()
     logfile = Path(settings.get(Tags.LOGFILE)).resolve()
@@ -24,12 +27,24 @@ def main() -> None:
         logfile.replace(f"{logfile}.old")
     logConfig.dictConfig(config=loggerConfig)
     signal.signal(signal.SIGINT, signal.SIG_DFL)
-    app = QApplication(sys.argv)
-    settings = Settings()
     database: dataStructure.QuestionDB = dataStructure.QuestionDB(settings)
     window = ui.MainWindow(settings, database)
     database.window = window
     window.show()
+    # Update check
+    latestTag = updateQuery.get_latest_tag(e2mMetadata.get("API_id"))
+    if latestTag is None:
+        mainLogger.warning(
+            "Couldn't check for Updates, maybe there is  no internet connection"
+        )
+    if latestTag is not None and latestTag.strip("v") != __version__:
+        mainLogger.warning(
+            "A new Update is available: %s --> %s ", __version__, latestTag
+        )
+        changelog = updateQuery.get_changelog(e2mMetadata.get("API_id"))
+        # Delay showing the update dialog slightly
+        QTimer.singleShot(100, lambda: window.showUpdateDialog(changelog, latestTag))
+
     for k, v in e2mMetadata.items():
         msg = f"{k:^14s}:  {v}"
         mainLogger.info(msg)

{excel2moodle-0.6.1 → excel2moodle-0.6.3}/excel2moodle/core/bullets.py

@@ -15,7 +15,7 @@ class BulletList:
     def __init__(self, rawBullets: list[str], qID: str) -> None:
         self.rawBullets: list[str] = rawBullets
         self.element: ET.Element = ET.Element("ul")
-        self.bullets: dict[str, BulletP] = {}
+        self.bullets: dict[str | int, BulletP] = {}
         self.id = qID
         self.logger = LogAdapterQuestionID(loggerObj, {"qID": self.id})
         self._setupBullets(rawBullets)
@@ -70,7 +70,7 @@ class BulletList:
             if match is None:
                 self.logger.debug("Got a normal bulletItem")
                 num: float = float(quant.replace(",", "."))
-                bulletName: str = str(i + 1)
+                bulletName = i + 1
             else:
                 bulletName = match.group(1)
                 num: float = 0.0

{excel2moodle-0.6.1 → excel2moodle-0.6.3}/excel2moodle/core/category.py

@@ -5,10 +5,9 @@ from typing import TYPE_CHECKING
 import lxml.etree as ET
 import pandas as pd
 
-from excel2moodle.core.settings import Tags
-
 if TYPE_CHECKING:
     from excel2moodle.core.question import Question
+from excel2moodle.core.settings import Tags
 
 loggerObj = logging.getLogger(__name__)
 
@@ -25,12 +24,13 @@ class Category:
     ) -> None:
         """Instantiate a new Category object."""
         self.NAME = name
-        match = re.search(r"\d+$", str(self.NAME))
-        self.n: int = int(match.group(0)) if match else 99
+        match = re.search(r"\d+", str(self.NAME))
+        n = int(match.group(0)) if match else 99
+        self.n: int = n if n <= 99 and n >= 0 else 99
         self.desc = str(description)
         self.dataframe: pd.DataFrame = dataframe
         self.settings: dict[str, float | str] = settings if settings else {}
-        self.questions: dict[int, Question] = {}
+        self._questions: dict[int, Question]
         self.maxVariants: int | None = None
         loggerObj.info("initializing Category %s", self.NAME)
 
@@ -50,6 +50,18 @@ class Category:
     def id(self) -> str:
         return f"{self.n:02d}"
 
+    @property
+    def questions(self) -> dict:
+        if not hasattr(self, "_questions"):
+            msg = f"Category {self.id} doesn't contain any valid questions."
+            raise ValueError(msg)
+        return self._questions
+
+    def appendQuestion(self, questionNumber: int, question) -> None:
+        if not hasattr(self, "_questions"):
+            self._questions: dict[int, Question] = {}
+        self._questions[questionNumber] = question
+
     def __hash__(self) -> int:
         return hash(self.NAME)
 
@@ -58,13 +70,20 @@ class Category:
             return self.NAME == other.NAME
         return False
 
-    def getCategoryHeader(self) -> ET.Element:
+    def getCategoryHeader(self, subCategory: str | None = None) -> ET.Element:
         """Insert an <question type='category'> before all Questions of this Category."""
         header = ET.Element("question", type="category")
         cat = ET.SubElement(header, "category")
         info = ET.SubElement(header, "info", format="html")
-        ET.SubElement(cat, "text").text = f"$module$/top/{self.NAME}"
+        catStr = (
+            f"$module$/top/{self.NAME}"
+            if subCategory is None
+            else f"$module$/top/{self.NAME}/Question-{subCategory[2:]}_Variants"
+        )
+        ET.SubElement(cat, "text").text = catStr
         ET.SubElement(info, "text").text = str(self.desc)
-        ET.SubElement(header, "idnumber").text = self.id
+        ET.SubElement(header, "idnumber").text = (
+            f"cat-{self.id}" if subCategory is None else f"variants-{subCategory}"
+        )
         ET.indent(header)
         return header

{excel2moodle-0.6.1 → excel2moodle-0.6.3}/excel2moodle/core/dataStructure.py

@@ -3,6 +3,7 @@
 At the heart is the class ``xmlTest``
 """
 
+import datetime as dt
 import logging
 import sys
 from concurrent.futures import ProcessPoolExecutor, as_completed
@@ -11,14 +12,16 @@ from typing import TYPE_CHECKING
 
 import lxml.etree as ET  # noqa: N812
 import pandas as pd
+import yaml
 from PySide6.QtCore import QObject, Signal
 from PySide6.QtWidgets import QDialog
 
+from excel2moodle import __version__
 from excel2moodle.core import stringHelpers
 from excel2moodle.core.category import Category
 from excel2moodle.core.exceptions import InvalidFieldException, QNotParsedException
 from excel2moodle.core.globals import Tags
-from excel2moodle.core.question import Question
+from excel2moodle.core.question import ParametricQuestion, Question
 from excel2moodle.core.settings import Settings
 from excel2moodle.core.validator import Validator
 from excel2moodle.logger import LogAdapterQuestionID
@@ -72,9 +75,10 @@ class QuestionDB:
     def __init__(self, settings: Settings) -> None:
         self.settings = settings
         self.window: QMainWindow | None = None
-        self.version = None
         self.categoriesMetaData: pd.DataFrame
         self.categories: dict[str, Category]
+        self._exportedQuestions: list[Question] = []
+        self._exportedAll: bool = False
 
     @property
     def spreadsheet(self) -> Path:
@@ -94,6 +98,17 @@ class QuestionDB:
         ``categoriesMetaData`` dataframe
         Setup the categories and store them  in ``self.categories = {}``
         Pass the question data to the categories.
+
+        Raises
+        ------
+        ValueError
+            When there is no 'seetings' worksheet in the file.
+        InvalidFieldException
+            When the settings are invalid
+            Or When the categories Sheet doesn't provide the necessary keys.
+
+        Before raising it logges the exceptions with a meaningful message.
+
         """
         sheetPath = sheetPath if sheetPath else self.spreadsheet
         logger.info("Start Parsing the Excel Metadata Sheet\n")
@@ -104,19 +119,14 @@ class QuestionDB:
                 index_col=0,
                 engine="calamine",
             )
-            logger.debug("Found the settings: \n\t%s", settingDf)
-            settingDf = self.harmonizeDFIndex(settingDf)
-            for tag, value in settingDf.iterrows():
-                val = value.iloc[0]
-                if pd.notna(val):
-                    self.settings.set(tag, val)
-        try:
-            self._validateProjectSettings(sheetPath=sheetPath)
-        except InvalidFieldException:
-            logger.exception(
-                "Can not create the database with invalid project settings."
-            )
-            raise
+        logger.debug("Found the settings: \n\t%s", settingDf)
+        settingDf = self.harmonizeDFIndex(settingDf)
+        for tag, value in settingDf.iterrows():
+            val = value.iloc[0]
+            if pd.notna(val):
+                self.settings.set(tag, val)
+
+        self._validateProjectSettings(sheetPath=sheetPath)
         with Path(sheetPath).open("rb") as f:
             self.categoriesMetaData = pd.read_excel(
                 f,
@@ -124,10 +134,20 @@ class QuestionDB:
                 index_col=0,
                 engine="calamine",
             )
-            logger.info("Sucessfully read categoriesMetaData")
+        if "description" not in self.categoriesMetaData.columns:
+            msg = f"You need to specify the 'description' tag for each category in the sheet '{self.settings.get(Tags.CATEGORIESSHEET)}'."
+            raise InvalidFieldException(msg, "0000", "description")
+        logger.info("Sucessfully read categoriesMetaData")
         return self.categoriesMetaData
 
     def _validateProjectSettings(self, sheetPath: Path) -> None:
+        if Tags.LOGLEVEL in self.settings:
+            level: str = self.settings.get(Tags.LOGLEVEL)
+            if level.upper() not in ("DEBUG", "INFO", "WARNING", "ERROR"):
+                self.settings.pop(Tags.LOGLEVEL)
+                logger.warning("You specified an unsupported Loglevel: %s", level)
+        if self.window is not None:
+            self.window.logHandler.setLevel(self.settings.get(Tags.LOGLEVEL).upper())
         if Tags.IMPORTMODULE in self.settings:
             logger.warning(
                 "Appending: %s to sys.path. All names defined by it will be usable",
@@ -276,7 +296,7 @@ class QuestionDB:
         for qNum in category.dataframe.columns:
             try:
                 self.setupAndParseQuestion(category, qNum)
-            except (InvalidFieldException, QNotParsedException):
+            except (InvalidFieldException, QNotParsedException, AttributeError):
                 logger.exception(
                     "Question %s%02d couldn't be parsed. The Question Data: \n %s",
                     category.id,
@@ -342,21 +362,26 @@ class QuestionDB:
         else:
             msg = "couldn't setup Parser"
             raise QNotParsedException(msg, question.id)
-        category.questions[qNumber] = question
+        category.appendQuestion(qNumber, question)
         return question
 
     def appendQuestions(
-        self, questions: list[QuestionItem], file: Path | None = None
+        self,
+        questions: list[QuestionItem],
+        file: Path | None = None,
+        pCount: int = 0,
+        qCount: int = 0,
     ) -> None:
         """Append selected question Elements to the tree."""
+        self._exportedQuestions.clear()
         tree = ET.Element("quiz")
         catdict: dict[Category, list[Question]] = {}
         for q in questions:
             logger.debug(f"got a question to append {q=}")
-            cat = q.parent().getCategory()
+            cat = q.parent().category
             if cat not in catdict:
                 catdict[cat] = []
-            catdict[cat].append(q.getQuestion())
+            catdict[cat].append(q.question)
         for cat, qlist in catdict.items():
             self._appendQElements(
                 cat,
@@ -365,6 +390,8 @@ class QuestionDB:
                 includeHeader=self.settings.get(Tags.INCLUDEINCATS),
             )
         stringHelpers.printDom(tree, file=file)
+        if self.settings.get(Tags.GENEXPORTREPORT):
+            self.generateExportReport(file, pCount=pCount, qCount=qCount)
 
     def _appendQElements(
         self,
@@ -373,17 +400,80 @@ class QuestionDB:
         tree: ET.Element,
         includeHeader: bool = True,
     ) -> None:
-        if includeHeader:
+        variant: int = self.settings.get(Tags.QUESTIONVARIANT)
+        if includeHeader or variant == -1:
             tree.append(cat.getCategoryHeader())
             logger.debug(f"Appended a new category item {cat=}")
-        variant: int = self.settings.get(Tags.QUESTIONVARIANT)
+            self._exportedAll: bool = True
         for q in qList:
-            if hasattr(q, "variants") and q.variants is not None:
-                if variant == 0 or variant > q.variants:
-                    dialog = QuestionVariantDialog(self.window, q)
-                    if dialog.exec() == QDialog.Accepted:
-                        variant = dialog.variant
-                        logger.debug("Die Fragen-Variante %s wurde gewählt", variant)
-                    else:
-                        logger.warning("Keine Fragenvariante wurde gewählt.")
-            tree.append(q.getUpdatedElement(variant=variant))
+            if not isinstance(q, ParametricQuestion):
+                tree.append(q.getUpdatedElement())
+                self._exportedQuestions.append(q)
+                continue
+            if variant == -1:
+                tree.append(cat.getCategoryHeader(subCategory=q.id))
+                for var in range(q.parametrics.variants):
+                    tree.append(q.getUpdatedElement(variant=var))
+            elif variant == 0 or variant > q.parametrics.variants:
+                dialog = QuestionVariantDialog(self.window, q)
+                if dialog.exec() == QDialog.Accepted:
+                    variant = dialog.variant
+                    logger.debug("Die Fragen-Variante %s wurde gewählt", variant)
+                else:
+                    logger.warning("Keine Fragenvariante wurde gewählt.")
+                tree.append(q.getUpdatedElement(variant=variant))
+            else:
+                tree.append(q.getUpdatedElement(variant=variant))
+            self._exportedQuestions.append(q)
+
+    def generateExportReport(
+        self, file: Path | None = None, pCount: int = 0, qCount: int = 0
+    ) -> None:
+        """Generate a YAML report of the exported questions."""
+        if not self._exportedQuestions:
+            return
+        if file:
+            base_path = file.with_name(f"{file.stem}_export_report.yaml")
+        else:
+            base_path = self.spreadsheet.parent / "export_report.yaml"
+
+        for i in range(99):
+            report_path = base_path.with_name(f"{base_path.stem}-{i:02d}.yaml")
+            if not report_path.resolve().exists():
+                break
+
+        report_data = {
+            "export_metadata": {
+                "export_time": dt.datetime.now(tz=None).strftime("%Y-%m-%d %H:%M:%S"),
+                "excel2moodle_version": __version__,
+            },
+            "categories": {},
+        }
+        if qCount != 0:
+            report_data["export_metadata"]["question_count"] = qCount
+        if pCount != 0:
+            report_data["export_metadata"]["total_point_count"] = pCount
+
+        sorted_questions = sorted(
+            self._exportedQuestions, key=lambda q: (q.category.name, q.id)
+        )
+
+        for question in sorted_questions:
+            category_name = question.category.name
+            if category_name not in report_data["categories"]:
+                report_data["categories"][category_name] = {
+                    "description": question.category.desc,
+                    "questions": [],
+                }
+
+            question_data = {"id": question.id, "name": question.name}
+            if isinstance(question, ParametricQuestion) and question.currentVariant > 0:
+                if self._exportedAll:
+                    question_data["exported_variant"] = "all"
+                else:
+                    question_data["exported_variant"] = question.currentVariant + 1
+
+            report_data["categories"][category_name]["questions"].append(question_data)
+
+        with report_path.open("w") as f:
+            yaml.dump(report_data, f, sort_keys=False)