A community-maintained Python framework for creating mathematical animations.
feat: support multiple TeX compilers in `TexTemplate` (#4810)
Caffein34c4622df54ec
diff --git a/manim/utils/tex.py b/manim/utils/tex.pyindex 6ef71777c..4617041ba 100644--- a/manim/utils/tex.py+++ b/manim/utils/tex.py@@ -33,8 +33,10 @@ class TexTemplate:_body: str = field(default="", init=False)"""A custom body, can be set from a file."""- tex_compiler: str = "latex"- """The TeX compiler to be used, e.g. ``latex``, ``pdflatex`` or ``lualatex``."""+ tex_compiler: str | list[str] = "latex"+ """The TeX compiler(s) to be used. Can be a single compiler (e.g. ``"latex"``,+ ``"pdflatex"``, ``"lualatex"``) or a list of compilers to compile in order+ (e.g. ``["lualatex", "pdflatex"]``)."""description: str = """""A description of the template"""diff --git a/manim/utils/tex_file_writing.py b/manim/utils/tex_file_writing.pyindex b7ad1bdc3..6a3765feb 100644--- a/manim/utils/tex_file_writing.py+++ b/manim/utils/tex_file_writing.py@@ -178,7 +178,9 @@ def insight_package_not_found_error(matching: Match[str]) -> Generator[str]:yield f"Install {matching[1]} it using your LaTeX package manager, or check for typos."-def compile_tex(tex_file: Path, tex_compiler: str, output_format: str) -> Path:+def compile_tex(+ tex_file: Path, tex_compiler: str | list[str], output_format: str+) -> Path:"""Compiles a tex_file into a .dvi or a .xdv or a .pdfParameters@@ -186,7 +188,8 @@ def compile_tex(tex_file: Path, tex_compiler: str, output_format: str) -> Path:tex_fileFile name of TeX file to be typeset.tex_compiler- String containing the compiler to be used, e.g. ``pdflatex`` or ``lualatex``+ The TeX compiler(s) to be used.+ Can be a single compiler (e.g. ``"latex"``, ``"pdflatex"`` ``"lualatex"``) or a list of compilers to compile in order (e.g. ``["lualatex", "pdflatex"]``).output_formatString containing the output format generated by the compiler, e.g. ``.dvi`` or ``.pdf``@@ -197,22 +200,26 @@ def compile_tex(tex_file: Path, tex_compiler: str, output_format: str) -> Path:"""result = tex_file.with_suffix(output_format)tex_dir = config.get_dir("tex_dir")+ tex_compilers = [tex_compiler] if isinstance(tex_compiler, str) else tex_compilerif not result.exists():- command = make_tex_compilation_command(- tex_compiler,- output_format,- tex_file,- tex_dir,- )- cp = subprocess.run(command, stdout=subprocess.DEVNULL)- if cp.returncode != 0:- log_file = tex_file.with_suffix(".log")- print_all_tex_errors(log_file, tex_compiler, tex_file)- raise ValueError(- f"{tex_compiler} error converting to"- f" {output_format[1:]}. See log output above or"- f" the log file: {log_file}",+ for i, compiler in enumerate(tex_compilers, start=1):+ if len(tex_compilers) > 1:+ logger.info(f"Compiling {i} of {len(tex_compilers)}: {compiler}")+ command = make_tex_compilation_command(+ compiler,+ output_format,+ tex_file,+ tex_dir,)+ cp = subprocess.run(command, stdout=subprocess.DEVNULL)+ if cp.returncode != 0:+ log_file = tex_file.with_suffix(".log")+ print_all_tex_errors(log_file, compiler, tex_file)+ raise ValueError(+ f"{compiler} error converting to"+ f" {output_format[1:]}. See log output above or"+ f" the log file: {log_file}",+ )return result