plugin-kit-ai 2.0.0__tar.gz → 2.0.2__tar.gz

{plugin_kit_ai-2.0.0/src/plugin_kit_ai.egg-info → plugin_kit_ai-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plugin-kit-ai
-Version: 2.0.0
+Version: 2.0.2
 Summary: Thin Python launcher for the plugin-kit-ai CLI
 Author: plugin-kit-ai
 License: Apache-2.0

{plugin_kit_ai-2.0.0 → plugin_kit_ai-2.0.2}/src/plugin_kit_ai/__init__.py

@@ -1,3 +1,3 @@
 """plugin-kit-ai Python wrapper package."""
 
-__version__ = "2.0.0"
+__version__ = "2.0.2"

{plugin_kit_ai-2.0.0 → plugin_kit_ai-2.0.2}/src/plugin_kit_ai/install.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import hashlib
 import json
 import os
+import re
 import shutil
 import stat
 import subprocess
@@ -25,10 +26,27 @@ PLACEHOLDER_VERSION = "0.0.0.dev0"
 
 
 def normalize_tag(raw: str) -> str:
-    value = str(raw or "").strip()
+    value = str(raw or "")
     if not value or value == "latest":
         return ""
-    return value if value.startswith("v") else f"v{value}"
+    match = re.fullmatch(r"(plugin-kit-ai-v|v)?((0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*))", value)
+    if not match:
+        raise ValueError(f"invalid plugin-kit-ai release tag: {value}")
+    prefix, version, major = match.group(1), match.group(2), int(match.group(3))
+    if major >= 2:
+        if prefix == "v":
+            raise ValueError("plugin-kit-ai v2+ requires a product-prefixed release tag")
+        return f"plugin-kit-ai-v{version}"
+    return f"{prefix or 'v'}{version}"
+
+
+def version_from_tag(tag: str) -> str:
+    normalized = normalize_tag(tag)
+    if not normalized:
+        raise ValueError("an exact plugin-kit-ai release tag is required")
+    if normalized.startswith("plugin-kit-ai-v"):
+        return normalized[len("plugin-kit-ai-v") :]
+    return normalized[1:]
 
 
 def derive_release_base(api_base: str, override: str) -> str:
@@ -79,7 +97,7 @@ def fetch_text(url: str, accept_json: bool = False) -> str:
 def latest_tag(api_base: str, repository: str) -> str:
     clean_base = str(api_base or DEFAULT_API_BASE).strip().rstrip("/")
     payload = json.loads(fetch_text(f"{clean_base}/repos/{repository}/releases/latest", accept_json=True))
-    tag_name = str(payload.get("tag_name", "")).strip()
+    tag_name = str(payload.get("tag_name", ""))
     if not tag_name:
         raise RuntimeError(f"could not resolve latest release tag from {clean_base}")
     return normalize_tag(tag_name)
@@ -142,7 +160,7 @@ def ensure_installed(*, quiet: bool = False) -> Dict[str, str]:
     tag = resolve_requested_tag()
     if not tag:
         tag = latest_tag(api_base, repository)
-    version = tag[1:]
+    version = version_from_tag(tag)
     asset_name = asset_name_for_version(version, platform_info)
 
     cache_root = default_cache_root()

{plugin_kit_ai-2.0.0 → plugin_kit_ai-2.0.2/src/plugin_kit_ai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plugin-kit-ai
-Version: 2.0.0
+Version: 2.0.2
 Summary: Thin Python launcher for the plugin-kit-ai CLI
 Author: plugin-kit-ai
 License: Apache-2.0

{plugin_kit_ai-2.0.0 → plugin_kit_ai-2.0.2}/src/plugin_kit_ai.egg-info/SOURCES.txt

@@ -9,4 +9,5 @@ src/plugin_kit_ai.egg-info/PKG-INFO
 src/plugin_kit_ai.egg-info/SOURCES.txt
 src/plugin_kit_ai.egg-info/dependency_links.txt
 src/plugin_kit_ai.egg-info/entry_points.txt
-src/plugin_kit_ai.egg-info/top_level.txt
+src/plugin_kit_ai.egg-info/top_level.txt
+tests/test_install.py

plugin_kit_ai-2.0.2/tests/test_install.py

@@ -0,0 +1,79 @@
+"""Cold-cache wrapper regressions, without network or user cache access."""
+import hashlib
+import io
+import os
+from pathlib import Path
+import tarfile
+import tempfile
+import unittest
+from unittest.mock import patch
+
+from plugin_kit_ai import install
+
+
+class ReleaseTags(unittest.TestCase):
+    def test_numeric_and_product_tags(self):
+        for raw, tag, version in [
+            ('2.0.2', 'plugin-kit-ai-v2.0.2', '2.0.2'),
+            ('plugin-kit-ai-v2.0.2', 'plugin-kit-ai-v2.0.2', '2.0.2'),
+            ('1.2.4', 'v1.2.4', '1.2.4'),
+            ('v1.2.4', 'v1.2.4', '1.2.4'),
+            ('plugin-kit-ai-v1.2.4', 'plugin-kit-ai-v1.2.4', '1.2.4'),
+        ]:
+            with self.subTest(raw=raw):
+                self.assertEqual(install.normalize_tag(raw), tag)
+                self.assertEqual(install.version_from_tag(tag), version)
+
+    def test_reject_wrong_product_and_malformed_tags(self):
+        for tag in ['agentplugins-v0.1.62', 'v2.0.2', '2.00.2', '2.0',
+                    'plugin-kit-ai-plugin-kit-ai-v2.0.2', '2.0.2-rc.1',
+                    '2.0.2+build', '../2.0.2', 'vlatest', '2.0.2\n',
+                    ' plugin-kit-ai-v2.0.2']:
+            with self.subTest(tag=tag), self.assertRaises(ValueError):
+                install.normalize_tag(tag)
+
+    def test_packaged_version_and_latest_product_validation(self):
+        with patch.dict(os.environ, {}, clear=True), patch.object(install, '__version__', '2.0.2'):
+            self.assertEqual(install.resolve_requested_tag(), 'plugin-kit-ai-v2.0.2')
+        with patch.object(install, 'fetch_text', return_value='{"tag_name":"agentplugins-v0.1.62"}'):
+            with self.assertRaises(ValueError):
+                install.latest_tag(install.DEFAULT_API_BASE, install.DEFAULT_REPOSITORY)
+
+    def test_cold_cache_and_checksum(self):
+        platform = install.detect_platform()
+        stream = io.BytesIO()
+        binary = b'fixture executable bytes'
+        with tarfile.open(fileobj=stream, mode='w:gz') as archive:
+            member = tarfile.TarInfo(platform.binary_name)
+            member.size = len(binary)
+            archive.addfile(member, io.BytesIO(binary))
+        body = stream.getvalue()
+        for raw in ['2.0.2', 'plugin-kit-ai-v2.0.2', '1.2.4', 'v1.2.4']:
+            for bad_checksum in [False, True]:
+                with self.subTest(raw=raw, bad_checksum=bad_checksum), tempfile.TemporaryDirectory() as root:
+                    tag = install.normalize_tag(raw)
+                    version = install.version_from_tag(tag)
+                    asset = install.asset_name_for_version(version, platform)
+                    base = f'https://github.com/{install.DEFAULT_REPOSITORY}/releases/download/{tag}'
+                    checksum = '0' * 64 if bad_checksum else hashlib.sha256(body).hexdigest()
+                    def fetch(url, accept_json=False):
+                        self.assertIn(url, [f'{base}/checksums.txt', f'{base}/{asset}'])
+                        return f'{checksum}  {asset}\n'.encode() if url.endswith('/checksums.txt') else body
+                    with patch.dict(os.environ, {'PLUGIN_KIT_AI_VERSION': raw,
+                                                 'PLUGIN_KIT_AI_CACHE_DIR': root}, clear=True), \
+                            patch.object(install, 'fetch_bytes', side_effect=fetch) as downloaded:
+                        if bad_checksum:
+                            with self.assertRaisesRegex(RuntimeError, 'checksum mismatch'):
+                                install.ensure_installed(quiet=True)
+                            self.assertFalse((Path(root) / tag / platform.binary_name).exists())
+                        else:
+                            result = install.ensure_installed(quiet=True)
+                            self.assertEqual(result['version'], version)
+                            self.assertEqual(Path(result['installed_binary']).read_bytes(), binary)
+                            self.assertEqual(downloaded.call_count, 2)
+                            install.ensure_installed(quiet=True)
+                            self.assertEqual(downloaded.call_count, 2)
+
+
+if __name__ == '__main__':
+    unittest.main()