excel2moodle 0.5.0__tar.gz → 0.5.2__tar.gz

excel2moodle-0.5.2/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: excel2moodle
+Version: 0.5.2
+Summary: A package for converting questions from a spreadsheet, to valid moodle-xml
+Author: Jakob Bosse
+License-Expression: GPL-3.0-or-later
+Project-URL: Repository, https://gitlab.com/jbosse3/excel2moodle.git
+Project-URL: Documentation, https://jbosse3.gitlab.io/excel2moodle
+Keywords: moodle,XML,teaching,question,converter,open educational Ressource
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyside6>=6.8.0
+Requires-Dist: pandas>=2.1.3
+Requires-Dist: lxml>=5.4.0
+Requires-Dist: asteval>=1.0.6
+Requires-Dist: python-calamine>=0.3.2
+Dynamic: license-file
+
+# excel 2 Moodle
+![Logo](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.
+
+## Concept
+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.
+Another sheet stores metadata for the different categories of questions.
+And each category lives inside a separate sheet inside the spreadsheet document. 
+
+## Getting Started
+
+### Installation
+To get started with excel2moodle first have a look at the [installation](https://jbosse3.gitlab.io/excel2moodle/howto.html#excel2moodle-unter-windows-installieren)
+If you already have python and uv installed, it is as easy as running `uv tool install excel2moodle`.
+
+### [ 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.
+
+Some 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.
+
+
+## Functionality
+* Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+* Question Preview:
+    + This helps you when selecting the correct questions for the export.
+* 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
+
+
+![MainWindow](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)
+Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse
+
+## Supporting
+A special thanks goes to the [Civil Engineering Departement of the Fachhochschule Potsdam](https://www.fh-potsdam.de/en/study-further-education/departments/civil-engineering-department) 
+where i was employed as a student associate to work on this project.
+
+If You want to support my work as well, you can by me a [coffee](https://ko-fi.com/jbosse3)
+
+# Changelogs
+
+## 0.5.2 (2025-06-30)
+Extended Documentation and bugfix for import Module
+
+### bugfix (2 changes)
+
+- [Default question variant saved and reused.](https://gitlab.com/jbosse3/excel2moodle/-/commit/097705ba83727463a9b27cd76e99814a7ecf28df)
+- [bugfix: Import module working again](https://gitlab.com/jbosse3/excel2moodle/-/commit/5f293970bcdac3858911cdcc102b72714af057bd)
+
+### documentation (1 change)
+
+- [documentation: Added how to build question database](https://gitlab.com/jbosse3/excel2moodle/-/commit/71ceb122aa37e8bf2735b659359ae37d81017599)
+
+### feature (1 change)
+
+- [Implemented MC question string method](https://gitlab.com/jbosse3/excel2moodle/-/commit/c4f2081d0000ee60322fe8eec8468fa3317ce7be)
+
+### improvement (1 change)
+
+- [Implemented ClozePart object](https://gitlab.com/jbosse3/excel2moodle/-/commit/878f90f45e37421384c4f8f602115e7596b4ceb9)
+
+## 0.5.2 (2025-06-30)
+Extended Documentation and bugfix for import Module
+
+### bugfix (2 changes)
+
+- [Default question variant saved and reused.](https://gitlab.com/jbosse3/excel2moodle/-/commit/097705ba83727463a9b27cd76e99814a7ecf28df)
+- [bugfix: Import module working again](https://gitlab.com/jbosse3/excel2moodle/-/commit/5f293970bcdac3858911cdcc102b72714af057bd)
+
+### documentation (1 change)
+
+- [documentation: Added how to build question database](https://gitlab.com/jbosse3/excel2moodle/-/commit/71ceb122aa37e8bf2735b659359ae37d81017599)
+
+### feature (1 change)
+
+- [Implemented MC question string method](https://gitlab.com/jbosse3/excel2moodle/-/commit/c4f2081d0000ee60322fe8eec8468fa3317ce7be)
+
+### improvement (1 change)
+
+- [Implemented ClozePart object](https://gitlab.com/jbosse3/excel2moodle/-/commit/878f90f45e37421384c4f8f602115e7596b4ceb9)
+
+## 0.5.1 (2025-06-24)
+Minor docs improvement and question variant bugfix
+
+### bugfix (1 change)
+
+- [Bullet points variant didn't get updated](https://gitlab.com/jbosse3/excel2moodle/-/commit/7b4ad9e9c8a4216167ae019859ebaa8def81d57f)
+
+## 0.5.0 (2025-06-20)
+settings handling improved
+
+### feature (2 changes)
+
+- [Pixmaps and vector graphics scaled to fit in preview](https://gitlab.com/jbosse3/excel2moodle/-/commit/00a6ef13fb2a0046d7641e24af6cf6f08642390e)
+- [feature: category Settings implemented](https://gitlab.com/jbosse3/excel2moodle/-/commit/d673cc3f5ba06051aa37bc17a3ef0161121cb730)
+
+### improvement (1 change)
+
+- [Tolerance is harmonized by questionData.get()](https://gitlab.com/jbosse3/excel2moodle/-/commit/8d1724f4877e1584cc531b6b3f278bdea68b5831)
+
+### Settings Errors are logged (1 change)
+
+- [Log Errors in settings Sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/07e58f957c69ea818db1c5679cf89e287817ced3)
+

excel2moodle-0.5.2/README.md

@@ -0,0 +1,125 @@
+# excel 2 Moodle
+![Logo](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.
+
+## Concept
+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.
+Another sheet stores metadata for the different categories of questions.
+And each category lives inside a separate sheet inside the spreadsheet document. 
+
+## Getting Started
+
+### Installation
+To get started with excel2moodle first have a look at the [installation](https://jbosse3.gitlab.io/excel2moodle/howto.html#excel2moodle-unter-windows-installieren)
+If you already have python and uv installed, it is as easy as running `uv tool install excel2moodle`.
+
+### [ 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.
+
+Some 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.
+
+
+## Functionality
+* Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+* Question Preview:
+    + This helps you when selecting the correct questions for the export.
+* 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
+
+
+![MainWindow](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)
+Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse
+
+## Supporting
+A special thanks goes to the [Civil Engineering Departement of the Fachhochschule Potsdam](https://www.fh-potsdam.de/en/study-further-education/departments/civil-engineering-department) 
+where i was employed as a student associate to work on this project.
+
+If You want to support my work as well, you can by me a [coffee](https://ko-fi.com/jbosse3)
+
+# Changelogs
+
+## 0.5.2 (2025-06-30)
+Extended Documentation and bugfix for import Module
+
+### bugfix (2 changes)
+
+- [Default question variant saved and reused.](https://gitlab.com/jbosse3/excel2moodle/-/commit/097705ba83727463a9b27cd76e99814a7ecf28df)
+- [bugfix: Import module working again](https://gitlab.com/jbosse3/excel2moodle/-/commit/5f293970bcdac3858911cdcc102b72714af057bd)
+
+### documentation (1 change)
+
+- [documentation: Added how to build question database](https://gitlab.com/jbosse3/excel2moodle/-/commit/71ceb122aa37e8bf2735b659359ae37d81017599)
+
+### feature (1 change)
+
+- [Implemented MC question string method](https://gitlab.com/jbosse3/excel2moodle/-/commit/c4f2081d0000ee60322fe8eec8468fa3317ce7be)
+
+### improvement (1 change)
+
+- [Implemented ClozePart object](https://gitlab.com/jbosse3/excel2moodle/-/commit/878f90f45e37421384c4f8f602115e7596b4ceb9)
+
+## 0.5.2 (2025-06-30)
+Extended Documentation and bugfix for import Module
+
+### bugfix (2 changes)
+
+- [Default question variant saved and reused.](https://gitlab.com/jbosse3/excel2moodle/-/commit/097705ba83727463a9b27cd76e99814a7ecf28df)
+- [bugfix: Import module working again](https://gitlab.com/jbosse3/excel2moodle/-/commit/5f293970bcdac3858911cdcc102b72714af057bd)
+
+### documentation (1 change)
+
+- [documentation: Added how to build question database](https://gitlab.com/jbosse3/excel2moodle/-/commit/71ceb122aa37e8bf2735b659359ae37d81017599)
+
+### feature (1 change)
+
+- [Implemented MC question string method](https://gitlab.com/jbosse3/excel2moodle/-/commit/c4f2081d0000ee60322fe8eec8468fa3317ce7be)
+
+### improvement (1 change)
+
+- [Implemented ClozePart object](https://gitlab.com/jbosse3/excel2moodle/-/commit/878f90f45e37421384c4f8f602115e7596b4ceb9)
+
+## 0.5.1 (2025-06-24)
+Minor docs improvement and question variant bugfix
+
+### bugfix (1 change)
+
+- [Bullet points variant didn't get updated](https://gitlab.com/jbosse3/excel2moodle/-/commit/7b4ad9e9c8a4216167ae019859ebaa8def81d57f)
+
+## 0.5.0 (2025-06-20)
+settings handling improved
+
+### feature (2 changes)
+
+- [Pixmaps and vector graphics scaled to fit in preview](https://gitlab.com/jbosse3/excel2moodle/-/commit/00a6ef13fb2a0046d7641e24af6cf6f08642390e)
+- [feature: category Settings implemented](https://gitlab.com/jbosse3/excel2moodle/-/commit/d673cc3f5ba06051aa37bc17a3ef0161121cb730)
+
+### improvement (1 change)
+
+- [Tolerance is harmonized by questionData.get()](https://gitlab.com/jbosse3/excel2moodle/-/commit/8d1724f4877e1584cc531b6b3f278bdea68b5831)
+
+### Settings Errors are logged (1 change)
+
+- [Log Errors in settings Sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/07e58f957c69ea818db1c5679cf89e287817ced3)
+

{excel2moodle-0.5.0 → excel2moodle-0.5.2}/excel2moodle/core/dataStructure.py

@@ -131,7 +131,7 @@ class QuestionDB:
         if Tags.IMPORTMODULE in self.settings:
             logger.warning(
                 "Appending: %s to sys.path. All names defined by it will be usable",
-                sheetPath,
+                sheetPath.parent,
             )
             sys.path.append(str(sheetPath.parent))
         if Tags.PICTURESUBFOLDER not in self.settings:
@@ -286,7 +286,7 @@ class QuestionDB:
         self.signals.categoryQuestionsReady.emit(category)
 
     @classmethod
-    def setupAndParseQuestion(cls, category: Category, qNumber: int) -> Question | None:
+    def setupAndParseQuestion(cls, category: Category, qNumber: int) -> Question:
         """Check if the Question Data is valid. Then parse it.
 
         The Question data is accessed from  `category.dataframe` via its number
@@ -322,7 +322,7 @@ class QuestionDB:
         question = QuestionTypeMapping[qtype].create(category, validData)
         if question.isParsed:
             locallogger.info("Question already parsed")
-            return None
+            return question
         if isinstance(question, NFQuestion):
             cls.nfParser.setup(question)
             locallogger.debug("setup a new NF parser ")

{excel2moodle-0.5.0 → excel2moodle-0.5.2}/excel2moodle/core/question.py

@@ -161,15 +161,15 @@ class Question:
     def assemble(self, variant=0) -> None:
         """Assemble the question to the valid xml Tree."""
         mainText = self._getTextElement()
-        self.logger.debug("Starting assembly")
-        self._setAnswerElement(variant=variant)
-        textParts = self._assembleMainTextParts()
+        self.logger.info("Starting assembly variant: %s", variant)
+        self._assembleAnswer(variant=variant)
+        textParts = self._assembleText(variant=variant)
         if hasattr(self, "picture") and self.picture.ready:
             mainText.append(self.picture.element)
             self.logger.debug("Appended Picture element to text")
         mainText.append(etHelpers.getCdatTxtElement(textParts))
 
-    def _assembleMainTextParts(self, variant=0) -> list[ET.Element]:
+    def _assembleText(self, variant=0) -> list[ET.Element]:
         """Assemble the Question Text.
 
         Intended for the cloze question, where the answers parts are part of the text.
@@ -202,7 +202,7 @@ class Question:
             return self.bulletList
         return None
 
-    def _setAnswerElement(self, variant: int = 0) -> None:
+    def _assembleAnswer(self, variant: int = 0) -> None:
         pass
 
     def _setID(self, id=0) -> None:
@@ -229,7 +229,7 @@ class ParametricQuestion(Question):
         def replaceMatch(match: Match[str]) -> str | int | float:
             key = match.group(1)
             if key in self.variables:
-                value = self.variables[key][variant]
+                value = self.variables[key][variant - 1]
                 return f"{value}".replace(".", ",\\!")
             return match.group(0)  # keep original if no match
 

excel2moodle-0.5.2/excel2moodle/question_types/cloze.py

@@ -0,0 +1,342 @@
+"""Implementation of tde cloze question type.
+
+This question type is like the NFM but supports multiple fields of answers.
+All Answers are calculated off an equation using the same variables.
+"""
+
+import logging
+import math
+import re
+from typing import Literal, overload
+
+import lxml.etree as ET
+
+from excel2moodle.core.exceptions import QNotParsedException
+from excel2moodle.core.globals import (
+    Tags,
+    TextElements,
+)
+from excel2moodle.core.question import ParametricQuestion
+from excel2moodle.core.settings import Tags
+from excel2moodle.question_types.nfm import NFMQuestionParser
+
+logger = logging.getLogger(__name__)
+
+
+class ClozePart:
+    def __init__(
+        self,
+        question: ParametricQuestion,
+        text: list[str],
+    ) -> None:
+        self.question = question
+        self.text: list[ET.Element] = self._setupText(text)
+        if not self.text:
+            msg = f"Answer part for cloze question {self.question.id} is invalid without partText"
+            raise ValueError(msg)
+
+    @property
+    def points(self) -> float:
+        if hasattr(self, "_points"):
+            return self._points
+        return 0.0
+        self.question.logger.error("Invalid call to points of unparsed cloze part")
+        return 0.0
+
+    @points.setter
+    def points(self, points: float) -> None:
+        self._points = points if points > 0 else 0.0
+
+    @property
+    def typ(self) -> Literal["MC", "NFM"] | None:
+        if hasattr(self, "_typ"):
+            return self._typ
+        return None
+
+    @property
+    def mcAnswerString(self) -> str:
+        if hasattr(self, "_mcAnswer"):
+            return self._mcAnswer
+        msg = "No MC Answer was set"
+        raise ValueError(msg)
+
+    @mcAnswerString.setter
+    def mcAnswerString(self, answerString: str) -> None:
+        self._mcAnswer: str = answerString
+
+    def _setupText(self, text: list[str]) -> ET.Element:
+        textList: list[ET.Element] = []
+        for t in text:
+            textList.append(TextElements.PLEFT.create())
+            textList[-1].text = t
+        return textList
+
+    def setAnswer(
+        self,
+        equation: str | None = None,
+        trueAns: list[str] | None = None,
+        falseAns: list[str] | None = None,
+    ) -> bool:
+        if falseAns is not None:
+            self.falseAnswers: list[str] = falseAns
+        if trueAns is not None:
+            self.trueAnswers: list[str] = trueAns
+        if equation is not None:
+            self.equation: str = equation
+        check = False
+        t = hasattr(self, "trueAnswers")
+        f = hasattr(self, "falseAnswers")
+        eq = hasattr(self, "equation")
+        if t and f and not eq:
+            self._typ: Literal["MC", "NFM"] = "MC"
+            return True
+        if eq and not t and not f:
+            self._typ: Literal["MC", "NFM"] = "NFM"
+            self.nfResults: list[float] = []
+            return True
+        return False
+
+    def __repr__(self) -> str:
+        answers: str = (
+            self.equation
+            if self.typ == "NFM"
+            else f"{self.trueAnswers}\n {self.falseAnswers}"
+        )
+        return f"Cloze Part {self.typ}\n Answers: '{answers}'"
+
+
+class ClozeQuestion(ParametricQuestion):
+    """Cloze Question Type."""
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.questionParts: dict[int, ClozePart] = {}
+        self.questionTexts: list[ET.Element] = []
+
+    @property
+    def partsNum(self) -> int:
+        return len(self.questionParts)
+
+    @property
+    def points(self) -> float:
+        pts: float = 0
+        if self.isParsed:
+            for p in self.questionParts.values():
+                pts = pts + p.points
+        else:
+            pts = self.rawData.get(Tags.POINTS)
+        return pts
+
+    def _assembleAnswer(self, variant: int = 1) -> None:
+        for partNum, part in self.questionParts.items():
+            if part.typ == "MC":
+                ansStr = part.mcAnswerString
+                self.logger.info("MC answer part: %s ", ansStr)
+            elif part.typ == "NFM":
+                result = part.nfResults[variant - 1]
+                ansStr = ClozeQuestionParser.getNumericAnsStr(
+                    result,
+                    self.rawData.get(Tags.TOLERANCE),
+                    wrongSignCount=self.rawData.get(Tags.WRONGSIGNPERCENT),
+                    points=part.points,
+                )
+                self.logger.info("NF answer part: %s ", ansStr)
+            else:
+                msg = "Type of the answer part is invalid"
+                raise QNotParsedException(msg, self.id)
+            ul = TextElements.ULIST.create()
+            item = TextElements.LISTITEM.create()
+            item.text = ansStr
+            ul.append(item)
+            part.text.append(ul)
+            self.logger.debug("Appended part %s %s to main text", partNum, part)
+            part.text.append(ET.Element("hr"))
+            self.questionTexts.extend(part.text)
+
+    def _assembleText(self, variant=0) -> list[ET.Element]:
+        textParts = super()._assembleText(variant=variant)
+        self.logger.debug("Appending QuestionParts to main text")
+        textParts.extend(self.questionTexts)
+        return textParts
+
+
+class ClozeQuestionParser(NFMQuestionParser):
+    """Parser for the cloze question type."""
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.question: ClozeQuestion
+
+    def setup(self, question: ClozeQuestion) -> None:
+        self.question: ClozeQuestion = question
+        super().setup(question)
+
+    def _parseAnswers(self) -> None:
+        self._setupParts()
+        self._parseAnswerParts()
+
+    def _setupParts(self) -> None:
+        parts: dict[int, ClozePart] = {
+            self.getPartNumber(key): ClozePart(self.question, self.rawInput[key])
+            for key in self.rawInput
+            if key.startswith(Tags.QUESTIONPART)
+        }
+        partsNum = len(parts)
+        equations: dict[int, str] = self._getPartValues(Tags.RESULT)
+        trueAnsws: dict[int, list[str]] = self._getPartValues(Tags.TRUE)
+        falseAnsws: dict[int, list[str]] = self._getPartValues(Tags.FALSE)
+        points: dict[int, float] = self._getPartValues(Tags.POINTS)
+        for num, part in parts.items():
+            eq = equations.get(num)
+            true = trueAnsws.get(num)
+            false = falseAnsws.get(num)
+            part.setAnswer(equation=eq, trueAns=true, falseAns=false)
+        if len(points) == 0:
+            pts = round(self.rawInput.get(Tags.POINTS) / partsNum, 3)
+            for part in parts.values():
+                part.points = pts
+        elif len(points) != partsNum:
+            logger.warning(
+                "Some Answer parts are missing the points, they will get the standard points"
+            )
+            for num, part in parts.items():
+                p = points.get(num)
+                part.points = p if p is not None else self.rawInput.get(Tags.POINTS)
+
+        self.question.questionParts = parts
+
+    @overload
+    def _getPartValues(self, Tag: Literal[Tags.RESULT]) -> dict[int, str]: ...
+    @overload
+    def _getPartValues(self, Tag: Literal[Tags.POINTS]) -> dict[int, float]: ...
+    @overload
+    def _getPartValues(
+        self, Tag: Literal[Tags.TRUE, Tags.FALSE]
+    ) -> dict[int, list[str]]: ...
+    def _getPartValues(self, Tag):
+        tagValues: dict = {
+            self.getPartNumber(key): self.rawInput[key]
+            for key in self.rawInput
+            if key.startswith(Tag)
+        }
+        self.logger.warning("Found part data %s:  %s", Tag, tagValues)
+        return tagValues
+
+    def _parseAnswerParts(self) -> None:
+        """Parse the numeric or MC result items."""
+        try:
+            bps = str(self.rawInput[Tags.BPOINTS])
+        except KeyError:
+            bps = None
+            number = 1
+        else:
+            varNames: list[str] = self._getVarsList(bps)
+            self.question.variables, number = self._getVariablesDict(varNames)
+        for variant in range(number):
+            self.setupAstIntprt(self.question.variables, variant)
+            for partNum, part in self.question.questionParts.items():
+                if part.typ == "NFM":
+                    result = self._calculateNFMPartResult(part, partNum, variant)
+                    part.nfResults.append(result)
+                    logger.debug("Appended NF part %s result: %s", partNum, result)
+                elif part.typ == "MC":
+                    ansStr = self.getMCAnsStr(
+                        part.trueAnswers, part.falseAnswers, points=part.points
+                    )
+                    part.mcAnswerString = ansStr
+                    logger.debug("Appended MC part %s: %s", partNum, ansStr)
+        self._setVariants(number)
+
+    def _calculateNFMPartResult(
+        self, part: ClozePart, partNum: int, variant: int
+    ) -> float:
+        result = self.astEval(part.equation)
+        if isinstance(result, float):
+            try:
+                firstResult = self.rawInput[f"{Tags.FIRSTRESULT}:{partNum}"]
+            except KeyError:
+                firstResult = 0.0
+            if variant == 0 and not math.isclose(result, firstResult, rel_tol=0.002):
+                self.logger.warning(
+                    "The calculated result %s differs from given firstResult: %s",
+                    result,
+                    firstResult,
+                )
+            return result
+        msg = f"The expression {part.equation} could not be evaluated."
+        raise QNotParsedException(msg, self.question.id)
+
+    def getPartNumber(self, indexKey: str) -> int:
+        """Return the number of the question Part.
+
+        The number should be given after the `@` sign.
+        This is number is used, to reference the question Text
+        and the expected answer fields together.
+        """
+        try:
+            num = re.findall(r":(\d+)$", indexKey)[0]
+        except IndexError:
+            msg = f"No :i question Part value given for {indexKey}"
+            raise QNotParsedException(msg, self.question.id)
+        else:
+            return int(num)
+
+    @staticmethod
+    def getNumericAnsStr(
+        result: float,
+        tolerance: float,
+        points: float = 1,
+        wrongSignCount: int = 50,
+        wrongSignFeedback: str = "your result has the wrong sign (+-)",
+    ) -> str:
+        """Generate the answer string from `result`.
+
+        Parameters.
+        ----------
+        wrongSignCount:
+            If the wrong sign `+` or `-` is given, how much of the points should be given.
+            Interpreted as percent.
+        tolerance:
+            The relative tolerance, as fraction
+
+        """
+        absTol = f":{round(result * tolerance, 3)}"
+        answerParts: list[str | float] = [
+            "{",
+            points,
+            ":NUMERICAL:=",
+            round(result, 3),
+            absTol,
+            "~%",
+            wrongSignCount,
+            "%",
+            round(result * (-1), 3),
+            absTol,
+            f"#{wrongSignFeedback}",
+            "}",
+        ]
+        answerPStrings = [str(part) for part in answerParts]
+        return "".join(answerPStrings)
+
+    @staticmethod
+    def getMCAnsStr(
+        true: list[str],
+        false: list[str],
+        points: float = 1,
+    ) -> str:
+        """Generate the answer string for the MC answers."""
+        truePercent: float = round(100 / len(true), 1)
+        falsePercent: float = round(100 / len(false), 1)
+        falseList: list[str] = [f"~%-{falsePercent}%{ans}" for ans in false]
+        trueList: list[str] = [f"~%{truePercent}%{ans}" for ans in true]
+        answerParts: list[str | float] = [
+            "{",
+            points,
+            ":MULTIRESPONSE:",
+        ]
+        answerParts.extend(trueList)
+        answerParts.extend(falseList)
+        answerParts.append("}")
+
+        answerPStrings = [str(part) for part in answerParts]
+        return "".join(answerPStrings)