Release 0.0.3 and transition to pytask 0.0.5. (#3)

Author: tobiasraabe

CHANGES.rst

@@ -7,6 +7,12 @@ all releases are available on `Anaconda.org
 <https://anaconda.org/pytask/pytask-latex>`_.
 
 
+0.0.3 - 2020-08-12
+------------------
+
+- :gh:`3` prepares pytask-latex for pytask v0.0.5 and releases v0.0.3.
+
+
 0.0.2 - 2020-07-22
 ------------------
 

README.rst

@@ -78,22 +78,25 @@ via the ``@pytask.mark.latex`` marker. The default is the following.
 
 .. code-block:: python
 
-    @pytask.mark.latex("--pdf", "--interaction=nonstopmode", "--synctex=1")
+    @pytask.mark.latex(["--pdf", "--interaction=nonstopmode", "--synctex=1"])
     def task_compile_latex_document():
         pass
 
 For example, to compile your document with XeLaTeX, use
 
 .. code-block:: python
 
-    @pytask.mark.latex("--xelatex", "--interaction=nonstopmode")
+    @pytask.mark.latex(["--xelatex", "--interaction=nonstopmode"])
     def task_compile_latex_document():
         pass
 
 The options ``jobname``, ``output-directory`` and the ``.tex`` file which will be
 compiled are handled by the ``@pytask.mark.depends_on`` and ``@pytask.mark.produces``
 markers and cannot be changed.
 
+You can either pass a string or a list of strings to the ``@pytask.mark.latex``
+decorator.
+
 
 Parametrization
 ~~~~~~~~~~~~~~~
@@ -124,8 +127,8 @@ to include the latex decorator in the parametrization just like with
     @pytask.mark.parametrize(
         "produces, latex",
         [
-            ("document.pdf", ["--pdf", "interaction=nonstopmode"]),
-            ("document.dvi", ["--dvi", "interaction=nonstopmode"]),
+            ("document.pdf", (["--pdf", "interaction=nonstopmode"],)),
+            ("document.dvi", (["--dvi", "interaction=nonstopmode"],)),
         ],
     )
     def task_compile_latex_document():

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.0.2
+current_version = 0.0.3
 parse = (?P<major>\d+)\.(?P<minor>\d+)(\.(?P<patch>\d+))(\-?((dev)?(?P<dev>\d+))?)
 serialize = 
 	{major}.{minor}.{patch}dev{dev}

setup.py

@@ -3,7 +3,7 @@
 
 setup(
     name="pytask-latex",
-    version="0.0.2",
+    version="0.0.3",
     packages=find_packages(where="src"),
     package_dir={"": "src"},
     entry_points={"pytask": ["pytask_latex = pytask_latex.plugin"]},

src/pytask_latex/__init__.py

@@ -1 +1 @@
-__version__ = "0.0.2"
+__version__ = "0.0.3"

src/pytask_latex/collect.py

@@ -1,13 +1,32 @@
 import copy
 import functools
 import subprocess
+from typing import Iterable
+from typing import Optional
+from typing import Union
 
-import pytask
-from pytask.mark import get_markers_from_task
-from pytask.mark import has_marker
-from pytask.nodes import PythonFunctionTask
-from pytask.parametrize import _copy_func
-from pytask.shared import to_list
+from _pytask.config import hookimpl
+from _pytask.mark import get_specific_markers_from_task
+from _pytask.mark import has_marker
+from _pytask.nodes import PythonFunctionTask
+from _pytask.parametrize import _copy_func
+from _pytask.shared import to_list
+
+
+def latex(options: Optional[Union[str, Iterable[str]]] = None):
+    """Specify command line options for latexmk.
+
+    Parameters
+    ----------
+    options : Optional[Union[str, Iterable[str]]]
+        One or multiple command line options passed to latexmk.
+
+    """
+    if options is None:
+        options = ["--pdf", "--interaction=nonstopmode", "--synctex=1"]
+    elif isinstance(options, str):
+        options = [options]
+    return options
 
 
 def compile_latex_document(depends_on, produces, latex):
@@ -26,7 +45,7 @@ def compile_latex_document(depends_on, produces, latex):
     )
 
 
-@pytask.hookimpl
+@hookimpl
 def pytask_collect_task(session, path, name, obj):
     """Collect a task which is a function.
 
@@ -40,7 +59,7 @@ def pytask_collect_task(session, path, name, obj):
             path, name, obj, session
         )
         latex_function = _copy_func(compile_latex_document)
-        latex_function.pytestmark = copy.deepcopy(task.function.pytestmark)
+        latex_function.pytaskmark = copy.deepcopy(task.function.pytaskmark)
 
         args = _create_command_line_arguments(task)
         latex_function = functools.partial(latex_function, latex=args)
@@ -57,10 +76,11 @@ def pytask_collect_task(session, path, name, obj):
 
 
 def _create_command_line_arguments(task):
-    args = get_markers_from_task(task, "latex")[0].args
-    if args:
-        out = list(args)
-    else:
-        out = ["--pdf", "--interaction=nonstopmode", "--synctex=1"]
+    latex_marks = get_specific_markers_from_task(task, "latex")
+    mark = latex_marks[0]
+    for mark_ in latex_marks[1:]:
+        mark = mark.combine_with(mark_)
+
+    options = latex(*mark.args, **mark.kwargs)
 
-    return out
+    return options

src/pytask_latex/config.py

@@ -0,0 +1,6 @@
+from _pytask.config import hookimpl
+
+
+@hookimpl
+def pytask_parse_config(config):
+    config["markers"]["latex"] = "latex: Tasks which compile LaTeX documents."

src/pytask_latex/execute.py

@@ -1,13 +1,13 @@
 import shutil
 
-import pytask
-from pytask.mark import get_markers_from_task
-from pytask.nodes import FilePathNode
+from _pytask.config import hookimpl
+from _pytask.mark import get_specific_markers_from_task
+from _pytask.nodes import FilePathNode
 
 
-@pytask.hookimpl
+@hookimpl
 def pytask_execute_task_setup(task):
-    if get_markers_from_task(task, "latex"):
+    if get_specific_markers_from_task(task, "latex"):
         if shutil.which("latexmk") is None:
             raise RuntimeError(
                 "latexmk is needed to compile LaTeX documents, but it is not found on "

src/pytask_latex/parametrize.py

@@ -1,8 +1,9 @@
-import pytask
+from _pytask.config import hookimpl
+from _pytask.mark import MARK_GEN as mark  # noqa: N811
 
 
-@pytask.hookimpl
-def pytask_generate_tasks_add_marker(obj, kwargs):
+@hookimpl
+def pytask_parametrize_kwarg_to_marker(obj, kwargs):
     if callable(obj):
         if "latex" in kwargs:
-            pytask.mark.__getattr__("latex")(*kwargs.pop("latex"))(obj)
+            mark.latex(*kwargs.pop("latex"))(obj)

src/pytask_latex/plugin.py

@@ -1,11 +1,13 @@
-import pytask
+from _pytask.config import hookimpl
 from pytask_latex import collect
+from pytask_latex import config
 from pytask_latex import execute
 from pytask_latex import parametrize
 
 
-@pytask.hookimpl
+@hookimpl
 def pytask_add_hooks(pm):
     pm.register(collect)
+    pm.register(config)
     pm.register(execute)
     pm.register(parametrize)