scrapely-python 0.1.11__py3-none-any.whl → 0.1.13__py3-none-any.whl

scrapely/__init__.py

@@ -132,7 +132,7 @@ from .errors import (
     raise_for_status,
 )
 
-__version__ = '0.1.11'
+__version__ = '0.1.13'
 __all__ = [
     # Core
     'Actor',

scrapely/actor.py

@@ -491,7 +491,7 @@ class Actor(metaclass=_ActorMeta):
                     if flush is not None:
                         deadline_ms = min(max(1, timeout_secs) * 1000, 30_000)
                         # The flush's own deadline ends its retries (charge POSTs back off
-                        # for up to ~45 s) a little before wait_for would cancel it.
+                        # for up to ~2 min) a little before wait_for would cancel it.
                         await asyncio.wait_for(
                             flush(max_intents=64, deadline_ms=max(500, deadline_ms - 2_000)),
                             timeout=max(1.0, deadline_ms / 1000.0),
@@ -652,12 +652,12 @@ class Actor(metaclass=_ActorMeta):
 
     @classmethod
     def is_at_home(cls) -> bool:
-        return cls._config.get('is_at_home', False) if cls._config else False
+        return bool(cls._env_config().get('is_at_home', False))
 
     @classmethod
     def is_standby(cls) -> bool:
         """Return True when the actor run was started in standby mode (Node SDK ``isStandby`` parity)."""
-        return (cls._config.get('meta_origin') == 'STANDBY') if cls._config else False
+        return cls._env_config().get('meta_origin') == 'STANDBY'
 
     @_ClassProperty
     def is_paying(cls) -> bool:
@@ -721,7 +721,7 @@ class Actor(metaclass=_ActorMeta):
             return cast(Dict[str, Any], cls._cached_input)
 
         kvs = await cls.open_key_value_store()
-        input_key = cls._config.get('input_key', 'INPUT') if cls._config else 'INPUT'
+        input_key = cls._env_config().get('input_key', 'INPUT')
         result = await kvs.get_value(input_key)
         if isinstance(result, dict):
             result = decrypt_secret_inputs(result)
@@ -848,7 +848,7 @@ class Actor(metaclass=_ActorMeta):
                 name = name_or_id
 
         if alias is not None:
-            storages_json = cls._config.get('actor_storages_json') if cls._config else None
+            storages_json = cls._env_config().get('actor_storages_json')
             resolved = resolve_alias_from_storages_json(alias, storage_type, storages_json)
             if resolved is not None:
                 id = resolved
@@ -1067,12 +1067,15 @@ class Actor(metaclass=_ActorMeta):
             return None
 
         client = cls.new_client(token=token, base_url=api_url)
+        # Setting the message is idempotent: a 429 (run API rate limit), 5xx or
+        # dropped connection is retried with backoff instead of failing the run.
         response = await client.put(
             f'/v2/actor-runs/{run_id}',
             json_data={
                 'statusMessage': message,
                 'isStatusMessageTerminal': is_terminal,
             },
+            idempotent=True,
         )
         body: Any = {}
         if response.content:
@@ -1126,6 +1129,12 @@ class Actor(metaclass=_ActorMeta):
             cls._config = Configuration.get_global_config()
         return cls._config
 
+    @classmethod
+    def _env_config(cls) -> Configuration:
+        # Apify parity: is_at_home() and friends read the environment even
+        # before init(). Doesn't set cls._config, so init() state is unchanged.
+        return cls._config if cls._config is not None else Configuration.get_global_config()
+
     @classmethod
     def new_client(cls, token: Optional[str] = None, base_url: Optional[str] = None) -> ApiClient:
         config = cls.get_config()

scrapely/charging.py

@@ -49,16 +49,26 @@ CHARGE_IDEMPOTENCY_SAFE_AGE_SECS = 30 * 24 * 60 * 60
 # Soft cap on open unresolved intents. Refuse NEW billable charges when full.
 _PENDING_MAX_ENTRIES = 1024
 
-# Same-key POST attempts before leaving an intent pending / raising. The API
-# client itself retries 5xx answers and refused or reset connections of these
-# POSTs with its long backoff (0.5 s doubling to 8 s, about 45 s): re-sending
+# Same-key POST attempts before leaving an intent pending / re-queueing a void.
+# The API client itself retries 429 and 5xx answers and refused or reset
+# connections of these POSTs with exponential backoff (honouring Retry-After)
+# for its retry window (2 minutes, SCRAPELY_API_RETRY_WINDOW_SECS): re-sending
 # is safe because every attempt carries the same Idempotency-Key. These outer
 # attempts cover what the client gives up on quickly (timeouts, other
-# transport errors), with the same backoff, within _RETRY_BUDGET_SECS.
+# transport errors), within _RETRY_BUDGET_SECS. Then the charge stays pending
+# (the void is re-queued) and is retried before the next push and at exit,
+# the same as the JS SDK.
 _POST_ATTEMPTS = 8
 
-# Outer retries stop once this much time has passed since the first attempt.
-_RETRY_BUDGET_SECS = 60.0
+# Outer retries stop once this much time has passed since the first attempt
+# (the API retry window; JS SDK parity).
+_RETRY_BUDGET_SECS = 120.0
+
+
+def _is_transient_status(status: Optional[int]) -> bool:
+    """408/429 and 5xx: the platform could not take the request now; try again later."""
+    return status is not None and (status in (408, 429) or status >= 500)
+
 
 # Local-only dataset collecting one entry per logical charge operation
 # (JS ChargingManager LOCAL_CHARGING_LOG_DATASET_NAME parity).
@@ -563,7 +573,12 @@ class ChargingManager:
         return await self._void_charge(event_name, operation_id, reserved, not_found_means_voided=True)
 
     async def _void_charge(
-        self, event_name: str, operation_id: str, reserved: int, not_found_means_voided: bool = False
+        self,
+        event_name: str,
+        operation_id: str,
+        reserved: int,
+        not_found_means_voided: bool = False,
+        deadline: Optional[float] = None,
     ) -> bool:
         """Reverse an accepted charge whose items were never stored, then unwind locally.
 
@@ -573,6 +588,8 @@ class ChargingManager:
         if self._client is None or not self._is_at_home or not self._actor_run_id:
             return False
         started = time.monotonic()
+        budget_end = started + self._RETRY_BUDGET_SECS
+        deadline = budget_end if deadline is None else min(deadline, budget_end)
         for attempt in range(self._POST_ATTEMPTS):
             try:
                 await self._client.post(
@@ -580,6 +597,7 @@ class ChargingManager:
                     json_data={},
                     headers={'Idempotency-Key': operation_id},
                     idempotent=True,
+                    retry_deadline=deadline,
                 )
                 self._unwind_reservation(event_name, reserved)
                 return True
@@ -592,24 +610,37 @@ class ChargingManager:
                     self._unwind_reservation(event_name, reserved)
                     return True
                 # 404: nothing to void; 409: already settled; 4xx auth: permanent.
-                if status is not None and 400 <= status < 500:
+                # 408/429 (rate limited) and 5xx are not answers: re-queue below.
+                if status is not None and 400 <= status < 500 and not _is_transient_status(status):
                     return False
-                if not await self._backoff_before_retry(attempt, started, err):
+                if not await self._backoff_before_retry(attempt, started, err, deadline):
                     break
         # Outcome unknown: keep the reservation and retry before the next push / at exit.
         self._pending_voids.append((event_name, operation_id, reserved, not_found_means_voided))
         logger.error('Void of charge %s (%r) not confirmed yet; will retry', operation_id, event_name)
         return False
 
-    async def _retry_pending_voids(self) -> bool:
+    async def _retry_pending_voids(self, deadline: Optional[float] = None) -> bool:
         """Retry unconfirmed voids (caller holds the operation lock).
 
-        Returns False while any earlier void is still unconfirmed.
+        With ``deadline`` (``time.monotonic()``, the exit flush) keeps retrying
+        with backoff while time is left. Returns False while any earlier void
+        is still unconfirmed.
         """
-        pending, self._pending_voids = self._pending_voids, []
-        for event_name, operation_id, reserved, not_found_means_voided in pending:
-            await self._void_charge(event_name, operation_id, reserved, not_found_means_voided)
-        return not self._pending_voids
+        from .storage.api_client import server_retry_delay
+
+        round_ = 0
+        while True:
+            pending, self._pending_voids = self._pending_voids, []
+            for event_name, operation_id, reserved, not_found_means_voided in pending:
+                await self._void_charge(event_name, operation_id, reserved, not_found_means_voided, deadline)
+            if not self._pending_voids:
+                return True
+            left = 0.0 if deadline is None else deadline - time.monotonic()
+            if left <= 0:
+                return False
+            await asyncio.sleep(min(server_retry_delay(round_, None), left))
+            round_ += 1
 
     def _quarantine_stale_pending(self) -> None:
         """Remove intents older than the safe replay window (fail closed, no replay).
@@ -656,7 +687,7 @@ class ChargingManager:
             },
             headers={'Idempotency-Key': idempotency_key},
             idempotent=True,
-            **({'retry_deadline': deadline} if deadline is not None else {}),
+            retry_deadline=deadline,
         )
         if isinstance(response, dict):
             return response
@@ -674,17 +705,17 @@ class ChargingManager:
     ) -> bool:
         """Sleep before the next same-key attempt; False when no attempt is left.
 
-        A 5xx answer reaching this point was already retried by the API client
-        with its long backoff, so it ends the attempts. Timeouts and other
-        errors without an answer back off the same way (0.5 s doubling to 8 s)
-        while attempts and the retry budget last.
+        A 429/5xx answer reaching this point was already retried by the API
+        client for the whole budget, so it ends the attempts. Timeouts, 408 and
+        other errors back off the same way while attempts and the retry budget
+        last.
         """
         from .storage.api_client import server_retry_delay
 
         if attempt + 1 >= self._POST_ATTEMPTS:
             return False
         status = _http_status_of(err)
-        if status is not None and status >= 500:
+        if status is not None and (status == 429 or status >= 500):
             return False
         delay = server_retry_delay(attempt, None)
         if time.monotonic() - started + delay > self._RETRY_BUDGET_SECS:
@@ -714,6 +745,9 @@ class ChargingManager:
         """
         last_error: Optional[BaseException] = None
         started = time.monotonic()
+        # The client's own retries count against the same budget.
+        budget_end = started + self._RETRY_BUDGET_SECS
+        deadline = budget_end if deadline is None else min(deadline, budget_end)
         for attempt in range(self._POST_ATTEMPTS):
             try:
                 body = await self._post_charge_once(
@@ -762,11 +796,10 @@ class ChargingManager:
         """Caller must hold _operation_lock."""
         if not self._is_at_home or self._client is None or not self._actor_run_id:
             return 0
-        await self._retry_pending_voids()
-
-        import time
-
         deadline = None if deadline_ms is None else (time.monotonic() + max(0.0, deadline_ms) / 1000.0)
+        # Voids first: an unconfirmed one means the user may be billed for items
+        # that were never stored. At exit (with a deadline) keep retrying them.
+        await self._retry_pending_voids(deadline)
         confirmed_total = 0
         async with self._flush_lock:
             while True:

scrapely/configuration.py

@@ -266,6 +266,22 @@ class Configuration:
         value = self.get('standby_port')
         return value if isinstance(value, int) else 4321
 
+    @property
+    def web_server_port(self) -> int:
+        """Apify name for the container port (ACTOR_WEB_SERVER_PORT, default 4321)."""
+        value = self.get('container_port')
+        return value if isinstance(value, int) else 4321
+
+    @property
+    def web_server_url(self) -> str:
+        """Apify name for the container URL (ACTOR_WEB_SERVER_URL)."""
+        return cast(str, self.get('container_url'))
+
+    @property
+    def standby_url(self) -> str:
+        """Public standby URL (ACTOR_STANDBY_URL), falling back to the container URL."""
+        return cast(str, self.get('standby_url') or self.get('container_url'))
+
     @property
     def token(self) -> Optional[str]:
         """Get the authentication token."""

scrapely/storage/api_client.py

@@ -5,7 +5,9 @@ Base API client for Scrapely storage operations.
 from __future__ import annotations
 
 import asyncio
+import json
 import logging
+import os
 import random
 import time
 from typing import Any, Dict, Optional, Union
@@ -36,13 +38,16 @@ def is_retryable_response(
 ) -> bool:
     """Whether a non-2xx answer is retried.
 
-    Idempotent methods: 500/502/503/504. Others (dataset push, KV PUT) only on
-    a 503 that certainly was not processed: the rate limiter refused it
-    ("rate-limit-unavailable", before the handler), or HAProxy had no backend
-    (its own page, nothing forwarded). Any other 503 may mean "outcome unknown"
-    (a direct dataset write whose commit was not confirmed), and re-sending
-    could store the items twice.
+    429 always: the run API limiter and dataset backpressure refuse it before
+    anything is written. Idempotent methods: also 500/502/503/504. Others
+    (dataset push, KV PUT) only on a 503 that certainly was not processed: the
+    rate limiter refused it ("rate-limit-unavailable", before the handler), or
+    HAProxy had no backend (its own page, nothing forwarded). Any other 503 may
+    mean "outcome unknown" (a direct dataset write whose commit was not
+    confirmed), and re-sending could store the items twice.
     """
+    if status == 429:
+        return True
     if idempotent:
         return status in (500, 502, 503, 504)
     if status != 503:
@@ -70,22 +75,60 @@ def _error_type(response: httpx.Response) -> Optional[str]:
     return None
 
 
-def server_retry_delay(server_attempt: int, retry_after: Optional[str], now: Optional[float] = None) -> float:
-    """Exponential backoff with jitter, in seconds; honours a Retry-After (seconds or HTTP date) of up to 30 s."""
-    if retry_after is not None and retry_after.strip():
-        secs: Optional[float] = None
+# Default time budget for retrying one API call (429, 503, network errors).
+DEFAULT_API_RETRY_WINDOW_SECS = 120.0
+_MAX_BACKOFF_SECS = 30.0
+
+
+def api_retry_window_secs() -> float:
+    """How long one API call keeps retrying before it gives up.
+
+    ``SCRAPELY_API_RETRY_WINDOW_SECS`` when set, else ``ApiClient.retry_window_secs``
+    (2 minutes by default).
+    """
+    raw = os.environ.get('SCRAPELY_API_RETRY_WINDOW_SECS')
+    if raw:
         try:
-            secs = float(retry_after)
+            value = float(raw)
+            if value >= 0:
+                return value
         except ValueError:
-            try:
-                from email.utils import parsedate_to_datetime
+            pass
+    return ApiClient.retry_window_secs
+
+
+def _parse_retry_after(retry_after: Optional[str], now: Optional[float]) -> Optional[float]:
+    if retry_after is None or not retry_after.strip():
+        return None
+    secs: Optional[float] = None
+    try:
+        secs = float(retry_after)
+    except ValueError:
+        try:
+            from email.utils import parsedate_to_datetime
 
-                secs = max(0.0, parsedate_to_datetime(retry_after).timestamp() - (time.time() if now is None else now))
-            except Exception:
-                secs = None
-        if secs is not None and secs >= 0:
-            return min(secs, 30.0) + random.random() * 0.1
-    return min(8.0, 0.5 * 2 ** server_attempt) + random.random() * 0.25
+            secs = max(0.0, parsedate_to_datetime(retry_after).timestamp() - (time.time() if now is None else now))
+        except Exception:
+            secs = None
+    if secs is None or secs < 0 or secs != secs:
+        return None
+    # Not capped: a Retry-After past the retry window ends the retries instead.
+    return secs
+
+
+def server_retry_delay(attempt: int, retry_after: Optional[str], now: Optional[float] = None) -> float:
+    """Delay in seconds before retry number ``attempt + 1``.
+
+    Exponential backoff (0.5 s doubling, capped at 30 s) with equal jitter, and
+    never earlier than the server's Retry-After (seconds or HTTP date) plus a little jitter so throttled clients don't all come back in
+    the same instant.
+    """
+    exp: float = min(_MAX_BACKOFF_SECS, 0.5 * float(2 ** min(attempt, 16)))
+    backoff = exp / 2 + random.random() * (exp / 2)
+    ra = _parse_retry_after(retry_after, now)
+    if ra is None:
+        return backoff
+    return max(ra + random.random() * min(1.0, ra * 0.2 + 0.1), backoff)
 
 
 class AdaptiveRateLimiter:
@@ -139,25 +182,8 @@ class AdaptiveRateLimiter:
 
         self.last_request_time = time.time() * 1000
 
-    async def handle_rate_limited(self, response: httpx.Response) -> None:
+    def record_rate_limited(self) -> None:
         self._rate_limit_errors[429] = self._rate_limit_errors.get(429, 0) + 1
-        retry_after = response.headers.get('Retry-After')
-        wait_ms = 1000.0
-        if retry_after:
-            try:
-                wait_ms = float(retry_after) * 1000
-            except ValueError:
-                try:
-                    from email.utils import parsedate_to_datetime
-
-                    retry_date = parsedate_to_datetime(retry_after).timestamp() * 1000
-                    wait_ms = max(0.0, retry_date - time.time() * 1000)
-                except Exception:
-                    wait_ms = 1000.0
-
-        wait_ms = wait_ms + random.random() * 100
-        logger.warning('[RateLimiter] Rate limited, waiting %.0fms before retry', wait_ms)
-        await asyncio.sleep(wait_ms / 1000)
 
     def get_rate_limit_errors(self) -> Dict[int, int]:
         return dict(self._rate_limit_errors)
@@ -170,11 +196,10 @@ class ApiClient:
     """
 
     _rate_limiter = AdaptiveRateLimiter()
-    _max_retries = 3
-    # Retries while the API is briefly unavailable (503/5xx, connection
-    # refused): backoff 0.5 s doubling to 8 s, about 45 s in total, which
-    # covers a main redeploy.
-    _max_server_retries = 8
+    # How long one call keeps retrying 429/503/network errors before it gives
+    # up (SCRAPELY_API_RETRY_WINDOW_SECS overrides it). Long enough that a
+    # throttled run slows down instead of failing, and covers a main redeploy.
+    retry_window_secs = DEFAULT_API_RETRY_WINDOW_SECS
 
     def __init__(
         self,
@@ -260,12 +285,25 @@ class ApiClient:
         idempotent: Optional[bool] = None,
         retry_deadline: Optional[float] = None,
     ) -> httpx.Response:
-        """Make an HTTP request with adaptive rate limiting and 429 retries.
+        """Make an HTTP request with the API retry policy.
+
+        Retries, with exponential backoff and jitter that honours Retry-After,
+        until the retry window (2 minutes by default) runs out:
+
+        - 429 (run API rate limit, dataset backpressure): always; nothing was applied.
+        - 503 from the limiter or HAProxy: always; nothing was forwarded.
+        - 500/502/503/504, read/write timeouts and dropped connections:
+          idempotent calls only.
+        - Refused connections and connect/pool timeouts: always; the request
+          never left.
+
+        A write (dataset push, KV PUT) whose request may have reached the API is
+        never re-sent: there is no idempotency key for it, so a re-send could
+        store the same rows twice. Such failures surface to the caller instead.
 
-        ``retry_deadline`` (a ``time.monotonic()`` value) stops the 5xx /
-        connection retries once the next backoff would end after it, so a
-        caller with a time budget (e.g. the exit flush) gets an answer instead
-        of being cancelled mid-retry.
+        ``retry_deadline`` (a ``time.monotonic()`` value) ends the retries
+        earlier, so a caller with a time budget (e.g. the exit flush) gets an
+        answer instead of being cancelled mid-retry.
         """
         client = await self._ensure_client()
         url = self._url(path)
@@ -274,78 +312,76 @@ class ApiClient:
         request_headers = dict(headers or {})
         if json_data is not None and 'Content-Type' not in request_headers:
             request_headers['Content-Type'] = 'application/json'
+        if json_data is not None:
+            # Apify/crawlee parity: unknown objects (datetimes, LLM result
+            # objects, ...) are stored as strings instead of raising.
+            content = json.dumps(json_data, ensure_ascii=False, default=str).encode('utf-8')
 
         if idempotent is None:
             idempotent = method.upper() in IDEMPOTENT_METHODS
-        attempt = 0  # timeouts and 429s
-        server_attempt = 0  # 503/5xx and connection failures (API briefly unavailable)
+        deadline = time.monotonic() + max(0.0, api_retry_window_secs())
+        if retry_deadline is not None:
+            deadline = min(deadline, retry_deadline)
+        attempt = 0
+
+        async def backoff(why: str, retry_after: Optional[str]) -> bool:
+            """Sleep before the next attempt; False once the retry window is used up."""
+            nonlocal attempt
+            # Retrying sooner than asked would only be refused again: give up
+            # when the next try would land past the window / deadline.
+            wait = server_retry_delay(attempt, retry_after)
+            if time.monotonic() + wait > deadline:
+                return False
+            attempt += 1
+            logger.warning('%s %s %s; retry %d in %.1fs', method, path, why, attempt, wait)
+            await asyncio.sleep(wait)
+            return True
+
         while True:
             await self._rate_limiter.wait_for_slot()
+            request_kwargs: Dict[str, Any] = {}
+            if retry_deadline is not None:
+                # A caller with a time budget: no attempt may outlive it.
+                request_kwargs['timeout'] = max(0.5, min(self.timeout, retry_deadline - time.monotonic()))
             try:
                 response = await client.request(
                     method,
                     url,
                     params=params,
-                    json=json_data,
                     content=content,
                     headers=request_headers or None,
+                    **request_kwargs,
                 )
-            except httpx.TimeoutException:
-                if do_not_retry_timeouts or attempt >= self._max_retries:
+            except (httpx.ConnectTimeout, httpx.PoolTimeout, httpx.ConnectError) as exc:
+                # Never reached the API: safe for every method.
+                if isinstance(exc, (httpx.ConnectTimeout, httpx.PoolTimeout)) and do_not_retry_timeouts:
                     raise
-                attempt += 1
-                await asyncio.sleep(0.25 * attempt)
-                continue
+                if await backoff(f'failed ({type(exc).__name__})', None):
+                    continue
+                raise
+            except httpx.TimeoutException as exc:
+                # Read/write timeout: the request may have been applied.
+                if idempotent and not do_not_retry_timeouts and await backoff(f'timed out ({type(exc).__name__})', None):
+                    continue
+                raise
             except httpx.TransportError as exc:
-                # No response. A refused/unresolvable connection never reached
-                # the API, so it is safe for every method; anything else (reset
-                # mid-request) only for idempotent ones.
-                wait = server_retry_delay(server_attempt, None)
-                if (
-                    (idempotent or isinstance(exc, httpx.ConnectError))
-                    and server_attempt < self._max_server_retries
-                    and (retry_deadline is None or time.monotonic() + wait <= retry_deadline)
-                ):
-                    server_attempt += 1
-                    logger.warning(
-                        '%s %s failed (%s); retry %d/%d in %.1fs',
-                        method, path, type(exc).__name__, server_attempt, self._max_server_retries, wait,
-                    )
-                    await asyncio.sleep(wait)
+                # Reset mid-request: only idempotent calls are re-sent.
+                if idempotent and await backoff(f'failed ({type(exc).__name__})', None):
                     continue
                 raise
 
             self._rate_limiter.update_from_headers(response.headers)
-
-            if response.status_code == 429 and attempt < self._max_retries:
-                attempt += 1
-                await self._rate_limiter.handle_rate_limited(response)
-                continue
-
-            # API briefly unavailable (main redeploy, limiter store blip); see
-            # is_retryable_response for which answers are safe to re-send.
-            if (
-                not response.is_success
-                and server_attempt < self._max_server_retries
-                and (
-                    retry_deadline is None
-                    or time.monotonic() + server_retry_delay(server_attempt, response.headers.get('Retry-After')) <= retry_deadline
-                )
-                and is_retryable_response(
-                    response.status_code,
-                    idempotent,
-                    _error_type(response) if response.status_code == 503 else None,
-                    response.text if response.status_code == 503 else None,
-                )
+            if response.status_code == 429:
+                self._rate_limiter.record_rate_limited()
+
+            if not response.is_success and is_retryable_response(
+                response.status_code,
+                idempotent,
+                _error_type(response) if response.status_code == 503 else None,
+                response.text if response.status_code == 503 else None,
             ):
-                wait = server_retry_delay(server_attempt, response.headers.get('Retry-After'))
-                server_attempt += 1
-                logger.warning(
-                    '%s %s answered %d; retry %d/%d in %.1fs',
-                    method, path, response.status_code, server_attempt, self._max_server_retries, wait,
-                )
-                await asyncio.sleep(wait)
-                continue
+                if await backoff(f'answered {response.status_code}', response.headers.get('Retry-After')):
+                    continue
 
             if raise_for_status:
                 await self._raise_for_status(response)
@@ -402,6 +438,7 @@ class ApiClient:
         params: Optional[Dict[str, Any]] = None,
         *,
         raise_for_status: bool = True,
+        idempotent: Optional[bool] = None,
     ) -> httpx.Response:
         return await self.request(
             'PUT',
@@ -411,6 +448,7 @@ class ApiClient:
             content=content,
             headers=headers,
             raise_for_status=raise_for_status,
+            idempotent=idempotent,
         )
 
     async def delete(

scrapely/storage/client.py

@@ -6,6 +6,7 @@ Ports the patterns from the TypeScript ApiStorageClient.
 
 from __future__ import annotations
 
+import os
 import logging
 import re
 import uuid
@@ -358,7 +359,14 @@ class ApiStorageClient:
         return cast(Dict[str, Any], await self.api_client.get_json(f'/v2/key-value-stores/{store_id}/keys', params=params))
 
     def kvs_public_url(self, store_id: str, key: str) -> str:
-        return f'{self.api_client.api_url}{kvs_record_path(store_id, key)}'
+        # api_url is the container-internal API address; links handed to users
+        # must use the public base URL the platform injects.
+        public_base = (
+            os.environ.get('APIFY_API_PUBLIC_BASE_URL')
+            or os.environ.get('ACTOR_API_PUBLIC_BASE_URL')
+            or self.api_client.api_url
+        ).rstrip('/')
+        return f'{public_base}{kvs_record_path(store_id, key)}'
 
     # --- Request queue resource ops ---
 

{scrapely_python-0.1.11.dist-info → scrapely_python-0.1.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrapely-python
-Version: 0.1.11
+Version: 0.1.13
 Summary: Scrapely Python SDK - A toolkit for building Actors on the Scrapely platform
 Author-email: Scrapely <support@scrape.ly>
 License-Expression: MIT AND Apache-2.0

{scrapely_python-0.1.11.dist-info → scrapely_python-0.1.13.dist-info}/RECORD

@@ -1,11 +1,11 @@
-scrapely/__init__.py,sha256=RxtELQHc6mWoQhDgFu_EK_jFjuPOMlKEcDEZizk1vxQ,5746
+scrapely/__init__.py,sha256=op7jaJu8R-WYcJhTBg85PBitZyUU99cW8GlZSOgQh2Y,5746
 scrapely/_browser_locations.py,sha256=8QVVnkms2bDn3_LDYgYDR59MvFx8757l_JYnZ7xb3oI,145269
-scrapely/actor.py,sha256=2nWeaEIo11-XO0w3QAzA1lbn4Gm1MvjStsiNdOvk_tc,77721
+scrapely/actor.py,sha256=RL--_STBMxpy428v1T2xlI89Poibinl_fBKzcbaHonk,78144
 scrapely/browser_configuration.py,sha256=jAZapNSHLFW05B96df4wNBtcyiiU9DA3ml0yTL1FwfA,5770
 scrapely/cdp_retry.py,sha256=hdTJEAIKhApM7IOk1DrQEl8NoflSJSmqd4RbNJ2IsgI,8540
-scrapely/charging.py,sha256=41KG60D-YM9oi-1qbSKRfZbw92pFWi1yvvc2c2L6V5k,66862
+scrapely/charging.py,sha256=_GHEKEgQ7lRYTVPacBiBuvlaqGTNcsF65K8xhiJ0dNM,68526
 scrapely/charging_client.py,sha256=-4q-Ww7gu9EZXpM9QIn1Vd4vwAXmgL_WEKqaQIx3ViA,3961
-scrapely/configuration.py,sha256=GjMr3YsxM16HYjAOTUzWZKG2E8FuMzAoFXmkn5dbDPM,16396
+scrapely/configuration.py,sha256=Of-lKm7hoPGUQO8d08kV7fAy2co9QTfb8Of_8ds5PSA,17028
 scrapely/errors.py,sha256=DCAlVvE3jToZuPEG2HVDL7i8D8hLboomQ5JpSOcsXoQ,4107
 scrapely/log.py,sha256=iVKoQdMLQXEWz1STzbSXrNUxsS_FNwiIdqoEg7CzeqU,1440
 scrapely/patch_browser_pool.py,sha256=qZstdQ1rFw8kGjzB9fm3GXco8Jt40eklTw1Czf_vh-8,38018
@@ -23,8 +23,8 @@ scrapely/request_loaders/__init__.py,sha256=aNgr4pRt3MziUbU6UQ_bjTT3moMNvvyUsPeC
 scrapely/request_loaders/_scrapely_request_list.py,sha256=vguj-EvBjvrGY5_vf2fGXnJBfnhlPeRjdkjPFaxUA7g,7628
 scrapely/storage/__init__.py,sha256=diAhxEvOXjc3YVhZvzkO3MttJUXQWJ5ogxstiApsh7U,1405
 scrapely/storage/_metadata.py,sha256=WWawBnVN0b1iK2K-SlxZXUc6czb5wXWf8iC_0tzkgAQ,4764
-scrapely/storage/api_client.py,sha256=jqfBOOHo97DeTzJQlh0bBTn0EjjK184VtnxFIs20rbg,16649
-scrapely/storage/client.py,sha256=Ln_NA8nJz62nXldkcj54PFZopX5P3Lp8HGot_8friNM,22015
+scrapely/storage/api_client.py,sha256=SRtDOR58fggYwWjcz-S5RshDCM4kO2opxqn_k9Wdyxg,18183
+scrapely/storage/client.py,sha256=qQtFf1G2wv2RU5uHil521j3EAI7JDLX9VngPePe3VMU,22353
 scrapely/storage/patch_storage.py,sha256=o3Fv0BByeZ1T9HhkzhY6bjolOFsIQcnqBoHq1EdG8Fw,8758
 scrapely/storage/scrapely_dataset_client.py,sha256=u5dnXxe1BAsq7rh-haR5W1ChE7UZ_k7B9ShR8YtwFkg,10695
 scrapely/storage/scrapely_kvs_client.py,sha256=ItQhe2rcSl20NkSmegfqHiRyKncH4Qg9BjQVpF6jHfk,7403
@@ -38,10 +38,10 @@ scrapely/storage/_file_system/_key_value_store_client.py,sha256=4Ipgbh4qEqAkwQJ9
 scrapely/storage/_file_system/_storage_client.py,sha256=aaGJ4P0QAtIgEMl6yHpuobeWFD5M4rMC5HwhOOvuGuo,1794
 scrapely/storage_clients/__init__.py,sha256=cs1YX7JV2_GKBXeiiJgkQFali08b5_y_jH6Yw7iROAA,656
 scrapely/storages/__init__.py,sha256=4PAELhJNZ3exJ7Uouicn-bCQ58NafKjhLBixQ8ATQc4,173
-scrapely_python-0.1.11.dist-info/licenses/LICENSE,sha256=pQGY0XwjIYh-a2HfawxHq1en53bXkFkDj2Q70jKWHr4,1088
-scrapely_python-0.1.11.dist-info/licenses/LICENSE-APACHE,sha256=N8m0FzMq8i4UbTgXZvKEZJSD-27OF8pWZYS_atz4kTU,11355
-scrapely_python-0.1.11.dist-info/licenses/NOTICE,sha256=DEsNrw6UdSIqdYYqMWVFgJnyt6jUivTD7iFU6YM_e1A,1122
-scrapely_python-0.1.11.dist-info/METADATA,sha256=TjBOSZzW9n2wrL0IQQQ6Qxp-T_SCsjPsOAP1I_lCTEc,3487
-scrapely_python-0.1.11.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-scrapely_python-0.1.11.dist-info/top_level.txt,sha256=T4B9UMrs4q99QSAFyD1zdXhl40KnLhBKqrDkPhOTsmY,9
-scrapely_python-0.1.11.dist-info/RECORD,,
+scrapely_python-0.1.13.dist-info/licenses/LICENSE,sha256=pQGY0XwjIYh-a2HfawxHq1en53bXkFkDj2Q70jKWHr4,1088
+scrapely_python-0.1.13.dist-info/licenses/LICENSE-APACHE,sha256=N8m0FzMq8i4UbTgXZvKEZJSD-27OF8pWZYS_atz4kTU,11355
+scrapely_python-0.1.13.dist-info/licenses/NOTICE,sha256=DEsNrw6UdSIqdYYqMWVFgJnyt6jUivTD7iFU6YM_e1A,1122
+scrapely_python-0.1.13.dist-info/METADATA,sha256=IlnwQFkV2dC5TTZYZjJwaqBvqahQyhtl2RTdfQR3F28,3487
+scrapely_python-0.1.13.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+scrapely_python-0.1.13.dist-info/top_level.txt,sha256=T4B9UMrs4q99QSAFyD1zdXhl40KnLhBKqrDkPhOTsmY,9
+scrapely_python-0.1.13.dist-info/RECORD,,