utharnessly 0.1.0__tar.gz

utharnessly-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+/target
+*.db
+*.db-shm
+*.db-wal
+.env
+.DS_Store
+.idea/
+.vscode/
+/ui/screenshots/*.ansi
+/ui/screenshots/*.png
+/ui/dist/
+/ui/node_modules/

utharnessly-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Utharness Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

utharnessly-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.5
+Name: utharnessly
+Version: 0.1.0
+Summary: Cross-platform launcher for the utharness local-first agent terminal
+Project-URL: Homepage, https://github.com/uthumany/utharnessly
+Project-URL: Repository, https://github.com/uthumany/utharnessly.git
+Project-URL: Issues, https://github.com/uthumany/utharnessly/issues
+Author: Utharness Contributors
+License: MIT License
+        
+        Copyright (c) 2026 Utharness Contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agent,cli,rust,terminal,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: System :: Shells
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# utharnessly
+
+`utharnessly` is the Python launcher for the [Utharness](https://github.com/uthumany/utharnessly) local-first agent terminal. It downloads the matching GitHub Release archive on first use, verifies the published SHA-256 checksum, caches the native Rust runtime and bundled Ink UI, and forwards CLI arguments to `utharness`.
+
+## Usage
+
+```bash
+python -m pip install utharnessly
+utharnessly --help
+utharnessly --version
+utharnessly
+```
+
+The release launcher currently publishes Linux x64, macOS x64, and Windows x64 artifacts. Other architectures and operating systems should use the documented source-build or remote-host workflow in the repository installation guide.
+
+```bash
+utharnessly update
+utharnessly uninstall
+```
+
+`uninstall` prints the package and cache removal commands; it does not silently mutate the Python environment.
+
+## License
+
+MIT. See the repository for the full license and development instructions.

utharnessly-0.1.0/README.md

@@ -0,0 +1,25 @@
+# utharnessly
+
+`utharnessly` is the Python launcher for the [Utharness](https://github.com/uthumany/utharnessly) local-first agent terminal. It downloads the matching GitHub Release archive on first use, verifies the published SHA-256 checksum, caches the native Rust runtime and bundled Ink UI, and forwards CLI arguments to `utharness`.
+
+## Usage
+
+```bash
+python -m pip install utharnessly
+utharnessly --help
+utharnessly --version
+utharnessly
+```
+
+The release launcher currently publishes Linux x64, macOS x64, and Windows x64 artifacts. Other architectures and operating systems should use the documented source-build or remote-host workflow in the repository installation guide.
+
+```bash
+utharnessly update
+utharnessly uninstall
+```
+
+`uninstall` prints the package and cache removal commands; it does not silently mutate the Python environment.
+
+## License
+
+MIT. See the repository for the full license and development instructions.

utharnessly-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "utharnessly"
+version = "0.1.0"
+description = "Cross-platform launcher for the utharness local-first agent terminal"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+authors = [{ name = "Utharness Contributors" }]
+keywords = ["cli", "terminal", "agent", "rust", "tui"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: System :: Shells",
+]
+
+[project.urls]
+Homepage = "https://github.com/uthumany/utharnessly"
+Repository = "https://github.com/uthumany/utharnessly.git"
+Issues = "https://github.com/uthumany/utharnessly/issues"
+
+[project.scripts]
+utharnessly = "utharnessly.cli:main"
+utharness = "utharnessly.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/utharnessly"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/README.md",
+  "/LICENSE",
+  "/pyproject.toml",
+]

utharnessly-0.1.0/src/utharnessly/__init__.py

@@ -0,0 +1,3 @@
+"""utharnessly Python launcher package."""
+
+__version__ = "0.1.0"

utharnessly-0.1.0/src/utharnessly/cli.py

@@ -0,0 +1,140 @@
+"""Thin Python launcher for the utharnessly native release."""
+
+from __future__ import annotations
+
+import hashlib
+import os
+import platform
+import shutil
+import subprocess
+import sys
+import tarfile
+import tempfile
+import urllib.request
+import zipfile
+from pathlib import Path
+
+VERSION = "0.1.0"
+REPOSITORY = "uthumany/utharnessly"
+
+
+def release_base_url() -> str:
+    return os.environ.get(
+        "UTHARNESSLY_RELEASE_BASE_URL",
+        f"https://github.com/{REPOSITORY}/releases/download/v{VERSION}",
+    ).rstrip("/")
+
+
+def platform_asset() -> tuple[str, str]:
+    system = sys.platform
+    machine = platform.machine().lower()
+    if system.startswith("linux") and machine in {"x86_64", "amd64"}:
+        return "utharnessly-linux-x64.tar.gz", "tar.gz"
+    if system == "darwin" and machine in {"x86_64", "amd64"}:
+        return "utharnessly-macos-x64.tar.gz", "tar.gz"
+    if system.startswith("win") and machine in {"x86_64", "amd64"}:
+        return "utharnessly-windows-x64.zip", "zip"
+    raise RuntimeError(
+        f"No published utharnessly binary for {system}/{machine}. "
+        "Supported release targets are Linux x64, macOS x64, and Windows x64; "
+        f"use the source instructions at https://github.com/{REPOSITORY} on other targets."
+    )
+
+
+def cache_root() -> Path:
+    if os.name == "nt":
+        base = Path(os.environ.get("LOCALAPPDATA", Path.home()))
+    else:
+        base = Path(os.environ.get("XDG_CACHE_HOME", Path.home() / ".cache"))
+    return base / "utharnessly" / VERSION
+
+
+def _download(url: str, destination: Path) -> None:
+    request = urllib.request.Request(url, headers={"User-Agent": "utharnessly-python-launcher"})
+    with urllib.request.urlopen(request, timeout=60) as response, destination.open("wb") as output:
+        shutil.copyfileobj(response, output)
+
+
+def _verify_checksum(archive: Path, checksums: Path) -> None:
+    asset = archive.name
+    line = next((row for row in checksums.read_text(encoding="utf-8").splitlines() if asset in row), None)
+    if not line:
+        raise RuntimeError(f"SHA256SUMS does not contain {asset}")
+    expected = line.split()[0].lower()
+    actual = hashlib.sha256(archive.read_bytes()).hexdigest()
+    if expected != actual:
+        raise RuntimeError(f"checksum verification failed for {asset}")
+
+
+def _extract(archive: Path, format_name: str, destination: Path) -> None:
+    if format_name == "tar.gz":
+        with tarfile.open(archive, "r:gz") as handle:
+            handle.extractall(destination, filter="data")
+    elif format_name == "zip":
+        with zipfile.ZipFile(archive) as handle:
+            handle.extractall(destination)
+    else:
+        raise RuntimeError(f"unsupported archive format: {format_name}")
+
+
+def ensure_binary(force: bool = False) -> tuple[Path, Path]:
+    asset, format_name = platform_asset()
+    root = cache_root()
+    binary = root / ("utharness.exe" if os.name == "nt" else "utharness")
+    ui = root / "ui"
+    if not force and binary.is_file():
+        return binary, ui
+    shutil.rmtree(root, ignore_errors=True)
+    root.mkdir(parents=True, exist_ok=True)
+    with tempfile.TemporaryDirectory(prefix="utharnessly-") as temporary:
+        temporary_path = Path(temporary)
+        archive = temporary_path / asset
+        checksums = temporary_path / "SHA256SUMS"
+        print(f"Downloading utharnessly v{VERSION} ({sys.platform}/{platform.machine()})…", file=sys.stderr)
+        _download(f"{release_base_url()}/{asset}", archive)
+        _download(f"{release_base_url()}/SHA256SUMS", checksums)
+        _verify_checksum(archive, checksums)
+        extracted = temporary_path / "extracted"
+        extracted.mkdir()
+        _extract(archive, format_name, extracted)
+        package_root = next((entry for entry in extracted.iterdir() if entry.is_dir() and entry.name.startswith("utharnessly-")), None)
+        if package_root is None:
+            raise RuntimeError("release archive did not contain an utharnessly directory")
+        shutil.copy2(package_root / binary.name, binary)
+        if os.name != "nt":
+            binary.chmod(0o755)
+        shutil.copytree(package_root / "ui", ui)
+    return binary, ui
+
+
+def main() -> int:
+    args = sys.argv[1:]
+    if args in (["--version"], ["-V"]):
+        print(f"utharnessly {VERSION}")
+        return 0
+    if args and args[0] == "update":
+        try:
+            ensure_binary(force=True)
+            print(f"utharnessly {VERSION} is ready.")
+            return 0
+        except Exception as error:  # pragma: no cover - platform/network-specific
+            print(f"utharnessly update failed: {error}", file=sys.stderr)
+            return 1
+    if args and args[0] == "uninstall":
+        print("Remove the Python package with: python -m pip uninstall utharnessly")
+        cache_command = f'rmdir /s /q "{cache_root()}"' if os.name == "nt" else f'rm -rf "{cache_root()}"'
+        print(f"Remove the cached native runtime with: {cache_command}")
+        return 0
+    try:
+        binary, _ui = ensure_binary()
+    except Exception as error:  # pragma: no cover - platform/network-specific
+        print(f"utharnessly: {error}", file=sys.stderr)
+        return 1
+    environment = os.environ.copy()
+    environment["UTHARNESS_RUNTIME_BIN"] = str(binary)
+    completed = subprocess.run([str(binary), *args], env=environment, check=False)
+    return completed.returncode
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())