ggcode 1.0.9__tar.gz → 1.1.0__tar.gz

ggcode-1.1.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: ggcode
+Version: 1.1.0
+Summary: Thin Python wrapper that installs the ggcode GitHub Release binary
+Author: topcheer
+License: MIT
+Project-URL: Homepage, https://github.com/topcheer/ggcode
+Project-URL: Repository, https://github.com/topcheer/ggcode.git
+Project-URL: Issues, https://github.com/topcheer/ggcode/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# ggcode Python wrapper
+
+`ggcode` on PyPI is a thin Python wrapper for the `ggcode` terminal agent.
+
+It does not ship the platform binary inside the wheel. Instead, the wrapper downloads the latest
+matching `ggcode` GitHub Release on first run, caches it locally, and then launches it.
+
+## Install
+
+```bash
+pip install ggcode
+```
+
+Then run:
+
+```bash
+ggcode
+```
+
+## What it does
+
+- Detects your operating system and CPU architecture
+- Downloads the latest matching `ggcode` archive from GitHub Releases
+- Verifies the archive against `checksums.txt`
+- Extracts and caches the binary for future runs
+
+## Pin a specific ggcode release
+
+By default, the wrapper always resolves the latest `ggcode` release.
+
+To force a specific release, set `GGCODE_INSTALL_VERSION`:
+
+```bash
+GGCODE_INSTALL_VERSION=vX.Y.Z ggcode
+```
+
+or:
+
+```bash
+GGCODE_INSTALL_VERSION=X.Y.Z ggcode
+```
+
+## Supported platforms
+
+- macOS
+- Linux
+- Windows
+
+Supported architectures:
+
+- x86_64 / amd64
+- arm64
+
+## Project links
+
+- Repository: https://github.com/topcheer/ggcode
+- Issues: https://github.com/topcheer/ggcode/issues

ggcode-1.1.0/README.md

@@ -0,0 +1,57 @@
+# ggcode Python wrapper
+
+`ggcode` on PyPI is a thin Python wrapper for the `ggcode` terminal agent.
+
+It does not ship the platform binary inside the wheel. Instead, the wrapper downloads the latest
+matching `ggcode` GitHub Release on first run, caches it locally, and then launches it.
+
+## Install
+
+```bash
+pip install ggcode
+```
+
+Then run:
+
+```bash
+ggcode
+```
+
+## What it does
+
+- Detects your operating system and CPU architecture
+- Downloads the latest matching `ggcode` archive from GitHub Releases
+- Verifies the archive against `checksums.txt`
+- Extracts and caches the binary for future runs
+
+## Pin a specific ggcode release
+
+By default, the wrapper always resolves the latest `ggcode` release.
+
+To force a specific release, set `GGCODE_INSTALL_VERSION`:
+
+```bash
+GGCODE_INSTALL_VERSION=vX.Y.Z ggcode
+```
+
+or:
+
+```bash
+GGCODE_INSTALL_VERSION=X.Y.Z ggcode
+```
+
+## Supported platforms
+
+- macOS
+- Linux
+- Windows
+
+Supported architectures:
+
+- x86_64 / amd64
+- arm64
+
+## Project links
+
+- Repository: https://github.com/topcheer/ggcode
+- Issues: https://github.com/topcheer/ggcode/issues

ggcode-1.1.0/ggcode.egg-info/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: ggcode
+Version: 1.1.0
+Summary: Thin Python wrapper that installs the ggcode GitHub Release binary
+Author: topcheer
+License: MIT
+Project-URL: Homepage, https://github.com/topcheer/ggcode
+Project-URL: Repository, https://github.com/topcheer/ggcode.git
+Project-URL: Issues, https://github.com/topcheer/ggcode/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# ggcode Python wrapper
+
+`ggcode` on PyPI is a thin Python wrapper for the `ggcode` terminal agent.
+
+It does not ship the platform binary inside the wheel. Instead, the wrapper downloads the latest
+matching `ggcode` GitHub Release on first run, caches it locally, and then launches it.
+
+## Install
+
+```bash
+pip install ggcode
+```
+
+Then run:
+
+```bash
+ggcode
+```
+
+## What it does
+
+- Detects your operating system and CPU architecture
+- Downloads the latest matching `ggcode` archive from GitHub Releases
+- Verifies the archive against `checksums.txt`
+- Extracts and caches the binary for future runs
+
+## Pin a specific ggcode release
+
+By default, the wrapper always resolves the latest `ggcode` release.
+
+To force a specific release, set `GGCODE_INSTALL_VERSION`:
+
+```bash
+GGCODE_INSTALL_VERSION=vX.Y.Z ggcode
+```
+
+or:
+
+```bash
+GGCODE_INSTALL_VERSION=X.Y.Z ggcode
+```
+
+## Supported platforms
+
+- macOS
+- Linux
+- Windows
+
+Supported architectures:
+
+- x86_64 / amd64
+- arm64
+
+## Project links
+
+- Repository: https://github.com/topcheer/ggcode
+- Issues: https://github.com/topcheer/ggcode/issues

{ggcode-1.0.9 → ggcode-1.1.0}/ggcode.egg-info/SOURCES.txt

@@ -6,4 +6,5 @@ ggcode.egg-info/dependency_links.txt
 ggcode.egg-info/entry_points.txt
 ggcode.egg-info/top_level.txt
 ggcode_release_installer/__init__.py
-ggcode_release_installer/cli.py
+ggcode_release_installer/cli.py
+tests/test_cli.py

ggcode-1.1.0/ggcode_release_installer/__init__.py

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

{ggcode-1.0.9 → ggcode-1.1.0}/ggcode_release_installer/cli.py

@@ -9,19 +9,18 @@ import subprocess
 import sys
 import tarfile
 import tempfile
+import urllib.parse
 import urllib.request
 import zipfile
 from pathlib import Path
 
-from . import __version__
-
 OWNER = "topcheer"
 REPO = "ggcode"
 
 
 def normalize_version() -> str:
-    selected = os.environ.get("GGCODE_INSTALL_VERSION", __version__).strip()
-    if not selected or selected == "latest" or selected.startswith("0.0.0"):
+    selected = os.environ.get("GGCODE_INSTALL_VERSION", "").strip()
+    if not selected or selected == "latest":
         return "latest"
     if selected.startswith("v"):
         return selected
@@ -29,15 +28,15 @@ def normalize_version() -> str:
 
 
 def resolve_target() -> tuple[str, str]:
-    platform = sys.platform
-    if platform.startswith("linux"):
+    system = sys.platform
+    if system.startswith("linux"):
         goos = "linux"
-    elif platform == "darwin":
+    elif system == "darwin":
         goos = "darwin"
-    elif platform in ("win32", "cygwin"):
+    elif system in ("win32", "cygwin"):
         goos = "windows"
     else:
-        raise RuntimeError(f"Unsupported platform: {platform}")
+        raise RuntimeError(f"Unsupported platform: {system}")
 
     machine = platform.machine().lower() or os.environ.get("PROCESSOR_ARCHITECTURE", "").lower()
     if machine in ("x86_64", "amd64"):
@@ -67,6 +66,20 @@ def download(url: str) -> bytes:
         return response.read()
 
 
+def resolve_release_version(version: str) -> str:
+    if version != "latest":
+        return version
+
+    with urllib.request.urlopen(f"https://github.com/{OWNER}/{REPO}/releases/latest") as response:
+        final_url = response.geturl()
+
+    parsed = urllib.parse.urlparse(final_url)
+    parts = [part for part in parsed.path.split("/") if part]
+    if len(parts) < 4 or parts[-2] != "tag":
+        raise RuntimeError(f"Could not resolve latest ggcode release from {final_url}")
+    return urllib.parse.unquote(parts[-1])
+
+
 def parse_checksums(body: str) -> dict[str, str]:
     checksums: dict[str, str] = {}
     for raw_line in body.splitlines():
@@ -77,7 +90,7 @@ def parse_checksums(body: str) -> dict[str, str]:
 
 
 def ensure_installed() -> Path:
-    version = normalize_version()
+    version = resolve_release_version(normalize_version())
     goos, arch = resolve_target()
     archive_ext = ".zip" if goos == "windows" else ".tar.gz"
     archive_name = f"ggcode_{goos}_{arch}{archive_ext}"

{ggcode-1.0.9 → ggcode-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ggcode"
-version = "1.0.9"
+version = "1.1.0"
 description = "Thin Python wrapper that installs the ggcode GitHub Release binary"
 readme = "README.md"
 requires-python = ">=3.9"

ggcode-1.1.0/tests/test_cli.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import os
+import unittest
+from unittest.mock import patch
+
+from ggcode_release_installer import cli
+
+
+class ResolveTargetTests(unittest.TestCase):
+    def test_normalize_version_defaults_to_latest(self) -> None:
+        with patch.dict(os.environ, {}, clear=True):
+            self.assertEqual(cli.normalize_version(), "latest")
+
+    def test_normalize_version_uses_explicit_override(self) -> None:
+        with patch.dict(os.environ, {"GGCODE_INSTALL_VERSION": "1.2.3"}, clear=True):
+            self.assertEqual(cli.normalize_version(), "v1.2.3")
+
+    def test_resolve_target_uses_platform_module_for_machine(self) -> None:
+        with patch.object(cli.sys, "platform", "darwin"):
+            with patch.object(cli.platform, "machine", return_value="arm64"):
+                self.assertEqual(cli.resolve_target(), ("darwin", "arm64"))
+
+    def test_resolve_target_falls_back_to_processor_architecture(self) -> None:
+        env = dict(os.environ, PROCESSOR_ARCHITECTURE="AMD64")
+        with patch.dict(os.environ, env, clear=True):
+            with patch.object(cli.sys, "platform", "win32"):
+                with patch.object(cli.platform, "machine", return_value=""):
+                    self.assertEqual(cli.resolve_target(), ("windows", "x86_64"))
+
+    def test_resolve_release_version_follows_latest_redirect(self) -> None:
+        response = unittest.mock.Mock()
+        response.geturl.return_value = "https://github.com/topcheer/ggcode/releases/tag/v9.9.9"
+        response.__enter__ = unittest.mock.Mock(return_value=response)
+        response.__exit__ = unittest.mock.Mock(return_value=False)
+        with patch.object(cli.urllib.request, "urlopen", return_value=response):
+            self.assertEqual(cli.resolve_release_version("latest"), "v9.9.9")
+
+
+if __name__ == "__main__":
+    unittest.main()

ggcode-1.0.9/PKG-INFO

@@ -1,16 +0,0 @@
-Metadata-Version: 2.4
-Name: ggcode
-Version: 1.0.9
-Summary: Thin Python wrapper that installs the ggcode GitHub Release binary
-Author: topcheer
-License: MIT
-Project-URL: Homepage, https://github.com/topcheer/ggcode
-Project-URL: Repository, https://github.com/topcheer/ggcode.git
-Project-URL: Issues, https://github.com/topcheer/ggcode/issues
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-
-# ggcode Python wrapper
-
-This package installs a small Python launcher that downloads the matching `ggcode`
-binary from GitHub Releases on first run and then executes it.

ggcode-1.0.9/README.md

@@ -1,4 +0,0 @@
-# ggcode Python wrapper
-
-This package installs a small Python launcher that downloads the matching `ggcode`
-binary from GitHub Releases on first run and then executes it.

ggcode-1.0.9/ggcode.egg-info/PKG-INFO

@@ -1,16 +0,0 @@
-Metadata-Version: 2.4
-Name: ggcode
-Version: 1.0.9
-Summary: Thin Python wrapper that installs the ggcode GitHub Release binary
-Author: topcheer
-License: MIT
-Project-URL: Homepage, https://github.com/topcheer/ggcode
-Project-URL: Repository, https://github.com/topcheer/ggcode.git
-Project-URL: Issues, https://github.com/topcheer/ggcode/issues
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-
-# ggcode Python wrapper
-
-This package installs a small Python launcher that downloads the matching `ggcode`
-binary from GitHub Releases on first run and then executes it.

ggcode-1.0.9/ggcode_release_installer/__init__.py

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