rate_limit_archlinux

arch_toolkit::client

Function rate_limit_archlinux 

Source 
pub async fn rate_limit_archlinux() -> OwnedSemaphorePermit
Expand description

What: Apply rate limiting specifically for archlinux.org requests with exponential backoff.

Inputs: None

Output: OwnedSemaphorePermit that the caller MUST hold during the request.

§Panics

  • Panics if the archlinux.org request semaphore is closed (should never happen in practice).

Details:

  • Acquires a semaphore permit to serialize archlinux.org requests (only 1 at a time).
  • Uses base delay (500ms) for archlinux.org to reduce request frequency.
  • Implements exponential backoff: increases delay on consecutive failures (500ms → 1s → 2s → 4s, max 60s).
  • Adds random jitter (0-500ms) to prevent thundering herd when multiple clients retry simultaneously.
  • Resets backoff after successful requests.
  • Thread-safe via mutex guarding the rate limiter state.
  • The returned permit MUST be held until the HTTP request completes to ensure serialization.