valbridge-cli 1.0.2__py3-none-any.whl

valbridge_cli/__init__.py

@@ -0,0 +1,2 @@
+"""Installable valbridge CLI launcher."""
+

valbridge_cli/__main__.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+import subprocess
+import sys
+
+from ._runtime import resolve_binary
+
+
+def main() -> int:
+    try:
+        binary = resolve_binary()
+    except RuntimeError as exc:
+        sys.stderr.write(f"{exc}\n")
+        return 1
+    completed = subprocess.run([binary, *sys.argv[1:]], check=False)
+    return completed.returncode
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

valbridge_cli/_runtime.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+import importlib.metadata
+import os
+import platform
+import shutil
+import stat
+import sys
+import tempfile
+from urllib.parse import urlparse
+import urllib.request
+from pathlib import Path
+
+OWNER = "vectorfy-co"
+REPO = "valbridge"
+ENV_BIN = "VALBRIDGE_CLI_BIN"
+DOWNLOAD_TIMEOUT_SECONDS = 30
+
+
+def _package_version() -> str:
+    return importlib.metadata.version("valbridge-cli")
+
+
+def _platform_info() -> tuple[str, str, str]:
+    machine = platform.machine().lower()
+    if machine in {"x86_64", "amd64"}:
+        arch = "x64"
+    elif machine in {"arm64", "aarch64"}:
+        arch = "arm64"
+    else:
+        raise RuntimeError(f"Unsupported valbridge CLI architecture: {machine}")
+
+    if sys_platform := sys.platform:
+        if sys_platform.startswith("darwin"):
+            return "darwin", arch, ""
+        if sys_platform.startswith("linux"):
+            return "linux", arch, ""
+        if sys_platform.startswith("win"):
+            return "windows", arch, ".exe"
+
+    raise RuntimeError(f"Unsupported valbridge CLI platform: {sys.platform}")
+
+
+def _release_asset(version: str) -> tuple[str, str]:
+    platform_name, arch, ext = _platform_info()
+    filename = f"valbridge-{platform_name}-{arch}{ext}"
+    tag = f"cli-v{version}"
+    return filename, f"https://github.com/{OWNER}/{REPO}/releases/download/{tag}/{filename}"
+
+
+def _cache_path(version: str, filename: str) -> Path:
+    return Path.home() / ".cache" / "valbridge" / "cli" / version / filename
+
+
+def resolve_binary() -> str:
+    override = os.getenv(ENV_BIN)
+    if override:
+        return override
+
+    version = _package_version()
+    filename, url = _release_asset(version)
+    destination = _cache_path(version, filename)
+    if not destination.exists():
+        destination.parent.mkdir(parents=True, exist_ok=True)
+        parsed = urlparse(url)
+        if parsed.scheme != "https":
+            raise RuntimeError(f"Refusing to download valbridge CLI over non-HTTPS scheme: {parsed.scheme or '<missing>'}")
+
+        with tempfile.NamedTemporaryFile(delete=False, dir=destination.parent) as temp_file:
+            temp_path = Path(temp_file.name)
+
+        try:
+            with urllib.request.urlopen(url, timeout=DOWNLOAD_TIMEOUT_SECONDS) as response:
+                with temp_path.open("wb") as file_obj:
+                    shutil.copyfileobj(response, file_obj)
+            temp_path.replace(destination)
+        except Exception:
+            temp_path.unlink(missing_ok=True)
+            raise
+
+        if os.name != "nt":
+            destination.chmod(destination.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+
+    return str(destination)

valbridge_cli-1.0.2.dist-info/METADATA

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: valbridge-cli
+Version: 1.0.2
+Summary: Installable CLI launcher for valbridge
+Project-URL: Homepage, https://github.com/vectorfy-co/valbridge
+Project-URL: Documentation, https://github.com/vectorfy-co/valbridge
+Project-URL: Repository, https://github.com/vectorfy-co/valbridge
+Project-URL: Issues, https://github.com/vectorfy-co/valbridge/issues
+Project-URL: Changelog, https://github.com/vectorfy-co/valbridge/blob/main/CHANGELOG.md
+Author: vectorfyco
+Maintainer: vectorfyco
+License: MIT
+Keywords: cli,code-generation,json-schema,valbridge
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# ![valbridge-cli](https://img.shields.io/static/v1?label=&message=valbridge-cli&color=3776AB&style=for-the-badge&logo=pypi&logoColor=white)
+
+Installable valbridge CLI launcher for pip and uvx. Downloads the correct platform binary automatically.
+
+<a href="https://pypi.org/project/valbridge-cli/"><img src="https://img.shields.io/pypi/v/valbridge-cli?style=flat&logo=pypi&logoColor=white" alt="PyPI" /></a>
+<a href="https://github.com/vectorfy-co/valbridge/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vectorfy-co/valbridge?style=flat" alt="License" /></a>
+
+</div>
+
+---
+
+## Zero-install usage
+
+Run directly without installing globally:
+
+```bash
+uvx valbridge-cli generate
+uvx valbridge-cli generate --help
+```
+
+## Global installation
+
+```bash
+# pip
+pip install valbridge-cli
+
+# uv (recommended)
+uv tool install valbridge-cli
+```
+
+Then use the `valbridge` command directly:
+
+```bash
+valbridge generate
+valbridge extract --schema user:Profile
+valbridge --help
+```
+
+## How it works
+
+The launcher downloads the matching `valbridge` Go binary for the current platform on first run and caches it locally. Subsequent runs use the cached binary.
+
+## Environment variables
+
+| Variable | Description |
+| --- | --- |
+| `VALBRIDGE_CLI_BIN` | Override the binary path. Set to a local build to skip the download. |
+
+## Related packages
+
+| Package | Purpose |
+| --- | --- |
+| [`@vectorfyco/valbridge-cli`](https://www.npmjs.com/package/@vectorfyco/valbridge-cli) | npm/npx CLI launcher (same binary, different installer) |
+| [`valbridge`](https://pypi.org/project/valbridge/) | Runtime client for generated validators |
+| [`valbridge-pydantic`](https://pypi.org/project/valbridge-pydantic/) | Pydantic adapter for code generation |
+
+## Learn more
+
+- [GitHub repository](https://github.com/vectorfy-co/valbridge)
+- [Full documentation](https://github.com/vectorfy-co/valbridge#readme)

valbridge_cli-1.0.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+valbridge_cli/__init__.py,sha256=Iu9W50xm_hQ9NxXmlEWrf819iaNnwd6CZQAHWp1NoP8,43
+valbridge_cli/__main__.py,sha256=SthaZyQEM5afBi-dwPEpEks3JVr0uf6V2DAEKIs0ssc,412
+valbridge_cli/_runtime.py,sha256=_SLiUl6WgC3KRC7qGsATdtCj-YQdtUIsNHiKUqKbKBE,2672
+valbridge_cli-1.0.2.dist-info/METADATA,sha256=rP88wLgW0fadHvvajXRrMYLUb8zet4kSk-tY0m07Ogs,2984
+valbridge_cli-1.0.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+valbridge_cli-1.0.2.dist-info/entry_points.txt,sha256=f5osMvxd63HG2mXIjy_l7u278X8j5uZQ_vDv6Tuy994,58
+valbridge_cli-1.0.2.dist-info/RECORD,,

valbridge_cli-1.0.2.dist-info/WHEEL

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

valbridge_cli-1.0.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+valbridge = valbridge_cli.__main__:main