prefect-client 3.0.11__tar.gz → 3.1.0__tar.gz

{prefect-client-3.0.11/src/prefect_client.egg-info → prefect-client-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: prefect-client
-Version: 3.0.11
+Version: 3.1.0
 Summary: Workflow orchestration and management.
 Home-page: https://www.prefect.io
 Author: Prefect Technologies, Inc.

{prefect-client-3.0.11 → prefect-client-3.1.0}/requirements-client.txt

@@ -3,7 +3,7 @@ asgi-lifespan >= 1.0, < 3.0
 cachetools >= 5.3, < 6.0
 cloudpickle >= 2.0, < 4.0
 coolname >= 1.0.4, < 3.0.0
-croniter >= 1.0.12, < 4.0.0
+croniter >= 1.0.12, < 5.0.0
 exceptiongroup >= 1.0.0
 fastapi >= 0.111.0, < 1.0.0
 fsspec >= 2022.5.0

{prefect-client-3.0.11 → prefect-client-3.1.0}/requirements-dev.txt

@@ -12,7 +12,6 @@ pluggy >= 1.4.0
 pytest >= 8.3
 pytest-asyncio >= 0.24
 pytest-benchmark
-pytest-codspeed
 pytest-cov
 pytest-env
 pytest-flakefinder

{prefect-client-3.0.11 → prefect-client-3.1.0}/requirements.txt

@@ -12,6 +12,7 @@ graphviz >= 0.20.1
 jinja2 >= 3.0.0, < 4.0.0
 jinja2-humanize-extension >= 0.4.0
 humanize >= 4.9.0, < 5.0.0
+opentelemetry-api >= 1.27.0, < 2.0.0
 pytz >= 2021.1, < 2025
 readchar >= 4.0.0, < 5.0.0
 sqlalchemy[asyncio] >= 2.0, < 3.0.0

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2024-10-24T17:36:06-0500",
+ "date": "2024-10-31T12:43:46-0700",
  "dirty": true,
  "error": null,
- "full-revisionid": "a17ccfcf2be76360f13806d7aca1e2cf9fa3741e",
- "version": "3.0.11"
+ "full-revisionid": "a83ba39b095e5945140ab6313e39dbc56056afe1",
+ "version": "3.1.0"
 }
 '''  # END VERSION_JSON
 

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/cache_policies.py

@@ -175,7 +175,7 @@ class CompoundCachePolicy(CachePolicy):
                 keys.append(policy_key)
         if not keys:
             return None
-        return hash_objects(*keys)
+        return hash_objects(*keys, raise_on_failure=True)
 
 
 @dataclass
@@ -224,7 +224,7 @@ class TaskSource(CachePolicy):
             else:
                 raise
 
-        return hash_objects(lines)
+        return hash_objects(lines, raise_on_failure=True)
 
 
 @dataclass
@@ -242,7 +242,7 @@ class FlowParameters(CachePolicy):
     ) -> Optional[str]:
         if not flow_parameters:
             return None
-        return hash_objects(flow_parameters)
+        return hash_objects(flow_parameters, raise_on_failure=True)
 
 
 @dataclass
@@ -293,7 +293,7 @@ class Inputs(CachePolicy):
             if key not in exclude:
                 hashed_inputs[key] = val
 
-        return hash_objects(hashed_inputs)
+        return hash_objects(hashed_inputs, raise_on_failure=True)
 
     def __sub__(self, other: str) -> "CachePolicy":
         if not isinstance(other, str):

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/client/orchestration.py

@@ -134,6 +134,7 @@ from prefect.settings import (
     PREFECT_CLOUD_API_URL,
     PREFECT_SERVER_ALLOW_EPHEMERAL_MODE,
     PREFECT_TESTING_UNIT_TEST_MODE,
+    get_current_settings,
 )
 
 if TYPE_CHECKING:
@@ -2594,22 +2595,43 @@ class PrefectClient:
         work_pool_name: str,
         worker_name: str,
         heartbeat_interval_seconds: Optional[float] = None,
-    ):
+        get_worker_id: bool = False,
+    ) -> Optional[UUID]:
         """
         Sends a worker heartbeat for a given work pool.
 
         Args:
             work_pool_name: The name of the work pool to heartbeat against.
             worker_name: The name of the worker sending the heartbeat.
+            return_id: Whether to return the worker ID. Note: will return `None` if the connected server does not support returning worker IDs, even if `return_id` is `True`.
         """
-        await self._client.post(
+
+        if get_worker_id:
+            return_dict = {"return_id": get_worker_id}
+        else:
+            return_dict = {}
+
+        resp = await self._client.post(
             f"/work_pools/{work_pool_name}/workers/heartbeat",
             json={
                 "name": worker_name,
                 "heartbeat_interval_seconds": heartbeat_interval_seconds,
-            },
+            }
+            | return_dict,
         )
 
+        if (
+            (
+                self.server_type == ServerType.CLOUD
+                or get_current_settings().testing.test_mode
+            )
+            and get_worker_id
+            and resp.status_code == 200
+        ):
+            return UUID(resp.text)
+        else:
+            return None
+
     async def read_workers_for_work_pool(
         self,
         work_pool_name: str,

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/client/schemas/actions.py

@@ -85,18 +85,10 @@ class DeploymentScheduleCreate(ActionBaseModel):
     active: bool = Field(
         default=True, description="Whether or not the schedule is active."
     )
-    max_active_runs: Optional[PositiveInteger] = Field(
-        default=None,
-        description="The maximum number of active runs for the schedule.",
-    )
     max_scheduled_runs: Optional[PositiveInteger] = Field(
         default=None,
         description="The maximum number of scheduled runs for the schedule.",
     )
-    catchup: bool = Field(
-        default=False,
-        description="Whether or not a worker should catch up on Late runs for the schedule.",
-    )
 
     @field_validator("max_scheduled_runs")
     @classmethod
@@ -114,21 +106,11 @@ class DeploymentScheduleUpdate(ActionBaseModel):
         default=True, description="Whether or not the schedule is active."
     )
 
-    max_active_runs: Optional[PositiveInteger] = Field(
-        default=None,
-        description="The maximum number of active runs for the schedule.",
-    )
-
     max_scheduled_runs: Optional[PositiveInteger] = Field(
         default=None,
         description="The maximum number of scheduled runs for the schedule.",
     )
 
-    catchup: Optional[bool] = Field(
-        default=None,
-        description="Whether or not a worker should catch up on Late runs for the schedule.",
-    )
-
     @field_validator("max_scheduled_runs")
     @classmethod
     def validate_max_scheduled_runs(cls, v):
@@ -580,6 +562,17 @@ class LogCreate(ActionBaseModel):
     timestamp: DateTime = Field(default=..., description="The log timestamp.")
     flow_run_id: Optional[UUID] = Field(None)
     task_run_id: Optional[UUID] = Field(None)
+    worker_id: Optional[UUID] = Field(None)
+
+    def model_dump(self, *args, **kwargs):
+        """
+        The worker_id field is only included in logs sent to Prefect Cloud.
+        If it's unset, we should not include it in the log payload.
+        """
+        data = super().model_dump(*args, **kwargs)
+        if self.worker_id is None:
+            data.pop("worker_id")
+        return data
 
 
 class WorkPoolCreate(ActionBaseModel):

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/client/schemas/objects.py

@@ -32,6 +32,7 @@ from pydantic.functional_validators import ModelWrapValidatorHandler
 from pydantic_extra_types.pendulum_dt import DateTime
 from typing_extensions import Literal, Self, TypeVar
 
+from prefect._internal.compatibility import deprecated
 from prefect._internal.compatibility.migration import getattr_migration
 from prefect._internal.schemas.bases import ObjectBaseModel, PrefectBaseModel
 from prefect._internal.schemas.fields import CreatedBy, UpdatedBy
@@ -186,7 +187,7 @@ class StateDetails(PrefectBaseModel):
 
 
 def data_discriminator(x: Any) -> str:
-    if isinstance(x, dict) and "type" in x:
+    if isinstance(x, dict) and "type" in x and x["type"] != "unpersisted":
         return "BaseResult"
     elif isinstance(x, dict) and "storage_key" in x:
         return "ResultRecordMetadata"
@@ -220,10 +221,17 @@ class State(ObjectBaseModel, Generic[R]):
     def result(self: "State[R]", raise_on_failure: bool = False) -> Union[R, Exception]:
         ...
 
+    @deprecated.deprecated_parameter(
+        "fetch",
+        when=lambda fetch: fetch is not True,
+        start_date="Oct 2024",
+        end_date="Jan 2025",
+        help="Please ensure you are awaiting the call to `result()` when calling in an async context.",
+    )
     def result(
         self,
         raise_on_failure: bool = True,
-        fetch: Optional[bool] = None,
+        fetch: bool = True,
         retry_result_failure: bool = True,
     ) -> Union[R, Exception]:
         """
@@ -248,22 +256,6 @@ class State(ObjectBaseModel, Generic[R]):
             The result of the run
 
         Examples:
-            >>> from prefect import flow, task
-            >>> @task
-            >>> def my_task(x):
-            >>>     return x
-
-            Get the result from a task future in a flow
-
-            >>> @flow
-            >>> def my_flow():
-            >>>     future = my_task("hello")
-            >>>     state = future.wait()
-            >>>     result = state.result()
-            >>>     print(result)
-            >>> my_flow()
-            hello
-
             Get the result from a flow state
 
             >>> @flow
@@ -307,7 +299,7 @@ class State(ObjectBaseModel, Generic[R]):
             >>>     raise ValueError("oh no!")
             >>> my_flow.deploy("my_deployment/my_flow")
             >>> flow_run = run_deployment("my_deployment/my_flow")
-            >>> await flow_run.state.result(raise_on_failure=True, fetch=True) # Raises `ValueError("oh no!")`
+            >>> await flow_run.state.result(raise_on_failure=True) # Raises `ValueError("oh no!")`
         """
         from prefect.states import get_state_result
 
@@ -365,6 +357,12 @@ class State(ObjectBaseModel, Generic[R]):
                 self.state_details.scheduled_time = DateTime.now("utc")
         return self
 
+    @model_validator(mode="after")
+    def set_unpersisted_results_to_none(self) -> Self:
+        if isinstance(self.data, dict) and self.data.get("type") == "unpersisted":
+            self.data = None
+        return self
+
     def is_scheduled(self) -> bool:
         return self.type == StateType.SCHEDULED
 
@@ -1061,18 +1059,10 @@ class DeploymentSchedule(ObjectBaseModel):
     active: bool = Field(
         default=True, description="Whether or not the schedule is active."
     )
-    max_active_runs: Optional[PositiveInteger] = Field(
-        default=None,
-        description="The maximum number of active runs for the schedule.",
-    )
     max_scheduled_runs: Optional[PositiveInteger] = Field(
         default=None,
         description="The maximum number of scheduled runs for the schedule.",
     )
-    catchup: bool = Field(
-        default=False,
-        description="Whether or not a worker should catch up on Late runs for the schedule.",
-    )
 
 
 class Deployment(ObjectBaseModel):

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/context.py

@@ -38,7 +38,11 @@ from prefect.client.orchestration import PrefectClient, SyncPrefectClient, get_c
 from prefect.client.schemas import FlowRun, TaskRun
 from prefect.events.worker import EventsWorker
 from prefect.exceptions import MissingContextError
-from prefect.results import ResultStore, get_default_persist_setting
+from prefect.results import (
+    ResultStore,
+    get_default_persist_setting,
+    get_default_persist_setting_for_tasks,
+)
 from prefect.settings import Profile, Settings
 from prefect.settings.legacy import _get_settings_fields
 from prefect.states import State
@@ -397,7 +401,7 @@ class TaskRunContext(RunContext):
 
     # Result handling
     result_store: ResultStore
-    persist_result: bool = Field(default_factory=get_default_persist_setting)
+    persist_result: bool = Field(default_factory=get_default_persist_setting_for_tasks)
 
     __var__ = ContextVar("task_run")
 

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/deployments/base.py

@@ -272,8 +272,6 @@ def _format_deployment_for_saving_to_prefect_file(
                 schedule_config = deployment_schedule.schedule.model_dump()
 
             schedule_config["active"] = deployment_schedule.active
-            schedule_config["max_active_runs"] = deployment_schedule.max_active_runs
-            schedule_config["catchup"] = deployment_schedule.catchup
             schedules.append(schedule_config)
 
         deployment["schedules"] = schedules

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/deployments/schedules.py

@@ -14,15 +14,11 @@ FlexibleScheduleList = Sequence[
 def create_deployment_schedule_create(
     schedule: "SCHEDULE_TYPES",
     active: Optional[bool] = True,
-    max_active_runs: Optional[int] = None,
-    catchup: bool = False,
 ) -> DeploymentScheduleCreate:
     """Create a DeploymentScheduleCreate object from common schedule parameters."""
     return DeploymentScheduleCreate(
         schedule=schedule,
         active=active if active is not None else True,
-        max_active_runs=max_active_runs,
-        catchup=catchup,
     )
 
 

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/logging/logging.yml

@@ -102,9 +102,13 @@ loggers:
 
   uvicorn:
     level: "${PREFECT_SERVER_LOGGING_LEVEL}"
+    handlers: [console]
+    propagate: false
 
   fastapi:
     level: "${PREFECT_SERVER_LOGGING_LEVEL}"
+    handlers: [console]
+    propagate: false
 
 # The root logger: any logger without propagation disabled sends to here as well
 root:

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/results.py

@@ -56,13 +56,7 @@ from prefect.filesystems import (
 from prefect.locking.protocol import LockManager
 from prefect.logging import get_logger
 from prefect.serializers import PickleSerializer, Serializer
-from prefect.settings import (
-    PREFECT_DEFAULT_RESULT_STORAGE_BLOCK,
-    PREFECT_LOCAL_STORAGE_PATH,
-    PREFECT_RESULTS_DEFAULT_SERIALIZER,
-    PREFECT_RESULTS_PERSIST_BY_DEFAULT,
-    PREFECT_TASK_SCHEDULING_DEFAULT_STORAGE_BLOCK,
-)
+from prefect.settings.context import get_current_settings
 from prefect.utilities.annotations import NotSet
 from prefect.utilities.asyncutils import sync_compatible
 from prefect.utilities.pydantic import get_dispatch_key, lookup_type, register_base_type
@@ -94,8 +88,9 @@ async def get_default_result_storage() -> WritableFileSystem:
     """
     Generate a default file system for result storage.
     """
-    default_block = PREFECT_DEFAULT_RESULT_STORAGE_BLOCK.value()
-    basepath = PREFECT_LOCAL_STORAGE_PATH.value()
+    settings = get_current_settings()
+    default_block = settings.results.default_storage_block
+    basepath = settings.results.local_storage_path
 
     cache_key = (str(default_block), str(basepath))
 
@@ -169,13 +164,14 @@ async def get_or_create_default_task_scheduling_storage() -> ResultStorage:
     """
     Generate a default file system for background task parameter/result storage.
     """
-    default_block = PREFECT_TASK_SCHEDULING_DEFAULT_STORAGE_BLOCK.value()
+    settings = get_current_settings()
+    default_block = settings.tasks.scheduling.default_storage_block
 
     if default_block is not None:
         return await Block.load(default_block)
 
     # otherwise, use the local file system
-    basepath = PREFECT_LOCAL_STORAGE_PATH.value()
+    basepath = settings.results.local_storage_path
     return LocalFileSystem(basepath=basepath)
 
 
@@ -183,22 +179,36 @@ def get_default_result_serializer() -> Serializer:
     """
     Generate a default file system for result storage.
     """
-    return resolve_serializer(PREFECT_RESULTS_DEFAULT_SERIALIZER.value())
+    settings = get_current_settings()
+    return resolve_serializer(settings.results.default_serializer)
 
 
 def get_default_persist_setting() -> bool:
     """
-    Return the default option for result persistence (False).
+    Return the default option for result persistence.
+    """
+    settings = get_current_settings()
+    return settings.results.persist_by_default
+
+
+def get_default_persist_setting_for_tasks() -> bool:
+    """
+    Return the default option for result persistence for tasks.
     """
-    return PREFECT_RESULTS_PERSIST_BY_DEFAULT.value()
+    settings = get_current_settings()
+    return (
+        settings.tasks.default_persist_result
+        if settings.tasks.default_persist_result is not None
+        else settings.results.persist_by_default
+    )
 
 
 def should_persist_result() -> bool:
     """
     Return the default option for result persistence determined by the current run context.
 
-    If there is no current run context, the default value set by
-    `PREFECT_RESULTS_PERSIST_BY_DEFAULT` will be returned.
+    If there is no current run context, the value of `results.persist_by_default` on the
+    current settings will be returned.
     """
     from prefect.context import FlowRunContext, TaskRunContext
 
@@ -209,7 +219,7 @@ def should_persist_result() -> bool:
     if flow_run_context is not None:
         return flow_run_context.persist_result
 
-    return PREFECT_RESULTS_PERSIST_BY_DEFAULT.value()
+    return get_default_persist_setting()
 
 
 def _format_user_supplied_storage_key(key: str) -> str:

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/settings/base.py

@@ -1,3 +1,4 @@
+import inspect
 from functools import partial
 from typing import Any, Dict, Tuple, Type
 
@@ -8,9 +9,18 @@ from pydantic import (
     SerializerFunctionWrapHandler,
     model_serializer,
 )
-from pydantic_settings import BaseSettings, PydanticBaseSettingsSource
+from pydantic_settings import (
+    BaseSettings,
+    PydanticBaseSettingsSource,
+    SettingsConfigDict,
+)
 
-from prefect.settings.sources import EnvFilterSettingsSource, ProfileSettingsTomlLoader
+from prefect.settings.sources import (
+    EnvFilterSettingsSource,
+    PrefectTomlConfigSettingsSource,
+    ProfileSettingsTomlLoader,
+    PyprojectTomlConfigSettingsSource,
+)
 from prefect.utilities.collections import visit_collection
 from prefect.utilities.pydantic import handle_secret_render
 
@@ -54,6 +64,8 @@ class PrefectBaseSettings(BaseSettings):
             ),
             dotenv_settings,
             file_secret_settings,
+            PrefectTomlConfigSettingsSource(settings_cls),
+            PyprojectTomlConfigSettingsSource(settings_cls),
             ProfileSettingsTomlLoader(settings_cls),
         )
 
@@ -105,7 +117,7 @@ class PrefectBaseSettings(BaseSettings):
             if isinstance(child_settings := getattr(self, key), PrefectBaseSettings):
                 child_jsonable = child_settings.model_dump(
                     mode=info.mode,
-                    include=child_include,
+                    include=child_include,  # type: ignore
                     exclude=child_exclude,
                     exclude_unset=info.exclude_unset,
                     context=info.context,
@@ -129,3 +141,53 @@ class PrefectBaseSettings(BaseSettings):
             )
 
         return jsonable_self
+
+
+class PrefectSettingsConfigDict(SettingsConfigDict, total=False):
+    """
+    Configuration for the behavior of Prefect settings models.
+    """
+
+    prefect_toml_table_header: tuple[str, ...]
+    """
+    Header of the TOML table within a prefect.toml file to use when filling variables.
+    This is supplied as a `tuple[str, ...]` instead of a `str` to accommodate for headers
+    containing a `.`.
+
+    To use the root table, exclude this config setting or provide an empty tuple.
+    """
+
+
+def _add_environment_variables(
+    schema: Dict[str, Any], model: Type[PrefectBaseSettings]
+) -> None:
+    for property in schema["properties"]:
+        env_vars = []
+        schema["properties"][property]["supported_environment_variables"] = env_vars
+        field = model.model_fields[property]
+        if inspect.isclass(field.annotation) and issubclass(
+            field.annotation, PrefectBaseSettings
+        ):
+            continue
+        elif field.validation_alias:
+            if isinstance(field.validation_alias, AliasChoices):
+                for alias in field.validation_alias.choices:
+                    if isinstance(alias, str):
+                        env_vars.append(alias.upper())
+        else:
+            env_vars.append(f"{model.model_config.get('env_prefix')}{property.upper()}")
+
+
+def _build_settings_config(
+    path: Tuple[str, ...] = tuple(),
+) -> PrefectSettingsConfigDict:
+    env_prefix = f"PREFECT_{'_'.join(path).upper()}_" if path else "PREFECT_"
+    return PrefectSettingsConfigDict(
+        env_prefix=env_prefix,
+        env_file=".env",
+        extra="ignore",
+        toml_file="prefect.toml",
+        prefect_toml_table_header=path,
+        pyproject_toml_table_header=("tool", "prefect", *path),
+        json_schema_extra=_add_environment_variables,
+    )

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/settings/legacy.py

@@ -64,7 +64,7 @@ class Setting:
         for key in path:
             current_value = getattr(current_value, key, None)
         if isinstance(current_value, _SECRET_TYPES):
-            return current_value.get_secret_value()
+            return current_value.get_secret_value()  # type: ignore
         return current_value
 
     def __bool__(self) -> bool:

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/settings/models/api.py

@@ -2,9 +2,11 @@ import os
 from typing import Optional
 
 from pydantic import Field, SecretStr
-from pydantic_settings import SettingsConfigDict
 
-from prefect.settings.base import PrefectBaseSettings
+from prefect.settings.base import (
+    PrefectBaseSettings,
+    _build_settings_config,
+)
 
 
 class APISettings(PrefectBaseSettings):
@@ -12,9 +14,7 @@ class APISettings(PrefectBaseSettings):
     Settings for interacting with the Prefect API
     """
 
-    model_config = SettingsConfigDict(
-        env_prefix="PREFECT_API_", env_file=".env", extra="ignore"
-    )
+    model_config = _build_settings_config(("api",))
     url: Optional[str] = Field(
         default=None,
         description="The URL of the Prefect API. If not set, the client will attempt to infer it.",

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/settings/models/cli.py

@@ -1,9 +1,11 @@
 from typing import Optional
 
 from pydantic import Field
-from pydantic_settings import SettingsConfigDict
 
-from prefect.settings.base import PrefectBaseSettings
+from prefect.settings.base import (
+    PrefectBaseSettings,
+    _build_settings_config,
+)
 
 
 class CLISettings(PrefectBaseSettings):
@@ -11,9 +13,7 @@ class CLISettings(PrefectBaseSettings):
     Settings for controlling CLI behavior
     """
 
-    model_config = SettingsConfigDict(
-        env_prefix="PREFECT_CLI_", env_file=".env", extra="ignore"
-    )
+    model_config = _build_settings_config(("cli",))
 
     colors: bool = Field(
         default=True,

{prefect-client-3.0.11 → prefect-client-3.1.0}/src/prefect/settings/models/client.py

@@ -1,7 +1,9 @@
 from pydantic import AliasChoices, AliasPath, Field
-from pydantic_settings import SettingsConfigDict
 
-from prefect.settings.base import PrefectBaseSettings
+from prefect.settings.base import (
+    PrefectBaseSettings,
+    _build_settings_config,
+)
 from prefect.types import ClientRetryExtraCodes
 
 
@@ -10,9 +12,7 @@ class ClientMetricsSettings(PrefectBaseSettings):
     Settings for controlling metrics reporting from the client
     """
 
-    model_config = SettingsConfigDict(
-        env_prefix="PREFECT_CLIENT_METRICS_", env_file=".env", extra="ignore"
-    )
+    model_config = _build_settings_config(("client", "metrics"))
 
     enabled: bool = Field(
         default=False,
@@ -37,9 +37,7 @@ class ClientSettings(PrefectBaseSettings):
     Settings for controlling API client behavior
     """
 
-    model_config = SettingsConfigDict(
-        env_prefix="PREFECT_CLIENT_", env_file=".env", extra="ignore"
-    )
+    model_config = _build_settings_config(("client",))
 
     max_retries: int = Field(
         default=5,