hector-cli 0.1.0__tar.gz → 0.2.1__tar.gz

{hector_cli-0.1.0 → hector_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hector-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: YAML-driven Renode + Verilator simulation orchestrator for embedded hardware CI
 Home-page: https://hector-ci.com
 Author: Nemesis
@@ -117,6 +117,7 @@ Generated files go in `.hector/` — add it to your `.gitignore`. The Renode **b
 | Command | Behaviour |
 |---|---|
 | `hector run` | Run simulation interactively (Renode monitor) |
+| `hector run -f board.yaml` | Read a config file other than `.hector.yaml` (`-f`/`--file`; works on every command) |
 | `hector run --set BIN=fw.elf` | Override a config argument at the command line |
 | `hector run --set BIN=fw.elf --set BOARD=nucleo` | Override multiple arguments |
 | `hector run --debug boardA:3333` | Halt a CPU and open a GDB server |
@@ -147,13 +148,24 @@ Generated files go in `.hector/` — add it to your `.gitignore`. The Renode **b
 | `hector export` | Generate the files and print the run command instead of executing it |
 | `hector export --no-docker` | Print the bare `renode <resc>` command instead of the `docker run …` one |
 | `hector validate` | Validate `.hector.yaml` without running anything |
+| `hector validate -f board.yaml` | Validate a config file by another name |
 | `hector init` | Scaffold a starter `.hector.yaml` |
+| `hector init -f board.yaml` | Scaffold the starter config under a custom name |
 | `hector --version` | Print the tool version |
 
 `hector` is structured as subcommands: `run` (simulate), `test` (run the `tests:`
 section), `export` (emit the command without running it), plus `init` and
 `validate`. Run `hector <command> --help` for the flags each one accepts.
 
+Every command reads (or, for `init`, writes) `.hector.yaml` by default. Point it
+at a different file with **`-f` / `--file`** — useful when one project keeps
+several configs (e.g. `ci.hector.yaml`, `local.hector.yaml`):
+
+```bash
+hector test -f ci.hector.yaml
+hector run  --file boards/nucleo.yaml
+```
+
 ### Debug mode (`--debug NODE:PORT`)
 
 Repeat the flag for each machine you want to debug. ([Renode docs: GDB debugging](https://renode.readthedocs.io/en/latest/debugging/gdb.html))

{hector_cli-0.1.0 → hector_cli-0.2.1}/README.md

@@ -87,6 +87,7 @@ Generated files go in `.hector/` — add it to your `.gitignore`. The Renode **b
 | Command | Behaviour |
 |---|---|
 | `hector run` | Run simulation interactively (Renode monitor) |
+| `hector run -f board.yaml` | Read a config file other than `.hector.yaml` (`-f`/`--file`; works on every command) |
 | `hector run --set BIN=fw.elf` | Override a config argument at the command line |
 | `hector run --set BIN=fw.elf --set BOARD=nucleo` | Override multiple arguments |
 | `hector run --debug boardA:3333` | Halt a CPU and open a GDB server |
@@ -117,13 +118,24 @@ Generated files go in `.hector/` — add it to your `.gitignore`. The Renode **b
 | `hector export` | Generate the files and print the run command instead of executing it |
 | `hector export --no-docker` | Print the bare `renode <resc>` command instead of the `docker run …` one |
 | `hector validate` | Validate `.hector.yaml` without running anything |
+| `hector validate -f board.yaml` | Validate a config file by another name |
 | `hector init` | Scaffold a starter `.hector.yaml` |
+| `hector init -f board.yaml` | Scaffold the starter config under a custom name |
 | `hector --version` | Print the tool version |
 
 `hector` is structured as subcommands: `run` (simulate), `test` (run the `tests:`
 section), `export` (emit the command without running it), plus `init` and
 `validate`. Run `hector <command> --help` for the flags each one accepts.
 
+Every command reads (or, for `init`, writes) `.hector.yaml` by default. Point it
+at a different file with **`-f` / `--file`** — useful when one project keeps
+several configs (e.g. `ci.hector.yaml`, `local.hector.yaml`):
+
+```bash
+hector test -f ci.hector.yaml
+hector run  --file boards/nucleo.yaml
+```
+
 ### Debug mode (`--debug NODE:PORT`)
 
 Repeat the flag for each machine you want to debug. ([Renode docs: GDB debugging](https://renode.readthedocs.io/en/latest/debugging/gdb.html))

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector/commands/base.py

@@ -30,9 +30,19 @@ class Command:
 # Reusable flag groups (shared so each command's surface stays consistent)
 # ---------------------------------------------------------------------------
 
+def add_config_file_argument(parser):
+    """The Hector config file to read. Shared by every config-driven command
+    (run / test / export / validate) and `init` (which writes it)."""
+    parser.add_argument(
+        "-f", "--file", metavar="PATH", dest="file", default=".hector.yaml",
+        help="Path to the Hector config file (default: .hector.yaml).",
+    )
+
+
 def add_common_arguments(parser):
     """Flags shared by the config-driven commands (run / test / export): they all
     read .hector.yaml, pin a Renode version, expand the matrix, and collect output."""
+    add_config_file_argument(parser)
     parser.add_argument(
         "--set", action="append", metavar="KEY=VALUE", dest="set_args",
         help="Override a config argument. Repeatable. Takes precedence over env vars "

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector/commands/init.py

@@ -2,14 +2,17 @@
 """`hector init` — scaffold a new .hector.yaml in the current directory."""
 
 from ..scaffold import scaffold_init
-from .base import COMMANDS, Command
+from .base import COMMANDS, Command, add_config_file_argument
 
 
 @COMMANDS.register("init")
 class InitCommand(Command):
     name = "init"
-    help = "Scaffold a new .hector.yaml in the current directory."
+    help = "Scaffold a new config file in the current directory."
+
+    def add_arguments(self, parser):
+        add_config_file_argument(parser)
 
     def execute(self, args):
-        scaffold_init()
+        scaffold_init(args.file)
         return 0

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector/commands/validate.py

@@ -2,14 +2,18 @@
 """`hector validate` — check .hector.yaml without running anything; exit 1 on errors."""
 
 from .. import pipeline
-from .base import COMMANDS, Command
+from .base import COMMANDS, Command, add_config_file_argument
 
 
 @COMMANDS.register("validate")
 class ValidateCommand(Command):
     name = "validate"
-    help = "Validate .hector.yaml without running anything; exit 1 on errors."
+    help = "Validate the config file without running anything; exit 1 on errors."
+
+    def add_arguments(self, parser):
+        add_config_file_argument(parser)
 
     def execute(self, args):
+        pipeline.apply_global_flags(args)   # picks up -f/--file
         # _run_validate prints a report and exits with the right code itself.
         pipeline._run_validate()

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector/core.py

@@ -66,7 +66,7 @@ class Registry:
 # ==========================================================================
 # CONSTANTS
 # ==========================================================================
-TOOL_VERSION = "0.1.0"
+TOOL_VERSION = "0.2.1"
 SUPPORTED_SCHEMA_VERSIONS = {"0.1"}
 
 RENODE_REPO_URL = "https://github.com/renode/renode.git"

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector/pipeline.py

@@ -43,8 +43,17 @@ from .validator import print_issues, validate_config
 # adding one module — no changes here.
 # ---------------------------------------------------------------------------
 
+# The config file every command reads/writes. Overridable with -f/--file; set by
+# apply_global_flags before any config is loaded.
+CONFIG_PATH = ".hector.yaml"
+
+
 def apply_global_flags(args):
-    """Honour --workspace-mount / --no-docker before anything touches paths."""
+    """Honour --file / --workspace-mount / --no-docker before anything touches paths."""
+    path = getattr(args, "file", None)
+    if path:
+        global CONFIG_PATH
+        CONFIG_PATH = path
     if getattr(args, "workspace_mount", None):
         _core.WORKSPACE_MOUNT = args.workspace_mount
     if getattr(args, "no_docker", False):
@@ -53,8 +62,8 @@ def apply_global_flags(args):
 
 
 def load_config_or_exit():
-    """Load and sanity-check ./.hector.yaml, or print an error and exit."""
-    config_path = ".hector.yaml"
+    """Load and sanity-check the config file (CONFIG_PATH), or print an error and exit."""
+    config_path = CONFIG_PATH
     if not os.path.exists(config_path):
         print(f"[ERROR] No '{config_path}' in the current directory ({os.getcwd()}).\n"
               "        Run hector from a project that has a .hector.yaml, or create one "
@@ -198,8 +207,8 @@ def snapshot_fastpath(args):
 
 
 def _run_validate():
-    """Load .hector.yaml and report all config errors, then exit."""
-    config_path = ".hector.yaml"
+    """Load the config file (CONFIG_PATH) and report all config errors, then exit."""
+    config_path = CONFIG_PATH
     if not os.path.exists(config_path):
         print(f"[VALIDATE] {config_path} not found in current directory.")
         sys.exit(1)

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector/scaffold.py

@@ -41,9 +41,9 @@ _PLATFORMS_NOTE = """\
 """
 
 
-def scaffold_init():
-    """Interactively create a starter .hector.yaml config in the current directory."""
-    target = ".hector.yaml"
+def scaffold_init(target=".hector.yaml"):
+    """Interactively create a starter config in the current directory (default
+    name .hector.yaml; override via -f/--file)."""
     if os.path.exists(target):
         print(f"[INIT] {target} already exists — not overwriting.")
         print(f"[INIT] Delete or rename it, then run 'hector init' again.")

{hector_cli-0.1.0 → hector_cli-0.2.1}/hector_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hector-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: YAML-driven Renode + Verilator simulation orchestrator for embedded hardware CI
 Home-page: https://hector-ci.com
 Author: Nemesis
@@ -117,6 +117,7 @@ Generated files go in `.hector/` — add it to your `.gitignore`. The Renode **b
 | Command | Behaviour |
 |---|---|
 | `hector run` | Run simulation interactively (Renode monitor) |
+| `hector run -f board.yaml` | Read a config file other than `.hector.yaml` (`-f`/`--file`; works on every command) |
 | `hector run --set BIN=fw.elf` | Override a config argument at the command line |
 | `hector run --set BIN=fw.elf --set BOARD=nucleo` | Override multiple arguments |
 | `hector run --debug boardA:3333` | Halt a CPU and open a GDB server |
@@ -147,13 +148,24 @@ Generated files go in `.hector/` — add it to your `.gitignore`. The Renode **b
 | `hector export` | Generate the files and print the run command instead of executing it |
 | `hector export --no-docker` | Print the bare `renode <resc>` command instead of the `docker run …` one |
 | `hector validate` | Validate `.hector.yaml` without running anything |
+| `hector validate -f board.yaml` | Validate a config file by another name |
 | `hector init` | Scaffold a starter `.hector.yaml` |
+| `hector init -f board.yaml` | Scaffold the starter config under a custom name |
 | `hector --version` | Print the tool version |
 
 `hector` is structured as subcommands: `run` (simulate), `test` (run the `tests:`
 section), `export` (emit the command without running it), plus `init` and
 `validate`. Run `hector <command> --help` for the flags each one accepts.
 
+Every command reads (or, for `init`, writes) `.hector.yaml` by default. Point it
+at a different file with **`-f` / `--file`** — useful when one project keeps
+several configs (e.g. `ci.hector.yaml`, `local.hector.yaml`):
+
+```bash
+hector test -f ci.hector.yaml
+hector run  --file boards/nucleo.yaml
+```
+
 ### Debug mode (`--debug NODE:PORT`)
 
 Repeat the flag for each machine you want to debug. ([Renode docs: GDB debugging](https://renode.readthedocs.io/en/latest/debugging/gdb.html))

{hector_cli-0.1.0 → hector_cli-0.2.1}/setup.py

@@ -1,11 +1,23 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 import os
+import re
 
 from setuptools import setup, find_packages
 
 _HERE = os.path.abspath(os.path.dirname(__file__))
 
 
+def _read_version():
+    # Single source of truth: hector/core.py's TOOL_VERSION. Read it textually
+    # (no import) so the build never needs the package's runtime deps installed.
+    with open(os.path.join(_HERE, "hector", "core.py")) as f:
+        for line in f:
+            m = re.match(r"""^TOOL_VERSION\s*=\s*["'](.+?)["']""", line)
+            if m:
+                return m.group(1)
+    raise RuntimeError("Could not find TOOL_VERSION in hector/core.py")
+
+
 def _read_readme():
     # README lives at the repo root (one level above this package dir); fall back
     # gracefully so the build never crashes if it's absent.
@@ -19,7 +31,7 @@ def _read_readme():
 
 setup(
     name="hector-cli",
-    version="0.1.0",
+    version=_read_version(),
     description="YAML-driven Renode + Verilator simulation orchestrator for embedded hardware CI",
     long_description=_read_readme(),
     long_description_content_type="text/markdown",