add render job wrapper

Author: JohnMount

coverage.txt

@@ -1,5 +1,5 @@
 ============================= test session starts ==============================
-platform darwin -- Python 3.9.7, pytest-6.2.5, py-1.11.0, pluggy-1.0.0
+platform darwin -- Python 3.9.12, pytest-7.1.1, pluggy-1.0.0
 rootdir: /Users/johnmount/Documents/work/wvpy/pkg
 plugins: anyio-3.5.0, cov-3.0.0
 collected 20 items
@@ -19,16 +19,26 @@ tests/test_stats1.py .                                                   [ 90%]
 tests/test_threshold_stats.py .                                          [ 95%]
 tests/test_typs_in_frame.py .                                            [100%]
 
----------- coverage: platform darwin, python 3.9.7-final-0 -----------
+=============================== warnings summary ===============================
+../../../../opt/anaconda3/envs/research_env/lib/python3.9/site-packages/seaborn/rcmod.py:82
+  /Users/johnmount/opt/anaconda3/envs/research_env/lib/python3.9/site-packages/seaborn/rcmod.py:82: DeprecationWarning: distutils Version classes are deprecated. Use packaging.version instead.
+    if LooseVersion(mpl.__version__) >= "3.0":
+
+../../../../opt/anaconda3/envs/research_env/lib/python3.9/site-packages/setuptools/_distutils/version.py:351
+  /Users/johnmount/opt/anaconda3/envs/research_env/lib/python3.9/site-packages/setuptools/_distutils/version.py:351: DeprecationWarning: distutils Version classes are deprecated. Use packaging.version instead.
+    other = LooseVersion(other)
+
+-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
+
+---------- coverage: platform darwin, python 3.9.12-final-0 ----------
 Name                      Stmts   Miss  Cover
 ---------------------------------------------
 wvpy/__init__.py              3      0   100%
-wvpy/jtools.py              156     41    74%
+wvpy/jtools.py              178     58    67%
 wvpy/pysheet.py              89     89     0%
 wvpy/render_workbook.py      47     47     0%
 wvpy/util.py                321      7    98%
 ---------------------------------------------
-TOTAL                       616    184    70%
-
+TOTAL                       638    201    68%
 
-============================= 20 passed in 13.17s ==============================
+======================= 20 passed, 2 warnings in 16.34s ========================

pkg/build/lib/wvpy/jtools.py

@@ -276,3 +276,44 @@ def render_as_html(
         raise caught
     if verbose:
         print(f'\tdone render_as_html "{html_name}" {datetime.datetime.now()}')
+
+
+class JTask:
+    def __init__(
+        self,
+        sheet_name: str,
+        output_suffix: Optional[str] = None,
+        exclude_input: bool = True,
+        init_code: Optional[str] = None,
+        path_prefix: str = "",
+    ) -> None:
+        assert isinstance(sheet_name, str)
+        assert isinstance(output_suffix, (str, type(None)))
+        assert isinstance(exclude_input, bool)
+        assert isinstance(init_code, (str, type(None)))
+        assert isinstance(path_prefix, str)
+        self.sheet_name = sheet_name
+        self.output_suffix = output_suffix
+        self.exclude_input = exclude_input
+        self.init_code = init_code
+        self.path_prefix = path_prefix
+
+    def __str__(self) -> str:
+        return f'JTask(sheet_name="{self.sheet_name}", output_suffix="{self.output_suffix}", exclude_input="{self.exclude_input}", init_code="""{self.init_code}""", path_prefix="{self.path_prefix}")'
+
+    def __repr__(self) -> str:
+        return self.__str__()
+
+
+def job_fn(arg: JTask):
+    assert isinstance(arg, JTask)
+    # render notebook
+    try:
+        render_as_html(
+            arg.path_prefix + arg.sheet_name,
+            exclude_input=arg.exclude_input,
+            output_suffix=arg.output_suffix,
+            init_code=arg.init_code,
+        )
+    except Exception as e:
+        print(f"{arg} caught {e}")