hypervisual 0.1.0__py3-none-any.whl

hypervisual/__init__.py

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

hypervisual/__main__.py

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

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:]])

hypervisual-0.1.0.dist-info/METADATA

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

@@ -0,0 +1,7 @@
+hypervisual/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+hypervisual/__main__.py,sha256=ohukg9GAwTSuyvvamPfhu8xiPFjIDCBUtNhmb8WGXAU,46
+hypervisual/launcher.py,sha256=SKAyE7Y4aYqBbHXkm9SoGIVkrw1VbpEG6ExgO1L0toE,2275
+hypervisual-0.1.0.dist-info/METADATA,sha256=PbK7el1K0ZHj79BWmdH3IKzYh5cc8R44Oto5_l_yWH4,1305
+hypervisual-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+hypervisual-0.1.0.dist-info/entry_points.txt,sha256=uDI0o9JYD4NZ6wp8C3CDsUxgsWS0KWYbXduY_3XSerI,91
+hypervisual-0.1.0.dist-info/RECORD,,

hypervisual-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

hypervisual-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+codi = hypervisual.launcher:main
+hypervisual = hypervisual.launcher:main