in2lambda 0.3.3__py3-none-any.whl → 1.0.0__py3-none-any.whl

in2lambda/api/question.py

@@ -1,4 +1,4 @@
-"""A full question with optional parts that's contained in a module."""
+"""A full question with optional parts that's contained in a set."""
 
 from dataclasses import dataclass, field
 from typing import Union

in2lambda/api/set.py

@@ -0,0 +1,185 @@
+"""Represents a list of questions."""
+
+from dataclasses import dataclass, field
+from typing import Union
+
+import panflute as pf
+
+from in2lambda.api.question import Question
+from in2lambda.api.visibility_status import VisibilityController, VisibilityStatus
+
+
+@dataclass
+class Set:
+    """Represents a list of questions."""
+
+    _name: str = field(default="set")
+    _description: str = field(default="")
+    _finalAnswerVisibility: VisibilityController = field(
+        default_factory=lambda: VisibilityController(
+            VisibilityStatus.OPEN_WITH_WARNINGS
+        )
+    )
+    _workedSolutionVisibility: VisibilityController = field(
+        default_factory=lambda: VisibilityController(
+            VisibilityStatus.OPEN_WITH_WARNINGS
+        )
+    )
+    _structuredTutorialVisibility: VisibilityController = field(
+        default_factory=lambda: VisibilityController(VisibilityStatus.OPEN)
+    )
+
+    questions: list[Question] = field(default_factory=list)
+    _current_question_index = -1
+
+    @property
+    def current_question(self) -> Question:
+        """The current question being modified, or Question("INVALID") if there are no questions.
+
+        The reasoning behind returning Question("INVALID") is in case filter logic is being applied
+        on text before the first question (e.g. intro paragraphs). In that case, there is no effect.
+
+        Returns:
+            The current question or Question("INVALID") if there are no questions.
+
+        Examples:
+            >>> from in2lambda.api.set import Set
+            >>> Set().current_question
+            Question(title='INVALID', parts=[], images=[], main_text='')
+            >>> s = Set()
+            >>> s.add_question()
+            >>> s.current_question
+            Question(title='', parts=[], images=[], main_text='')
+        """
+        return (
+            self.questions[self._current_question_index]
+            if self.questions
+            else Question("INVALID")
+        )
+
+    def add_question(
+        self, title: str = "", main_text: Union[pf.Element, str] = pf.Str("")
+    ) -> None:
+        """Inserts a new question into the set.
+
+        Args:
+            title: An optional string for the title of the question. If no title
+                is provided, the question title auto-increments i.e. Question 1, 2, etc.
+            main_text: An optional string or panflute element for the main question text.
+
+        Examples:
+            >>> from in2lambda.api.set import Set
+            >>> import panflute as pf
+            >>> s = Set()
+            >>> s.add_question("Some title", pf.Para(pf.Str("hello"), pf.Space, pf.Str("there")))
+            >>> s.questions
+            [Question(title='Some title', parts=[], images=[], main_text='hello there')]
+            >>> s.add_question(main_text="Normal string text")
+            >>> s.questions[1].main_text
+            'Normal string text'
+        """
+        question = Question(title=title)
+        question.main_text = main_text
+        self.questions.append(question)
+
+    def increment_current_question(self) -> None:
+        """Manually overrides the current question being modified.
+
+        The default (-1) indicates the last question added. Incrementing for the
+        first time sets to 0 i.e. the first question.
+
+        The is useful if adding question text first and answers later.
+
+        Examples:
+            >>> from in2lambda.api.set import Set
+            >>> s = Set()
+            >>> # Imagine adding the questions from a question file first...
+            >>> s.add_question("Question 1")
+            >>> s.add_question("Question 2")
+            >>> # ...and then adding solutions from an answer file later
+            >>> s.increment_current_question()  # Loop back to question 1
+            >>> s.current_question.add_solution("Question 1 answer")
+            >>> s.increment_current_question()
+            >>> s.current_question.add_solution("Question 2 answer")
+            >>> s.questions
+            [Question(title='Question 1', parts=[Part(text='', worked_solution='Question 1 answer')], images=[], main_text=''),\
+ Question(title='Question 2', parts=[Part(text='', worked_solution='Question 2 answer')], images=[], main_text='')]
+        """
+        self._current_question_index += 1
+
+    def to_json(self, output_dir: str) -> None:
+        """Turns this set into Lambda Feedback JSON/ZIP files.
+
+        WARNING: This will overwrite any existing files in the directory.
+
+        Args:
+            output_dir: Where to output the final Lambda Feedback JSON/ZIP files.
+
+        Examples:
+            >>> import tempfile
+            >>> import os
+            >>> import json
+            >>> # Create a set with two questions
+            >>> s = Set()
+            >>> s.add_question("Question 1")
+            >>> s.add_question("Question 2")
+            >>> with tempfile.TemporaryDirectory() as temp_dir:
+            ...     # Write the JSON files to the temporary directory
+            ...     s.to_json(temp_dir)
+            ...     # Check the contents of the directory
+            ...     sorted(os.listdir(temp_dir))
+            ...     # Check the contents of the set directory
+            ...     sorted(os.listdir(f"{temp_dir}/set"))
+            ...     # Check the title of the first question
+            ...     with open(f"{temp_dir}/set/question_000_Question_1.json") as file:
+            ...         print(f"Question 1's title: {json.load(file)['title']}")
+            ['set', 'set.zip']
+            ['question_000_Question_1.json', 'question_001_Question_2.json', 'set_set.json']
+            Question 1's title: Question 1
+        """
+        from in2lambda.json_convert import json_convert
+
+        json_convert.main(self, output_dir)
+
+    def set_name(self, name: str) -> None:
+        """Sets the name of the set.
+
+        Args:
+            name: The name to set for the set.
+
+        Examples:
+            >>> from in2lambda.api.set import Set
+            >>> s = Set()
+            >>> s.set_name("My Question Set")
+            >>> s._name
+            'My Question Set'
+        """
+        self._name = name
+
+    def set_description(self, description: str) -> None:
+        """Sets the description of the set.
+
+        Args:
+            description: The description to set for the set.
+
+        Examples:
+            >>> from in2lambda.api.set import Set
+            >>> s = Set()
+            >>> s.set_description("This is my question set.")
+            >>> s._description
+            'This is my question set.'
+        """
+        self._description = description
+
+    def __repr__(self):
+        """Custom representation showing visibility status values instead of memory addresses."""
+        return (
+            f"Set("
+            f"_name={self._name!r}, "
+            f"_description={self._description!r}, "
+            f"_finalAnswerVisibility={str(self._finalAnswerVisibility)!r}, "
+            f"_workedSolutionVisibility={str(self._workedSolutionVisibility)!r}, "
+            f"_structuredTutorialVisibility={str(self._structuredTutorialVisibility)!r}, "
+            f"questions={self.questions!r}"
+            f")"
+        )

in2lambda/api/visibility_status.py

@@ -0,0 +1,76 @@
+"""Module for managing visibility status of questions and sets."""
+
+from enum import Enum
+
+class VisibilityStatus(Enum):
+    """Enum representing the visibility status of a question or set."""
+
+    OPEN = "OPEN"
+    HIDE = "HIDE"
+    OPEN_WITH_WARNINGS = "OPEN_WITH_WARNINGS"
+
+    def __str__(self):
+        """Return the string representation of the visibility status."""
+        return self.value
+
+    def __repr__(self) -> str:
+        """Return a string representation for debugging."""
+        return str(self)
+
+
+class VisibilityController:
+    """Controller for managing visibility status with easy-to-use methods."""
+
+    def __init__(self, initial_status: VisibilityStatus = VisibilityStatus.OPEN):
+        """Initialize the VisibilityController with a specific status."""
+        self._status = initial_status
+
+    @property
+    def status(self) -> VisibilityStatus:
+        """Return the current visibility status."""
+        return self._status
+
+    def to_open(self):
+        """Change status to OPEN.
+
+        Example:
+            >>> vc = VisibilityController()
+            >>> vc.to_open()
+            >>> vc.status
+            OPEN
+        """
+        self._status = VisibilityStatus.OPEN
+
+    def to_hide(self):
+        """Change status to HIDE.
+
+        Example:
+            >>> vc = VisibilityController()
+            >>> vc.to_hide()
+            >>> vc.status
+            HIDE
+        """
+        self._status = VisibilityStatus.HIDE
+
+    def to_open_with_warnings(self):
+        """Change status to OPEN_WITH_WARNINGS.
+
+        Example:
+            >>> vc = VisibilityController()
+            >>> vc.to_open_with_warnings()
+            >>> vc.status
+            OPEN_WITH_WARNINGS
+        """
+        self._status = VisibilityStatus.OPEN_WITH_WARNINGS
+
+    def __str__(self):
+        """Return the string representation of the visibility status."""
+        return str(self._status)
+
+    def __repr__(self) -> str:
+        """Return a string representation for debugging."""
+        return str(self)
+
+    def to_dict(self):
+        """Convert VisibilityController to dictionary for JSON serialization."""
+        return {"status": str(self._status)}

in2lambda/filters/PartPartSolSol/filter.py

@@ -6,7 +6,7 @@ from typing import Optional
 
 import panflute as pf
 
-from in2lambda.api.module import Module
+from in2lambda.api.set import Set
 from in2lambda.filters.markdown import filter
 
 
@@ -14,7 +14,7 @@ from in2lambda.filters.markdown import filter
 def pandoc_filter(
     elem: pf.Element,
     doc: pf.elements.Doc,
-    module: Module,
+    set: Set,
     parsing_answers: bool,
 ) -> Optional[pf.Str]:
     """A Pandoc filter that parses and translates various TeX elements.
@@ -23,7 +23,7 @@ def pandoc_filter(
         elem: The current TeX element being processed. This could be a paragraph,
             ordered list, etc.
         doc: A Pandoc document container - essentially the Pandoc AST.
-        module: The Python API that is used to store the result after processing
+        set: The Python API that is used to store the result after processing
             the TeX file.
         parsing_answers: Whether an answers-only document is currently being parsed.
 
@@ -46,10 +46,10 @@ def pandoc_filter(
 
     # Solutions are in a Div
     if isinstance(elem, pf.Div):
-        module.add_question(main_text="\n".join(pandoc_filter.question))
+        set.add_question(main_text="\n".join(pandoc_filter.question))
         if hasattr(pandoc_filter, "parts"):
             for part in pandoc_filter.parts:
-                module.current_question.add_part_text(part)
+                set.current_question.add_part_text(part)
         pandoc_filter.question = []
         pandoc_filter.parts = []
 
@@ -58,8 +58,8 @@ def pandoc_filter(
         match type(first_answer_part := elem.content[0]):
             case pf.OrderedList:
                 for item in first_answer_part.content:
-                    module.current_question.add_solution(pf.stringify(item))
+                    set.current_question.add_solution(pf.stringify(item))
             case pf.Para:
-                module.current_question.add_solution(pf.stringify(elem))
+                set.current_question.add_solution(pf.stringify(elem))
 
     return None

in2lambda/filters/PartSolPartSol/filter.py

@@ -7,7 +7,7 @@ from typing import Optional
 
 import panflute as pf
 
-from in2lambda.api.module import Module
+from in2lambda.api.set import Set
 from in2lambda.filters.markdown import filter
 
 
@@ -15,7 +15,7 @@ from in2lambda.filters.markdown import filter
 def pandoc_filter(
     elem: pf.Element,
     doc: pf.elements.Doc,
-    module: Module,
+    set: Set,
     parsing_answers: bool,
 ) -> Optional[pf.Str]:
     """A Pandoc filter that parses and translates various TeX elements.
@@ -24,7 +24,7 @@ def pandoc_filter(
         elem: The current TeX element being processed. This could be a paragraph,
             ordered list, etc.
         doc: A Pandoc document container - essentially the Pandoc AST.
-        module: The Python API that is used to store the result after processing
+        set: The Python API that is used to store the result after processing
             the TeX file.
         parsing_answers: Whether an answers-only document is currently being parsed.
 
@@ -48,16 +48,14 @@ def pandoc_filter(
                         for item in listItem.content
                         if not isinstance(item, pf.Div)
                     ]
-                    module.current_question.add_part_text("\n".join(part))
-                    module.current_question.add_solution(
-                        pandoc_filter.solutions.popleft()
-                    )
+                    set.current_question.add_part_text("\n".join(part))
+                    set.current_question.add_solution(pandoc_filter.solutions.popleft())
 
     if isinstance(elem, pf.Div):
         pandoc_filter.solutions.append(pf.stringify(elem))
         if pandoc_filter.question:
-            module.add_question(main_text="\n".join(pandoc_filter.question))
-            module.current_question.add_solution(pf.stringify(elem))
-            module.current_question._last_part["solution"] -= 1
+            set.add_question(main_text="\n".join(pandoc_filter.question))
+            set.current_question.add_solution(pf.stringify(elem))
+            set.current_question._last_part["solution"] -= 1
         pandoc_filter.question = []
     return None

in2lambda/filters/PartsOneSol/filter.py

@@ -9,7 +9,7 @@ from typing import Optional
 
 import panflute as pf
 
-from in2lambda.api.module import Module
+from in2lambda.api.set import Set
 from in2lambda.filters.markdown import filter
 
 
@@ -17,7 +17,7 @@ from in2lambda.filters.markdown import filter
 def pandoc_filter(
     elem: pf.Element,
     doc: pf.elements.Doc,
-    module: Module,
+    set: Set,
     parsing_answers: bool,
 ) -> Optional[pf.Str]:
     """A Pandoc filter that parses and translates various TeX elements.
@@ -26,7 +26,7 @@ def pandoc_filter(
         elem: The current TeX element being processed. This could be a paragraph,
             ordered list, etc.
         doc: A Pandoc document container - essentially the Pandoc AST.
-        module: The Python API that is used to store the result after processing
+        set: The Python API that is used to store the result after processing
             the TeX file.
         parsing_answers: Whether an answers-only document is currently being parsed.
 
@@ -42,17 +42,17 @@ def pandoc_filter(
                 isinstance(elem.prev, pf.Header)
                 and pf.stringify(elem.prev) != "Solution"
             ):
-                module.add_question(main_text=elem)
+                set.add_question(main_text=elem)
 
         # Parts are denoted via ordered lists
         case pf.OrderedList:
             for item in elem.content:
-                module.current_question.add_part_text(item)
+                set.current_question.add_part_text(item)
 
         # Solution is in a Div with nested content being "Solution"
         case pf.Div:
             if pf.stringify(elem.content[0].content) == "Solution":
-                module.current_question.add_solution(
+                set.current_question.add_solution(
                     pf.stringify(elem)  # [len("Solution") :] - For Jon Rackham
                 )
 

in2lambda/filters/PartsSepSol/filter.py

@@ -9,7 +9,7 @@ from typing import Optional
 
 import panflute as pf
 
-from in2lambda.api.module import Module
+from in2lambda.api.set import Set
 from in2lambda.filters.markdown import filter
 
 
@@ -17,7 +17,7 @@ from in2lambda.filters.markdown import filter
 def pandoc_filter(
     elem: pf.Element,
     doc: pf.elements.Doc,
-    module: Module,
+    set: Set,
     parsing_answers: bool,
 ) -> Optional[pf.Str]:
     """A Pandoc filter that parses and translates various TeX elements.
@@ -26,7 +26,7 @@ def pandoc_filter(
         elem: The current TeX element being processed. This could be a paragraph,
             ordered list, etc.
         doc: A Pandoc document container - essentially the Pandoc AST.
-        module: The Python API that is used to store the result after processing
+        set: The Python API that is used to store the result after processing
             the TeX file.
         parsing_answers: Whether an answers-only document is currently being parsed.
 
@@ -39,7 +39,7 @@ def pandoc_filter(
         for numbered_part in elem.content:
             if parsing_answers:
                 # Denotes that we've reached the answer for a new question
-                module.increment_current_question()
+                set.increment_current_question()
             # For each numbered question, extract blurb and parts
             blurb: list[str] = []
             lettered_parts: list[str] = []
@@ -64,17 +64,17 @@ def pandoc_filter(
 
             # Answers for questions with no parts
             if parsing_answers and not lettered_parts:
-                module.current_question.add_solution(spaced_blurb)
+                set.current_question.add_solution(spaced_blurb)
             # Add the main question text as the Lambda Feedback blurb
             elif not parsing_answers:
-                module.add_question(main_text=spaced_blurb)
+                set.add_question(main_text=spaced_blurb)
 
             # Add each part solution/text
             # For the solution, prepend any top level answer text to each part answer
             for part in lettered_parts:
                 (
-                    module.current_question.add_solution(spaced_blurb + part)
+                    set.current_question.add_solution(spaced_blurb + part)
                     if parsing_answers
-                    else module.current_question.add_part_text(part)
+                    else set.current_question.add_part_text(part)
                 )
     return None

in2lambda/filters/markdown.py

@@ -9,7 +9,7 @@ import panflute as pf
 from beartype.typing import Callable, Optional
 from rich_click import echo
 
-from in2lambda.api.module import Module
+from in2lambda.api.set import Set
 from in2lambda.katex_convert.katex_convert import latex_to_katex
 
 
@@ -32,7 +32,7 @@ def image_directories(tex_file: str) -> list[str]:
         >>> temp_dir = tempfile.mkdtemp()
         >>> tex_file = os.path.join(temp_dir, 'test.tex')
         >>> with open(tex_file, 'w') as f:
-        ...     f.write("\\graphicspath{{subdir1/}{subdir2/}{subdir3/}}")
+        ...    f.write("\\graphicspath{{subdir1/}{subdir2/}{subdir3/}}")
         45
         >>> image_directories(tex_file)
         ['subdir1/', 'subdir2/', 'subdir3/']
@@ -71,7 +71,7 @@ def image_path(image_name: str, tex_file: str) -> Optional[str]:
         The absolute path to the image if it can be found. If not, it returns None.
 
     Examples:
-        >>> from in2lambda.filters.markdown import image_path
+                    set.current_question.images.append(path)
         >>> import tempfile
         >>> import os
         >>> # Example TeX file with a subdirectory
@@ -117,11 +117,11 @@ def image_path(image_name: str, tex_file: str) -> Optional[str]:
 
 def filter(
     func: Callable[
-        [pf.Element, pf.elements.Doc, Module, bool],
+        [pf.Element, pf.elements.Doc, Set, bool],
         Optional[pf.Str],
     ]
 ) -> Callable[
-    [pf.Element, pf.elements.Doc, Module, str, bool],
+    [pf.Element, pf.elements.Doc, Set, str, bool],
     Optional[pf.Str],
 ]:
     """Python decorator to make generic LaTeX elements markdown readable.
@@ -136,7 +136,7 @@ def filter(
     def markdown_converter(
         elem: pf.Element,
         doc: pf.elements.Doc,
-        module: Module,
+        set: Set,
         tex_file: str,
         parsing_answers: bool,
     ) -> Optional[pf.Str]:
@@ -175,7 +175,7 @@ def filter(
                 if path is None:
                     echo(f"Warning: Couldn't find {elem.url}")
                 else:
-                    module.current_question.images.append(path)
+                    set.current_question.images.append(path)
                 return pf.Str(f"![pictureTag]({elem.url})")
 
             case pf.Strong:
@@ -189,6 +189,6 @@ def filter(
             case pf.Str:
                 return pf.Str(elem.text.replace("\u00a0", "\u202f"))
 
-        return func(elem, doc, module, parsing_answers)
+        return func(elem, doc, set, parsing_answers)
 
     return markdown_converter

in2lambda/json_convert/__init__.py

@@ -1 +1 @@
-"""Files relating to translating the questions of a Python module object into JSON."""
+"""Files relating to translating the questions of a Python set object into JSON."""

in2lambda/json_convert/json_convert.py

@@ -1,41 +1,78 @@
-"""Converts questions from a Python module object into Lambda Feedback JSON."""
+"""Converts questions from a Python set object into Lambda Feedback JSON."""
 
 import json
 import os
+import re
 import shutil
+import zipfile
 from copy import deepcopy
 from pathlib import Path
 from typing import Any
 
-from in2lambda.api.question import Question
+from in2lambda.api.set import Set
 
-MINIMAL_TEMPLATE = "minimal_template.json"
+MINIMAL_QUESTION_TEMPLATE = "minimal_template_question.json"
+MINIMAL_SET_TEMPLATE = "minimal_template_set.json"
+
+
+def _zip_sorted_folder(folder_path, zip_path):
+    """Zips the contents of a folder, preserving the directory structure.
+
+    Args:
+        folder_path: The path to the folder to zip.
+        zip_path: The path where the zip file will be created.
+    """
+    with zipfile.ZipFile(zip_path, "w") as zf:
+        for root, dirs, files in os.walk(folder_path):
+            # Sort files for deterministic, alphabetical order
+            for file in sorted(files):
+                abs_path = os.path.join(root, file)
+                rel_path = os.path.relpath(abs_path, folder_path)
+                zf.write(abs_path, arcname=rel_path)
 
 
 def converter(
-    template: dict[str, Any], ListQuestions: list[Question], output_dir: str
+    question_template: dict[str, Any],
+    set_template: dict[str, Any],
+    SetQuestions: Set,
+    output_dir: str,
 ) -> None:
-    """Turns a list of question objects into Lambda Feedback JSON.
+    """Turns a set of question objects into Lambda Feedback JSON.
 
     Args:
-        template: The loaded JSON from the minimal template (it needs to be in sync).
-        ListQuestions: A list of question objects.
+        question_template: The loaded JSON from the minimal question template (it needs to be in sync).
+        set_template: The loaded JSON from the minimal set template (it needs to be in sync).
+        SetQuestions: A Set object containing questions.
         output_dir: The absolute path for where to produced the final JSON/zip files.
     """
-    # Create output by copying template
+    ListQuestions = SetQuestions.questions
+    set_name = SetQuestions._name
+    set_description = SetQuestions._description
 
     # create directory to put the questions
     os.makedirs(output_dir, exist_ok=True)
-    output_question = os.path.join(output_dir, "set")
+    output_question = os.path.join(output_dir, set_name)
     os.makedirs(output_question, exist_ok=True)
 
-    # create directory to put images - should be in set
-    output_image = os.path.join(output_question, "media")
-    os.makedirs(output_image, exist_ok=True)
+    set_template["name"] = set_name
+    set_template["description"] = set_description
+    set_template["finalAnswerVisibility"] = str(
+        SetQuestions._finalAnswerVisibility.status
+    )
+    set_template["workedSolutionVisibility"] = str(
+        SetQuestions._workedSolutionVisibility.status
+    )
+    set_template["structuredTutorialVisibility"] = str(
+        SetQuestions._structuredTutorialVisibility.status
+    )
+    # create the set file
+    with open(f"{output_question}/set_{set_name}.json", "w") as file:
+        json.dump(set_template, file)
 
     for i in range(len(ListQuestions)):
-        output = deepcopy(template)
+        output = deepcopy(question_template)
 
+        output["orderNumber"] = i  # order number starts at 0
         # add title to the question file
         if ListQuestions[i].title != "":
             output["title"] = ListQuestions[i].title
@@ -52,7 +89,7 @@ def converter(
                 ListQuestions[i].parts[0].worked_solution
             )
             for j in range(1, len(ListQuestions[i].parts)):
-                output["parts"].append(deepcopy(template["parts"][0]))
+                output["parts"].append(deepcopy(question_template["parts"][0]))
                 output["parts"][j]["content"] = ListQuestions[i].parts[j].text
                 output["parts"][j]["orderNumber"] = j
                 output["parts"][j]["workedSolution"]["content"] = (
@@ -60,7 +97,9 @@ def converter(
                 )
 
         # Output file
-        filename = "question_" + str(i + 1)
+        filename = (
+            "question_" + str(i).zfill(3) + "_" + re.sub(r'[^\w\-_.]', '_', output['title'].strip())
+        )
 
         # write questions into directory
         with open(f"{output_question}/{filename}.json", "w") as file:
@@ -71,24 +110,30 @@ def converter(
             image_path = os.path.abspath(
                 ListQuestions[i].images[k]
             )  # converts computer path into python path
+            # If images exist, create a media directory
+            output_image = os.path.join(output_question, "media")
+            os.makedirs(output_image, exist_ok=True)
             shutil.copy(image_path, output_image)  # copies image into the directory
 
-        # output zip file in destination folder
-        shutil.make_archive(output_question, "zip", output_question)
+    # output zip file in destination folder
+    _zip_sorted_folder(output_question, output_question + ".zip")
 
 
-def main(questions: list[Question], output_dir: str) -> None:
+def main(set_questions: Set, output_dir: str) -> None:
     """Preliminary defensive programming before calling the main converter function.
 
     This ultimately then produces the Lambda Feedback JSON/ZIP files.
 
     Args:
-        questions: A list of question objects.
+        set_questions: A Set object containing questions.
         output_dir: Where to output the final Lambda Feedback JSON/ZIP files.
     """
     # Use path so minimal template can be found regardless of where the user is running python from.
-    with open(Path(__file__).with_name(MINIMAL_TEMPLATE), "r") as file:
-        template = json.load(file)
+    with open(Path(__file__).with_name(MINIMAL_QUESTION_TEMPLATE), "r") as file:
+        question_template = json.load(file)
+
+    with open(Path(__file__).with_name(MINIMAL_SET_TEMPLATE), "r") as file:
+        set_template = json.load(file)
 
     # check if directory exists in file
     if os.path.isdir(output_dir):
@@ -96,4 +141,4 @@ def main(questions: list[Question], output_dir: str) -> None:
             shutil.rmtree(output_dir)
         except OSError as e:
             print("Error: %s : %s" % (output_dir, e.strerror))
-    converter(template, questions, output_dir)
+    converter(question_template, set_template, set_questions, output_dir)

in2lambda/json_convert/{minimal_template.json → minimal_template_question.json}

@@ -1,23 +1,23 @@
 {
+  "orderNumber": 0,
+  "title": "Question title here",
+  "masterContent": "Top level question here",
+  "publish": false,
   "displayFinalAnswer": true,
   "displayStructuredTutorial": true,
   "displayWorkedSolution": true,
-  "masterContent": "Top level question here",
+  "displayChatbot": false,
   "parts": [
     {
-      "answer": "",
-      "content": "Part text here",
       "orderNumber": 0,
+      "content": "Part text here",
+      "answerContent": "",
       "responseAreas": [],
-      "tutorial": [],
-      "universalPartId": "N/A",
       "workedSolution": {
+        "title": "",
         "content": "Part worked solution here",
-        "id": "N/A",
-        "title": ""
+        "children": []
       }
     }
-  ],
-  "publish": false,
-  "title": "Question title here"
+  ]
 }

in2lambda/json_convert/minimal_template_set.json

@@ -0,0 +1,9 @@
+{
+    "name": "a simple example",
+    "description": "description here",
+    "manuallyHidden": true,
+    "finalAnswerVisibility": "OPEN_WITH_WARNINGS",
+    "workedSolutionVisibility": "OPEN_WITH_WARNINGS",
+    "structuredTutorialVisibility": "OPEN",
+    "chatbotVisibility": "HIDE"
+}

in2lambda/main.py

@@ -15,7 +15,7 @@ import panflute as pf
 import rich_click as click
 
 import in2lambda.filters
-from in2lambda.api.module import Module
+from in2lambda.api.set import Set
 
 
 def docx_to_md(docx_file: str) -> str:
@@ -81,7 +81,7 @@ def runner(
     chosen_filter: str,
     output_dir: Optional[str] = None,
     answer_file: Optional[str] = None,
-) -> Module:
+) -> Set:
     r"""Takes in a TeX file for a given subject and outputs how it's broken down within Lambda Feedback.
 
     Args:
@@ -100,12 +100,12 @@ def runner(
         >>> from in2lambda.main import runner
         >>> # Retrieve an example TeX file and run the given filter.
         >>> runner(f"{os.path.dirname(in2lambda.__file__)}/filters/PartsSepSol/example.tex", "PartsSepSol") # doctest: +ELLIPSIS
-        Module(questions=[Question(title='', parts=[Part(text=..., worked_solution=''), ...], images=[], main_text='This is a sample question\n\n'), ...])
+        Set(_name='set', _description='', _finalAnswerVisibility='OPEN_WITH_WARNINGS', _workedSolutionVisibility='OPEN_WITH_WARNINGS', _structuredTutorialVisibility='OPEN', questions=[Question(title='', parts=[Part(text=..., worked_solution=''), ...], images=[], main_text='This is a sample question\n\n'), ...])
         >>> runner(f"{os.path.dirname(in2lambda.__file__)}/filters/PartsOneSol/example.tex", "PartsOneSol") # doctest: +ELLIPSIS
-        Module(questions=[Question(title='', parts=[Part(text='This is part (a)\n\n', worked_solution=''), ...], images=[], main_text='Here is some preliminary question information that might be useful.'), ...)
+        Set(_name='set', _description='', _finalAnswerVisibility='OPEN_WITH_WARNINGS', _workedSolutionVisibility='OPEN_WITH_WARNINGS', _structuredTutorialVisibility='OPEN', questions=[Question(title='', parts=[Part(text=..., worked_solution=''), ...], images=[], main_text='Here is some preliminary question information that might be useful.'), ...])
     """
     # The list of questions for Lambda Feedback as a Python API.
-    module = Module()
+    set_obj = Set()
 
     # Dynamically import the correct pandoc filter depending on the subject.
     filter_module = importlib.import_module(f"in2lambda.filters.{chosen_filter}.filter")
@@ -124,7 +124,7 @@ def runner(
     pf.run_filter(
         filter_module.pandoc_filter,
         doc=pf.convert_text(text, input_format=input_format, standalone=True),
-        module=module,
+        set=set_obj,
         tex_file=question_file,
         parsing_answers=False,
     )
@@ -146,16 +146,16 @@ def runner(
             doc=pf.convert_text(
                 answer_text, input_format=answer_format, standalone=True
             ),
-            module=module,
+            set=set_obj,
             tex_file=answer_file,
             parsing_answers=True,
         )
 
     # Read the Python API format and convert to JSON.
     if output_dir is not None:
-        module.to_json(output_dir)
+        set_obj.to_json(output_dir)
 
-    return module
+    return set_obj
 
 
 @click.command(

{in2lambda-0.3.3.dist-info → in2lambda-1.0.0.dist-info}/METADATA

@@ -1,8 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: in2lambda
-Version: 0.3.3
+Version: 1.0.0
 Summary: Converts content ready for import into Lambda Feedback
-Home-page: https://lambda-feedback.github.io/in2lambda
 License: MIT
 Requires-Python: >=3.10,<4.0
 Classifier: Development Status :: 3 - Alpha
@@ -13,13 +12,16 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Typing :: Typed
 Requires-Dist: beartype (>=0.17.2,<0.18.0)
 Requires-Dist: panflute (>=2.3.1,<3.0.0)
+Requires-Dist: requests (<2.32.0)
 Requires-Dist: rich-click (>=1.7.4,<2.0.0)
 Project-URL: Bug Tracker, https://github.com/lambda-feedback/in2lambda/issues
 Project-URL: Documentation, https://lambda-feedback.github.io/in2lambda
+Project-URL: Homepage, https://lambda-feedback.github.io/in2lambda
 Project-URL: Repository, https://github.com/lambda-feedback/in2lambda
 Description-Content-Type: text/markdown
 

{in2lambda-0.3.3.dist-info → in2lambda-1.0.0.dist-info}/RECORD

@@ -1,8 +1,9 @@
 in2lambda/__init__.py,sha256=VvbVGkrakfqTIqnYUuv95_LFxitkMODRYr161R9128U,492
 in2lambda/api/__init__.py,sha256=uh1WA1JIIYmjaWXms3JR5LOlnizv-ozW4ijBHQxi9QA,103
-in2lambda/api/module.py,sha256=frAU0m6dJceXiVlGKiny_1UJGowwO0Q6p6RAlKjKqME,5173
 in2lambda/api/part.py,sha256=Y-W0sd5mJQifA8V8nZNTYk_HPhxhRQq5mUCdlYKioXw,204
-in2lambda/api/question.py,sha256=is-Bmx85GFAV7Jf8mblP2ZtkDgfbRcVbMhh9Tmy2hmk,6173
+in2lambda/api/question.py,sha256=B1U8FMKs89UhV51s8ePTVvoSVNnisMrQyPz3kPdZmcM,6170
+in2lambda/api/set.py,sha256=k7bY5iMuIbmDS_HxflY0J7RtRpW6DwsKMONYwqaDBAk,7135
+in2lambda/api/visibility_status.py,sha256=UU-6SOtf5VYoLAZ5NCPy7QXxe6FyfnEmnZJK8Fm17mc,2170
 in2lambda/example_questions.tex,sha256=kvcuUUoQXTJYqrAlUMfibzGsL9qFgqbKS57JIg1YhkA,9491
 in2lambda/example_solutions.tex,sha256=0idJQV9Q8VhMO_dB5RYzYkZzyEMSA594sqnPdl4wlLA,22164
 in2lambda/figures/O2_potential.png,sha256=AxDizIID24J20wqVUAneGIN_WWr6Vfra3xoBdkgJbK0,64855
@@ -10,29 +11,30 @@ in2lambda/figures/activated_complex.png,sha256=6AQuS6lftVMX0GkAR5WpOQnSgzvhNA3Pb
 in2lambda/figures/rocket-momentum.png,sha256=EXsR7k_WehhSBfnsh4fssCTEKHpu6q3lCa4csHAFGHI,397693
 in2lambda/filters/PartPartSolSol/__init__.py,sha256=YJCnCoGJfXt7jrMdgcsEfkI7Su9WK-VOvUwwefQ8zog,124
 in2lambda/filters/PartPartSolSol/example.tex,sha256=TK4JyjYj_wFfi9bkV8uKfXdFIBYPsvgMng5x1XdE_oU,667
-in2lambda/filters/PartPartSolSol/filter.py,sha256=vttP0_RNjLuLu2GSUudzv2qk-AQHuRb172JAwf_0mmA,2383
+in2lambda/filters/PartPartSolSol/filter.py,sha256=Dj7mc5jBExvHU5Dqfb8W0Df30gWqprHuVvCTYcsk0wQ,2356
 in2lambda/filters/PartSolPartSol/__init__.py,sha256=Rf1LgSoGNkkgVN3yt6dbT_UhZs5ngMAPLpOFx2NwCBo,124
 in2lambda/filters/PartSolPartSol/example.tex,sha256=teJGf6ClSgEYj7QuitPiTlfG8V2U2JEQUUzZFhQ35kk,607
-in2lambda/filters/PartSolPartSol/filter.py,sha256=bBUREAVw9FqrpQgTx9fAIivONjRefshCWSbIkZDs0Fc,2294
+in2lambda/filters/PartSolPartSol/filter.py,sha256=XlgHaLzDvemgJSK23mg2LP5KX-zwxYMWgWmggnBo0W0,2218
 in2lambda/filters/PartsOneSol/__init__.py,sha256=2aOKWhpyDwlXGNylO1VNROux1HCg2jL9XWaY_4SyWXQ,121
 in2lambda/filters/PartsOneSol/example.tex,sha256=d45J2goEL_X-otuwtwJwXId1KHTW2sGGkv6rYfYZ_M4,756
-in2lambda/filters/PartsOneSol/filter.py,sha256=DLj7DcDt1Aru2B4Tb5rljOFKZ4sXB8UUc4Yd3knnJow,2017
+in2lambda/filters/PartsOneSol/filter.py,sha256=dYol405f1wJfGEKSMYmVnzcJ_OvRCF8spSMZgTO9aos,1993
 in2lambda/filters/PartsSepSol/__init__.py,sha256=yAIUC3oJVob1R7Rrvn0sXGpK_-pXfF46DeJ9vaXSNfQ,121
 in2lambda/filters/PartsSepSol/example.tex,sha256=w7mJIcWCqKzJE_sJG4bg0J-V9kXSfe6doKWXgTd1nF8,687
-in2lambda/filters/PartsSepSol/filter.py,sha256=9cV6HhSqOQGTk5bIS36pgBbB-5UWO3mPI2s8l9ZsNeE,3206
+in2lambda/filters/PartsSepSol/filter.py,sha256=izPDylUkuRdHDJlLsOx5nArs1owdXRmdSS6eaqEaBgE,3176
 in2lambda/filters/__init__.py,sha256=tla_1d85db2MAT-fgc5sNoScuYZJeTgKedzFn3NXT2c,69
-in2lambda/filters/markdown.py,sha256=6c0Q89CCtVhJ5F7of-eueUs9WqXXhMZNFq0uZr-ZxMQ,7156
-in2lambda/json_convert/__init__.py,sha256=2X3SLn6H449zXFprtZZU7M20elsOJ09mQr7EDnv04ow,87
-in2lambda/json_convert/json_convert.py,sha256=3C8Aa0RU1zRUXDvpvL6wV16jcGTuwVI0A1NfDcQg8fg,3662
-in2lambda/json_convert/minimal_template.json,sha256=o83cZbhabXqeJiTCkLqdhijrJiiAfv1_I6HLT_QunZ8,516
+in2lambda/filters/markdown.py,sha256=OMnCt18asL7o-gbfggtQnTr5x5I_TpHppLOdfpUi308,7130
+in2lambda/json_convert/__init__.py,sha256=cZI8iK_yGzVPy54_e6SPLk3yS4Nh1Rw0XirZIVt3CAo,84
+in2lambda/json_convert/json_convert.py,sha256=LZZOwdac9h6UD5dIOSqa7XmLGCe_q_eMWSuVhQb1w1o,5520
+in2lambda/json_convert/minimal_template_question.json,sha256=mJgp6vRbeWopaXVrpzbReHXAZx0No-9ICpUoRZTdH3c,519
+in2lambda/json_convert/minimal_template_set.json,sha256=Uj4I_0rhaXdhXAIupgQMOddVmhm92e3XP3iIwh1esQc,283
 in2lambda/katex_convert/__init__.py,sha256=D0X21-NQXNrWwu_klZeCaQaqtV9vHfFv1PlrtuVAHlI,96
 in2lambda/katex_convert/delete_list.txt,sha256=Ywx8ltUbrvSxGaQVoTSXfXAe4FfPSCuRchkSCICYjHU,1753
 in2lambda/katex_convert/katex_convert.py,sha256=3UUw84432lOBnPLJwAw68MMyFPrD6ijxyYR-qVhJhnw,4909
 in2lambda/katex_convert/replace_list.txt,sha256=y5ciG4orj64eqEKsOVaQ95Zx7Xx0y4Awa4JIS27HVSw,611
-in2lambda/main.py,sha256=IifSQfMn1ARYlrvowYYcYLGo6b5sMOxxz-nnELk56_k,7068
+in2lambda/main.py,sha256=zIat7kBuk25b0JUkcPdhHYQSy2H5PL5HAIYWMe-ch8E,7353
 in2lambda/py.typed,sha256=gN7aphE6U0Jj-OffDD7hw1OkRs9gg6OPOrVpN5eAnCA,56
-in2lambda-0.3.3.dist-info/LICENSE,sha256=vEyoprnh_ic_ZQ-woDohxEIE8GJOyXqbYZ-5cH42FG4,1072
-in2lambda-0.3.3.dist-info/METADATA,sha256=ROh8P1bkW2CWV73U1g6zrvEhvtz5Pc_iceFsqp2e5wI,1833
-in2lambda-0.3.3.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-in2lambda-0.3.3.dist-info/entry_points.txt,sha256=xhkZ_lmsx7SgdhjJC-DvkFFqu-Ff-wD4Poir55bdUSM,48
-in2lambda-0.3.3.dist-info/RECORD,,
+in2lambda-1.0.0.dist-info/LICENSE,sha256=vEyoprnh_ic_ZQ-woDohxEIE8GJOyXqbYZ-5cH42FG4,1072
+in2lambda-1.0.0.dist-info/METADATA,sha256=RnRazCJTS1F-fzbqmRxHvuv2NNBFcOUuzyMhXQb7cbc,1930
+in2lambda-1.0.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+in2lambda-1.0.0.dist-info/entry_points.txt,sha256=xhkZ_lmsx7SgdhjJC-DvkFFqu-Ff-wD4Poir55bdUSM,48
+in2lambda-1.0.0.dist-info/RECORD,,

{in2lambda-0.3.3.dist-info → in2lambda-1.0.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.8.1
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any

in2lambda/api/module.py

@@ -1,125 +0,0 @@
-"""Represents a list of questions."""
-
-from dataclasses import dataclass, field
-from typing import Union
-
-import panflute as pf
-
-from in2lambda.api.question import Question
-from in2lambda.json_convert import json_convert
-
-
-@dataclass
-class Module:
-    """Represents a list of questions."""
-
-    questions: list[Question] = field(default_factory=list)
-    _current_question_index = -1
-
-    @property
-    def current_question(self) -> Question:
-        """The current question being modified, or Question("INVALID") if there are no questions.
-
-        The reasoning behind returning Question("INVALID") is in case filter logic is being applied
-        on text before the first question (e.g. intro paragraphs). In that case, there is no effect.
-
-        Returns:
-            The current question or Question("INVALID") if there are no questions.
-
-        Examples:
-            >>> from in2lambda.api.module import Module
-            >>> Module().current_question
-            Question(title='INVALID', parts=[], images=[], main_text='')
-            >>> module = Module()
-            >>> module.add_question()
-            >>> module.current_question
-            Question(title='', parts=[], images=[], main_text='')
-        """
-        return (
-            self.questions[self._current_question_index]
-            if self.questions
-            else Question("INVALID")
-        )
-
-    def add_question(
-        self, title: str = "", main_text: Union[pf.Element, str] = pf.Str("")
-    ) -> None:
-        """Inserts a new question into the module.
-
-        Args:
-            title: An optional string for the title of the question. If no title
-                is provided, the question title auto-increments i.e. Question 1, 2, etc.
-            main_text: An optional string or panflute element for the main question text.
-
-        Examples:
-            >>> from in2lambda.api.module import Module
-            >>> import panflute as pf
-            >>> module = Module()
-            >>> module.add_question("Some title", pf.Para(pf.Str("hello"), pf.Space, pf.Str("there")))
-            >>> module
-            Module(questions=[Question(title='Some title', parts=[], images=[], main_text='hello there')])
-            >>> module.add_question(main_text="Normal string text")
-            >>> module.questions[1].main_text
-            'Normal string text'
-        """
-        question = Question(title=title)
-        question.main_text = main_text
-        self.questions.append(question)
-
-    def increment_current_question(self) -> None:
-        """Manually overrides the current question being modified.
-
-        The default (-1) indicates the last question added. Incrementing for the
-        first time sets to 0 i.e. the first question.
-
-        The is useful if adding question text first and answers later.
-
-        Examples:
-            >>> from in2lambda.api.module import Module
-            >>> module = Module()
-            >>> # Imagine adding the questions from a question file first...
-            >>> module.add_question("Question 1")
-            >>> module.add_question("Question 2")
-            >>> # ...and then adding solutions from an answer file later
-            >>> module.increment_current_question()  # Loop back to question 1
-            >>> module.current_question.add_solution("Question 1 answer")
-            >>> module.increment_current_question()
-            >>> module.current_question.add_solution("Question 2 answer")
-            >>> module.questions
-            [Question(title='Question 1', parts=[Part(text='', worked_solution='Question 1 answer')], images=[], main_text=''),\
- Question(title='Question 2', parts=[Part(text='', worked_solution='Question 2 answer')], images=[], main_text='')]
-        """
-        self._current_question_index += 1
-
-    def to_json(self, output_dir: str) -> None:
-        """Turns this module into Lambda Feedback JSON/ZIP files.
-
-        WARNING: This will overwrite any existing files in the directory.
-
-        Args:
-            output_dir: Where to output the final Lambda Feedback JSON/ZIP files.
-
-        Examples:
-            >>> import tempfile
-            >>> import os
-            >>> import json
-            >>> # Create a module with two questions
-            >>> module = Module()
-            >>> module.add_question("Question 1")
-            >>> module.add_question("Question 2")
-            >>> with tempfile.TemporaryDirectory() as temp_dir:
-            ...     # Write the JSON files to the temporary directory
-            ...     module.to_json(temp_dir)
-            ...     # Check the contents of the directory
-            ...     sorted(os.listdir(temp_dir))
-            ...     # Check the contents of the set directory
-            ...     sorted(os.listdir(f"{temp_dir}/set"))
-            ...     # Check the title of the first question
-            ...     with open(f"{temp_dir}/set/question_1.json") as file:
-            ...         print(f"Question 1's title: {json.load(file)['title']}")
-            ['set', 'set.zip']
-            ['media', 'question_1.json', 'question_2.json']
-            Question 1's title: Question 1
-
-        """
-        json_convert.main(self.questions, output_dir)