feat(core): PyPI latest-version check (#31)

packages/create-python-app-core/pyproject.toml

@@ -5,6 +5,7 @@ description = "Scaffolding engine for Create Awesome Python App (stub)"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
+ "httpx>=0.28.1",
  "packaging>=24.0",
 ]
 

packages/create-python-app-core/src/create_python_app_core/api.py

@@ -35,8 +35,20 @@ def check_python_version(required: str, package_name: str) -> None:
 
 async def check_for_latest_version(package_name: str) -> str | None:
  """Fetch latest version from PyPI. Returns None on failure."""
- _ = package_name
- return None
+ import httpx
+
+ url = f"https://pypi.org/pypi/{package_name}/json"
+ try:
+ async with httpx.AsyncClient(
+ headers={"User-Agent": CPA_USER_AGENT},
+ timeout=10.0,
+ ) as client:
+ response = await client.get(url)
+ response.raise_for_status()
+ data = response.json()
+ return str(data["info"]["version"])
+ except Exception:
+ return None
 
 
 def print_env_info() -> None:

packages/create-python-app-core/tests/test_pypi_version.py

@@ -0,0 +1,25 @@
+import pytest
+from create_python_app_core.api import check_for_latest_version
+
+
+@pytest.mark.asyncio
+async def test_check_for_latest_version_handles_failure(
+ monkeypatch: pytest.MonkeyPatch,
+) -> None:
+ import httpx
+
+ class FakeClient:
+ def __init__(self, *args, **kwargs):
+ pass
+
+ async def __aenter__(self):
+ return self
+
+ async def __aexit__(self, *args):
+ return None
+
+ async def get(self, url: str):
+ raise httpx.ConnectError("offline")
+
+ monkeypatch.setattr("httpx.AsyncClient", FakeClient)
+ assert await check_for_latest_version("create-awesome-python-app") is None

pyproject.toml

@@ -19,6 +19,7 @@ dev = [
  "pyright>=1.1.400",
  "pre-commit>=4.0.0",
  "pytest-cov>=6.0.0",
+ "pytest-asyncio>=0.25.0",
  "pytest>=8.0.0",
 ]
 
@@ -44,6 +45,7 @@ venv = ".venv"
 
 
 [tool.pytest.ini_options]
+asyncio_mode = "auto"
 testpaths = ["packages"]
 pythonpath = ["packages/create-python-app-core/src", "packages/create-awesome-python-app/src"]