in2lambda 0.2.0__tar.gz → 0.2.1__tar.gz

{in2lambda-0.2.0 → in2lambda-0.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: in2lambda
-Version: 0.2.0
-Summary: Automagically uploads questions to Lambda Feedback so you don't have to.
+Version: 0.2.1
+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

{in2lambda-0.2.0 → in2lambda-0.2.1}/in2lambda/filters/PartPartSolSol/filter.py

@@ -7,7 +7,7 @@ from typing import Optional
 import panflute as pf
 
 from in2lambda.api.module import Module
-from in2lambda.filters._markdown import filter
+from in2lambda.filters.markdown import filter
 
 
 @filter

{in2lambda-0.2.0 → in2lambda-0.2.1}/in2lambda/filters/PartSolPartSol/filter.py

@@ -8,7 +8,7 @@ from typing import Optional
 import panflute as pf
 
 from in2lambda.api.module import Module
-from in2lambda.filters._markdown import filter
+from in2lambda.filters.markdown import filter
 
 
 @filter

{in2lambda-0.2.0 → in2lambda-0.2.1}/in2lambda/filters/PartsOneSol/filter.py

@@ -10,7 +10,7 @@ from typing import Optional
 import panflute as pf
 
 from in2lambda.api.module import Module
-from in2lambda.filters._markdown import filter
+from in2lambda.filters.markdown import filter
 
 
 @filter

{in2lambda-0.2.0 → in2lambda-0.2.1}/in2lambda/filters/PartsSepSol/filter.py

@@ -10,7 +10,7 @@ from typing import Optional
 import panflute as pf
 
 from in2lambda.api.module import Module
-from in2lambda.filters._markdown import filter
+from in2lambda.filters.markdown import filter
 
 
 @filter

in2lambda-0.2.0/in2lambda/filters/_markdown.py → in2lambda-0.2.1/in2lambda/filters/markdown.py

@@ -1,5 +1,7 @@
 """Generic helper functions used during the Pandoc filter stage for markdown conversion."""
 
+import os
+import re
 from functools import cache
 from pathlib import Path
 
@@ -13,7 +15,7 @@ from in2lambda.katex_convert.katex_convert import latex_to_katex
 
 @cache
 def image_directories(tex_file: str) -> list[str]:
-    """Determines the image directories referenced by `graphicspath` in a given TeX document.
+    r"""Determines the image directories referenced by `graphicspath` in a given TeX document.
 
     Args:
         tex_file: The absolute path to a TeX file
@@ -21,22 +23,45 @@ def image_directories(tex_file: str) -> list[str]:
     Returns:
         The exact contents of `graphicspath`, regardless of whether the directories are
         absolute or relative.
+
+    Examples:
+        >>> from in2lambda.filters.markdown import image_directories
+        >>> import tempfile
+        >>> import os
+        >>> # Example TeX file with a graphicspath
+        >>> 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/}}")
+        45
+        >>> image_directories(tex_file)
+        ['subdir1/', 'subdir2/', 'subdir3/']
+        >>> with open(tex_file, 'w') as f:
+        ...    f.write("\graphicspath{ { subdir1/ }, { subdir2/ }, { subdir3/ } }")
+        57
+        >>> image_directories.cache_clear()
+        >>> image_directories(tex_file)
+        ['subdir1/', 'subdir2/', 'subdir3/']
+        >>> with open(tex_file, 'w') as f:
+        ...    f.write("No image directory")
+        18
+        >>> image_directories.cache_clear()
+        >>> image_directories(tex_file)
+        []
     """
     with open(tex_file, "r") as file:
         for line in file:
-            # Assumes line is in the format \graphicspath{ {...}, {...}, ...}
             if "graphicspath" in line:
-                return [
-                    i.strip("{").rstrip("}")
-                    for i in line.replace(" ", "")[len("\graphicspath{") : -1].split(
-                        ","
-                    )
-                ]
+                # Matches anything surrounded by curly braces, but excludes the top level
+                # graphicspath brace.
+                return [match.strip() for match in re.findall(r"{([^{]*?)}", line)]
     return []
 
 
+# TODO: This assumes the file extension is included, but that isn't required by LaTeX
+# See: https://www.overleaf.com/learn/latex/Inserting_Images#Generating_high-res_and_low-res_images
 def image_path(image_name: str, tex_file: str) -> Optional[str]:
-    """Determines the absolute path to an image referenced in a tex_file.
+    r"""Determines the absolute path to an image referenced in a tex_file.
 
     Args:
         image_name: The file name of the image e.g. example.png
@@ -44,29 +69,49 @@ def image_path(image_name: str, tex_file: str) -> Optional[str]:
 
     Returns:
         The absolute path to the image if it can be found. If not, it returns None.
+
+    Examples:
+        >>> from in2lambda.filters.markdown import image_path
+        >>> import tempfile
+        >>> import os
+        >>> # Example TeX file with a subdirectory
+        >>> 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/}}")
+        51
+        >>> # Example image in a relative subdirectory
+        >>> sub_dir = os.path.join(temp_dir, 'subdir3')
+        >>> os.makedirs(sub_dir)
+        >>> with open(os.path.join(sub_dir, 'inside_folder.png'), 'w') as f:
+        ...     pass
+        >>> image_path("inside_folder.png", tex_file) == os.path.join(temp_dir, 'subdir3', "inside_folder.png")
+        True
+        >>> # Absolute path provided
+        >>> image_path(os.path.join(temp_dir, 'subdir3', "inside_folder.png"), tex_file) == os.path.join(temp_dir, 'subdir3', "inside_folder.png")
+        True
     """
     # In case the filename is the exact absolute/relative location to the image
     # When handling relative locations (i.e. begins with dot), first go to the directory of the TeX file.
-    filename = (
-        f"{str(Path(tex_file).parent)}/" if image_name[0] == "." else ""
-    ) + image_name
+
+    filename = os.path.join(
+        str(Path(tex_file).parent) if image_name[0] == "." else "", image_name
+    )
 
     if Path(filename).is_file():
-        return filename
+        return os.path.normpath(filename)
 
     # Absolute or relative directories referenced by `graphicspath`
     image_locations = image_directories(tex_file)
 
     for directory in image_locations:
-        if directory[-1] != "/":
-            directory += "/"
-        filename = (
-            (f"{str(Path(tex_file).parent)}/" if directory[0] == "." else "")
-            + directory
-            + image_name
+        filename = os.path.join(
+            str(Path(tex_file).parent) if directory[0] == "." else "",
+            directory,
+            image_name,
         )
         if Path(filename).is_file():
-            return filename
+            return os.path.normpath(filename)
     return None
 
 

{in2lambda-0.2.0 → in2lambda-0.2.1}/in2lambda/katex_convert/katex_convert.py

@@ -34,6 +34,9 @@ def latex_to_katex(latex_string: str) -> str:
 
     Returns:
         Hopefully, a valid KaTeX expression that's similar to the LaTeX expression.
+
+    Examples:
+        >>>
     """
     katex_string = replace_functions(delete_functions(latex_string))
     return katex_string
@@ -143,7 +146,7 @@ def brace_remover(latex_string: str, brace_start_index: int) -> str:
 
 
 if __name__ == "__main__":
-    latex_input = """ \\textbf{Vector Algebra:} for two vectors $\\vec{a}$ and $\\vec{b}$ in $\\mathbb{R}^3$ given by \\norm{a}"""
+    latex_input = "\\textbf{Vector Algebra:} for two vectors $\\vec{a}$ and $\\vec{b}$ in $\\mathbb{R}^3$ given by \\norm{a}"
 
     katex_output = latex_to_katex(latex_input)
     print(katex_output)

{in2lambda-0.2.0 → in2lambda-0.2.1}/in2lambda/main.py

@@ -12,6 +12,41 @@ from in2lambda.api.module import Module
 from in2lambda.json_convert import json_convert
 
 
+def file_type(file: str) -> str:
+    """Determines which pandoc file format to use for a given file.
+
+    See https://github.com/jgm/pandoc/blob/bad922a69236e22b20d51c4ec0b90c5a6c038433/src/Text/Pandoc/Format.hs#L171
+    (or any newer commit) for pandoc's supported file extensions.
+
+    Args:
+        file: A file path with the file extension included.
+
+    Returns:
+        An option in `pandoc --list-input-formats` that matches the given file type
+
+    Examples:
+        >>> from in2lambda.main import file_type
+        >>> file_type("example.tex")
+        'latex'
+        >>> file_type("/some/random/path/demo.md")
+        'markdown'
+        >>> file_type("no_extension")
+        Traceback (most recent call last):
+        RuntimeError: Unsupported file extension: .no_extension
+        >>> file_type("demo.unknown_extension")
+        Traceback (most recent call last):
+        RuntimeError: Unsupported file extension: .unknown_extension
+    """
+    match (extension := file.split(".")[-1].lower()):
+        case "tex" | "latex" | "ltx":
+            return "latex"
+        case "md" | "rmd" | "markdown" | "mdown" | "mdwn" | "mkd" | "mkdn" | "text" | "txt":
+            return "markdown"
+        case "docx":
+            return "docx"  # Pandoc doesn't seem to support doc
+    raise RuntimeError(f"Unsupported file extension: .{extension}")
+
+
 def runner(
     question_file: str,
     chosen_filter: str,
@@ -52,7 +87,9 @@ def runner(
     # Parse the Pandoc AST using the relevant panflute filter.
     pf.run_filter(
         filter_module.pandoc_filter,
-        doc=pf.convert_text(text, input_format="latex", standalone=True),
+        doc=pf.convert_text(
+            text, input_format=file_type(question_file), standalone=True
+        ),
         module=module,
         tex_file=question_file,
         parsing_answers=False,
@@ -65,7 +102,9 @@ def runner(
 
         pf.run_filter(
             filter_module.pandoc_filter,
-            doc=pf.convert_text(answer_text, input_format="latex", standalone=True),
+            doc=pf.convert_text(
+                answer_text, input_format=file_type(answer_file), standalone=True
+            ),
             module=module,
             tex_file=answer_file,
             parsing_answers=True,
@@ -79,7 +118,8 @@ def runner(
 
 
 @click.command(
-    epilog="See the docs at https://lambda-feedback.github.io/user-documentation/ for more details."
+    no_args_is_help=True,
+    epilog="See the docs at https://lambda-feedback.github.io/in2lambda/ for more details.",
 )
 @click.argument(  # Use resolve_path to get absolute path
     "question_file", type=click.Path(exists=True, readable=True, resolve_path=True)
@@ -91,7 +131,7 @@ def runner(
         [
             i.name
             for i in pkgutil.iter_modules(in2lambda.filters.__path__)
-            if i.name[0] != "_"
+            if i.name != "markdown"
         ],
         case_sensitive=False,
     ),

{in2lambda-0.2.0 → in2lambda-0.2.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 name = "in2lambda"
-version = "0.2.0"
-description = "Automagically uploads questions to Lambda Feedback so you don't have to."
+version = "0.2.1"
+description = "Converts content ready for import into Lambda Feedback"
 authors = []
 license = "MIT"
 readme = "README.md"
@@ -43,7 +43,7 @@ pre-commit = "^3.3.3"
 [tool.poetry.group.docs.dependencies]
 furo = "^2023.8.19"
 myst-parser = "^2.0.0"
-sphinx = "^7.2.4"
+sphinx = "^7.2.5"
 sphinx-copybutton = "^0.5.2"
 sphinx-design = "^0.5.0"
 sphinx-click = "^5.0.1"