scrapely-client-python 1.0.7__py3-none-any.whl → 1.0.9__py3-none-any.whl

scrapely_client/_consts.py

@@ -7,6 +7,9 @@ from datetime import timedelta
 DEFAULT_API_URL = 'https://api.scrape.ly'
 """Default base URL for the Scrapely API."""
 
+API_URL_ENV_VAR = 'SCRAPELY_API_URL'
+"""Environment variable that sets the API URL when `api_url` is not passed to the client."""
+
 API_VERSION = 'v2'
 """Current Scrapely API version."""
 

scrapely_client/_models.py

@@ -51,9 +51,7 @@ class ActVersion(BaseModel):
     version_number: Annotated[
         str | None, Field(examples=['0.0'], pattern='^([0-9]|[1-9][0-9])\\.([0-9]|[1-9][0-9])(\\.[0-9]+)?$')
     ] = None
-    git_repo_url: Annotated[
-        str | None, Field(examples=['https://github.com/example/my-actor.git#main:src'])
-    ] = None
+    git_repo_url: Annotated[str | None, Field(examples=['https://github.com/example/my-actor.git#main:src'])] = None
     """
     URL of the git repository, present when sourceType is GIT_REPO.
     """
@@ -151,9 +149,7 @@ class Actor(BaseModel):
     """
     Description of the Actor to display by search engines such as Google.
     """
-    picture_url: Annotated[
-        str | None, Field(examples=['https://images.scrape.ly/.../actor-picture.png'])
-    ] = None
+    picture_url: Annotated[str | None, Field(examples=['https://images.scrape.ly/.../actor-picture.png'])] = None
     """
     URL of the Actor's icon, displayed on the Actor's page in Scrapely Store and dashboard.
     """
@@ -224,7 +220,7 @@ class ActorChargeEvent(BaseModel):
 
 @docs_group('Models')
 class ActorDefinition(BaseModel):
-    """The definition of the Actor, the full specification of this field can be found in the upstream API docs."""
+    """The definition of the Actor, as declared in its Actor configuration file (for example `.actor/actor.json`)."""
 
     model_config = ConfigDict(
         extra='allow',
@@ -265,7 +261,7 @@ class ActorDefinition(BaseModel):
     """
     input: dict[str, Any] | None = None
     """
-    The input schema object, the full specification can be found in the upstream API docs
+    The input schema object.
     """
     changelog: str | None = None
     """
@@ -988,7 +984,7 @@ class Dataset(BaseModel):
         ),
     ] = None
     """
-    Defines the schema of items in your dataset, the full specification can be found in the upstream API docs
+    Defines the schema of items in your dataset.
     """
     console_url: Annotated[AnyUrl, Field(examples=['https://api.scrape.ly/storage/datasets/27TmTznX9YPeAYhkC'])]
     items_public_url: Annotated[
@@ -1290,7 +1286,11 @@ class EncodeAndSignData(BaseModel):
 
 @docs_group('Models')
 class DecodeAndVerifyRequest(EncodeAndSignData):
-    pass
+    model_config = ConfigDict(
+        extra='allow',
+        populate_by_name=True,
+        alias_generator=to_camel,
+    )
 
 
 @docs_group('Models')
@@ -1978,8 +1978,10 @@ class MonthlyUsage(BaseModel):
         alias_generator=to_camel,
     )
     usage_cycle: UsageCycle
-    # Scrapely emits raw byte counts (int) for the `DATA_TRANSFER_*_BYTES` keys
     monthly_service_usage: dict[str, UsageItem | int]
+    """
+    Scrapely emits raw byte counts (integers) for the `DATA_TRANSFER_*_BYTES` keys.
+    """
     daily_service_usages: list[DailyServiceUsages]
     total_usage_credits_usd_before_volume_discount: Annotated[float, Field(examples=[0.786143673840067])]
     total_usage_credits_usd_after_volume_discount: Annotated[float, Field(examples=[0.786143673840067])]
@@ -2133,9 +2135,14 @@ class ListOfStoreActors(PaginationResponse):
         alias_generator=to_camel,
     )
     items: list[StoreListActor]
-    # Scrapely's store envelope omits `desc` and `count`; tolerate their absence.
     desc: Annotated[bool, Field(examples=[False])] = False
+    """
+    Whether the results are sorted in descending order. The store listing may omit it.
+    """
     count: Annotated[int, Field(examples=[1], ge=0)] = 0
+    """
+    The number of items returned in this response. The store listing may omit it.
+    """
 
 
 @docs_group('Models')
@@ -2285,7 +2292,9 @@ class Profile(BaseModel):
     )
     bio: Annotated[str | None, Field(examples=['I started web scraping in 1985 using Altair BASIC.'])] = None
     name: Annotated[str | None, Field(examples=['Jane Doe'])] = None
-    picture_url: Annotated[AnyUrl | None, Field(examples=['https://api.scrape.ly/img/anonymous_user_picture.png'])] = None
+    picture_url: Annotated[AnyUrl | None, Field(examples=['https://api.scrape.ly/img/anonymous_user_picture.png'])] = (
+        None
+    )
     github_username: Annotated[str | None, Field(examples=['torvalds.'])] = None
     website_url: Annotated[AnyUrl | None, Field(examples=['http://www.example.com'])] = None
     twitter_username: Annotated[str | None, Field(examples=['@BillGates'])] = None
@@ -3414,7 +3423,7 @@ class Storages(BaseModel):
     )
     dataset: dict[str, Any] | None = None
     """
-    Defines the schema of items in your dataset, the full specification can be found in the upstream API docs
+    Defines the schema of items in your dataset.
     """
 
 
@@ -3426,8 +3435,10 @@ class StoreListActor(BaseModel):
         alias_generator=to_camel,
     )
     id: Annotated[str, Field(examples=['zdc3Pyhyz3m8vjDeM'])]
-    # Scrapely can return null titles; tolerate their absence.
     title: Annotated[str | None, Field(examples=['My Public Actor'])] = None
+    """
+    Scrapely can return a `null` title.
+    """
     name: Annotated[str, Field(examples=['my-public-actor'])]
     username: Annotated[str, Field(examples=['jane35'])]
     user_full_name: Annotated[str | None, Field(examples=['Jane H. Doe'])] = None
@@ -3752,7 +3763,7 @@ class UpdateLimitsRequest(BaseModel):
     """
     data_retention_days: Annotated[int | None, Field(examples=[90])] = None
     """
-    How many days unnamed storages (datasets, key-value stores and request queues without a name) are kept: Free 2 days (48 hours), Starter 31, Scale 60, Business 90. Runs follow their own retention: on the Free plan the latest 10 runs per Actor are kept and older ones are deleted after 7 days; on paid plans runs are deleted after 31 days. This value is set by your plan and cannot be changed through the API.
+    How many days unnamed storages (datasets, key-value stores and request queues without a name) are kept: Free 2 days (48 hours), Starter 31, Scale 60, Business 90. Runs and their logs are kept for the same time as their results; on the Free plan your latest 10 runs are kept with their results until you delete them. This value is set by your plan and cannot be changed through the API.
 
     """
 
@@ -3800,7 +3811,11 @@ class UpdateRunRequest(BaseModel):
 
 @docs_group('Models')
 class UpdateStoreRequest(UpdateDatasetRequest):
-    pass
+    model_config = ConfigDict(
+        extra='allow',
+        populate_by_name=True,
+        alias_generator=to_camel,
+    )
 
 
 @docs_group('Models')
@@ -3909,7 +3924,9 @@ class Version(BaseModel):
         populate_by_name=True,
         alias_generator=to_camel,
     )
-    version_number: Annotated[str, Field(examples=['0.0'], pattern='^([0-9]|[1-9][0-9])\\.([0-9]|[1-9][0-9])(\\.[0-9]+)?$')]
+    version_number: Annotated[
+        str, Field(examples=['0.0'], pattern='^([0-9]|[1-9][0-9])\\.([0-9]|[1-9][0-9])(\\.[0-9]+)?$')
+    ]
     """
     The version number of the Actor. `MAJOR.MINOR` or `MAJOR.MINOR.PATCH` (Scrapely staging uses triplets like `0.0.1`).
     """
@@ -4037,7 +4054,11 @@ class WebhookDispatch(BaseModel):
 
 @docs_group('Models')
 class WebhookDispatchResponse(TestWebhookResponse):
-    pass
+    model_config = ConfigDict(
+        extra='allow',
+        populate_by_name=True,
+        alias_generator=to_camel,
+    )
 
 
 @docs_group('Models')

scrapely_client/_resource_clients/_resource_client.py

@@ -13,7 +13,7 @@ from scrapely_client._consts import DEFAULT_WAIT_FOR_FINISH, DEFAULT_WAIT_WHEN_J
 from scrapely_client._docs import docs_group
 from scrapely_client._logging import WithLogDetailsClient
 from scrapely_client._utils.errors import catch_not_found_for_resource_or_throw, catch_not_found_or_throw
-from scrapely_client._utils.http import response_to_dict, to_safe_id
+from scrapely_client._utils.http import response_to_dict, to_path_segment, to_safe_id
 from scrapely_client._utils.time import to_seconds
 from scrapely_client.errors import ApifyApiError
 
@@ -77,7 +77,8 @@ class ResourceClientBase(metaclass=WithLogDetailsClient):
         """Build the full resource URL from base URL, path, and optional ID."""
         url = f'{self._base_url}/{self._resource_path}'
         if self._resource_id is not None:
-            url = f'{url}/{to_safe_id(self._resource_id)}'
+            # One path segment whatever the id holds: `..`, `?` or `#` must not retarget the call.
+            url = f'{url}/{to_path_segment(to_safe_id(self._resource_id))}'
         return url
 
     @cached_property

scrapely_client/_resource_clients/automation.py

@@ -3,12 +3,11 @@
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
-from urllib.parse import quote
 
 from scrapely_client._docs import docs_group
 from scrapely_client._resource_clients._resource_client import ResourceClient, ResourceClientAsync
 from scrapely_client._utils.errors import catch_not_found_or_throw
-from scrapely_client._utils.http import response_to_dict
+from scrapely_client._utils.http import response_to_dict, to_path_segment
 from scrapely_client.errors import ApifyApiError
 
 if TYPE_CHECKING:
@@ -134,7 +133,7 @@ class AutomationClient(ResourceClient):
         """
         try:
             response = self._http_client.call(
-                url=self._build_url(f'runs/{quote(run_id, safe="")}'),
+                url=self._build_url(f'runs/{to_path_segment(run_id)}'),
                 method='GET',
                 params=self._build_params(),
                 timeout=timeout,
@@ -290,7 +289,7 @@ class AutomationClientAsync(ResourceClientAsync):
         """
         try:
             response = await self._http_client.call(
-                url=self._build_url(f'runs/{quote(run_id, safe="")}'),
+                url=self._build_url(f'runs/{to_path_segment(run_id)}'),
                 method='GET',
                 params=self._build_params(),
                 timeout=timeout,

scrapely_client/_resource_clients/request_queue.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import asyncio
 import json
 import math
+import re
 from collections.abc import Iterable
 from queue import Queue
 from typing import TYPE_CHECKING, Any, Literal
@@ -40,7 +41,7 @@ from scrapely_client._models import (
 from scrapely_client._pagination import DEFAULT_CHUNK_SIZE, get_cursor_iterator, get_cursor_iterator_async
 from scrapely_client._resource_clients._resource_client import ResourceClient, ResourceClientAsync
 from scrapely_client._utils.errors import catch_not_found_or_throw
-from scrapely_client._utils.http import response_to_dict
+from scrapely_client._utils.http import response_to_dict, to_path_segment
 from scrapely_client._utils.time import to_seconds
 from scrapely_client.errors import ApifyApiError
 
@@ -68,6 +69,32 @@ _MAX_PAYLOAD_SIZE_BYTES = 9 * 1024 * 1024
 _SAFETY_BUFFER_PERCENT = 0.01 / 100
 """Safety margin (0.01%) deducted from the maximum payload size when splitting requests into batches."""
 
+_REQUEST_ID_PATTERN = re.compile(r'[A-Za-z0-9_~-]{1,128}')
+"""Request ids the API accepts: letters, digits, `-`, `_` and `~`, at most 128 characters."""
+
+
+def _request_path(request_id: str, suffix: str = '') -> str:
+    """Build the path of one request, with the id percent-encoded as a single path segment.
+
+    Request ids can come from queue contents written by someone else. Unencoded, an id such as `..`,
+    `../../key-value-stores/<id>/records/INPUT` or `a?b` would point the authenticated call at another resource.
+    """
+    if not isinstance(request_id, str):
+        raise TypeError(f'Request id must be a string, not {type(request_id).__name__}.')
+    return f'requests/{to_path_segment(request_id)}{suffix}'
+
+
+def _stored_request_id(request: Request) -> str:
+    """Return the id of a request passed to `update_request`, after checking it against the API's id grammar."""
+    request_id = request.id
+    if request_id is None:
+        raise ValueError('The request has no id. update_request needs the id of a request stored in the queue.')
+    if not isinstance(request_id, str) or not _REQUEST_ID_PATTERN.fullmatch(request_id):
+        raise ValueError(
+            f'Invalid request id {request_id!r}: use 1-128 letters, digits, "-", "_" or "~", as returned by the API.'
+        )
+    return request_id
+
 
 def _serialize_requests(
     requests: list[RequestDraft] | list[RequestDraftDict] | list[RequestDraftCamelDict],
@@ -270,7 +297,7 @@ class RequestQueueClient(ResourceClient):
         """
         try:
             response = self._http_client.call(
-                url=self._build_url(f'requests/{request_id}'),
+                url=self._build_url(_request_path(request_id)),
                 method='GET',
                 params=self._build_params(),
                 timeout=timeout,
@@ -303,11 +330,12 @@ class RequestQueueClient(ResourceClient):
         """
         if not isinstance(request, Request):
             request = Request.model_validate(request)
+        request_id = _stored_request_id(request)
 
         request_params = self._build_params(forefront=forefront, clientKey=self.client_key)
 
         response = self._http_client.call(
-            url=self._build_url(f'requests/{request.id}'),
+            url=self._build_url(_request_path(request_id)),
             method='PUT',
             json=request.model_dump(by_alias=True, exclude_none=True),
             params=request_params,
@@ -330,7 +358,7 @@ class RequestQueueClient(ResourceClient):
         )
 
         self._http_client.call(
-            url=self._build_url(f'requests/{request_id}'),
+            url=self._build_url(_request_path(request_id)),
             method='DELETE',
             params=request_params,
             timeout=timeout,
@@ -360,7 +388,7 @@ class RequestQueueClient(ResourceClient):
         )
 
         response = self._http_client.call(
-            url=self._build_url(f'requests/{request_id}/lock'),
+            url=self._build_url(_request_path(request_id, '/lock')),
             method='PUT',
             params=request_params,
             timeout=timeout,
@@ -387,7 +415,7 @@ class RequestQueueClient(ResourceClient):
         request_params = self._build_params(clientKey=self.client_key, forefront=forefront)
 
         self._http_client.call(
-            url=self._build_url(f'requests/{request_id}/lock'),
+            url=self._build_url(_request_path(request_id, '/lock')),
             method='DELETE',
             params=request_params,
             timeout=timeout,
@@ -781,7 +809,7 @@ class RequestQueueClientAsync(ResourceClientAsync):
         """
         try:
             response = await self._http_client.call(
-                url=self._build_url(f'requests/{request_id}'),
+                url=self._build_url(_request_path(request_id)),
                 method='GET',
                 params=self._build_params(),
                 timeout=timeout,
@@ -812,11 +840,12 @@ class RequestQueueClientAsync(ResourceClientAsync):
         """
         if not isinstance(request, Request):
             request = Request.model_validate(request)
+        request_id = _stored_request_id(request)
 
         request_params = self._build_params(forefront=forefront, clientKey=self.client_key)
 
         response = await self._http_client.call(
-            url=self._build_url(f'requests/{request.id}'),
+            url=self._build_url(_request_path(request_id)),
             method='PUT',
             json=request.model_dump(by_alias=True, exclude_none=True),
             params=request_params,
@@ -837,7 +866,7 @@ class RequestQueueClientAsync(ResourceClientAsync):
         request_params = self._build_params(clientKey=self.client_key)
 
         await self._http_client.call(
-            url=self._build_url(f'requests/{request_id}'),
+            url=self._build_url(_request_path(request_id)),
             method='DELETE',
             params=request_params,
             timeout=timeout,
@@ -867,7 +896,7 @@ class RequestQueueClientAsync(ResourceClientAsync):
         )
 
         response = await self._http_client.call(
-            url=self._build_url(f'requests/{request_id}/lock'),
+            url=self._build_url(_request_path(request_id, '/lock')),
             method='PUT',
             params=request_params,
             timeout=timeout,
@@ -894,7 +923,7 @@ class RequestQueueClientAsync(ResourceClientAsync):
         request_params = self._build_params(clientKey=self.client_key, forefront=forefront)
 
         await self._http_client.call(
-            url=self._build_url(f'requests/{request_id}/lock'),
+            url=self._build_url(_request_path(request_id, '/lock')),
             method='DELETE',
             params=request_params,
             timeout=timeout,

scrapely_client/_scrapely_client.py

@@ -2,12 +2,14 @@
 # Modified by TeraShift GmbH. See the LICENSE and NOTICE files.
 from __future__ import annotations
 
+import os
 from functools import cached_property
 from typing import TYPE_CHECKING
 
 from scrapely_client._charging import ChargingHooks, wrap_dataset_client_with_charging
 from scrapely_client._client_registry import ClientRegistry, ClientRegistryAsync
 from scrapely_client._consts import (
+    API_URL_ENV_VAR,
     API_VERSION,
     DEFAULT_API_URL,
     DEFAULT_MAX_RETRIES,
@@ -90,6 +92,13 @@ if TYPE_CHECKING:
     from scrapely_client.types import HttpCompressionAlgorithm
 
 
+def _resolve_api_url(api_url: str | None) -> str:
+    """Return `api_url` if given, else the `SCRAPELY_API_URL` environment variable, else the production API."""
+    if api_url is not None:
+        return api_url
+    return os.environ.get(API_URL_ENV_VAR, '').strip() or DEFAULT_API_URL
+
+
 @docs_group('Scrapely API clients')
 class ApifyClient:
     """Synchronous client for the Scrapely API.
@@ -124,7 +133,7 @@ class ApifyClient:
         self,
         token: str | None = None,
         *,
-        api_url: str = DEFAULT_API_URL,
+        api_url: str | None = None,
         api_public_url: str | None = DEFAULT_API_URL,
         max_retries: int = DEFAULT_MAX_RETRIES,
         min_delay_between_retries: timedelta = DEFAULT_MIN_DELAY_BETWEEN_RETRIES,
@@ -144,9 +153,9 @@ class ApifyClient:
         Args:
             token: The Scrapely API token. You can find your token on the
                 Integrations page in the Scrapely dashboard.
-            api_url: The URL of the Scrapely API server to connect to. Defaults to https://api.scrape.ly. It can
-                be an internal URL that is not globally accessible, in which case `api_public_url` should be set
-                as well.
+            api_url: The URL of the Scrapely API server to connect to. When not given, the `SCRAPELY_API_URL`
+                environment variable is used, then https://api.scrape.ly. It can be an internal URL that is not
+                globally accessible, in which case `api_public_url` should be set as well.
             api_public_url: The globally accessible URL of the Scrapely API server. Should be set only if `api_url`
                 is an internal URL that is not globally accessible. Defaults to https://api.scrape.ly.
             max_retries: How many times to retry a failed request at most.
@@ -165,7 +174,7 @@ class ApifyClient:
             default_dataset_id: ID of the actor run's default dataset, used to gate charging interception.
         """
         # We need to do this because of mocking in tests and default mutable arguments.
-        api_url = DEFAULT_API_URL if api_url is None else api_url
+        api_url = _resolve_api_url(api_url)
         api_public_url = DEFAULT_API_URL if api_public_url is None else api_public_url
 
         if headers:
@@ -234,7 +243,7 @@ class ApifyClient:
         cls,
         token: str | None = None,
         *,
-        api_url: str = DEFAULT_API_URL,
+        api_url: str | None = None,
         api_public_url: str | None = DEFAULT_API_URL,
         http_client: HttpClient,
     ) -> ApifyClient:
@@ -263,7 +272,8 @@ class ApifyClient:
         Args:
             token: The Scrapely API token. It is set as the `Authorization` header on the custom client,
                 unless the client already has one configured.
-            api_url: The URL of the Scrapely API server to connect to. Defaults to https://api.scrape.ly.
+            api_url: The URL of the Scrapely API server to connect to. When not given, the `SCRAPELY_API_URL`
+                environment variable is used, then https://api.scrape.ly.
             api_public_url: The globally accessible URL of the Scrapely API server. Defaults to https://api.scrape.ly.
             http_client: A custom HTTP client instance extending `HttpClient`.
         """
@@ -513,7 +523,7 @@ class ApifyClientAsync:
         self,
         token: str | None = None,
         *,
-        api_url: str = DEFAULT_API_URL,
+        api_url: str | None = None,
         api_public_url: str | None = DEFAULT_API_URL,
         max_retries: int = DEFAULT_MAX_RETRIES,
         min_delay_between_retries: timedelta = DEFAULT_MIN_DELAY_BETWEEN_RETRIES,
@@ -533,9 +543,9 @@ class ApifyClientAsync:
         Args:
             token: The Scrapely API token. You can find your token on the
                 Integrations page in the Scrapely dashboard.
-            api_url: The URL of the Scrapely API server to connect to. Defaults to https://api.scrape.ly. It can
-                be an internal URL that is not globally accessible, in which case `api_public_url` should be set
-                as well.
+            api_url: The URL of the Scrapely API server to connect to. When not given, the `SCRAPELY_API_URL`
+                environment variable is used, then https://api.scrape.ly. It can be an internal URL that is not
+                globally accessible, in which case `api_public_url` should be set as well.
             api_public_url: The globally accessible URL of the Scrapely API server. Should be set only if `api_url`
                 is an internal URL that is not globally accessible. Defaults to https://api.scrape.ly.
             max_retries: How many times to retry a failed request at most.
@@ -554,7 +564,7 @@ class ApifyClientAsync:
             default_dataset_id: ID of the actor run's default dataset, used to gate charging interception.
         """
         # We need to do this because of mocking in tests and default mutable arguments.
-        api_url = DEFAULT_API_URL if api_url is None else api_url
+        api_url = _resolve_api_url(api_url)
         api_public_url = DEFAULT_API_URL if api_public_url is None else api_public_url
 
         if headers:
@@ -623,7 +633,7 @@ class ApifyClientAsync:
         cls,
         token: str | None = None,
         *,
-        api_url: str = DEFAULT_API_URL,
+        api_url: str | None = None,
         api_public_url: str | None = DEFAULT_API_URL,
         http_client: HttpClientAsync,
     ) -> ApifyClientAsync:
@@ -652,7 +662,8 @@ class ApifyClientAsync:
         Args:
             token: The Scrapely API token. It is set as the `Authorization` header on the custom client,
                 unless the client already has one configured.
-            api_url: The URL of the Scrapely API server to connect to. Defaults to https://api.scrape.ly.
+            api_url: The URL of the Scrapely API server to connect to. When not given, the `SCRAPELY_API_URL`
+                environment variable is used, then https://api.scrape.ly.
             api_public_url: The globally accessible URL of the Scrapely API server. Defaults to https://api.scrape.ly.
             http_client: A custom HTTP client instance extending `HttpClientAsync`.
         """

{scrapely_client_python-1.0.7.dist-info → scrapely_client_python-1.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrapely-client-python
-Version: 1.0.7
+Version: 1.0.9
 Summary: Scrapely API client for Python
 Keywords: scrapely,api,client,automation,crawling,scraping
 Author: TeraShift GmbH (Scrape.ly)
@@ -94,6 +94,8 @@ Description-Content-Type: text/markdown
 
 You'll need a Scrapely API token — find yours in the integrations section of the Scrapely dashboard. Pass it to the client and you're ready to go.
 
+The client sends requests to `https://api.scrape.ly` unless you pass another API origin as `api_url`. When `api_url` is not given, the `SCRAPELY_API_URL` environment variable sets it (for example `SCRAPELY_API_URL=https://api-staging.scrape.ly`). `api_public_url`, used for public storage links, keeps its own argument and default. The client does not read the token from the environment.
+
 ### Synchronous client
 
 ```python
@@ -190,6 +192,21 @@ for item in client.dataset('DATASET-ID').iterate_items(fields=['title', 'url']):
     process(item)
 ```
 
+### Create and run an automation
+
+```python
+automation = client.automations().create({
+    'title': 'Daily dentists',
+    'trigger': {'kind': 'schedule', 'cron': '0 9 * * *', 'timezone': 'Europe/Berlin'},
+    'steps': [{'kind': 'savedInput', 'savedInputId': 'SAVED-INPUT-ID'}],
+    'ai': {'mode': 'summarize', 'prompt': 'List the new practices with their phone numbers.'},
+    'deliveries': [{'channel': 'email'}],
+})
+run = client.automation(automation['id']).run()
+```
+
+Automations take and return the API's camelCase dictionaries (see the automations section of the API reference).
+
 ### Tune retries and timeouts
 
 ```python

{scrapely_client_python-1.0.7.dist-info → scrapely_client_python-1.0.9.dist-info}/RECORD

@@ -1,21 +1,21 @@
 scrapely_client/__init__.py,sha256=Fu2-Un-vv1wGjqG3QyxDkbxMOmg6kfwdDBQ0yPGFm2M,879
 scrapely_client/_charging.py,sha256=L7vvpX9bj0UwHc-83_zFpfcGyrMlbzoB_EpE9iSH2zM,6807
 scrapely_client/_client_registry.py,sha256=FXqW7wYdHaFUjrtugXkh9IORzazzxGQssHOgtudj8Jc,5588
-scrapely_client/_consts.py,sha256=Eh9KdIKY1yeFjT0GGMg8AZASa6ed9VjbzVtpgrNU1Ak,3537
+scrapely_client/_consts.py,sha256=zfGGi17JdkNR23W8hQinwbm81wXg_H_Pw1C_mpMMhWc,3668
 scrapely_client/_docs.py,sha256=MtrntqA7S0BDKzJlZzBAfqeI2bUtybwcb85JfP9vaDA,1117
 scrapely_client/_literals.py,sha256=qSc0qIjhcI7qa42fNQ-IGPm_7cpCI9_OaQ6oYGIOdy4,17006
 scrapely_client/_logging.py,sha256=7yZ2GE8zv9M5r5IdmPB_jiAPy-fJN_kYSWQ2UwXu6p8,6780
-scrapely_client/_models.py,sha256=-aYSNKIxRrO60Y80HbHnBvjNktEbNzmO8wsdNtP_GHM,142629
+scrapely_client/_models.py,sha256=fQ7WQQpXp5f-8_RiXG7Un2JVDBdO4_rQFUIP5-DewpM,142909
 scrapely_client/_pagination.py,sha256=by-2FLNUQquXfxgr2mJVCgOqBBZRYMJpmTjfy4aWfpE,8579
 scrapely_client/_resource_clients/__init__.py,sha256=cy_gBIqs8m7UpnKToffNad2zX2Su8We5B_q5IDM879M,4016
-scrapely_client/_resource_clients/_resource_client.py,sha256=0-QqVXamPbX4HX5cVoMQaTAw8ws4fGPYwY_-SJgReyM,21599
+scrapely_client/_resource_clients/_resource_client.py,sha256=b22QuV7osKBor62RsFWMOMKoyevUAY9PY2JrirxrWA8,21732
 scrapely_client/_resource_clients/actor.py,sha256=9aJipoTI8BBYg1NZcHKuDQASatHe3XsUqKwtmNGSHkI,46153
 scrapely_client/_resource_clients/actor_collection.py,sha256=LynOa8R-sTogMVN6jVl2mDW4xmw4a1IZ35Hv8gHX71c,16966
 scrapely_client/_resource_clients/actor_env_var.py,sha256=dWKE_5xqhjQwCiNPNRXiyCw6g0GcUq1DxUR6Nd1JrRs,4810
 scrapely_client/_resource_clients/actor_env_var_collection.py,sha256=1Ueh_QYHbIS1Ztl7X9ZpIMglFND1U8Nmw08u0Z4ERrs,5675
 scrapely_client/_resource_clients/actor_version.py,sha256=Qo8ztYWuKg6nPBKiOiCXuIBbaiTTrH5DfLEDZjQj-mE,10232
 scrapely_client/_resource_clients/actor_version_collection.py,sha256=GtiB_UV_D7E3bpBlLhiudIRZ31lN78GoYpzTn4HjOo8,9712
-scrapely_client/_resource_clients/automation.py,sha256=JOKLZcXrRbAIowg2J0jdtkG30URkYLGWtA0_-4VGiJM,11313
+scrapely_client/_resource_clients/automation.py,sha256=5dzATC-ZNsbfYUgvBxPadDtIDVNOuDc5yaI1AIRdPP0,11301
 scrapely_client/_resource_clients/automation_collection.py,sha256=0AOWLE3wuAlD1oWywEAfXBsnClLHs_IQ3l4Hi28ibac,5592
 scrapely_client/_resource_clients/build.py,sha256=Bp2OTcil31OunorPKnw6CIc9K0ZlnYLStaNENtPkq1Y,7805
 scrapely_client/_resource_clients/build_collection.py,sha256=TAuG4H46n6HIIntjg4tWiKqiDOgIUao5LX95xWjExwc,5766
@@ -24,7 +24,7 @@ scrapely_client/_resource_clients/dataset_collection.py,sha256=3IGH7B12agw1kHPhz
 scrapely_client/_resource_clients/key_value_store.py,sha256=Fthku9RWqCGjBwvuvdUiiT6YpvlOLNQDYsu4VMMEmSU,32673
 scrapely_client/_resource_clients/key_value_store_collection.py,sha256=D9XPMI7DVdAB1rPK-VKbeY1_JNxSajyPxJIhTTcCT0g,9279
 scrapely_client/_resource_clients/log.py,sha256=XBuJRpUvBKfVhFypMFE0Wowpv5VOg2fs57PDkJEVaEQ,7491
-scrapely_client/_resource_clients/request_queue.py,sha256=Oq680wT057dLMEHBqCEWVOoTIXiz6_ri-1vagcgfhKw,41047
+scrapely_client/_resource_clients/request_queue.py,sha256=ajPrm2uAjjMiAUlsie4D6o9rLb6J1H9fhOdKxXiLJCQ,42518
 scrapely_client/_resource_clients/request_queue_collection.py,sha256=wAX3bODdo5ozDXkeZ-HHUmTJdPxAj-xr3H6PKBNjkPE,8983
 scrapely_client/_resource_clients/run.py,sha256=Xu-Xldw4wqDeg8pGAn1VIEOyQahaA9spZUykCdsZcW8,32219
 scrapely_client/_resource_clients/run_collection.py,sha256=tU-UX1W_mYD7tRfL9S2YHU4oxZXUSZ6Z9mNwuX-sc64,8441
@@ -38,7 +38,7 @@ scrapely_client/_resource_clients/webhook.py,sha256=bZNla1cNM508EQL8zPe-7vgvfsCf
 scrapely_client/_resource_clients/webhook_collection.py,sha256=-1LYc4upqSonEJdLVEldMvaV3Wi38EaL-Lzd9cmlAbQ,11351
 scrapely_client/_resource_clients/webhook_dispatch.py,sha256=ylrPUHHH-0UlF6htefV2tceHGB3w3WdrZpjKLD1oyec,2660
 scrapely_client/_resource_clients/webhook_dispatch_collection.py,sha256=RZXnczm6UKxnqDWmDYBvwyusp1_h1ONJMB7uCsBHg6E,5949
-scrapely_client/_scrapely_client.py,sha256=N0JNmFq279IzP57uWmzIUikpsDeqOYgALFcDAf2wjSs,38026
+scrapely_client/_scrapely_client.py,sha256=1h03mj75oLpQGw_gIZeZrNk7_8PwQTTxzAPaQr4RxWo,38566
 scrapely_client/_statistics.py,sha256=mTsUFVByduYFPoHocZULv53k5dYg77Bl03wamQD6Jyc,903
 scrapely_client/_status_message_watcher.py,sha256=9Tstosbk_bUoq5K9xkhRQ5PBqsFaJFtvsGsAU0OvLjY,7893
 scrapely_client/_streamed_log.py,sha256=OaxB5-ghZX1DYuZmjNCgVeHAH0fYPReqjQlWaa8-dVA,11659
@@ -61,8 +61,8 @@ scrapely_client/http_compressors/_gzip.py,sha256=IJHZ87B5L1nrnXNFf1PjsYf-1MIIp9G
 scrapely_client/http_compressors/_resolve.py,sha256=AfIUzwX-ExczMgMQNAhfPd4CKAVKhIGq697bUm9i62k,1653
 scrapely_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 scrapely_client/types.py,sha256=Wnb9-GBN6OcQGfiDk18TJjIzvHXb5MHrjJaIce-2UzY,2215
-scrapely_client_python-1.0.7.dist-info/licenses/LICENSE,sha256=AsFjHssKjj4LGd2ZCqXn6FBzMqcWdjQre1byPPSypVw,11355
-scrapely_client_python-1.0.7.dist-info/licenses/NOTICE,sha256=0Seguz6wGdTod6Rld--Q4nHcmVqZF56Q_Atbh4YFEts,337
-scrapely_client_python-1.0.7.dist-info/WHEEL,sha256=zu8uUFWL0UT0x0NoMBJVVLAJ_uDxaBfwXEMuxyhQJSE,80
-scrapely_client_python-1.0.7.dist-info/METADATA,sha256=6-iIkl4y4ND_JW8MlUhDl_iR5tIpdT9CvGQK_Abi5YU,10554
-scrapely_client_python-1.0.7.dist-info/RECORD,,
+scrapely_client_python-1.0.9.dist-info/licenses/LICENSE,sha256=AsFjHssKjj4LGd2ZCqXn6FBzMqcWdjQre1byPPSypVw,11355
+scrapely_client_python-1.0.9.dist-info/licenses/NOTICE,sha256=0Seguz6wGdTod6Rld--Q4nHcmVqZF56Q_Atbh4YFEts,337
+scrapely_client_python-1.0.9.dist-info/WHEEL,sha256=si2p8vW03RnhyBnhWl4tj-ObJa78SpE-c9HsEtblGR0,80
+scrapely_client_python-1.0.9.dist-info/METADATA,sha256=RHU05F0ObBU5UuLh3jNzgKAE5_NY8bENCfejeNuW0fI,11529
+scrapely_client_python-1.0.9.dist-info/RECORD,,

{scrapely_client_python-1.0.7.dist-info → scrapely_client_python-1.0.9.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.13.3
+Generator: uv 0.13.5
 Root-Is-Purelib: true
 Tag: py3-none-any