Method needs_refresh

uncommon_route/benchmark.py:307–319

Return whether any configured source is missing or past its TTL.

(self, *, now: float | None = None)

        return total

    def needs_refresh(self, *, now: float | None = None) -> bool:
        """Return whether any configured source is missing or past its TTL."""
        now = time.time() if now is None else float(now)
        for provider in self._providers:
            source_data = self._sources.get(provider.source_name, {})
            if not source_data:
                if isinstance(provider, LocalFileProvider) and not provider._path.exists():
                    continue
                return True
            newest = max((e.fetched_at for e in source_data.values()), default=0.0)
            if now - newest >= provider.refresh_interval_s:
                return True
        return False

    def refresh_if_stale(self, *, background: bool = True, force: bool = False) -> bool:
        """Refresh stale benchmark data without blocking normal routing.