galtea-cli 0.0.1__py3-none-win_amd64.whl

galtea_cli/__init__.py

@@ -0,0 +1,27 @@
+"""galtea-cli — Python wrapper around the native galtea binary.
+
+This package is a thin shim that locates the platform-specific
+`galtea` executable bundled inside the wheel and forwards stdin /
+stdout / stderr / signals / exit codes to it.
+
+The version string is sourced from the installed distribution metadata
+via `importlib.metadata.version("galtea-cli")` — the single
+authoritative source. cli.yml sed-replaces the placeholder in
+pyproject.toml at build time, and that value flows through here without
+a parallel placeholder to keep in sync.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__: str = version("galtea-cli")
+except PackageNotFoundError:
+    # Source-tree / editable / uninstalled scenarios (e.g. running tests
+    # from cli/python/ without a prior `pip install`). Fall through to a
+    # sentinel rather than raising — `import galtea_cli` should not break
+    # before the package is installed.
+    __version__ = "0.0.0+unknown"
+
+__all__: list[str] = ["__version__"]

galtea_cli/__main__.py

@@ -0,0 +1,70 @@
+"""Console-script entry point for the galtea wheel.
+
+`pip install galtea-cli` registers this module under the `galtea`
+name (see `[project.scripts]` in pyproject.toml). At runtime we
+locate the bundled native binary, invoke it as a subprocess, and
+propagate its exit code.
+
+We use subprocess.run + sys.exit (NOT os.execv) on purpose:
+
+- os.execv replaces the current process image with the binary, which
+  on POSIX is fine but on Windows is emulated via subprocess +
+  exit-code copying with subtle semantics (signal handling, console
+  attach, exit-code truncation to 16 bits in some shells). Running
+  the binary as a subprocess and forwarding its return code is
+  identical on every platform we ship.
+- subprocess.run with default stdio inheritance forwards stdin,
+  stdout, stderr to the child without buffering, so interactive
+  prompts (`galtea login` no-echo password input) and TTY detection
+  work the same way they do when the binary is invoked directly.
+- KeyboardInterrupt is forwarded as SIGINT to the child on POSIX and
+  as the equivalent on Windows; we exit with the child's return code
+  rather than 130 so existing CI harnesses that key off galtea's
+  documented exit codes (e.g. exit 10 = version-gate hard-block, see
+  `cli-go.md` Versioning section) keep working.
+
+Pattern reference: astral-sh/ruff (`ruff/__main__.py`), astral-sh/uv
+(`uv/__main__.py`).
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+
+from galtea_cli._locate import find_binary
+
+
+def main() -> None:
+    """Locate the bundled galtea binary and forward control to it."""
+    try:
+        binary: str = find_binary()
+    except FileNotFoundError as exc:
+        print(f"galtea-cli: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+    # subprocess.run with the original argv tail; check=False so we
+    # propagate non-zero exit codes ourselves rather than raising
+    # CalledProcessError. close_fds defaults are fine on every
+    # platform we ship.
+    try:
+        completed: subprocess.CompletedProcess[bytes] = subprocess.run(
+            [binary, *sys.argv[1:]],
+            check=False,
+        )
+    except OSError as exc:
+        # Triggered by e.g. a wrong-platform wheel force-installed via
+        # `pip install --platform=...`, missing exec bit, or a virus
+        # scanner briefly locking the binary on Windows. Surface a
+        # clear remediation hint instead of a Python traceback.
+        print(
+            f"galtea-cli: failed to execute bundled binary at {binary}: {exc}\n"
+            "Try `pip install --upgrade --force-reinstall galtea-cli`.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    sys.exit(completed.returncode)
+
+
+if __name__ == "__main__":
+    main()

galtea_cli/_locate.py

@@ -0,0 +1,67 @@
+"""Locate the bundled galtea binary inside the installed wheel.
+
+Each per-platform wheel embeds exactly one binary under
+`galtea_cli/bin/`:
+- POSIX wheels (linux / macOS): `galtea_cli/bin/galtea`
+- Windows wheels: `galtea_cli/bin/galtea.exe`
+
+We deliberately don't fall through to a `PATH` lookup or a downloader:
+the contract of this wheel is that the binary it advertises is the
+binary it ships. If the binary is missing, that's a packaging bug we
+want to surface loudly rather than silently substitute a different
+version installed elsewhere on the system.
+
+Pattern reference: astral-sh/ruff (`ruff/_find_ruff.py`),
+astral-sh/uv (`uv/_find_uv.py`).
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+
+def _binary_filename() -> str:
+    """Return the bundled binary's filename for the current platform.
+
+    Windows ships `galtea.exe`; everything else ships `galtea`. This
+    matches GoReleaser's per-target output and the `format_overrides`
+    in `cli/.goreleaser.yaml`.
+    """
+    if sys.platform == "win32":
+        return "galtea.exe"
+    return "galtea"
+
+
+def find_binary() -> str:
+    """Return the absolute path to the bundled galtea binary.
+
+    Raises FileNotFoundError with a clear, actionable message when the
+    binary is missing — almost always means the wheel was built
+    without running `build_wheels.py` (or `cli/dist/` was empty when
+    the wheel was assembled), not a runtime configuration issue. The
+    message names the expected path so packagers and SREs can confirm
+    the failure mode without spelunking the wheel.
+    """
+    bin_dir: Path = Path(__file__).resolve().parent / "bin"
+    binary_path: Path = bin_dir / _binary_filename()
+    if not binary_path.is_file():
+        raise FileNotFoundError(
+            f"galtea binary not found at {binary_path}. "
+            "This usually means the wheel was built without bundling a "
+            "platform-specific binary. Reinstall galtea-cli, or download "
+            "the binary directly from "
+            "https://github.com/Galtea-AI/monorepo/releases."
+        )
+    # Defensive: ensure executable bit on POSIX. Wheels preserve the
+    # mode field, but a hand-extracted wheel on a hostile filesystem
+    # can lose it. OR with 0o111 (just the execute bits) instead of
+    # 0o755 — a binary the user explicitly chmod'd 0o600 should not
+    # silently become world-readable as a side effect of running it.
+    # No-op on Windows where the .exe extension governs executability.
+    if sys.platform != "win32":
+        mode: int = binary_path.stat().st_mode
+        if not mode & 0o111:
+            os.chmod(binary_path, mode | 0o111)
+    return str(binary_path)

galtea_cli-0.0.1.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: galtea-cli
+Version: 0.0.1
+Summary: Galtea CLI — terminal-native client for the Galtea AI testing & evaluation platform
+Project-URL: Homepage, https://galtea.ai/
+Project-URL: Documentation, https://docs.galtea.ai/
+Project-URL: Repository, https://github.com/Galtea-AI/monorepo
+Project-URL: Issues, https://github.com/Galtea-AI/monorepo/issues
+Project-URL: Changelog, https://github.com/Galtea-AI/monorepo/releases
+Author-email: Galtea AI <info@galtea.ai>
+License-Expression: Apache-2.0
+Keywords: ai-testing,cli,galtea,llm-evaluation,mlops
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# galtea-cli
+
+<p align="center">
+  <img src="https://galtea.ai/img/galtea_mod.png" alt="Galtea" width="500" height="auto"/>
+</p>
+
+<p align="center">
+  <strong>Terminal-native client for the Galtea AI Testing & Evaluation Platform</strong>
+</p>
+
+<p align="center">
+	<a href="https://pypi.org/project/galtea-cli/">
+		<img src="https://img.shields.io/pypi/v/galtea-cli.svg" alt="PyPI version">
+	</a>
+	<a href="https://github.com/Galtea-AI/monorepo/releases">
+		<img src="https://img.shields.io/badge/platform-linux%20%7C%20macOS%20%7C%20windows-lightgrey" alt="Platform support: Linux, macOS, Windows">
+	</a>
+	<a href="https://www.apache.org/licenses/LICENSE-2.0">
+		<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
+	</a>
+</p>
+
+The official command-line client for the [Galtea AI testing & evaluation
+platform](https://galtea.ai/), distributed as a Python package for
+zero-friction install on machines that already have Python.
+
+## Install
+
+```bash
+pip install galtea-cli
+```
+
+That's it. The wheel ships the matching native `galtea` binary inside
+the package and registers a `galtea` console script on your `PATH`:
+
+```bash
+galtea --version
+galtea login
+galtea products list
+```
+
+## Other install channels
+
+`galtea-cli` is one of several first-class distribution channels for the
+same single binary. Pick whichever fits your environment:
+
+| Channel | Install gesture |
+|---------|-----------------|
+| PyPI (this package) | `pip install galtea-cli` |
+| Homebrew | `brew install galtea-ai/tap/galtea` |
+| Scoop | `scoop bucket add galtea https://github.com/Galtea-AI/scoop-bucket && scoop install galtea` |
+| Winget | `winget install galtea` |
+| Debian / Ubuntu (apt) | `apt install galtea` — see [pkgs.galtea.ai](https://pkgs.galtea.ai) for the one-time `apt` source setup |
+| Fedora / RHEL (dnf) | `dnf install galtea` — see [pkgs.galtea.ai](https://pkgs.galtea.ai) for the one-time `dnf` repo setup |
+| Direct `.deb` / `.rpm` | Download from the [latest GitHub Release](https://github.com/Galtea-AI/monorepo/releases) and `dpkg -i` / `rpm -i` |
+| Direct download | [GitHub Releases](https://github.com/Galtea-AI/monorepo/releases) `tar.gz` / `zip` |
+
+The same binary ships through every channel — nothing is rebuilt per
+channel. See
+[`cli/adr/0005-pypi-distribution-and-monorepo-train.md`](https://github.com/Galtea-AI/monorepo/blob/main/cli/adr/0005-pypi-distribution-and-monorepo-train.md)
+for the rationale.
+
+## Documentation
+
+📖 **Full CLI documentation:** [docs.galtea.ai](https://docs.galtea.ai/) — command reference, tutorials, and authentication guides.
+
+For source code, issues, and release notes see the
+[monorepo](https://github.com/Galtea-AI/monorepo).
+
+## License
+
+Apache License 2.0.

galtea_cli-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+galtea_cli/__init__.py,sha256=_aDHGW46-lUZ6gOACX8Dc_HOIhz03361kYueqqcQ60k,1065
+galtea_cli/__main__.py,sha256=FDuocsYBNaqsETWSXkta8HwX7JvHmP1oJDYlj5cjgOk,2712
+galtea_cli/_locate.py,sha256=BBvjt385Luju00gEoUoyHciipfzTd_l89hay_nYAXYA,2694
+galtea_cli/bin/galtea.exe,sha256=_DocQk3_iA2YaXDLdk71nB7piZGVtJYdxSmFJAutRRo,32435712
+galtea_cli-0.0.1.dist-info/METADATA,sha256=ne8erbp86fvVa4FdhCjqcBhVsa8kC6A6jXwIXns2YJ0,4305
+galtea_cli-0.0.1.dist-info/WHEEL,sha256=fip2IBhkkNvH-S_Xh3PV94_XVqHJB1nn9gTAcldDBj4,94
+galtea_cli-0.0.1.dist-info/entry_points.txt,sha256=osQhcSz4pUM2EQxS5eq7xAWFUQN5Y5kcJ2DPAo15CNQ,52
+galtea_cli-0.0.1.dist-info/RECORD,,

galtea_cli-0.0.1.dist-info/WHEEL

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

galtea_cli-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+galtea = galtea_cli.__main__:main