atdd 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

atdd/__main__.py

@@ -1,4 +1,4 @@
-from .cli import main
+from .cli import cli
 
 if __name__ == "__main__":
-    main()
+    raise SystemExit(cli())

atdd/cli.py

@@ -41,6 +41,7 @@ from atdd.coach.commands.registry import RegistryUpdater
 from atdd.coach.commands.initializer import ProjectInitializer
 from atdd.coach.commands.session import SessionManager
 from atdd.coach.commands.sync import AgentConfigSync
+from atdd.version_check import print_update_notice
 
 
 class ATDDCoach:
@@ -400,5 +401,14 @@ Phase descriptions:
         return 0
 
 
+def cli() -> int:
+    """CLI entry point with version check."""
+    try:
+        result = main()
+    finally:
+        print_update_notice()
+    return result
+
+
 if __name__ == "__main__":
-    sys.exit(main())
+    sys.exit(cli())

atdd/version_check.py

@@ -0,0 +1,126 @@
+"""
+Version check for ATDD CLI.
+
+Checks PyPI for newer versions and notifies users. Uses a cached check
+to avoid adding latency to every command.
+
+Cache location: ~/.atdd/version_cache.json
+Disable: Set ATDD_NO_UPDATE_CHECK=1 environment variable
+"""
+import json
+import os
+import sys
+import time
+from pathlib import Path
+from typing import Optional, Tuple
+from urllib.request import urlopen
+from urllib.error import URLError
+
+from atdd import __version__
+
+# Check once per day (86400 seconds)
+CHECK_INTERVAL = 86400
+CACHE_DIR = Path.home() / ".atdd"
+CACHE_FILE = CACHE_DIR / "version_cache.json"
+PYPI_URL = "https://pypi.org/pypi/atdd/json"
+
+
+def _parse_version(version: str) -> Tuple[int, ...]:
+    """Parse version string into tuple for comparison."""
+    try:
+        return tuple(int(x) for x in version.split(".")[:3])
+    except (ValueError, AttributeError):
+        return (0, 0, 0)
+
+
+def _is_newer(latest: str, current: str) -> bool:
+    """Check if latest version is newer than current."""
+    return _parse_version(latest) > _parse_version(current)
+
+
+def _load_cache() -> dict:
+    """Load version cache from disk."""
+    try:
+        if CACHE_FILE.exists():
+            with open(CACHE_FILE) as f:
+                return json.load(f)
+    except (json.JSONDecodeError, OSError):
+        pass
+    return {}
+
+
+def _save_cache(data: dict) -> None:
+    """Save version cache to disk."""
+    try:
+        CACHE_DIR.mkdir(parents=True, exist_ok=True)
+        with open(CACHE_FILE, "w") as f:
+            json.dump(data, f)
+    except OSError:
+        pass  # Silently fail if we can't write cache
+
+
+def _fetch_latest_version() -> Optional[str]:
+    """Fetch latest version from PyPI."""
+    try:
+        with urlopen(PYPI_URL, timeout=2) as response:
+            data = json.loads(response.read().decode())
+            return data.get("info", {}).get("version")
+    except (URLError, json.JSONDecodeError, OSError, TimeoutError):
+        return None
+
+
+def check_for_updates() -> Optional[str]:
+    """
+    Check for updates if cache is stale.
+
+    Returns:
+        Message to display if update available, None otherwise.
+    """
+    # Respect disable flag
+    if os.environ.get("ATDD_NO_UPDATE_CHECK", "").lower() in ("1", "true", "yes"):
+        return None
+
+    # Skip if running in development (version 0.0.0)
+    if __version__ == "0.0.0":
+        return None
+
+    cache = _load_cache()
+    now = time.time()
+    last_check = cache.get("last_check", 0)
+    cached_latest = cache.get("latest_version")
+
+    # Check if cache is fresh
+    if now - last_check < CHECK_INTERVAL and cached_latest:
+        latest = cached_latest
+    else:
+        # Fetch from PyPI
+        latest = _fetch_latest_version()
+        if latest:
+            _save_cache({
+                "last_check": now,
+                "latest_version": latest,
+            })
+        elif cached_latest:
+            # Use cached version if fetch failed
+            latest = cached_latest
+        else:
+            return None
+
+    # Compare versions
+    if latest and _is_newer(latest, __version__):
+        return (
+            f"\nA new version of atdd is available: {__version__} → {latest}\n"
+            f"Run `pip install --upgrade atdd` to update."
+        )
+
+    return None
+
+
+def print_update_notice() -> None:
+    """Print update notice to stderr if available."""
+    try:
+        notice = check_for_updates()
+        if notice:
+            print(notice, file=sys.stderr)
+    except Exception:
+        pass  # Never fail the main command due to version check

{atdd-0.2.1.dist-info → atdd-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.2.1
+Version: 0.2.3
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10

{atdd-0.2.1.dist-info → atdd-0.2.3.dist-info}/RECORD

@@ -1,7 +1,8 @@
 atdd/__init__.py,sha256=-S8i9OahH-t9FJkPn6nprxipnjVum3rLeVsCS74T6eY,156
-atdd/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
-atdd/cli.py,sha256=POp59pszeoxh5KKJKWxkr0mrWv7-xlg1AWXhONEnipU,13149
+atdd/__main__.py,sha256=B0sXDQLjFN9GowTlXo4NMWwPZPjDsrT8Frq7DnbdOD8,77
+atdd/cli.py,sha256=GHMIPRR1tDVN72Tt3vmQ1dJrow-FeOw429mOHZLrS-c,13359
 atdd/conftest.py,sha256=Fj3kIhCETbj2QBCIjySBgdS3stKNRZcZzKTJr7A4LaQ,5300
+atdd/version_check.py,sha256=B9MbbxO_sJrEC3fxFJhTlOIkLLTRQCDO1_8ec1KvuWY,3540
 atdd/coach/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/commands/add_persistence_metadata.py,sha256=xAdeO9k53CIGTBhzNQbWenuzeoWKZimDBR9xBWaA3NU,6887
@@ -176,9 +177,9 @@ atdd/tester/validators/test_red_supabase_layer_structure.py,sha256=26cnzPZAwSFy0
 atdd/tester/validators/test_telemetry_structure.py,sha256=hIUnU2WU-8PNIg9EVHe2fnUdIQKIOUm5AWEtCBUXLVk,22467
 atdd/tester/validators/test_typescript_test_naming.py,sha256=E-TyGv_GVlTfsbyuxrtv9sOWSZS_QcpH6rrJFbWoeeU,11280
 atdd/tester/validators/test_typescript_test_structure.py,sha256=eV89SD1RaKtchBZupqhnJmaruoROosf3LwB4Fwe4UJI,2612
-atdd-0.2.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.2.1.dist-info/METADATA,sha256=ePniZ2i1mFTZaHz4dQrXpsxYxq0o0QWUD3K2HA5qS-o,5215
-atdd-0.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.2.1.dist-info/entry_points.txt,sha256=z0s90AA3SVM-A2hXQiOw-V3B_ygwqdgeib4-NbKTMyQ,39
-atdd-0.2.1.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.2.1.dist-info/RECORD,,
+atdd-0.2.3.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.2.3.dist-info/METADATA,sha256=7KkLUARDmdmL1PZ-9rw4JbTf7umDEsq4chYxHkJrujg,5215
+atdd-0.2.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.2.3.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.2.3.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.2.3.dist-info/RECORD,,

atdd-0.2.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+atdd = atdd.cli:cli

atdd-0.2.1.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-atdd = atdd.cli:main