hypervisual 0.1.0__tar.gz

hypervisual-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+dist/
+target/
+.DS_Store
+__pycache__/

hypervisual-0.1.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.5
+Name: hypervisual
+Version: 0.1.0
+Summary: HyperVisual CLI launcher: downloads and runs the `codi` binary for architecture diagrams as code.
+Project-URL: Homepage, https://hypervisual.io
+Project-URL: Repository, https://github.com/hypervisual-io/hypervisual
+License-Expression: Apache-2.0
+Keywords: architecture,c4,cli,diagrams,diagrams-as-code,mcp
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# hypervisual
+
+Launcher for the HyperVisual CLI (`codi`): architecture diagrams as code that validate themselves.
+
+```sh
+pipx run hypervisual validate architecture.codi
+uvx hypervisual render architecture.codi -o architecture.svg
+```
+
+On first run it downloads the matching `codi` binary from [GitHub Releases](https://github.com/hypervisual-io/hypervisual/releases), verifies its SHA-256 and caches it under `~/.cache/hypervisual`. Set `HYPERVISUAL_VERSION` to pin another release tag.
+
+Supported: macOS arm64, Linux x86_64 and arm64. Validation needs Python 3.9+ as `python3`.
+
+See [hypervisual-io/hypervisual](https://github.com/hypervisual-io/hypervisual) for agent skills and MCP setup.

hypervisual-0.1.0/README.md

@@ -0,0 +1,14 @@
+# hypervisual
+
+Launcher for the HyperVisual CLI (`codi`): architecture diagrams as code that validate themselves.
+
+```sh
+pipx run hypervisual validate architecture.codi
+uvx hypervisual render architecture.codi -o architecture.svg
+```
+
+On first run it downloads the matching `codi` binary from [GitHub Releases](https://github.com/hypervisual-io/hypervisual/releases), verifies its SHA-256 and caches it under `~/.cache/hypervisual`. Set `HYPERVISUAL_VERSION` to pin another release tag.
+
+Supported: macOS arm64, Linux x86_64 and arm64. Validation needs Python 3.9+ as `python3`.
+
+See [hypervisual-io/hypervisual](https://github.com/hypervisual-io/hypervisual) for agent skills and MCP setup.

hypervisual-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hypervisual"
+version = "0.1.0"
+description = "HyperVisual CLI launcher: downloads and runs the `codi` binary for architecture diagrams as code."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.9"
+keywords = ["architecture", "diagrams", "diagrams-as-code", "c4", "mcp", "cli"]
+classifiers = [
+  "Environment :: Console",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Topic :: Software Development :: Documentation",
+]
+
+[project.urls]
+Homepage = "https://hypervisual.io"
+Repository = "https://github.com/hypervisual-io/hypervisual"
+
+[project.scripts]
+hypervisual = "hypervisual.launcher:main"
+codi = "hypervisual.launcher:main"

hypervisual-0.1.0/src/hypervisual/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

hypervisual-0.1.0/src/hypervisual/__main__.py

@@ -0,0 +1,3 @@
+from hypervisual.launcher import main
+
+main()

hypervisual-0.1.0/src/hypervisual/launcher.py

@@ -0,0 +1,71 @@
+import hashlib
+import os
+import platform
+import sys
+import tarfile
+import tempfile
+import urllib.request
+from pathlib import Path
+
+from hypervisual import __version__
+
+REPO = "hypervisual-io/hypervisual"
+TARGETS = {
+    ("Darwin", "arm64"): "aarch64-apple-darwin",
+    ("Linux", "x86_64"): "x86_64-unknown-linux-gnu",
+    ("Linux", "amd64"): "x86_64-unknown-linux-gnu",
+    ("Linux", "aarch64"): "aarch64-unknown-linux-gnu",
+    ("Linux", "arm64"): "aarch64-unknown-linux-gnu",
+}
+
+
+def die(message):
+    sys.stderr.write(f"hypervisual: error: {message}\n")
+    sys.exit(1)
+
+
+def download(url):
+    try:
+        with urllib.request.urlopen(url) as response:
+            return response.read()
+    except OSError as error:
+        die(f"download failed: {url} ({error})")
+
+
+def ensure_binary():
+    tag = os.environ.get("HYPERVISUAL_VERSION") or f"v{__version__}"
+    system, machine = platform.system(), platform.machine()
+    target = TARGETS.get((system, machine))
+    if target is None:
+        die(f"no prebuilt binary for {system}/{machine} (available: macOS arm64, Linux x86_64, Linux arm64)")
+
+    cache_root = Path(os.environ.get("XDG_CACHE_HOME") or Path.home() / ".cache")
+    directory = cache_root / "hypervisual" / tag / target
+    binary = directory / "codi"
+    if binary.exists():
+        return binary
+
+    asset = f"codi-{target}.tar.gz"
+    base = f"https://github.com/{REPO}/releases/download/{tag}"
+    sys.stderr.write(f"hypervisual: downloading {asset} ({tag})\n")
+    archive = download(f"{base}/{asset}")
+    expected = download(f"{base}/{asset}.sha256").decode().split()[0]
+    if hashlib.sha256(archive).hexdigest() != expected:
+        die(f"checksum mismatch for {asset}")
+
+    directory.mkdir(parents=True, exist_ok=True)
+    with tempfile.TemporaryDirectory(dir=directory, prefix=".download-") as staging:
+        archive_path = Path(staging) / asset
+        archive_path.write_bytes(archive)
+        with tarfile.open(archive_path) as tar:
+            member = tar.getmember("codi")
+            tar.extract(member, staging)
+        extracted = Path(staging) / "codi"
+        extracted.chmod(0o755)
+        extracted.replace(binary)
+    return binary
+
+
+def main():
+    binary = ensure_binary()
+    os.execv(binary, [str(binary), *sys.argv[1:]])