runem 0.4.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

runem/runem.py

@@ -19,6 +19,7 @@ We do:
 - time tests and tell you what used the most time, and how much time run-tests saved
   you
 """
+import contextlib
 import multiprocessing
 import os
 import pathlib
@@ -30,14 +31,13 @@ from datetime import timedelta
 from itertools import repeat
 from multiprocessing.managers import DictProxy, ValueProxy
 from timeit import default_timer as timer
-from types import TracebackType
 
-from rich.console import Console, ConsoleOptions, ConsoleRenderable, RenderResult
 from rich.spinner import Spinner
+from rich.status import Status
 from rich.text import Text
 
 from runem.blocking_print import RICH_CONSOLE
-from runem.command_line import parse_args
+from runem.command_line import error_on_log_logic, parse_args
 from runem.config import load_project_config, load_user_configs
 from runem.config_metadata import ConfigMetadata
 from runem.config_parse import load_config_metadata
@@ -46,6 +46,7 @@ from runem.job_execute import job_execute
 from runem.job_filter import filter_jobs
 from runem.log import error, log, warn
 from runem.report import report_on_run
+from runem.run_command import RunemJobError
 from runem.types.common import OrderedPhases, PhaseName
 from runem.types.filters import FilePathListLookup
 from runem.types.hooks import HookName
@@ -56,7 +57,7 @@ from runem.types.types_jobs import (
     JobRunMetadatasByPhase,
     JobTiming,
 )
-from runem.utils import printable_set
+from runem.utils import printable_set_coloured
 
 
 def _determine_run_parameters(argv: typing.List[str]) -> ConfigMetadata:
@@ -67,12 +68,19 @@ def _determine_run_parameters(argv: typing.List[str]) -> ConfigMetadata:
 
     Return a ConfigMetadata object with all the required information.
     """
+
+    # Because we want to be able to show logging whilst parsing .runem.yml config, we
+    # need to check the state of the logging-verbosity switches here, manually, as well.
+    verbose = "--verbose" in argv
+    silent = ("--silent" in argv) or ("-s" in argv)
+    error_on_log_logic(verbose, silent)
+
     config: Config
     cfg_filepath: pathlib.Path
     config, cfg_filepath = load_project_config()
     user_configs: typing.List[typing.Tuple[Config, pathlib.Path]] = load_user_configs()
     config_metadata: ConfigMetadata = load_config_metadata(
-        config, cfg_filepath, user_configs, verbose=("--verbose" in argv)
+        config, cfg_filepath, user_configs, silent, verbose=("--verbose" in argv)
     )
 
     # Now we parse the cli arguments extending them with information from the
@@ -85,38 +93,8 @@ def _determine_run_parameters(argv: typing.List[str]) -> ConfigMetadata:
     return config_metadata
 
 
-class DummySpinner(ConsoleRenderable):  # pragma: no cover
-    """A dummy spinner for when spinners are disabled."""
-
-    def __init__(self) -> None:
-        self.text = ""
-
-    def __rich__(self) -> Text:
-        """Return a rich Text object for rendering."""
-        return Text(self.text)
-
-    def __rich_console__(
-        self, console: Console, options: ConsoleOptions
-    ) -> RenderResult:
-        """Yield an empty string or placeholder text."""
-        yield Text(self.text)
-
-    def __enter__(self) -> None:
-        """Support for context manager."""
-        pass
-
-    def __exit__(
-        self,
-        exc_type: typing.Optional[typing.Type[BaseException]],
-        exc_value: typing.Optional[BaseException],
-        traceback: typing.Optional[TracebackType],
-    ) -> None:
-        """Support for context manager."""
-        pass
-
-
 def _update_progress(
-    label: str,
+    phase: str,
     running_jobs: typing.Dict[str, str],
     completed_jobs: typing.Dict[str, str],
     all_jobs: Jobs,
@@ -133,30 +111,36 @@ def _update_progress(
         is_running (ValueProxy[bool]): Flag indicating if jobs are still running.
         num_workers (int): Indicates the number of workers performing the jobs.
     """
-    # Using the `rich` module to show a loading spinner on console
-    spinner: typing.Union[Spinner, DummySpinner]
-    if show_spinner:
-        spinner = Spinner("dots", text="Starting tasks...")
-    else:
-        spinner = DummySpinner()
 
     last_running_jobs_set: typing.Set[str] = set()
 
-    with RICH_CONSOLE.status(spinner):
+    # Using the `rich` module to show a loading spinner on console
+    spinner_ctx: typing.Union[Status, typing.ContextManager[None]] = (
+        RICH_CONSOLE.status(Spinner("dots", text="Starting tasks..."))
+        if show_spinner
+        else contextlib.nullcontext()
+    )
+
+    with spinner_ctx:
         while is_running.value:
             running_jobs_set: typing.Set[str] = set(running_jobs.values())
 
             # Progress report
             progress: str = f"{len(completed_jobs)}/{len(all_jobs)}"
-            running_jobs_list = printable_set(
-                running_jobs_set
+            running_jobs_list = printable_set_coloured(
+                running_jobs_set,
+                "blue",
             )  # Reflect current running jobs accurately
-            report: str = f"{label}: {progress}({num_workers}): {running_jobs_list}"
+            report: str = (
+                f"[green]{phase}[/green]: {progress}({num_workers}): {running_jobs_list}"
+            )
             if show_spinner:
-                spinner.text = report
+                assert isinstance(spinner_ctx, Status)
+                spinner_ctx.update(Text.from_markup(report))
             else:
                 if last_running_jobs_set != running_jobs_set:
                     RICH_CONSOLE.log(report)
+                    last_running_jobs_set = running_jobs_set
 
             # Sleep for reduced CPU usage
             time.sleep(0.1)
@@ -169,7 +153,7 @@ def _process_jobs(
     phase: PhaseName,
     jobs: Jobs,
     show_spinner: bool,
-) -> typing.Optional[BaseException]:
+) -> typing.Optional[RunemJobError]:
     """Execute each given job asynchronously.
 
     This is where the major real-world time savings happen, and it could be
@@ -189,12 +173,12 @@ def _process_jobs(
     num_concurrent_procs: int = min(max_num_concurrent_procs, len(jobs))
     log(
         (
-            f"Running '{phase}' with {num_concurrent_procs} workers (of "
+            f"Running '[green]{phase}[/green]' with {num_concurrent_procs} workers (of "
             f"{max_num_concurrent_procs} max) processing {len(jobs)} jobs"
         )
     )
 
-    subprocess_error: typing.Optional[BaseException] = None
+    subprocess_error: typing.Optional[RunemJobError] = None
 
     with multiprocessing.Manager() as manager:
         running_jobs: DictProxy[typing.Any, typing.Any] = manager.dict()
@@ -228,7 +212,7 @@ def _process_jobs(
                         repeat(file_lists),
                     ),
                 )
-        except BaseException as err:  # pylint: disable=broad-exception-caught
+        except RunemJobError as err:  # pylint: disable=broad-exception-caught
             subprocess_error = err
         finally:
             # Signal the terminal_writer process to exit
@@ -244,7 +228,7 @@ def _process_jobs_by_phase(
     filtered_jobs_by_phase: PhaseGroupedJobs,
     in_out_job_run_metadatas: JobRunMetadatasByPhase,
     show_spinner: bool,
-) -> typing.Optional[BaseException]:
+) -> typing.Optional[RunemJobError]:
     """Execute each job asynchronously, grouped by phase.
 
     Whilst it is conceptually useful to group jobs by 'phase', Phases are
@@ -268,7 +252,7 @@ def _process_jobs_by_phase(
         if config_metadata.args.verbose:
             log(f"Running Phase {phase}")
 
-        failure_exception: typing.Optional[BaseException] = _process_jobs(
+        failure_exception: typing.Optional[RunemJobError] = _process_jobs(
             config_metadata,
             file_lists,
             in_out_job_run_metadatas,
@@ -286,7 +270,7 @@ def _process_jobs_by_phase(
 
 
 MainReturnType = typing.Tuple[
-    ConfigMetadata, JobRunMetadatasByPhase, typing.Optional[BaseException]
+    ConfigMetadata, JobRunMetadatasByPhase, typing.Optional[RunemJobError]
 ]
 
 
@@ -326,7 +310,7 @@ def _main(
 
     start = timer()
 
-    failure_exception: typing.Optional[BaseException] = _process_jobs_by_phase(
+    failure_exception: typing.Optional[RunemJobError] = _process_jobs_by_phase(
         config_metadata,
         file_lists,
         filtered_jobs_by_phase,
@@ -355,7 +339,7 @@ def timed_main(argv: typing.List[str]) -> None:
     start = timer()
     config_metadata: ConfigMetadata
     job_run_metadatas: JobRunMetadatasByPhase
-    failure_exception: typing.Optional[BaseException]
+    failure_exception: typing.Optional[RunemJobError]
     config_metadata, job_run_metadatas, failure_exception = _main(argv)
     phase_run_oder: OrderedPhases = config_metadata.phases
     end = timer()
@@ -365,14 +349,15 @@ def timed_main(argv: typing.List[str]) -> None:
     system_time_spent, wall_clock_time_saved = report_on_run(
         phase_run_oder, job_run_metadatas, time_taken
     )
-    message: str = "DONE: runem took"
+    message: str = "[green bold]DONE[/green bold]: runem took"
     if failure_exception:
-        message = "FAILED: your jobs failed after"
+        message = "[red bold]FAILED[/red bold]: your jobs failed after"
     log(
         (
             f"{message}: {time_taken.total_seconds()}s, "
-            f"saving you {wall_clock_time_saved.total_seconds()}s, "
-            f"without runem you would have waited {system_time_spent.total_seconds()}s"
+            f"saving you [green]{wall_clock_time_saved.total_seconds()}s[/green], "
+            "without runem you would have waited "
+            f"[red]{system_time_spent.total_seconds()}s[/red]"
         )
     )
 
@@ -385,6 +370,7 @@ def timed_main(argv: typing.List[str]) -> None:
     if failure_exception is not None:
         # we got a failure somewhere, now that we've reported the timings we
         # re-raise.
+        error(failure_exception.stdout)
         raise failure_exception
 
 

runem/types/__init__.py

@@ -1,11 +1,12 @@
 from runem.types.common import FilePathList, JobName
 from runem.types.options import Options
-from runem.types.types_jobs import HookKwargs, JobKwargs, JobReturnData
+from runem.types.types_jobs import HookKwargs, JobKwargs, JobReturn, JobReturnData
 
 __all__ = [
     "FilePathList",
     "HookKwargs",
     "JobName",
+    "JobReturn",
     "JobReturnData",
     "Options",
     "JobKwargs",

runem/utils.py

@@ -4,3 +4,15 @@ import typing
 def printable_set(some_set: typing.Set[typing.Any]) -> str:
     """Get a printable, deterministic string version of a set."""
     return ", ".join([f"'{set_item}'" for set_item in sorted(list(some_set))])
+
+
+def printable_set_coloured(some_set: typing.Set[typing.Any], colour: str) -> str:
+    """`printable_set` but elements are surrounded with colour mark-up.
+
+    Parameters:
+        some_set: a set of anything
+        colour: a `rich` Console supported colour
+    """
+    return ", ".join(
+        [f"'[{colour}]{set_item}[/{colour}]'" for set_item in sorted(list(some_set))]
+    )

runem-0.6.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,52 @@
+runem/VERSION,sha256=l6XW5UCmEg0Jw53bZn4Ojiusf8wv_vgTuC4I_WA2W84,6
+runem/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+runem/__main__.py,sha256=dsOiVZegpfK9JOs5n7UmbX5iwwbj7iFkEbLoVeEgAn4,136
+runem/base.py,sha256=EZfR7FIlwEdU9Vfe47Wk2DOO8GQqpKxxLNKp6YHueZ4,316
+runem/blocking_print.py,sha256=2nCvc10zXl1DRJldkruKthKjfmZKErcmxQzt3pjmN-c,2289
+runem/cli.py,sha256=wEt_Jnumhl8SiOdKdSJzLkJpWv6n3_Odhi_HeIixr1k,134
+runem/command_line.py,sha256=qkZFCCq9hUl6RO398SJzoigv8di5jGw2sdNwgTVBdd8,14474
+runem/config.py,sha256=UiEU0Jyg5qjrNStvasWYjMOABQHhpZjbPiX3-sH_CMg,5969
+runem/config_metadata.py,sha256=krDomUcADsAeUQrxwNmOS58eeaNIlqmhWIKWv8mUH4A,3300
+runem/config_parse.py,sha256=zXQ4rpj-igQufB5JtTsI1mOE_gBTdBcI2hI6HWU28gg,13830
+runem/files.py,sha256=59boeFvUANYOS-PllIjeKIht6lNINZ43WxahDg90oAc,4392
+runem/hook_manager.py,sha256=H0TL3HCqU2mgKm_-dgCD7TsK5T1bLT4g7x6kpytMPhU,4350
+runem/informative_dict.py,sha256=U7p9z78UwOT4TAfng1iDXCEyeYz6C-XZlx9Z1pWNVrI,1548
+runem/job.py,sha256=NOdRQnGePPyYdmIR_6JKVFzp9nbgNGetpE13bHEHaf4,3442
+runem/job_execute.py,sha256=-76IJI0PDU_XdQiDxTKUfOHEno9pixxQb_zi58rFumo,4702
+runem/job_filter.py,sha256=7vgG4YWJ9gyGBFjV7QbSojG5ofYoszAmxXx9HnMLkHo,5384
+runem/job_runner_simple_command.py,sha256=iP5an6yixW8o4C0ZBtu6csb-oVK3Q62ZZgtHBmxlXaU,2428
+runem/job_wrapper.py,sha256=q5GtopZ5vhSJ581rwU4-lF9KnbL3ZYgOC8fqaCnXD_g,983
+runem/job_wrapper_python.py,sha256=rx7J_N-JXs8GgMq7Sla7B9s_ZAfofKUhEnzgMcq_bts,4303
+runem/log.py,sha256=6r6HIJyvp19P6PZNo93qdIxE0SpTAsY4ELrETBl1dC4,1363
+runem/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+runem/report.py,sha256=beye95AV9Lop_K7eOoLY40vKt0VGkIdg-ig-SmJ_5MY,9083
+runem/run_command.py,sha256=R77jqAtrXPBkFtT7QXJfnQkivU4h01M8G0Q2sjWY6Gs,7691
+runem/runem.py,sha256=6XZqf59_ZMyrBaK1FlaLzMXYNoDQsTUcbFqTbpZL1ik,13192
+runem/runem_version.py,sha256=MbETwZO2Tb1Y3hX_OYZjKepEMKA1cjNvr-7Cqhz6e3s,271
+runem/utils.py,sha256=MEYfox09rLvb6xmay_3rV1cWmdqMbhaAjOomYGNk15k,602
+runem/cli/initialise_options.py,sha256=zx_EduWQk7yGBr3XUNrffHCSInPv05edFItHLnlo9dk,918
+runem/types/__init__.py,sha256=0bWG7hE7VeqJ2oIu-xhrqQud8hcNp6WNbF3uMfT_n9g,314
+runem/types/common.py,sha256=gPMSoJ3yRUYjHnoviRrpSg0gRwsGLFGWGpbTWkq4jX0,279
+runem/types/errors.py,sha256=rbM5BA6UhY1X7Q0OZLUNsG7JXAjgNFTG5KQuqPNuZm8,103
+runem/types/filters.py,sha256=8R5fyMssN0ISGBilJhEtbdHFl6OP7uI51WKkB5SH6EA,255
+runem/types/hooks.py,sha256=lgrv5QAuHCEzr5dXDj4-azNcs63addY9zdrGWj5zv_s,292
+runem/types/options.py,sha256=y8_hyWYvhalC9-kZbvoDtxm0trZgyyGcswQqfuQy_pM,265
+runem/types/runem_config.py,sha256=qG_bghm5Nr-ZTbaZbf1v8Fx447V-hgEvvRy5NZ3t-Io,5141
+runem/types/types_jobs.py,sha256=wqiiBmRIJDbGlKcfOqewHGKx350w0p4_7pysMm7xGmo,4906
+scripts/test_hooks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+scripts/test_hooks/json_validators.py,sha256=N2FyWcpjWzfFGycXLo-ecNLJkxTFPPbqPfVBcJLBlb4,967
+scripts/test_hooks/py.py,sha256=YUbwNny7NPmv2bY7k7YcbJ-jRcnNfjQajE9Hn1MLaBc,8821
+scripts/test_hooks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+scripts/test_hooks/runem_hooks.py,sha256=FJMuDBEOz3dr9gBW3WW6yKbUJs_LFXb3klpqSzCAZRk,628
+scripts/test_hooks/yarn.py,sha256=1QsG1rKAclpZoqp86ntkuvzYaYN4UkEvO0JhO2Kf5C8,1082
+tests/cli/test_initialise_options.py,sha256=Ogwfqz39r2o1waXMqCC22OJsgZoLF2stwGVO5AZUc4s,3148
+tests/data/help_output.3.10.txt,sha256=5TUpNITVL6pD5BpFAl-Orh3vkOpStveijZzvgJuI_sA,4280
+tests/data/help_output.3.11.txt,sha256=ycrF-xKgdQ8qrWzkkR-vbHe7NulUTsCsS0_Gda8xYDs,4162
+tests/test_types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_types/test_public_api.py,sha256=QHiwt7CetQur65JSbFRnOzQxhCJkX5MVLymHHVd_6yc,160
+runem-0.6.0.dist-info/LICENSE,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
+runem-0.6.0.dist-info/METADATA,sha256=00_gsiXfiHPCwcZumnmOU2KjaUTvR6kF9c9nr4p2YHc,5892
+runem-0.6.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+runem-0.6.0.dist-info/entry_points.txt,sha256=nu0g_vBeuPihYtimbtlNusxWovylMppvJ8UxdJlJfvM,46
+runem-0.6.0.dist-info/top_level.txt,sha256=NkdxkwLKNNhxItveR2KqNqTshTZ268m5D7SjJEmG4-Y,20
+runem-0.6.0.dist-info/RECORD,,

{runem-0.4.0.dist-info → runem-0.6.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{runem-0.4.0.dist-info → runem-0.6.0.dist-info}/top_level.txt

@@ -1,2 +1,3 @@
 runem
+scripts
 tests

scripts/test_hooks/json_validators.py

@@ -0,0 +1,32 @@
+import pathlib
+
+from typing_extensions import Unpack
+
+from runem.run_command import run_command
+from runem.types import FilePathList, JobKwargs
+
+
+def _json_validate(
+    **kwargs: Unpack[JobKwargs],
+) -> None:
+    label = kwargs["label"]
+    json_files: FilePathList = kwargs["file_list"]
+    json_with_comments = (
+        "cspell.json",
+        "tsconfig.spec.json",
+        "launch.json",
+        "settings.json",
+    )
+    for json_file in json_files:
+        json_path = pathlib.Path(json_file)
+        if not json_path.exists():
+            raise RuntimeError(
+                f"could not find '{str(json_path)}, in {pathlib.Path('.').absolute()}"
+            )
+        if json_path.name in json_with_comments:
+            # until we use a validator that allows comments in json, skip these
+            continue
+
+        cmd = ["python", "-m", "json.tool", f"{json_file}"]
+        kwargs["label"] = f"{label} {json_file}"
+        run_command(cmd=cmd, **kwargs)