runem 0.0.29__tar.gz → 0.0.30__tar.gz

{runem-0.0.29 → runem-0.0.30}/HISTORY.md

@@ -4,6 +4,127 @@ Changelog
 
 (unreleased)
 ------------
+- Merge pull request #47 from lursight/feat/git-fast-files. [Frank
+  Harrison]
+
+  Feat/git fast files
+- Feat(git-files): adds -f and -h for handling changed files and head
+  files. [Frank Harrison]
+
+  This makes using runem for big projects MUCH more effecient.
+- Chore(help): moves help switch from -h -> -H. [Frank Harrison]
+
+  This is so we can add `-h` as `HEAD files`
+- Chore(error-reporting): adds warn() and error() logging types. [Frank
+  Harrison]
+- Merge pull request #46 from lursight/chore/docs. [Frank Harrison]
+
+  Chore/docs
+- Chore(test): adds a new e2e test for tags-to-ignore. [Frank Harrison]
+
+  Once again everything seems to be behaving properly.
+- Chore(docs): annotates the tags-to-exclude test. [Frank Harrison]
+
+  I thought it was buggy, but we have another issue somewhere.
+- Chore(docs): updates the core-goal in the README. [Frank Harrison]
+- Chore(test): adds NUM CORES handling to tests. [Frank Harrison]
+- Chore(coverage): fixes coverage warnings. [Frank Harrison]
+- Merge pull request #45 from lursight/chore/update_deps. [Frank
+  Harrison]
+
+  updates deps
+- Updates deps. [Frank Harrison]
+- Merge pull request #44 from lursight/chore/update_py_black. [Frank
+  Harrison]
+
+  Chore/update py black
+- Chore(black): updates formatting after upgrading black. [Frank
+  Harrison]
+- Chore(deps): upgrades py-black following dependabot. [Frank Harrison]
+- Merge pull request #43 from lursight/feat/user-local-hook_1st_pass.
+  [Frank Harrison]
+
+  Feat/user local hooks (1st pass)
+- Feat(user-local-cfg): fixes for python 3.9 tests. [Frank Harrison]
+- Feat(user-local-cfg): handles situations where jobs are in local
+  configs. [Frank Harrison]
+
+  ... and phases are missing.
+- Chore(docs): stop the help-text test being verbose. [Frank Harrison]
+
+  ... it is unlikely that --help will be used in verbose mode... probs. Sigh.
+- Feat(user-local-cfg): gets user- and local- configs working. [Frank
+  Harrison]
+- Feat(user-local-cfg): splits the project loading into load and parse
+  phases. [Frank Harrison]
+
+  This is so we can use it to load user configs
+- Feat(user-local-cfg): splits the config loading and the ConfigMetadata
+  construction functions. [Frank Harrison]
+
+  This allows re-using the parsing function for N files
+- Feat(hooks): adds a hook system with support for ON_EXIT. [Frank
+  Harrison]
+
+  - we remove the deprecated function-type for jobs
+  - we add support for hooks
+  - add a hooks section to the .runem.yml reader
+  - add a on-exit hook to the runem project's .runem.yml
+- Merge pull request #42 from lursight/feat/prettier_tree_graph. [Frank
+  Harrison]
+
+  Feat/prettier tree graph
+- Feat(prettier-tree-report): changes how we index the leaver on the
+  report-tree. [Frank Harrison]
+
+  Basically removes the duplicate information, reducing visual noise,
+  especially after adding the variously shaded bar-graphs
+- Chore(.runem): uses current best practise for accessing options in
+  runem's own jobs. [Frank Harrison]
+- Chore(.runem): connects the unit-test option to the runem python
+  checks. [Frank Harrison]
+- Chore(.runem): removes defunct options. [Frank Harrison]
+
+  These were left over from lursight's config
+- Chore(.runem): rename switches for consistency. [Frank Harrison]
+- Fix(pretty-tree): adds extra test for bar-graph chars. [Frank
+  Harrison]
+- Chore: typo. [Frank Harrison]
+- Merge pull request #41 from lursight/feat/prettier_tree_graph. [Frank
+  Harrison]
+
+  Feat/prettier tree graph
+- Feat(tree-graph): hangs all tree leaves off of the runem.phases.
+  [Frank Harrison]
+- Feat(tree-graph): adds runem-reports regression checks. [Frank
+  Harrison]
+
+  This means we can capture any changes if they happen to the layout of
+  the graph, as I intended to changed the layout next.
+- Merge pull request #38 from
+  lursight/dependabot/github_actions/softprops/action-gh-release-2.
+  [Frank Harrison]
+
+  chore(deps): bump softprops/action-gh-release from 1 to 2
+- Chore(deps): bump softprops/action-gh-release from 1 to 2.
+  [dependabot[bot]]
+
+  Bumps [softprops/action-gh-release](https://github.com/softprops/action-gh-release) from 1 to 2.
+  - [Release notes](https://github.com/softprops/action-gh-release/releases)
+  - [Changelog](https://github.com/softprops/action-gh-release/blob/master/CHANGELOG.md)
+  - [Commits](https://github.com/softprops/action-gh-release/compare/v1...v2)
+
+  ---
+  updated-dependencies:
+  - dependency-name: softprops/action-gh-release
+    dependency-type: direct:production
+    update-type: version-update:semver-major
+  ...
+
+
+0.0.29 (2024-03-18)
+-------------------
+- Release: version 0.0.29 🚀 [Frank Harrison]
 - Merge pull request #40 from lursight/fix/time_saved. [Frank Harrison]
 
   Fix/time saved

{runem-0.0.29 → runem-0.0.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runem
-Version: 0.0.29
+Version: 0.0.30
 Summary: Awesome runem created by lursight
 Home-page: https://github.com/lursight/runem/
 Author: lursight
@@ -10,26 +10,26 @@ Requires-Dist: halo
 Requires-Dist: packaging
 Requires-Dist: PyYAML
 Provides-Extra: test
-Requires-Dist: black==23.11.0; extra == "test"
-Requires-Dist: coverage==7.3.2; extra == "test"
+Requires-Dist: black==24.3.0; extra == "test"
+Requires-Dist: coverage==7.4.4; extra == "test"
 Requires-Dist: docformatter==1.7.5; extra == "test"
 Requires-Dist: flake8-bugbear==24.2.6; extra == "test"
 Requires-Dist: flake8==7.0.0; extra == "test"
 Requires-Dist: gitchangelog==3.0.4; extra == "test"
-Requires-Dist: isort==5.12.0; extra == "test"
+Requires-Dist: isort==5.13.2; extra == "test"
 Requires-Dist: mkdocs==1.5.3; extra == "test"
-Requires-Dist: mypy==1.8.0; extra == "test"
+Requires-Dist: mypy==1.9.0; extra == "test"
 Requires-Dist: pydocstyle==6.3.0; extra == "test"
-Requires-Dist: pylint==3.0.2; extra == "test"
+Requires-Dist: pylint==3.1.0; extra == "test"
 Requires-Dist: pylama==8.4.1; extra == "test"
 Requires-Dist: pytest-cov==4.1.0; extra == "test"
 Requires-Dist: pytest-profiling==1.7.0; extra == "test"
-Requires-Dist: pytest-xdist==3.3.1; extra == "test"
-Requires-Dist: pytest==7.4.3; extra == "test"
+Requires-Dist: pytest-xdist==3.5.0; extra == "test"
+Requires-Dist: pytest==8.1.1; extra == "test"
 Requires-Dist: setuptools; extra == "test"
 Requires-Dist: termplotlib==0.3.9; extra == "test"
-Requires-Dist: types-PyYAML==6.0.12.12; extra == "test"
-Requires-Dist: requests-mock==1.10.0; extra == "test"
+Requires-Dist: types-PyYAML==6.0.12.20240311; extra == "test"
+Requires-Dist: requests-mock==1.11.0; extra == "test"
 Requires-Dist: types-setuptools; extra == "test"
 
 # Run 'em
@@ -40,7 +40,7 @@ Requires-Dist: types-setuptools; extra == "test"
 
 ## 1. Overview
 
-The core objective of Run'em's is to minimize the wall-clock time required for executing whatever command-line tools a developer uses (or *should* use). Overall it is designed to enhance iteration speed and boost developer productivity.
+The core objective of Run'em's is to minimize the wall-clock time required for running checks, supporting [shift-left](https://en.wikipedia.org/wiki/Shift-left_testing). Overall it is designed to enhance iteration speed and boost developer productivity.
 
 `runem` is also designed to be easy to learn and simple to use, but `runem` also has many powerful tools for advanced users.
 
@@ -173,7 +173,7 @@ Here's a simple setup for a python project.
           type: bool
           desc: formats docs and comments in whatever job can do so
       - option:
-          name: check_only
+          name: check-only
           alias: check
           default: false
           type: bool
@@ -247,11 +247,11 @@ def _job_py_code_reformat(
     docformatter_extra_args = [
         "--in-place",
     ]
-    if "check_only" in options and options["check_only"]:
+    if options["check-only"]:
         extra_args.append("--check")
         docformatter_extra_args = []  # --inplace is not compatible with --check
 
-    if "black" in options and options["black"]:
+    if options["black"]:
         black_cmd = [
             "python3",
             "-m",
@@ -262,7 +262,7 @@ def _job_py_code_reformat(
         kwargs["label"] = f"{label} black"
         run_command(cmd=black_cmd, **kwargs)
 
-    if "docformatter" in options and options["docformatter"]:
+    if options["docformatter"]:
         docformatter_cmd = [
             "python3",
             "-m",
@@ -279,7 +279,7 @@ def _job_py_code_reformat(
             0,  # no work/change required
             3,  # no errors, but code was reformatted
         )
-        if "check_only" in options and options["check_only"]:
+        if options["check-only"]:
             # in check it is ONLY ok if no work/change was required
             allowed_exits = (0,)
         kwargs["label"] = f"{label} docformatter"
@@ -469,8 +469,8 @@ usage: runem.py [-h] [--jobs JOBS [JOBS ...]] [--not-jobs JOBS_EXCLUDED [JOBS_EX
                 [--not-phases PHASES_EXCLUDED [PHASES_EXCLUDED ...]] [--tags TAGS [TAGS ...]] [--not-tags TAGS_EXCLUDED [TAGS_EXCLUDED ...]]
                 [--black] [--no-black] [--check-only] [--no-check-only] [--coverage] [--no-coverage] [--docformatter] [--no-docformatter]
                 [--generate-call-graphs] [--no-generate-call-graphs] [--install-deps] [--no-install-deps] [--isort] [--no-isort] [--profile]
-                [--no-profile] [--update-snapshots] [--no-update-snapshots] [--unit-test] [--no-unit-test] [--unit-test-firebase-data]
-                [--no-unit-test-firebase-data] [--unit-test-python] [--no-unit-test-python] [--call-graphs | --no-call-graphs]
+                [--no-profile] [--unit-test] [--no-unit-test]
+                [--call-graphs | --no-call-graphs]
                 [--procs PROCS] [--root ROOT_DIR] [--verbose | --no-verbose | -v]
 
 Runs the Lursight Lang test-suite
@@ -524,18 +524,8 @@ job-param overrides:
   --no-isort            turn off allow/disallows isort from running on python files
   --profile             generate profile information in jobs that can
   --no-profile          turn off generate profile information in jobs that can
-  --update-snapshots    update snapshots in jobs that can update data snapshots
-  --no-update-snapshots
-                        turn off update snapshots in jobs that can update data snapshots
   --unit-test           run unit tests
   --no-unit-test        turn off run unit tests
-  --unit-test-firebase-data
-                        run unit tests for the firebase function's data
-  --no-unit-test-firebase-data
-                        turn off run unit tests for the firebase function's data
-  --unit-test-python    run unit tests for the python code
-  --no-unit-test-python
-                        turn off run unit tests for the python code
 ```
 </details>
 

{runem-0.0.29 → runem-0.0.30}/README.md

@@ -6,7 +6,7 @@
 
 ## 1. Overview
 
-The core objective of Run'em's is to minimize the wall-clock time required for executing whatever command-line tools a developer uses (or *should* use). Overall it is designed to enhance iteration speed and boost developer productivity.
+The core objective of Run'em's is to minimize the wall-clock time required for running checks, supporting [shift-left](https://en.wikipedia.org/wiki/Shift-left_testing). Overall it is designed to enhance iteration speed and boost developer productivity.
 
 `runem` is also designed to be easy to learn and simple to use, but `runem` also has many powerful tools for advanced users.
 
@@ -139,7 +139,7 @@ Here's a simple setup for a python project.
           type: bool
           desc: formats docs and comments in whatever job can do so
       - option:
-          name: check_only
+          name: check-only
           alias: check
           default: false
           type: bool
@@ -213,11 +213,11 @@ def _job_py_code_reformat(
     docformatter_extra_args = [
         "--in-place",
     ]
-    if "check_only" in options and options["check_only"]:
+    if options["check-only"]:
         extra_args.append("--check")
         docformatter_extra_args = []  # --inplace is not compatible with --check
 
-    if "black" in options and options["black"]:
+    if options["black"]:
         black_cmd = [
             "python3",
             "-m",
@@ -228,7 +228,7 @@ def _job_py_code_reformat(
         kwargs["label"] = f"{label} black"
         run_command(cmd=black_cmd, **kwargs)
 
-    if "docformatter" in options and options["docformatter"]:
+    if options["docformatter"]:
         docformatter_cmd = [
             "python3",
             "-m",
@@ -245,7 +245,7 @@ def _job_py_code_reformat(
             0,  # no work/change required
             3,  # no errors, but code was reformatted
         )
-        if "check_only" in options and options["check_only"]:
+        if options["check-only"]:
             # in check it is ONLY ok if no work/change was required
             allowed_exits = (0,)
         kwargs["label"] = f"{label} docformatter"
@@ -435,8 +435,8 @@ usage: runem.py [-h] [--jobs JOBS [JOBS ...]] [--not-jobs JOBS_EXCLUDED [JOBS_EX
                 [--not-phases PHASES_EXCLUDED [PHASES_EXCLUDED ...]] [--tags TAGS [TAGS ...]] [--not-tags TAGS_EXCLUDED [TAGS_EXCLUDED ...]]
                 [--black] [--no-black] [--check-only] [--no-check-only] [--coverage] [--no-coverage] [--docformatter] [--no-docformatter]
                 [--generate-call-graphs] [--no-generate-call-graphs] [--install-deps] [--no-install-deps] [--isort] [--no-isort] [--profile]
-                [--no-profile] [--update-snapshots] [--no-update-snapshots] [--unit-test] [--no-unit-test] [--unit-test-firebase-data]
-                [--no-unit-test-firebase-data] [--unit-test-python] [--no-unit-test-python] [--call-graphs | --no-call-graphs]
+                [--no-profile] [--unit-test] [--no-unit-test]
+                [--call-graphs | --no-call-graphs]
                 [--procs PROCS] [--root ROOT_DIR] [--verbose | --no-verbose | -v]
 
 Runs the Lursight Lang test-suite
@@ -490,18 +490,8 @@ job-param overrides:
   --no-isort            turn off allow/disallows isort from running on python files
   --profile             generate profile information in jobs that can
   --no-profile          turn off generate profile information in jobs that can
-  --update-snapshots    update snapshots in jobs that can update data snapshots
-  --no-update-snapshots
-                        turn off update snapshots in jobs that can update data snapshots
   --unit-test           run unit tests
   --no-unit-test        turn off run unit tests
-  --unit-test-firebase-data
-                        run unit tests for the firebase function's data
-  --no-unit-test-firebase-data
-                        turn off run unit tests for the firebase function's data
-  --unit-test-python    run unit tests for the python code
-  --no-unit-test-python
-                        turn off run unit tests for the python code
 ```
 </details>
 

runem-0.0.30/runem/VERSION

@@ -0,0 +1 @@
+0.0.30

{runem-0.0.29 → runem-0.0.30}/runem/cli.py

@@ -1,4 +1,5 @@
 """CLI interface for runem project."""
+
 import sys
 
 from runem.runem import timed_main

{runem-0.0.29 → runem-0.0.30}/runem/command_line.py

@@ -6,7 +6,7 @@ import typing
 
 from runem.config_metadata import ConfigMetadata
 from runem.informative_dict import InformativeDict
-from runem.log import log
+from runem.log import error, log
 from runem.runem_version import get_runem_version
 from runem.types import JobNames, OptionConfig, OptionsWritable
 from runem.utils import printable_set
@@ -22,7 +22,12 @@ def parse_args(
 
     Returns the parsed args, the jobs_names_to_run, job_phases_to_run, job_tags_to_run
     """
-    parser = argparse.ArgumentParser(description="Runs the Lursight Lang test-suite")
+    parser = argparse.ArgumentParser(
+        add_help=False, description="Runs the Lursight Lang test-suite"
+    )
+    parser.add_argument(
+        "-H", "--help", action="help", help="show this help message and exit"
+    )
 
     job_group = parser.add_argument_group("jobs")
     all_job_names: JobNames = set(name for name in config_metadata.all_job_names)
@@ -112,6 +117,26 @@ def parse_args(
         required=False,
     )
 
+    parser.add_argument(
+        "-f",
+        "--modified-files-only",
+        dest="check_modified_files_only",
+        help="only use files that have changed",
+        action=argparse.BooleanOptionalAction,
+        default=False,
+        required=False,
+    )
+
+    parser.add_argument(
+        "-h",
+        "--git-head-files-only",
+        dest="check_head_files_only",
+        help="fast run of files",
+        action=argparse.BooleanOptionalAction,
+        default=False,
+        required=False,
+    )
+
     parser.add_argument(
         "--procs",
         "-j",
@@ -206,9 +231,9 @@ def _validate_filters(
     for name, name_list in (("--jobs", args.jobs), ("--not-jobs", args.jobs_excluded)):
         for job_name in name_list:
             if job_name not in config_metadata.all_job_names:
-                log(
+                error(
                     (
-                        f"ERROR: invalid job-name '{job_name}' for {name}, "
+                        f"invalid job-name '{job_name}' for {name}, "
                         f"choose from one of {printable_set(config_metadata.all_job_names)}"
                     )
                 )
@@ -218,9 +243,9 @@ def _validate_filters(
     for name, tag_list in (("--tags", args.tags), ("--not-tags", args.tags_excluded)):
         for tag in tag_list:
             if tag not in config_metadata.all_job_tags:
-                log(
+                error(
                     (
-                        f"ERROR: invalid tag '{tag}' for {name}, "
+                        f"invalid tag '{tag}' for {name}, "
                         f"choose from one of {printable_set(config_metadata.all_job_tags)}"
                     )
                 )
@@ -233,9 +258,9 @@ def _validate_filters(
     ):
         for phase in phase_list:
             if phase not in config_metadata.all_job_phases:
-                log(
+                error(
                     (
-                        f"ERROR: invalid phase '{phase}' for {name}, "
+                        f"invalid phase '{phase}' for {name}, "
                         f"choose from one of {printable_set(config_metadata.all_job_phases)}"
                     )
                 )

{runem-0.0.29 → runem-0.0.30}/runem/config.py

@@ -5,9 +5,9 @@ import typing
 import yaml
 from packaging.version import Version
 
-from runem.log import log
+from runem.log import error, log
 from runem.runem_version import get_runem_version
-from runem.types import Config, GlobalConfig, GlobalSerialisedConfig
+from runem.types import Config, GlobalConfig, GlobalSerialisedConfig, UserConfigMetadata
 
 CFG_FILE_YAML = pathlib.Path(".runem.yml")
 
@@ -40,20 +40,53 @@ def _search_up_multiple_dirs_for_file(
     return None
 
 
-def _find_cfg() -> pathlib.Path:
-    """Searches up from the cwd for a .runem.yml config file."""
+def _find_config_file(
+    config_filename: typing.Union[str, pathlib.Path]
+) -> typing.Tuple[typing.Optional[pathlib.Path], typing.Tuple[pathlib.Path, ...]]:
+    """Searches up from the cwd for the given config file-name."""
     start_dirs = (pathlib.Path(".").absolute(),)
     cfg_candidate: typing.Optional[pathlib.Path] = _search_up_multiple_dirs_for_file(
-        start_dirs, CFG_FILE_YAML
+        start_dirs, config_filename
     )
+    return cfg_candidate, start_dirs
+
+
+def _find_project_cfg() -> pathlib.Path:
+    """Searches up from the cwd for the project .runem.yml config file."""
+    cfg_candidate: typing.Optional[pathlib.Path]
+    start_dirs: typing.Tuple[pathlib.Path, ...]
+    cfg_candidate, start_dirs = _find_config_file(config_filename=CFG_FILE_YAML)
+
     if cfg_candidate:
         return cfg_candidate
 
     # error out and exit as we currently require the cfg file as it lists jobs.
-    log(f"ERROR: Config not found! Looked from {start_dirs}")
+    error(f"Config not found! Looked from {start_dirs}")
     sys.exit(1)
 
 
+def _find_local_configs() -> typing.List[pathlib.Path]:
+    """Searches for all user-configs and returns the found ones.
+
+    TODO: add some priorities to the files, such that
+            - .runem.local.yml has lowest priority
+            - $HOME/.runem.user.yml is applied after .local
+            - .runem.user.yml overloads all others
+    """
+    local_configs: typing.List[pathlib.Path] = []
+    for config_filename in (".runem.local.yml", ".runem.user.yml"):
+        cfg_candidate: typing.Optional[pathlib.Path]
+        cfg_candidate, _ = _find_config_file(config_filename)
+        if cfg_candidate:
+            local_configs.append(cfg_candidate)
+
+    user_home_config: pathlib.Path = pathlib.Path("~/.runem.user.yml")
+    if user_home_config.exists():
+        local_configs.append(user_home_config)
+
+    return local_configs
+
+
 def _conform_global_config_types(
     all_config: Config,
 ) -> typing.Tuple[Config, typing.Optional[GlobalConfig]]:
@@ -77,9 +110,8 @@ def _conform_global_config_types(
     return all_config, global_config
 
 
-def load_config() -> typing.Tuple[Config, pathlib.Path]:
-    """Finds and loads the .runem.yml file."""
-    cfg_filepath: pathlib.Path = _find_cfg()
+def load_and_parse_config(cfg_filepath: pathlib.Path) -> Config:
+    """For the given config file pass, project or user, load it & parse/conform it."""
     with cfg_filepath.open("r+", encoding="utf-8") as config_file_handle:
         all_config = yaml.full_load(config_file_handle)
 
@@ -104,5 +136,22 @@ def load_config() -> typing.Tuple[Config, pathlib.Path]:
                 )
             )
             sys.exit(1)
+    return conformed_config
+
+
+def load_project_config() -> typing.Tuple[Config, pathlib.Path]:
+    """Finds and loads the .runem.yml file for the current project."""
+    cfg_filepath: pathlib.Path = _find_project_cfg()
+    conformed_config: Config = load_and_parse_config(cfg_filepath)
 
     return conformed_config, cfg_filepath
+
+
+def load_user_configs() -> UserConfigMetadata:
+    """Returns the user-local configs, that extend/override runem behaviour."""
+    user_configs: typing.List[typing.Tuple[Config, pathlib.Path]] = []
+    user_config_paths: typing.List[pathlib.Path] = _find_local_configs()
+    for config_path in user_config_paths:
+        user_config: Config = load_and_parse_config(config_path)
+        user_configs.append((user_config, config_path))
+    return user_configs

{runem-0.0.29 → runem-0.0.30}/runem/config_metadata.py

@@ -1,5 +1,6 @@
 import argparse
 import pathlib
+import typing
 
 from runem.informative_dict import InformativeDict
 from runem.types import (
@@ -13,6 +14,9 @@ from runem.types import (
     TagFileFilters,
 )
 
+if typing.TYPE_CHECKING:  # pragma: no cover
+    from runem.hook_manager import HookManager
+
 
 class ConfigMetadata:
     """Full metadata about what can and should be run."""
@@ -20,6 +24,7 @@ class ConfigMetadata:
     phases: OrderedPhases  # the phases and orders to run them in
     options_config: OptionConfigs  # the options to add to the cli and pass to jobs
     file_filters: TagFileFilters  # which files to get for which tag
+    hook_manager: "HookManager"  # the hooks register for the run
     jobs: PhaseGroupedJobs  # the jobs to be run ordered by phase
     all_job_names: JobNames  # the set of job-names
     all_job_phases: JobPhases  # the set of job-phases (should be subset of 'phases')
@@ -39,6 +44,7 @@ class ConfigMetadata:
         phases: OrderedPhases,
         options_config: OptionConfigs,
         file_filters: TagFileFilters,
+        hook_manager: "HookManager",
         jobs: PhaseGroupedJobs,
         all_job_names: JobNames,
         all_job_phases: JobPhases,
@@ -48,6 +54,8 @@ class ConfigMetadata:
         self.phases = phases
         self.options_config = options_config
         self.file_filters = file_filters
+        # initialise all the registered call-back hooks
+        self.hook_manager = hook_manager
         self.jobs = jobs
         self.all_job_names = all_job_names
         self.all_job_phases = all_job_phases