runem 0.5.0__tar.gz → 0.6.0__tar.gz

{runem-0.5.0 → runem-0.6.0}/HISTORY.md

@@ -4,6 +4,76 @@ Changelog
 
 (unreleased)
 ------------
+- Merge pull request #78 from lursight/feat/better_error_display. [Frank
+  Harrison]
+
+  Feat/better error display
+- Fix(spinner): fixes the Spinner show it only shows for --show-spinner.
+  [Frank Harrison]
+
+  Also, fixes it so that it shows only a single spinner
+- Feat(colours): adds better colours to the terminal output. [Frank
+  Harrison]
+
+  This helps to reinfoce time-saved and other aspects of the tool.
+- Feat(better-errors): makes finding the stderr in the list of errors
+  easier. [Frank Harrison]
+
+  We do this by colouring the text for the commands and wrapping the
+  errors with a red-box.
+
+  We colour:
+  - command-lines -> yellow
+  - job-labels -> blue
+  - errors -> red
+  - in-progress -> green box
+- Merge pull request #77 from lursight/fix/log-verbosity. [Frank
+  Harrison]
+
+  fix(log-verbosity): fixes verbosity bug when not showing the spinner
+- Fix(log-verbosity): fixes verbosity bug when not showing the spinner.
+  [Frank Harrison]
+
+  We were showing the running procs on every tick, instead of just the
+  changes to the running procs, if any.
+- Merge pull request #76 from lursight/chore/types/job-return-type.
+  [Frank Harrison]
+
+  chore(types) fixes exports for JobReturn type
+- Chore(types): exports the JobReturn type from the types submodule.
+  [Frank Harrison]
+- Merge pull request #75 from lursight/chore/todos. [Frank Harrison]
+
+  chore(todos): adds TODOD.txt to track ideas for runem
+- Chore(todos): adds TODOD.txt to track ideas for runem. [Frank
+  Harrison]
+- Merge pull request #74 from lursight/chore/help_docs. [Frank Harrison]
+
+  chore(docs): removes help output from a details block
+- Chore(docs): removes help output from a details block. [Frank
+  Harrison]
+
+  The details block broke the pre-formatted styling of the code-block.
+- Merge pull request #73 from lursight/chore/update_contrib. [Frank
+  Harrison]
+
+  chore(docs): trying to add line-breaks to non-bulletpointed list
+- Chore(docs): trying to add line-breaks to non-bulletpointed list.
+  [Frank Harrison]
+- Merge pull request #72 from lursight/chore/update_contrib. [Frank
+  Harrison]
+
+  Chore/update CONTRIBUTING.md and README.md
+- Chore(spell): adds 'pyenv' to dictionary. [Frank Harrison]
+- Chore(docs): improves the README. [Frank Harrison]
+- Docs(contrib): updates the contributing docs. [Frank Harrison]
+
+  We add some of the basics as well as some more recent changes
+
+
+0.5.0 (2024-12-12)
+------------------
+- Release: version 0.5.0 🚀 [Frank Harrison]
 - Merge pull request #71 from lursight/feat/pyproject. [Frank Harrison]
 
   Feat/pyproject

runem-0.6.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.2
+Name: runem
+Version: 0.6.0
+Summary: Awesome runem created by lursight
+Author: lursight
+License: Specify your license here
+Project-URL: Homepage, https://github.com/lursight/runem/
+Keywords: example,runem
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: packaging>=22.0
+Requires-Dist: PyYAML>=5.0.0
+Requires-Dist: rich>10.0.0
+Requires-Dist: typing_extensions>3.0.0
+Provides-Extra: tests
+Requires-Dist: black==24.10.0; extra == "tests"
+Requires-Dist: coverage==7.5; extra == "tests"
+Requires-Dist: docformatter==1.7.5; extra == "tests"
+Requires-Dist: flake8-bugbear==24.2.6; extra == "tests"
+Requires-Dist: flake8==7.0.0; extra == "tests"
+Requires-Dist: gitchangelog==3.0.4; extra == "tests"
+Requires-Dist: isort==5.13.2; extra == "tests"
+Requires-Dist: mkdocs==1.5.3; extra == "tests"
+Requires-Dist: mypy==1.9.0; extra == "tests"
+Requires-Dist: pydocstyle==6.3.0; extra == "tests"
+Requires-Dist: pylint==3.1.0; extra == "tests"
+Requires-Dist: pylama==8.4.1; extra == "tests"
+Requires-Dist: pytest-cov==6.0.0; extra == "tests"
+Requires-Dist: pytest-profiling==1.7.0; extra == "tests"
+Requires-Dist: pytest-xdist==3.6.1; extra == "tests"
+Requires-Dist: pytest==8.3.3; extra == "tests"
+Requires-Dist: setuptools; extra == "tests"
+Requires-Dist: termplotlib==0.3.9; extra == "tests"
+Requires-Dist: tox; extra == "tests"
+Requires-Dist: types-PyYAML==6.0.12.20240311; extra == "tests"
+Requires-Dist: requests-mock==1.11.0; extra == "tests"
+Requires-Dist: types-setuptools; extra == "tests"
+
+<!-- [![codecov](https://codecov.io/gh/lursight/runem/branch/main/graph/badge.svg?token=run-test_token_here)](https://codecov.io/gh/lursight/runem) -->
+[![CI](https://github.com/lursight/runem/actions/workflows/main.yml/badge.svg)](https://github.com/lursight/runem/actions/workflows/main.yml)
+[![DOCS](https://lursight.github.io/runem/docs/VIEW-DOCS-31c553.svg)](https://lursight.github.io/runem/)
+
+# Run’em
+
+**Your Blueprint of Commands. Your Engine of Parallel Execution.**
+Run’em is your definitive blueprint of tasks and commands—instantly discoverable, effortlessly parallel, and elegantly extensible.
+
+## Core Strengths
+
+**Blueprint** - discover tasks and onboard smoothly\
+**Parallel**  - get results quicker\
+**Simple**  - define task easily\
+**Extensible** - add tasks quickly\
+**Filters** - powerful task selection\
+**Reports** - see metrics on tasks
+
+## Why Run’em?
+- **Command Blueprint:** Instantly see and run all your tasks. No guesswork, no rummaging.
+- **Effortless Parallelism:** Execute tasks side-by-side to obliterate downtime.
+- **Simple YAML Declarations:** Define everything in one `.runem.yml`.
+- **Extensible & Smart:** Adapt to monorepos, complex workflows, and evolving needs.
+- **Discoverable by Design:** `runem --help` guides your team, new hires, or contributors to every defined command.
+
+## Contents
+- [Run’em](#runem)
+  - [Core Strengths](#core-strengths)
+  - [Why Run’em?](#why-runem)
+  - [Contents](#contents)
+- [Highlights](#highlights)
+- [Quick Start](#quick-start)
+- [Basic Use](#basic-use)
+- [Advanced Use](#advanced-use)
+- [Help & Discovery](#help--discovery)
+- [Troubleshooting](#troubleshooting)
+- [Contribute & Support](#contribute--support)
+- [About Run’em](#about-runem)
+
+# Highlights
+## Blueprint of Commands:
+The blueprint (available via `--help`) gives you a manifest of all jobs and tasks in a
+project. A single source of truth for all tasks.
+## Parallel Execution:
+Maximise speed with automatic concurrency. Runem tries to run all tasks as quickly as
+possible, looking at resources, with dependencies. It is not yet a full
+dependency-execution graph, but by version 1.0.0 it will be.
+## Filtering:
+Use powerful and flexible filtering. Select or excluded tasks by `tags`, `name` and
+`phase`. Chose the task to be run based on your needs, right now.
+
+You can also customise filtering by adding your own command `options`.
+
+See `--tags`, `--not-tags`, `--jobs`, `--not-jobs`, `--phases` and `--not-phases`.
+## Powerful Insights:** Understand what ran, how fast, and what failed.
+**Quiet by Default:** Focus on what matters, and reveal detail only when needed.
+
+# Quick Start
+**Install:**
+```bash
+pip install runem
+```
+**Define a task:**
+
+```yaml
+`# .runem.yml
+ - job:
+    command: echo "hello world!"
+```
+
+**Run:**
+
+```bash
+runem
+```
+
+Run multiple commands in parallel, see timing, and keep output minimal. Need detail?
+
+```bash
+runem --verbose
+```
+
+[Quick Start Docs](https://lursight.github.io/runem/docs/quick_start.html)
+
+# Basic Use
+
+Get comfortable with typical workflows:
+[Basic Use Docs](https://lursight.github.io/runem/docs/basic_use.html)
+
+# Advanced Use
+
+Scale up with multi-phase configs, filtered execution, and custom reporting:
+[Advanced Configuration](https://lursight.github.io/runem/docs/configuration.html)
+[Custom Reporting](https://lursight.github.io/runem/docs/reports.html)
+
+# Help & Discovery
+
+`runem --help` is your radar—instantly mapping out every available task:
+[Help & Job Discovery](https://lursight.github.io/runem/docs/help_and_job_discovery.html)
+
+# Troubleshooting
+
+Swift solutions to common issues:
+[Troubleshooting & Known Issues](https://lursight.github.io/runem/docs/troubleshooting_known_issues.html)
+
+---
+
+# Contribute & Support
+
+Brought to you by [Lursight Ltd.](https://lursight.com) and an open community.
+[CONTRIBUTING.md](CONTRIBUTING.md)
+[❤️ Sponsor](https://github.com/sponsors/lursight/)
+
+# About Run’em
+
+Run’em exists to accelerate your team’s delivery and reduce complexity. Learn about our [Mission](https://lursight.github.io/runem/docs/mission.html).
+

runem-0.6.0/README.md

@@ -0,0 +1,117 @@
+<!-- [![codecov](https://codecov.io/gh/lursight/runem/branch/main/graph/badge.svg?token=run-test_token_here)](https://codecov.io/gh/lursight/runem) -->
+[![CI](https://github.com/lursight/runem/actions/workflows/main.yml/badge.svg)](https://github.com/lursight/runem/actions/workflows/main.yml)
+[![DOCS](https://lursight.github.io/runem/docs/VIEW-DOCS-31c553.svg)](https://lursight.github.io/runem/)
+
+# Run’em
+
+**Your Blueprint of Commands. Your Engine of Parallel Execution.**
+Run’em is your definitive blueprint of tasks and commands—instantly discoverable, effortlessly parallel, and elegantly extensible.
+
+## Core Strengths
+
+**Blueprint** - discover tasks and onboard smoothly\
+**Parallel**  - get results quicker\
+**Simple**  - define task easily\
+**Extensible** - add tasks quickly\
+**Filters** - powerful task selection\
+**Reports** - see metrics on tasks
+
+## Why Run’em?
+- **Command Blueprint:** Instantly see and run all your tasks. No guesswork, no rummaging.
+- **Effortless Parallelism:** Execute tasks side-by-side to obliterate downtime.
+- **Simple YAML Declarations:** Define everything in one `.runem.yml`.
+- **Extensible & Smart:** Adapt to monorepos, complex workflows, and evolving needs.
+- **Discoverable by Design:** `runem --help` guides your team, new hires, or contributors to every defined command.
+
+## Contents
+- [Run’em](#runem)
+  - [Core Strengths](#core-strengths)
+  - [Why Run’em?](#why-runem)
+  - [Contents](#contents)
+- [Highlights](#highlights)
+- [Quick Start](#quick-start)
+- [Basic Use](#basic-use)
+- [Advanced Use](#advanced-use)
+- [Help & Discovery](#help--discovery)
+- [Troubleshooting](#troubleshooting)
+- [Contribute & Support](#contribute--support)
+- [About Run’em](#about-runem)
+
+# Highlights
+## Blueprint of Commands:
+The blueprint (available via `--help`) gives you a manifest of all jobs and tasks in a
+project. A single source of truth for all tasks.
+## Parallel Execution:
+Maximise speed with automatic concurrency. Runem tries to run all tasks as quickly as
+possible, looking at resources, with dependencies. It is not yet a full
+dependency-execution graph, but by version 1.0.0 it will be.
+## Filtering:
+Use powerful and flexible filtering. Select or excluded tasks by `tags`, `name` and
+`phase`. Chose the task to be run based on your needs, right now.
+
+You can also customise filtering by adding your own command `options`.
+
+See `--tags`, `--not-tags`, `--jobs`, `--not-jobs`, `--phases` and `--not-phases`.
+## Powerful Insights:** Understand what ran, how fast, and what failed.
+**Quiet by Default:** Focus on what matters, and reveal detail only when needed.
+
+# Quick Start
+**Install:**
+```bash
+pip install runem
+```
+**Define a task:**
+
+```yaml
+`# .runem.yml
+ - job:
+    command: echo "hello world!"
+```
+
+**Run:**
+
+```bash
+runem
+```
+
+Run multiple commands in parallel, see timing, and keep output minimal. Need detail?
+
+```bash
+runem --verbose
+```
+
+[Quick Start Docs](https://lursight.github.io/runem/docs/quick_start.html)
+
+# Basic Use
+
+Get comfortable with typical workflows:
+[Basic Use Docs](https://lursight.github.io/runem/docs/basic_use.html)
+
+# Advanced Use
+
+Scale up with multi-phase configs, filtered execution, and custom reporting:
+[Advanced Configuration](https://lursight.github.io/runem/docs/configuration.html)
+[Custom Reporting](https://lursight.github.io/runem/docs/reports.html)
+
+# Help & Discovery
+
+`runem --help` is your radar—instantly mapping out every available task:
+[Help & Job Discovery](https://lursight.github.io/runem/docs/help_and_job_discovery.html)
+
+# Troubleshooting
+
+Swift solutions to common issues:
+[Troubleshooting & Known Issues](https://lursight.github.io/runem/docs/troubleshooting_known_issues.html)
+
+---
+
+# Contribute & Support
+
+Brought to you by [Lursight Ltd.](https://lursight.com) and an open community.
+[CONTRIBUTING.md](CONTRIBUTING.md)
+[❤️ Sponsor](https://github.com/sponsors/lursight/)
+
+# About Run’em
+
+Run’em exists to accelerate your team’s delivery and reduce complexity. Learn about our [Mission](https://lursight.github.io/runem/docs/mission.html).
+

runem-0.6.0/runem/VERSION

@@ -0,0 +1 @@
+0.6.0

{runem-0.5.0 → runem-0.6.0}/runem/blocking_print.py

@@ -13,7 +13,14 @@ def _reset_console() -> Console:
 
     RICH_CONSOLE = Console(
         log_path=False,  # Do NOT print the source path.
-        markup=False,  # Do NOT print markup e.g. `[blink]Don't Panic![/blink]`.
+        # We allow markup here, BUT stdout/stderr from other procs should have
+        # `escape()` called on them so they don't error here.
+        # This means 'rich' effects/colors can be judiciously applied:
+        # e.g. `[blink]Don't Panic![/blink]`.
+        markup=True,
+        # `highlight` is what colourises string and number in print() calls.
+        # We do not want this to be auto-magic.
+        highlight=False,
     )
     return RICH_CONSOLE
 
@@ -31,7 +38,8 @@ def _reset_console_for_tests() -> None:
     RICH_CONSOLE = Console(
         log_path=False,  # Do NOT print the source path.
         log_time=False,  # Do not prefix with log time e.g. `[time] log message`.
-        markup=False,  # Do NOT print markup e.g. `[blink]Don't Panic![/blink]`.
+        markup=True,  # Allow some markup e.g. `[blink]Don't Panic![/blink]`.
+        highlight=False,
         width=999,  # A very wide width.
     )
 

runem-0.6.0/runem/log.py

@@ -0,0 +1,43 @@
+import typing
+
+from runem.blocking_print import blocking_print
+
+
+def log(
+    msg: str = "",
+    decorate: bool = True,
+    end: typing.Optional[str] = None,
+) -> None:
+    """Thin wrapper around 'print', change the 'msg' & handles system-errors.
+
+    One way we change it is to decorate the output with 'runem'
+
+    Parameters:
+        msg: str - the message to log out. Any `rich` markup will be escaped
+                   and not applied.
+        decorate: str - whether to add runem-specific prefix text. We do this
+                        to identify text that comes from the app vs text that
+                        comes from hooks or other third-parties.
+        end: Optional[str] - same as the end option used by `print()` and
+                             `rich`
+    Returns:
+        Nothing
+    """
+    # Remove any markup as it will probably error, if unsanitised.
+    # msg = escape(msg)
+
+    if decorate:
+        # Make it clear that the message comes from `runem` internals.
+        msg = f"[light_slate_grey]runem[/light_slate_grey]: {msg}"
+
+    # print in a blocking manner, waiting for system resources to free up if a
+    # runem job is contending on stdout or similar.
+    blocking_print(msg, end=end)
+
+
+def warn(msg: str) -> None:
+    log(f"[yellow]WARNING[/yellow]: {msg}")
+
+
+def error(msg: str) -> None:
+    log(f"[red]ERROR[/red]: {msg}")

{runem-0.5.0 → runem-0.6.0}/runem/report.py

@@ -211,7 +211,10 @@ def _print_reports_by_phase(
         for job_report_url_info in report_urls:
             if not job_report_url_info:
                 continue
-            log(f"report: {str(job_report_url_info[0])}: {str(job_report_url_info[1])}")
+            log(
+                f"report: [blue]{str(job_report_url_info[0])}[/blue]: "
+                f"{str(job_report_url_info[1])}"
+            )
 
 
 def report_on_run(

{runem-0.5.0 → runem-0.6.0}/runem/run_command.py

@@ -7,17 +7,33 @@ from subprocess import STDOUT as SUBPROCESS_STDOUT
 from subprocess import Popen
 from timeit import default_timer as timer
 
+from rich.markup import escape
+
 from runem.log import log
 
 TERMINAL_WIDTH = 86
 
 
-class RunCommandBadExitCode(RuntimeError):
-    pass
+class RunemJobError(RuntimeError):
+    """An exception type that stores the stdout/stderr.
+
+    Designed so that we do not print the full stdout via the exception stack, instead,
+    allows an opportunity to parse the markup in it.
+    """
+
+    def __init__(self, friendly_message: str, stdout: str):
+        self.stdout = stdout
+        super().__init__(friendly_message)
 
 
-class RunCommandUnhandledError(RuntimeError):
-    pass
+class RunCommandBadExitCode(RunemJobError):
+    def __init__(self, stdout: str):
+        super().__init__(friendly_message="Bad exit-code", stdout=stdout)
+
+
+class RunCommandUnhandledError(RunemJobError):
+    def __init__(self, stdout: str):
+        super().__init__(friendly_message="Unhandled job error", stdout=stdout)
 
 
 # A function type for recording timing information.
@@ -27,25 +43,25 @@ RecordSubJobTimeType = typing.Callable[[str, timedelta], None]
 def parse_stdout(stdout: str, prefix: str) -> str:
     """Prefixes each line of the output with a given label, except trailing new
     lines."""
+
     # Edge case: Return the prefix immediately for an empty string
     if not stdout:
         return prefix
 
-    # Split stdout into lines, noting if it ends with a newline
-    ends_with_newline = stdout.endswith("\n")
+    # Stop errors in `rich` by parsing out anything that might look like
+    # rich-markup.
+    stdout = escape(stdout)
+
+    # Split stdout into lines
     lines = stdout.split("\n")
 
     # Apply prefix to all lines except the last if it's empty (due to a trailing newline)
-    modified_lines = [f"{prefix}{line}" for line in lines[:-1]] + (
-        [lines[-1]]
-        if lines[-1] == "" and ends_with_newline
-        else [f"{prefix}{lines[-1]}"]
+    modified_lines = [f"{prefix}{escape(line)}" for line in lines[:-1]] + (
+        [f"{prefix}{escape(lines[-1])}"]
     )
 
     # Join the lines back together, appropriately handling the final newline
-    modified_stdout = "\n".join(modified_lines)
-    # if ends_with_newline:
-    #     modified_stdout += "\n"
+    modified_stdout: str = "\n".join(modified_lines)
 
     return modified_stdout
 
@@ -69,24 +85,34 @@ def _log_command_execution(
     label: str,
     env_overrides: typing.Optional[typing.Dict[str, str]],
     valid_exit_ids: typing.Optional[typing.Tuple[int, ...]],
+    decorate_logs: bool,
     verbose: bool,
     cwd: typing.Optional[pathlib.Path] = None,
 ) -> None:
     """Logs out useful debug information on '--verbose'."""
     if verbose:
-        log(f"running: start: {label}: {cmd_string}")
+        log(
+            f"running: start: [blue]{label}[/blue]: [yellow]{cmd_string}[yellow]",
+            decorate=decorate_logs,
+        )
         if valid_exit_ids is not None:
             valid_exit_strs = ",".join(str(exit_code) for exit_code in valid_exit_ids)
-            log(f"\tallowed return ids are: {valid_exit_strs}")
+            log(
+                f"\tallowed return ids are: [green]{valid_exit_strs}[/green]",
+                decorate=decorate_logs,
+            )
 
         if env_overrides:
             env_overrides_as_string = " ".join(
                 [f"{key}='{value}'" for key, value in env_overrides.items()]
             )
-            log(f"ENV OVERRIDES: {env_overrides_as_string} {cmd_string}")
+            log(
+                f"ENV OVERRIDES: [yellow]{env_overrides_as_string} {cmd_string}[/yellow]",
+                decorate=decorate_logs,
+            )
 
         if cwd:
-            log(f"cwd: {str(cwd)}")
+            log(f"cwd: {str(cwd)}", decorate=decorate_logs)
 
 
 def run_command(  # noqa: C901
@@ -98,6 +124,7 @@ def run_command(  # noqa: C901
     valid_exit_ids: typing.Optional[typing.Tuple[int, ...]] = None,
     cwd: typing.Optional[pathlib.Path] = None,
     record_sub_job_time: typing.Optional[RecordSubJobTimeType] = None,
+    decorate_logs: bool = True,
     **kwargs: typing.Any,
 ) -> str:
     """Runs the given command, returning stdout or throwing on any error."""
@@ -115,6 +142,7 @@ def run_command(  # noqa: C901
         label,
         env_overrides,
         valid_exit_ids,
+        decorate_logs,
         verbose,
         cwd,
     )
@@ -143,7 +171,12 @@ def run_command(  # noqa: C901
                 stdout += line
                 if verbose:
                     # print each line of output, assuming that each has a newline
-                    log(parse_stdout(line, prefix=f"{label}: "))
+                    log(
+                        parse_stdout(
+                            line, prefix=f"[green]| [/green][blue]{label}[/blue]: "
+                        ),
+                        decorate=False,
+                    )
 
             # Wait for the subprocess to finish and get the exit code
             process.wait()
@@ -154,15 +187,15 @@ def run_command(  # noqa: C901
                 )
                 raise RunCommandBadExitCode(
                     (
-                        f"non-zero exit {process.returncode} (allowed are "
-                        f"{valid_exit_strs}) from {cmd_string}"
+                        f"non-zero exit [red]{process.returncode}[/red] (allowed are "
+                        f"[green]{valid_exit_strs}[/green]) from {cmd_string}"
                     )
                 )
     except BaseException as err:
         if ignore_fails:
             return ""
         parsed_stdout: str = (
-            parse_stdout(stdout, prefix=f"{label}: ERROR: ") if process else ""
+            parse_stdout(stdout, prefix="[red]| [/red]") if process else ""
         )
         env_overrides_as_string = ""
         if env_overrides:
@@ -171,11 +204,11 @@ def run_command(  # noqa: C901
             )
             env_overrides_as_string = f"{env_overrides_as_string} "
         error_string = (
-            f"runem: test: FATAL: command failed: {label}"
-            f"\n\t{env_overrides_as_string}{cmd_string}"
-            f"\nERROR"
+            f"runem: [red bold]FATAL[/red bold]: command failed: [blue]{label}[/blue]"
+            f"\n\t[yellow]{env_overrides_as_string}{cmd_string}[/yellow]"
+            f"\n[red underline]| ERROR[/red underline]"
             f"\n{str(parsed_stdout)}"
-            f"\nERROR END"
+            f"\n[red underline]| ERROR END[/red underline]"
         )
 
         if isinstance(err, RunCommandBadExitCode):
@@ -184,7 +217,10 @@ def run_command(  # noqa: C901
         raise RunCommandUnhandledError(error_string) from err
 
     if verbose:
-        log(f"running: done: {label}: {cmd_string}")
+        log(
+            f"running: done: [blue]{label}[/blue]: [yellow]{cmd_string}[/yellow]",
+            decorate=decorate_logs,
+        )
 
     if record_sub_job_time is not None:
         # Capture how long this run took