Allow compiling LaTeX with lualatex

This is necessary to use some TeX features, such as TikZ's graph drawing
library.

As there isn't a reasonable way of detecting the necessity of using
lualatex, the --latex-compiler option is now also exposed through
config.yml, to make it possible to export the package if the statement
only compiles with the right latex compiler.

Author: meithecatte

example_package/config.yml

@@ -73,6 +73,13 @@ sinol_task_id: __ID__
 # See README.md for more information.
 sinol_contest_type: oi
 
+# You can configure how sinol-make will compile the LaTeX in `doc/`. By default,
+# it will attempt to choose an option that makes sense based on the presence
+# of *.ps/*.eps figures. You can choose between `pdflatex`, `lualatex` and
+# `latex_dvi`.
+# This option can be overridden by passing `--latex_compiler` to `sinol-make doc`.
+sinol_latex_compiler: auto
+
 # You can specify which tests are static (handwritten). This allows sinol-make to differentiate between
 # old and handwritten tests. If this key is not present old tests won't be removed.
 # This key is optional and should be a list of tests.

src/sinol_make/commands/doc/__init__.py

@@ -4,7 +4,7 @@
 import subprocess
 
 from sinol_make import util
-from sinol_make.helpers import paths
+from sinol_make.helpers import package_util, paths
 from sinol_make.interfaces.BaseCommand import BaseCommand
 
 
@@ -37,11 +37,11 @@ def compile_file_latex_div(self, file_path):
         print(util.info(f'Compilation successful for file {os.path.basename(file_path)}.'))
         return True
 
-    def compile_pdf_latex(self, file_path):
-        print(f'Compiling {os.path.basename(file_path)} (pdflatex)...')
+    def compile_pdf_latex(self, file_path, pdflatex='pdflatex'):
+        print(f'Compiling {os.path.basename(file_path)} ({pdflatex})...')
         os.chdir(os.path.dirname(file_path))
         for _ in range(3):
-            subprocess.run(['pdflatex', file_path])
+            subprocess.run([pdflatex, file_path])
         pdf_file = os.path.splitext(file_path)[0] + '.pdf'
         pdf_file_path = os.path.join(os.path.dirname(file_path), pdf_file)
         if not os.path.exists(pdf_file_path):
@@ -53,8 +53,8 @@ def make_file(self, file_path):
         """
         Compile the file two times to get the references right.
         """
-        if self.compilation_method == 'pdflatex':
-            return self.compile_pdf_latex(file_path)
+        if self.compilation_method in ('pdflatex', 'lualatex'):
+            return self.compile_pdf_latex(file_path, self.compilation_method)
         else:
             if not self.compile_file_latex_div(file_path):
                 return False
@@ -73,10 +73,11 @@ def configure_subparser(self, subparser: argparse.ArgumentParser):
             help='Compile latex files to pdf',
             description='Compiles latex files to pdf. By default compiles all files in the `doc` directory.\n'
                         'You can also specify files to compile.')
-        parser.add_argument('--latex-compiler', dest='latex_compiler', choices=['auto', 'pdflatex', 'latex_dvi'],
+        parser.add_argument('--latex-compiler', dest='latex_compiler', choices=['auto', 'pdflatex', 'latex_dvi', 'lualatex'],
                             help='Compiler used to compile documents. Available options:\n'
-                                 ' auto - uses the compiler based on the image types (default option).\n'
+                                 ' auto - uses the compiler based on the image types (default option, if not configured in config.yml).\n'
                                  ' pdflatex - uses pdflatex. Works with .png and .jpg images.\n'
+                                 ' lualatex - uses lualatex. Like pdflatex, but supports the graph drawing library of TikZ.\n'
                                  ' latex_dvi - uses latex and dvipdf. Works with .ps and .eps images.', default='auto')
         parser.add_argument('files', type=str, nargs='*', help='files to compile')
         return parser
@@ -85,10 +86,13 @@ def run(self, args: argparse.Namespace):
         args = util.init_package_command(args)
 
         if not hasattr(args, 'latex_compiler'):
-            args.latex_compiler = 'auto'
+            config = package_util.get_config()
+            args.latex_compiler = config.get('sinol_latex_compiler', 'auto')
 
         if args.latex_compiler == 'pdflatex':
             self.compilation_method = 'pdflatex'
+        elif args.latex_compiler == 'lualatex':
+            self.compilation_method = 'lualatex'
         elif args.latex_compiler == 'latex_dvi':
             self.compilation_method = 'latex_dvi'
         elif args.latex_compiler == 'auto':

src/sinol_make/util.py

@@ -91,6 +91,7 @@ def save_config(config):
         "title_en",
         "sinol_task_id",
         "sinol_contest_type",
+        "sinol_latex_compiler",
         "sinol_static_tests",
         "sinol_undocumented_time_tool",
         "sinol_undocumented_test_limits",