_sleep_for_retry() — anthropic-sdk-python Function Reference

Architecture documentation for the _sleep_for_retry() function in _base_client.py from the anthropic-sdk-python codebase.

Function python AnthropicClient SyncAPI calls 2 called by 2

Entity Profile

AnthropicClient→ SyncAPI→ _sleep_for_retry() — anthropic-sdk-python Function Reference

Dependency Diagram

graph TD
  e28246be_5825_36c7_9258_c1395a05766e["_sleep_for_retry()"]
  4b46ed95_ff71_ea5d_7534_6929dc929bdb["SyncAPIClient"]
  e28246be_5825_36c7_9258_c1395a05766e -->|defined in| 4b46ed95_ff71_ea5d_7534_6929dc929bdb
  2cb1e2bf_1a02_d5ea_42a9_c0def162363a["request()"]
  2cb1e2bf_1a02_d5ea_42a9_c0def162363a -->|calls| e28246be_5825_36c7_9258_c1395a05766e
  45cb7b8c_88f3_ad66_a029_ae39dee52385["_sleep_for_retry()"]
  45cb7b8c_88f3_ad66_a029_ae39dee52385 -->|calls| e28246be_5825_36c7_9258_c1395a05766e
  f6d7d851_1218_0312_84fe_55254f0ab693["_calculate_retry_timeout()"]
  e28246be_5825_36c7_9258_c1395a05766e -->|calls| f6d7d851_1218_0312_84fe_55254f0ab693
  45cb7b8c_88f3_ad66_a029_ae39dee52385["_sleep_for_retry()"]
  e28246be_5825_36c7_9258_c1395a05766e -->|calls| 45cb7b8c_88f3_ad66_a029_ae39dee52385
  style e28246be_5825_36c7_9258_c1395a05766e fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/anthropic/_base_client.py lines 1151–1163

    def _sleep_for_retry(
        self, *, retries_taken: int, max_retries: int, options: FinalRequestOptions, response: httpx.Response | None
    ) -> None:
        remaining_retries = max_retries - retries_taken
        if remaining_retries == 1:
            log.debug("1 retry left")
        else:
            log.debug("%i retries left", remaining_retries)

        timeout = self._calculate_retry_timeout(remaining_retries, options, response.headers if response else None)
        log.info("Retrying request to %s in %f seconds", options.url, timeout)

        time.sleep(timeout)