fix: address final review findings for service clients plan

Fixes 9 numbered findings + 7 minor fixes from the whole-plan review of
the MyWhoosh/Garmin service clients (Plan 3):

Garmin uploader (app/garmin/uploader.py):
- Detect Garmin-rejected imports (failures without successes) and raise
  new GarminImportRejected instead of reporting them as successful.
- Reclassify 429/rate-limit/500 login failures as transient instead of
  falling through to permanent auth errors; unrecognized login failures
  are now treated as transient (retryable) rather than GarminAuthError.
- Mirror the auth-token check from the login branch into the import
  branch so 401-at-import-time raises GarminAuthError instead of
  propagating raw.
- Add common GarminError base class, hoist transient-token tuple to a
  shared module constant, check response.status_code==409 before the
  duplicate substring fallback, and create the tokenstore dir 0o700.

MyWhoosh client (app/mywhoosh/client.py):
- Add optional max_pages bound to list_activities pagination.
- Add aclose()/__aenter__/__aexit__ so the client's own httpx.AsyncClient
  gets closed, while never closing an injected client.
- Guard the two remaining unguarded JSON-decode paths (login body,
  download-fit metadata) so malformed bodies raise
  MyWhooshIntegrationError instead of raw ValueError/AttributeError.
- Row-level malformation (missing id/activityFileId, unparseable
  startDatetime) is now skipped rather than aborting the whole page;
  envelope-shape failures still raise. id/activityFileId checks use
  explicit None/"" comparisons instead of Python falsiness.
- Replace asserts in _authenticated_post with explicit exceptions;
  restrict the reauth retry to 401 only, treat 403 as immediately
  terminal; naive startDatetime values are now treated as already-UTC
  instead of host-local.

MyWhoosh tokenstore (app/mywhoosh/tokenstore.py):
- load() now treats any corrupt/malformed token file (bad JSON, missing
  keys, OS errors) as "absent" instead of raising, so a bad cache no
  longer permanently wedges a user.

pyproject.toml:
- Tighten garminconnect pin to >=0.3.10,<1 (import_activity requires
  0.3.10+).

Adds/updates tests across tests/mywhoosh/ and tests/garmin/ covering
all of the above, including a fake client that wraps GarminUploadBlocked
in a plain RuntimeError to mirror the real garminconnect library's MFA
error wrapping.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Bastian Wagner
2026-08-15 15:23:14 +02:00
parent b48008c16e
commit 2f65c0178c
8 changed files with 426 additions and 33 deletions

View File

@@ -18,18 +18,40 @@ class UploadResult:
raw_response: Any
class GarminUploadBlocked(RuntimeError):
class GarminError(RuntimeError):
pass
class GarminAuthError(RuntimeError):
class GarminUploadBlocked(GarminError):
pass
class GarminTransientError(RuntimeError):
class GarminAuthError(GarminError):
pass
class GarminTransientError(GarminError):
pass
class GarminImportRejected(GarminError):
pass
_TRANSIENT_ERROR_TOKENS = (
"timeout",
"temporar",
"connection",
"429",
"too many",
"rate limit",
"500",
"502",
"503",
"504",
)
class GarminUploader:
def __init__(
self,
@@ -56,9 +78,12 @@ class GarminUploader:
if _looks_duplicate_error(exc):
return UploadResult("duplicate", True, None, str(exc))
text = str(exc).lower()
if any(token in text for token in ("timeout", "temporar", "connection", "502", "503", "504")):
if any(token in text for token in _TRANSIENT_ERROR_TOKENS):
raise GarminTransientError("Garmin import failed transiently") from exc
if any(token in text for token in ("password", "credential", "unauthorized", "401")):
raise GarminAuthError("Garmin import failed: authentication rejected") from exc
raise
_raise_if_import_rejected(response)
return UploadResult("imported", False, _extract_activity_id(response), response)
finally:
self._mfa_code = None
@@ -66,7 +91,7 @@ class GarminUploader:
def _ensure_client(self) -> GarminClientProtocol:
if self._client is not None:
return self._client
self.tokenstore.mkdir(parents=True, exist_ok=True)
self.tokenstore.mkdir(parents=True, exist_ok=True, mode=0o700)
factory = self.client_factory or _default_garmin_factory
client = factory(self.email, self.password, prompt_mfa=self._prompt_mfa)
try:
@@ -79,9 +104,9 @@ class GarminUploader:
raise GarminUploadBlocked("Garmin MFA is required") from exc
if any(token in text for token in ("password", "credential", "unauthorized", "401")):
raise GarminAuthError("Garmin authentication failed") from exc
if any(token in text for token in ("timeout", "temporar", "connection", "502", "503", "504")):
if any(token in text for token in _TRANSIENT_ERROR_TOKENS):
raise GarminTransientError("Garmin login failed transiently") from exc
raise GarminAuthError("Garmin login failed") from exc
raise GarminTransientError("Garmin login failed") from exc
self._client = client
return client
@@ -98,10 +123,25 @@ def _default_garmin_factory(*args: Any, **kwargs: Any) -> GarminClientProtocol:
def _looks_duplicate_error(exc: Exception) -> bool:
status_code = getattr(getattr(exc, "response", None), "status_code", None)
if status_code == 409:
return True
text = str(exc).lower()
return any(token in text for token in ("duplicate", "already exists", "409"))
def _raise_if_import_rejected(response: Any) -> None:
if not isinstance(response, dict):
return
detailed = response.get("detailedImportResult")
if not isinstance(detailed, dict):
return
failures = detailed.get("failures")
successes = detailed.get("successes")
if isinstance(failures, list) and failures and not successes:
raise GarminImportRejected(f"Garmin rejected the import ({len(failures)} failure(s))")
def _extract_activity_id(response: Any) -> str | None:
if not isinstance(response, dict):
return None