ssot-cli 0.1.17__tar.gz → 0.1.18.dev1__tar.gz

{ssot_cli-0.1.17 → ssot_cli-0.1.18.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-cli
-Version: 0.1.17
+Version: 0.1.18.dev1
 Summary: Primary CLI distribution for ssot-registry.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -25,9 +25,9 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Utilities
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ssot-contracts<0.3.0,>=0.2.23
-Requires-Dist: ssot-core<0.3.0,>=0.2.23
-Requires-Dist: ssot-conformance<0.3.0,>=0.2.23
+Requires-Dist: ssot-contracts<0.3.0,>=0.2.24.dev1
+Requires-Dist: ssot-core<0.3.0,>=0.2.24.dev1
+Requires-Dist: ssot-conformance<0.3.0,>=0.2.24.dev1
 Requires-Dist: ssot-pack-contracts<0.3.0,>=0.2.23
 Requires-Dist: tomli>=2.0.1; python_version < "3.11"
 
@@ -258,6 +258,7 @@ Global flags: `--output-file`, `--output-format`, `--version`
 | `ssot-registry feature update` | `--body`, `--body-file`, `--description`, `--id`, `--implementation-status`, `--origin`, `--title` |
 | `ssot-registry graph` | none |
 | `ssot-registry graph export` | `--format`, `--output` |
+| `ssot-registry graph lineage` | `--open`, `--output` |
 | `ssot-registry init` | `--force`, `--repo-id`, `--repo-name`, `--version` |
 | `ssot-registry issue` | none |
 | `ssot-registry issue close` | `--id` |
@@ -1087,12 +1088,16 @@ ssot-registry release revoke [path]
 
 Subcommands:
 
-- `export`, `sync-statuses`
+- `export`, `lineage`
 
 ```text
 ssot-registry graph export [path]
   --format {json,dot,png,svg} (required)
   --output OUTPUT
+
+ssot-registry graph lineage [path]
+  --output OUTPUT
+  --open
 ```
 
 ### `registry`

{ssot_cli-0.1.17 → ssot_cli-0.1.18.dev1}/README.md

@@ -225,6 +225,7 @@ Global flags: `--output-file`, `--output-format`, `--version`
 | `ssot-registry feature update` | `--body`, `--body-file`, `--description`, `--id`, `--implementation-status`, `--origin`, `--title` |
 | `ssot-registry graph` | none |
 | `ssot-registry graph export` | `--format`, `--output` |
+| `ssot-registry graph lineage` | `--open`, `--output` |
 | `ssot-registry init` | `--force`, `--repo-id`, `--repo-name`, `--version` |
 | `ssot-registry issue` | none |
 | `ssot-registry issue close` | `--id` |
@@ -1054,12 +1055,16 @@ ssot-registry release revoke [path]
 
 Subcommands:
 
-- `export`, `sync-statuses`
+- `export`, `lineage`
 
 ```text
 ssot-registry graph export [path]
   --format {json,dot,png,svg} (required)
   --output OUTPUT
+
+ssot-registry graph lineage [path]
+  --output OUTPUT
+  --open
 ```
 
 ### `registry`

{ssot_cli-0.1.17 → ssot_cli-0.1.18.dev1}/pyproject.toml

@@ -4,16 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssot-cli"
-version = "0.1.17"
+version = "0.1.18.dev1"
 description = "Primary CLI distribution for ssot-registry."
 readme = "README.md"
 requires-python = ">=3.10,<3.15"
 license = "Apache-2.0"
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 dependencies = [
-  "ssot-contracts>=0.2.23,<0.3.0",
-  "ssot-core>=0.2.23,<0.3.0",
-  "ssot-conformance>=0.2.23,<0.3.0",
+  "ssot-contracts>=0.2.24.dev1,<0.3.0",
+  "ssot-core>=0.2.24.dev1,<0.3.0",
+  "ssot-conformance>=0.2.24.dev1,<0.3.0",
   "ssot-pack-contracts>=0.2.23,<0.3.0",
   "tomli>=2.0.1; python_version < '3.11'",
 ]

{ssot_cli-0.1.17 → ssot_cli-0.1.18.dev1}/src/ssot_cli/graph_cmd.py

@@ -1,6 +1,10 @@
 from __future__ import annotations
 
 import argparse
+import os
+import subprocess
+import sys
+from pathlib import Path
 
 from ssot_registry.api import export_graph, export_lineage_graph
 
@@ -30,6 +34,7 @@ def register_graph(subparsers: argparse._SubParsersAction) -> None:
     )
     lineage.add_argument("path", nargs="?", default=".", help="Repository root or registry file to render from.")
     lineage.add_argument("--output", default=None, help="Destination HTML file. Defaults under `.ssot/graphs`.")
+    lineage.add_argument("--open", action="store_true", help="Open the generated HTML file with the local platform opener after export.")
     lineage.set_defaults(func=run_lineage)
 
 
@@ -38,4 +43,31 @@ def run_export(args: argparse.Namespace) -> dict[str, object]:
 
 
 def run_lineage(args: argparse.Namespace) -> dict[str, object]:
-    return export_lineage_graph(path=args.path, output=args.output)
+    payload = export_lineage_graph(path=args.path, output=args.output)
+    if args.open:
+        output_path = payload.get("output_path")
+        if not isinstance(output_path, str) or not output_path:
+            raise ValueError("lineage graph export did not return an output_path to open")
+        _open_file(Path(output_path))
+        payload["opened"] = True
+    else:
+        payload["opened"] = False
+    return payload
+
+
+def _open_file(path: Path) -> None:
+    target = path.resolve()
+    if not target.exists():
+        raise ValueError(f"Cannot open missing lineage graph artifact: {target}")
+    if target.is_dir():
+        raise ValueError(f"Cannot open lineage graph artifact because output path is a directory: {target}")
+
+    try:
+        if sys.platform.startswith("win"):
+            os.startfile(target)  # type: ignore[attr-defined]
+        elif sys.platform == "darwin":
+            subprocess.Popen(["open", str(target)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        else:
+            subprocess.Popen(["xdg-open", str(target)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    except OSError as exc:
+        raise ValueError(f"Failed to open lineage graph artifact {target}: {exc}") from exc

{ssot_cli-0.1.17 → ssot_cli-0.1.18.dev1}/src/ssot_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-cli
-Version: 0.1.17
+Version: 0.1.18.dev1
 Summary: Primary CLI distribution for ssot-registry.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -25,9 +25,9 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Utilities
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ssot-contracts<0.3.0,>=0.2.23
-Requires-Dist: ssot-core<0.3.0,>=0.2.23
-Requires-Dist: ssot-conformance<0.3.0,>=0.2.23
+Requires-Dist: ssot-contracts<0.3.0,>=0.2.24.dev1
+Requires-Dist: ssot-core<0.3.0,>=0.2.24.dev1
+Requires-Dist: ssot-conformance<0.3.0,>=0.2.24.dev1
 Requires-Dist: ssot-pack-contracts<0.3.0,>=0.2.23
 Requires-Dist: tomli>=2.0.1; python_version < "3.11"
 
@@ -258,6 +258,7 @@ Global flags: `--output-file`, `--output-format`, `--version`
 | `ssot-registry feature update` | `--body`, `--body-file`, `--description`, `--id`, `--implementation-status`, `--origin`, `--title` |
 | `ssot-registry graph` | none |
 | `ssot-registry graph export` | `--format`, `--output` |
+| `ssot-registry graph lineage` | `--open`, `--output` |
 | `ssot-registry init` | `--force`, `--repo-id`, `--repo-name`, `--version` |
 | `ssot-registry issue` | none |
 | `ssot-registry issue close` | `--id` |
@@ -1087,12 +1088,16 @@ ssot-registry release revoke [path]
 
 Subcommands:
 
-- `export`, `sync-statuses`
+- `export`, `lineage`
 
 ```text
 ssot-registry graph export [path]
   --format {json,dot,png,svg} (required)
   --output OUTPUT
+
+ssot-registry graph lineage [path]
+  --output OUTPUT
+  --open
 ```
 
 ### `registry`

ssot_cli-0.1.18.dev1/src/ssot_cli.egg-info/requires.txt

@@ -0,0 +1,7 @@
+ssot-contracts<0.3.0,>=0.2.24.dev1
+ssot-core<0.3.0,>=0.2.24.dev1
+ssot-conformance<0.3.0,>=0.2.24.dev1
+ssot-pack-contracts<0.3.0,>=0.2.23
+
+[:python_version < "3.11"]
+tomli>=2.0.1

ssot_cli-0.1.17/src/ssot_cli.egg-info/requires.txt

@@ -1,7 +0,0 @@
-ssot-contracts<0.3.0,>=0.2.23
-ssot-core<0.3.0,>=0.2.23
-ssot-conformance<0.3.0,>=0.2.23
-ssot-pack-contracts<0.3.0,>=0.2.23
-
-[:python_version < "3.11"]
-tomli>=2.0.1