apify 3.4.2b6__tar.gz → 3.4.2b8__tar.gz

{apify-3.4.2b6 → apify-3.4.2b8}/CHANGELOG.md

@@ -10,6 +10,9 @@ All notable changes to this project will be documented in this file.
 - **scrapy:** Correct proxy middleware exception log and import ([#953](https://github.com/apify/apify-sdk-python/pull/953)) ([5bd6eb9](https://github.com/apify/apify-sdk-python/commit/5bd6eb9843d90844cec083372e932413bceedec9)) by [@vdusek](https://github.com/vdusek)
 - **scrapy:** Skip a request that fails to convert instead of crashing the run ([#952](https://github.com/apify/apify-sdk-python/pull/952)) ([db9444f](https://github.com/apify/apify-sdk-python/commit/db9444faeb0158c29aa394121cf733ff2e843f28)) by [@vdusek](https://github.com/vdusek)
 - **scrapy:** [**breaking**] Serialize requests and HTTP cache as JSON instead of pickle ([#951](https://github.com/apify/apify-sdk-python/pull/951)) ([a87e8d1](https://github.com/apify/apify-sdk-python/commit/a87e8d1597478b4f12fd5bb9b379f65f637d8e96)) by [@vdusek](https://github.com/vdusek)
+- **scrapy:** Make logging configuration idempotent ([#954](https://github.com/apify/apify-sdk-python/pull/954)) ([2cc5602](https://github.com/apify/apify-sdk-python/commit/2cc5602b741b93c81f264d4e09e0d9bcfc7200f2)) by [@vdusek](https://github.com/vdusek)
+- Bump typing-extensions floor to 4.4.0 ([#960](https://github.com/apify/apify-sdk-python/pull/960)) ([b7e7d9c](https://github.com/apify/apify-sdk-python/commit/b7e7d9c9a053992d4281a8a19897957d2bff67e1)) by [@vdusek](https://github.com/vdusek)
+- Preserve decorated symbol types in docs_group and docs_name ([#964](https://github.com/apify/apify-sdk-python/pull/964)) ([6c359a7](https://github.com/apify/apify-sdk-python/commit/6c359a714b089b24c1be7fa9a07c9b9899cc5e11)) by [@vdusek](https://github.com/vdusek)
 
 ### 🚜 Refactor
 

{apify-3.4.2b6 → apify-3.4.2b8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apify
-Version: 3.4.2b6
+Version: 3.4.2b8
 Summary: Apify SDK for Python
 Project-URL: Apify Homepage, https://apify.com
 Project-URL: Changelog, https://docs.apify.com/sdk/python/docs/changelog
@@ -233,7 +233,7 @@ Requires-Dist: impit>=0.8.0
 Requires-Dist: lazy-object-proxy>=1.11.0
 Requires-Dist: more-itertools>=10.2.0
 Requires-Dist: pydantic>=2.11.0
-Requires-Dist: typing-extensions>=4.1.0
+Requires-Dist: typing-extensions>=4.4.0
 Requires-Dist: websockets>=14.0
 Requires-Dist: yarl>=1.18.0
 Provides-Extra: scrapy

{apify-3.4.2b6 → apify-3.4.2b8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apify"
-version = "3.4.2b6"
+version = "3.4.2b8"
 description = "Apify SDK for Python"
 authors = [{ name = "Apify Technologies s.r.o.", email = "support@apify.com" }]
 license = { file = "LICENSE" }
@@ -42,7 +42,7 @@ dependencies = [
     "lazy-object-proxy>=1.11.0",
     "more_itertools>=10.2.0",
     "pydantic>=2.11.0",
-    "typing-extensions>=4.1.0",
+    "typing-extensions>=4.4.0",
     "websockets>=14.0",
     "yarl>=1.18.0",
 ]

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/_actor.py

@@ -699,7 +699,15 @@ class _ActorType:
 
     @_ensure_context
     async def get_input(self) -> Any:
-        """Get the Actor input value from the default key-value store associated with the current Actor run."""
+        """Get the Actor input value from the default key-value store associated with the current Actor run.
+
+        The input is the deserialized contents of the input record (the `INPUT` key by default), so it is typically
+        a `dict` keyed by the fields declared in the Actor's input schema. Any secret input fields are decrypted to
+        plaintext before being returned.
+
+        Returns:
+            The Actor input, usually a `dict` of input fields, or `None` if the Actor has no input.
+        """
         input_value = await self.get_value(self.configuration.input_key)
         input_secrets_private_key = self.configuration.input_secrets_private_key_file
         input_secrets_key_passphrase = self.configuration.input_secrets_private_key_passphrase

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/_charging.py

@@ -5,9 +5,10 @@ from contextvars import ContextVar
 from dataclasses import dataclass
 from datetime import UTC, datetime
 from decimal import Decimal
-from typing import TYPE_CHECKING, Annotated, Literal, Protocol, TypedDict
+from typing import TYPE_CHECKING, Literal, Protocol, TypedDict
 
-from pydantic import Field
+from pydantic import ConfigDict
+from pydantic.alias_generators import to_camel
 
 import apify_client._models as _client_models
 from apify_client._models import ActorChargeEvent as ClientActorChargeEvent
@@ -56,7 +57,9 @@ _ensure_context = ensure_context('active')
 class ActorChargeEvent(ClientActorChargeEvent):
     """Definition of a single chargeable event in the pay-per-event pricing model."""
 
-    event_description: Annotated[str | None, Field(alias='eventDescription')] = None
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    event_description: str | None = None
     """Human-readable description of the event.
 
     Required in apify-client but omitted from the env var, so it is relaxed to optional.
@@ -67,7 +70,9 @@ class ActorChargeEvent(ClientActorChargeEvent):
 class PricingPerEvent(ClientPricingPerEvent):
     """Pay-per-event pricing details - the chargeable events and their prices."""
 
-    actor_charge_events: Annotated[dict[str, ActorChargeEvent] | None, Field(alias='actorChargeEvents')] = None
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    actor_charge_events: dict[str, ActorChargeEvent] | None = None
     """Mapping of event name to its charge definition."""
 
 
@@ -75,13 +80,15 @@ class PricingPerEvent(ClientPricingPerEvent):
 class FreeActorPricingInfo(ClientFree):
     """Pricing info for an Actor offered free of charge."""
 
-    apify_margin_percentage: Annotated[float | None, Field(alias='apifyMarginPercentage')] = None
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    apify_margin_percentage: float | None = None
     """Apify's margin on the price, as a percentage."""
 
-    created_at: Annotated[datetime | None, Field(alias='createdAt')] = None
+    created_at: datetime | None = None
     """Timestamp when this pricing info was created."""
 
-    started_at: Annotated[datetime | None, Field(alias='startedAt')] = None
+    started_at: datetime | None = None
     """Timestamp when this pricing became effective."""
 
 
@@ -89,19 +96,21 @@ class FreeActorPricingInfo(ClientFree):
 class FlatPricePerMonthActorPricingInfo(ClientFlatPricePerMonth):
     """Pricing info for an Actor billed at a flat monthly price."""
 
-    apify_margin_percentage: Annotated[float | None, Field(alias='apifyMarginPercentage')] = None
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    apify_margin_percentage: float | None = None
     """Apify's margin on the price, as a percentage."""
 
-    created_at: Annotated[datetime | None, Field(alias='createdAt')] = None
+    created_at: datetime | None = None
     """Timestamp when this pricing info was created."""
 
-    started_at: Annotated[datetime | None, Field(alias='startedAt')] = None
+    started_at: datetime | None = None
     """Timestamp when this pricing became effective."""
 
-    trial_minutes: Annotated[int | None, Field(alias='trialMinutes')] = None
+    trial_minutes: int | None = None
     """Length of the free trial period, in minutes."""
 
-    price_per_unit_usd: Annotated[float | None, Field(alias='pricePerUnitUsd')] = None
+    price_per_unit_usd: float | None = None
     """Price per unit, in USD."""
 
 
@@ -109,16 +118,18 @@ class FlatPricePerMonthActorPricingInfo(ClientFlatPricePerMonth):
 class PricePerDatasetItemActorPricingInfo(ClientPricePerDatasetItem):
     """Pricing info for an Actor billed per dataset item produced."""
 
-    apify_margin_percentage: Annotated[float | None, Field(alias='apifyMarginPercentage')] = None
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    apify_margin_percentage: float | None = None
     """Apify's margin on the price, as a percentage."""
 
-    created_at: Annotated[datetime | None, Field(alias='createdAt')] = None
+    created_at: datetime | None = None
     """Timestamp when this pricing info was created."""
 
-    started_at: Annotated[datetime | None, Field(alias='startedAt')] = None
+    started_at: datetime | None = None
     """Timestamp when this pricing became effective."""
 
-    unit_name: Annotated[str | None, Field(alias='unitName')] = None
+    unit_name: str | None = None
     """Name of the billed unit."""
 
 
@@ -126,16 +137,18 @@ class PricePerDatasetItemActorPricingInfo(ClientPricePerDatasetItem):
 class PayPerEventActorPricingInfo(ClientPayPerEvent):
     """Pricing info for an Actor billed per charged event."""
 
-    apify_margin_percentage: Annotated[float | None, Field(alias='apifyMarginPercentage')] = None
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    apify_margin_percentage: float | None = None
     """Apify's margin on the price, as a percentage."""
 
-    created_at: Annotated[datetime | None, Field(alias='createdAt')] = None
+    created_at: datetime | None = None
     """Timestamp when this pricing info was created."""
 
-    started_at: Annotated[datetime | None, Field(alias='startedAt')] = None
+    started_at: datetime | None = None
     """Timestamp when this pricing became effective."""
 
-    pricing_per_event: Annotated[PricingPerEvent, Field(alias='pricingPerEvent')]
+    pricing_per_event: PricingPerEvent
     """The pay-per-event pricing details."""
 
 

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/_utils.py

@@ -85,7 +85,7 @@ GroupName = Literal[
 ]
 
 
-def docs_group(group_name: GroupName) -> Callable:  # noqa: ARG001
+def docs_group(group_name: GroupName) -> Callable[[T], T]:  # noqa: ARG001
     """Mark a symbol for rendering and grouping in documentation.
 
     This decorator is used solely for documentation purposes and does not modify the behavior
@@ -98,13 +98,13 @@ def docs_group(group_name: GroupName) -> Callable:  # noqa: ARG001
         The original callable without modification.
     """
 
-    def wrapper(func: Callable) -> Callable:
+    def wrapper(func: T) -> T:
         return func
 
     return wrapper
 
 
-def docs_name(symbol_name: str) -> Callable:  # noqa: ARG001
+def docs_name(symbol_name: str) -> Callable[[T], T]:  # noqa: ARG001
     """Rename a symbol for documentation rendering.
 
     This decorator modifies only the displayed name of the symbol in the generated documentation
@@ -117,7 +117,7 @@ def docs_name(symbol_name: str) -> Callable:  # noqa: ARG001
         The original callable without modification.
     """
 
-    def wrapper(func: Callable) -> Callable:
+    def wrapper(func: T) -> T:
         return func
 
     return wrapper

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/events/_types.py

@@ -3,7 +3,8 @@ from __future__ import annotations
 from datetime import datetime
 from typing import Annotated, Any, Literal
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, ConfigDict, Field
+from pydantic.alias_generators import to_camel
 
 from crawlee.events._types import (
     Event,
@@ -29,28 +30,30 @@ This is the Apify-specific subset of [`Event`][crawlee.events.Event] — for the
 class SystemInfoEventData(BaseModel):
     """Resource usage metrics carried by a `systemInfo` event."""
 
-    mem_avg_bytes: Annotated[float, Field(alias='memAvgBytes')]
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
+    mem_avg_bytes: float
     """Average memory usage over the measured interval, in bytes."""
 
-    mem_current_bytes: Annotated[float, Field(alias='memCurrentBytes')]
+    mem_current_bytes: float
     """Current memory usage, in bytes."""
 
-    mem_max_bytes: Annotated[float, Field(alias='memMaxBytes')]
+    mem_max_bytes: float
     """Peak memory usage observed so far, in bytes."""
 
-    cpu_avg_usage: Annotated[float, Field(alias='cpuAvgUsage')]
+    cpu_avg_usage: float
     """Average CPU usage over the measured interval, in percent."""
 
-    cpu_max_usage: Annotated[float, Field(alias='cpuMaxUsage')]
+    cpu_max_usage: float
     """Peak CPU usage observed so far, in percent."""
 
-    cpu_current_usage: Annotated[float, Field(alias='cpuCurrentUsage')]
+    cpu_current_usage: float
     """Current CPU usage, in percent."""
 
-    is_cpu_overloaded: Annotated[bool, Field(alias='isCpuOverloaded')]
+    is_cpu_overloaded: bool
     """Whether the CPU is currently overloaded."""
 
-    created_at: Annotated[datetime, Field(alias='createdAt')]
+    created_at: datetime
     """Timestamp when the metrics were collected."""
 
     def to_crawlee_format(self, dedicated_cpus: float) -> EventSystemInfoData:
@@ -73,6 +76,8 @@ class SystemInfoEventData(BaseModel):
 class PersistStateEvent(BaseModel):
     """A `persistState` event instructing the Actor to persist its state."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal[Event.PERSIST_STATE]
     """The event name."""
 
@@ -84,6 +89,8 @@ class PersistStateEvent(BaseModel):
 class SystemInfoEvent(BaseModel):
     """A `systemInfo` event carrying the Actor's resource usage metrics."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal[Event.SYSTEM_INFO]
     """The event name."""
 
@@ -95,6 +102,8 @@ class SystemInfoEvent(BaseModel):
 class MigratingEvent(BaseModel):
     """A `migrating` event signalling the Actor is about to be migrated to another host."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal[Event.MIGRATING]
     """The event name."""
 
@@ -106,6 +115,8 @@ class MigratingEvent(BaseModel):
 class AbortingEvent(BaseModel):
     """An `aborting` event signalling the Actor run is being aborted."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal[Event.ABORTING]
     """The event name."""
 
@@ -117,6 +128,8 @@ class AbortingEvent(BaseModel):
 class ExitEvent(BaseModel):
     """An `exit` event signalling the Actor process is about to exit."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal[Event.EXIT]
     """The event name."""
 
@@ -128,6 +141,8 @@ class ExitEvent(BaseModel):
 class EventWithoutData(BaseModel):
     """A framework-level event that carries no payload (e.g. browser and page lifecycle events)."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal[
         Event.SESSION_RETIRED,
         Event.BROWSER_LAUNCHED,
@@ -146,6 +161,8 @@ class EventWithoutData(BaseModel):
 class DeprecatedEvent(BaseModel):
     """A deprecated event kept for backward compatibility (e.g. `cpuInfo`)."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: Literal['cpuInfo']
     """The event name."""
 
@@ -157,6 +174,8 @@ class DeprecatedEvent(BaseModel):
 class UnknownEvent(BaseModel):
     """A fallback for any event whose name is not recognized by the SDK."""
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     name: str
     """The event name."""
 

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/request_loaders/_apify_request_list.py

@@ -5,7 +5,8 @@ import re
 from itertools import chain
 from typing import Annotated, Any
 
-from pydantic import BaseModel, Field, TypeAdapter
+from pydantic import BaseModel, ConfigDict, Field, TypeAdapter
+from pydantic.alias_generators import to_camel
 
 from crawlee._types import HttpMethod
 from crawlee.http_clients import HttpClient, ImpitHttpClient
@@ -20,14 +21,16 @@ URL_NO_COMMAS_REGEX = re.compile(
 
 
 class _RequestDetails(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     method: HttpMethod = 'GET'
     payload: str = ''
     headers: Annotated[dict[str, str], Field(default_factory=dict)]
-    user_data: Annotated[dict[str, str], Field(default_factory=dict, alias='userData')]
+    user_data: Annotated[dict[str, str], Field(default_factory=dict)]
 
 
 class _RequestsFromUrlInput(_RequestDetails):
-    requests_from_url: str = Field(alias='requestsFromUrl')
+    requests_from_url: str
 
 
 class _SimpleUrlInput(_RequestDetails):

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/scrapy/_logging_config.py

@@ -13,6 +13,11 @@ _PRIMARY_LOGGERS = ['apify', 'apify_client', 'scrapy']
 _SUPPLEMENTAL_LOGGERS = ['filelock', 'hpack', 'httpcore', 'protego', 'twisted']
 _ALL_LOGGERS = _PRIMARY_LOGGERS + _SUPPLEMENTAL_LOGGERS
 
+# Mutable state shared with the Scrapy monkey-patch below. `initialize_logging` refreshes
+# `level`/`handler` on each call; the patch (installed once) reads them so it always applies the
+# latest configuration rather than values captured the first time it ran.
+_state: dict[str, Any] = {'level': 'INFO', 'handler': None, 'patched': False}
+
 
 def _configure_logger(name: str | None, logging_level: str, handler: logging.Handler) -> None:
     """Clear and reconfigure the logger."""
@@ -23,26 +28,39 @@ def _configure_logger(name: str | None, logging_level: str, handler: logging.Han
     logger.propagate = False
 
 
+def _configure_all_loggers() -> None:
+    """Apply the Apify handler and level to the root logger and all defined loggers."""
+    handler = _state['handler']
+    if handler is None:
+        return
+    for logger_name in [None, *_ALL_LOGGERS]:
+        _configure_logger(logger_name, _state['level'], handler)
+
+
 def initialize_logging() -> None:
     """Configure logging for Apify Actors and adjust Scrapy's logging settings."""
     # Retrieve Scrapy project settings and determine the logging level.
     settings = get_project_settings()
-    logging_level = settings.get('LOG_LEVEL', 'INFO')  # Default to INFO.
+    _state['level'] = settings.get('LOG_LEVEL', 'INFO')  # Default to INFO.
 
     # Create a custom handler with the Apify log formatter.
     handler = logging.StreamHandler()
     handler.setFormatter(ActorLogFormatter(include_logger_name=True))
+    _state['handler'] = handler
 
     # Configure the root logger and all other defined loggers.
-    for logger_name in [None, *_ALL_LOGGERS]:
-        _configure_logger(logger_name, logging_level, handler)
+    _configure_all_loggers()
+
+    # Monkey-patch Scrapy's logging to re-apply our settings whenever it reconfigures logging.
+    # Install the wrapper at most once, otherwise repeated calls would nest wrappers.
+    if _state['patched']:
+        return
 
-    # Monkey-patch Scrapy's logging configuration to re-apply our settings.
     original_configure_logging = scrapy_logging.configure_logging
 
     def new_configure_logging(*args: Any, **kwargs: Any) -> None:
         original_configure_logging(*args, **kwargs)
-        for logger_name in [None, *_ALL_LOGGERS]:
-            _configure_logger(logger_name, logging_level, handler)
+        _configure_all_loggers()
 
     scrapy_logging.configure_logging = new_configure_logging  # ty: ignore[invalid-assignment]
+    _state['patched'] = True

{apify-3.4.2b6 → apify-3.4.2b8}/src/apify/storage_clients/_apify/_models.py

@@ -3,7 +3,8 @@ from __future__ import annotations
 from datetime import datetime, timedelta
 from typing import TYPE_CHECKING, Annotated
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field
+from pydantic.alias_generators import to_camel
 
 from apify_client._models import RequestQueueStats
 from crawlee.storage_clients.models import KeyValueStoreMetadata, RequestQueueMetadata
@@ -22,7 +23,9 @@ class ApifyKeyValueStoreMetadata(KeyValueStoreMetadata):
     Includes additional Apify-specific fields.
     """
 
-    url_signing_secret_key: Annotated[str | None, Field(alias='urlSigningSecretKey', default=None)]
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    url_signing_secret_key: str | None = None
     """The secret key used for signing URLs for secure access to key-value store records."""
 
 
@@ -34,24 +37,31 @@ class RequestQueueHead(BaseModel):
     including metadata about the queue's state and lock information for the requests.
     """
 
-    model_config = ConfigDict(populate_by_name=True, extra='allow')
+    model_config = ConfigDict(populate_by_name=True, extra='allow', alias_generator=to_camel)
 
-    limit: Annotated[int | None, Field(alias='limit', default=None)]
+    limit: int | None = None
     """The maximum number of requests that were requested from the queue."""
 
-    had_multiple_clients: Annotated[bool, Field(alias='hadMultipleClients', default=False)]
+    had_multiple_clients: bool = False
     """Indicates whether the queue has been accessed by multiple clients (consumers)."""
 
-    queue_modified_at: Annotated[datetime, Field(alias='queueModifiedAt')]
+    queue_modified_at: datetime
     """The timestamp when the queue was last modified."""
 
-    lock_time: Annotated[timedelta | None, Field(alias='lockSecs', default=None)]
-    """The duration for which the returned requests are locked and cannot be processed by other clients."""
+    lock_time: Annotated[
+        timedelta | None,
+        Field(validation_alias=AliasChoices('lockSecs', 'lockTime'), serialization_alias='lockSecs'),
+    ] = None
+    """The duration for which the returned requests are locked and cannot be processed by other clients.
+
+    The platform's API names this field `lockSecs`, so it is serialized under that alias instead of the
+    `lockTime` that `to_camel` would derive from the field name.
+    """
 
-    queue_has_locked_requests: Annotated[bool | None, Field(alias='queueHasLockedRequests', default=False)]
+    queue_has_locked_requests: bool | None = False
     """Indicates whether the queue contains any locked requests."""
 
-    items: Annotated[list[Request], Field(alias='items', default_factory=list[Request])]
+    items: Annotated[list[Request], Field(default_factory=list[Request])]
     """The list of request objects retrieved from the beginning of the queue."""
 
     @classmethod
@@ -77,6 +87,8 @@ class CachedRequest(BaseModel):
     Only internal structure.
     """
 
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
     id: str
     """Id of the request."""
 
@@ -91,5 +103,7 @@ class CachedRequest(BaseModel):
 
 
 class ApifyRequestQueueMetadata(RequestQueueMetadata):
-    stats: Annotated[RequestQueueStats, Field(alias='stats', default_factory=RequestQueueStats)]
+    model_config = ConfigDict(alias_generator=to_camel)
+
+    stats: Annotated[RequestQueueStats, Field(default_factory=RequestQueueStats)]
     """Additional statistics about the request queue."""