prefect-client 3.2.6__tar.gz → 3.2.7__tar.gz

{prefect_client-3.2.6 → prefect_client-3.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.2.6
+Version: 3.2.7
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io

prefect_client-3.2.7/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.2.7"
+__build_date__ = "2025-02-21 19:38:38.599741+00:00"
+__git_commit__ = "d4d9001e40eb378ec68a97f7e3bab07d89c7557c"
+__dirty__ = False

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/client/orchestration/__init__.py

@@ -81,6 +81,7 @@ from prefect.client.orchestration._blocks_types.client import (
 
 import prefect
 import prefect.exceptions
+from prefect.logging.loggers import get_run_logger
 import prefect.settings
 import prefect.states
 from prefect.client.constants import SERVER_API_VERSION
@@ -1182,8 +1183,17 @@ class PrefectClient(
         if api_version.major != client_version.major:
             raise RuntimeError(
                 f"Found incompatible versions: client: {client_version}, server: {api_version}. "
-                f"Major versions must match."
+                "Major versions must match."
             )
+        if api_version < client_version:
+            warning_message = (
+                "Your Prefect server is running an older version of Prefect than your client which may result in unexpected behavior. "
+                f"Please upgrade your Prefect server from version {api_version} to version {client_version} or higher."
+            )
+            try:
+                get_run_logger().warning(warning_message)
+            except prefect.context.MissingContextError:
+                self.logger.warning(warning_message)
 
     async def __aenter__(self) -> Self:
         """
@@ -1523,8 +1533,17 @@ class SyncPrefectClient(
         if api_version.major != client_version.major:
             raise RuntimeError(
                 f"Found incompatible versions: client: {client_version}, server: {api_version}. "
-                f"Major versions must match."
+                "Major versions must match."
             )
+        if api_version < client_version:
+            warning_message = (
+                "Your Prefect server is running an older version of Prefect than your client which may result in unexpected behavior. "
+                f"Please upgrade your Prefect server from version {api_version} to version {client_version} or higher."
+            )
+            try:
+                get_run_logger().warning(warning_message)
+            except prefect.context.MissingContextError:
+                self.logger.warning(warning_message)
 
     def set_task_run_name(self, task_run_id: UUID, name: str) -> httpx.Response:
         task_run_data = TaskRunUpdate(name=name)

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/events/schemas/automations.py

@@ -84,7 +84,7 @@ class Trigger(PrefectBaseModel, abc.ABC, extra="ignore"):  # type: ignore[call-a
                 getattr(self, "name", None)
                 or f"Automation for deployment {self._deployment_id}"
             ),
-            description="",
+            description=getattr(self, "description", ""),
             enabled=getattr(self, "enabled", True),
             trigger=trigger,
             actions=self.actions(),

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/flows.py

@@ -2350,9 +2350,15 @@ async def load_flow_from_flow_run(
             f"Running {len(deployment.pull_steps)} deployment pull step(s)"
         )
 
-        from prefect.deployments.steps.core import run_steps
+        from prefect.deployments.steps.core import StepExecutionError, run_steps
+
+        try:
+            output = await run_steps(deployment.pull_steps)
+        except StepExecutionError as e:
+            e = e.__cause__ or e
+            run_logger.error(str(e))
+            raise
 
-        output = await run_steps(deployment.pull_steps)
         if output.get("directory"):
             run_logger.debug(f"Changing working directory to {output['directory']!r}")
             os.chdir(output["directory"])

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/logging/configuration.py

@@ -38,7 +38,9 @@ def load_logging_config(path: Path) -> dict[str, Any]:
         warnings.filterwarnings("ignore", category=DeprecationWarning)
         config = yaml.safe_load(
             # Substitute settings into the template in format $SETTING / ${SETTING}
-            template.substitute(current_settings.to_environment_variables())
+            template.substitute(
+                current_settings.to_environment_variables(include_aliases=True)
+            )
         )
 
     # Load overrides from the environment

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/server/api/server.py

@@ -55,6 +55,7 @@ from prefect.settings import (
     PREFECT_DEBUG_MODE,
     PREFECT_MEMO_STORE_PATH,
     PREFECT_MEMOIZE_BLOCK_AUTO_REGISTRATION,
+    PREFECT_SERVER_API_BASE_PATH,
     PREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS,
     PREFECT_UI_SERVE_BASE,
     get_current_settings,
@@ -356,7 +357,10 @@ def create_api_app(
             header_token = request.headers.get("Authorization")
 
             # used for probes in k8s and such
-            if request.url.path in ["/api/health", "/api/ready"]:
+            if (
+                request.url.path.endswith(("health", "ready"))
+                and request.method.upper() == "GET"
+            ):
                 return await call_next(request)
             try:
                 if header_token is None:
@@ -691,7 +695,10 @@ def create_app(
         name="static",
     )
     app.api_app = api_app
-    app.mount("/api", app=api_app, name="api")
+    if PREFECT_SERVER_API_BASE_PATH:
+        app.mount(PREFECT_SERVER_API_BASE_PATH.value(), app=api_app, name="api")
+    else:
+        app.mount("/api", app=api_app, name="api")
     app.mount("/", app=ui_app, name="ui")
 
     def openapi():

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/settings/base.py

@@ -92,6 +92,7 @@ class PrefectBaseSettings(BaseSettings):
         self,
         exclude_unset: bool = False,
         include_secrets: bool = True,
+        include_aliases: bool = False,
     ) -> Dict[str, str]:
         """Convert the settings object to a dictionary of environment variables."""
         env: Dict[str, Any] = self.model_dump(
@@ -105,12 +106,26 @@ class PrefectBaseSettings(BaseSettings):
                 child_env = child_settings.to_environment_variables(
                     exclude_unset=exclude_unset,
                     include_secrets=include_secrets,
+                    include_aliases=include_aliases,
                 )
                 env_variables.update(child_env)
             elif (value := env.get(key)) is not None:
-                env_variables[f"{self.model_config.get('env_prefix')}{key.upper()}"] = (
-                    _to_environment_variable_value(value)
-                )
+                validation_alias = self.model_fields[key].validation_alias
+                if include_aliases and validation_alias is not None:
+                    if isinstance(validation_alias, AliasChoices):
+                        for alias in validation_alias.choices:
+                            if isinstance(alias, str):
+                                env_variables[alias.upper()] = (
+                                    _to_environment_variable_value(value)
+                                )
+                    elif isinstance(validation_alias, str):
+                        env_variables[validation_alias.upper()] = (
+                            _to_environment_variable_value(value)
+                        )
+                else:
+                    env_variables[
+                        f"{self.model_config.get('env_prefix')}{key.upper()}"
+                    ] = _to_environment_variable_value(value)
         return env_variables
 
     @model_serializer(

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/settings/models/root.py

@@ -381,7 +381,11 @@ def _warn_on_misconfigured_api_url(settings: "Settings"):
                 warnings_list.append(warning)
 
         parsed_url = urlparse(api_url)
-        if parsed_url.path and not parsed_url.path.startswith("/api"):
+        if (
+            parsed_url.path
+            and "api.prefect.cloud" in api_url
+            and not parsed_url.path.startswith("/api")
+        ):
             warnings_list.append(
                 "`PREFECT_API_URL` should have `/api` after the base URL."
             )

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/settings/models/server/api.py

@@ -18,7 +18,7 @@ class ServerAPISettings(PrefectBaseSettings):
 
     auth_string: Optional[SecretStr] = Field(
         default=None,
-        description="A string to use for basic authentication with the API; typically in the form 'user:password' but can be any string.",
+        description="A string to use for basic authentication with the API in the form 'user:password'.",
     )
 
     host: str = Field(
@@ -31,6 +31,12 @@ class ServerAPISettings(PrefectBaseSettings):
         description="The API's port address (defaults to `4200`).",
     )
 
+    base_path: Optional[str] = Field(
+        default=None,
+        description="The base URL path to serve the API under.",
+        examples=["/v2/api"],
+    )
+
     default_limit: int = Field(
         default=200,
         description="The default limit applied to queries that can return multiple objects, such as `POST /flow_runs/filter`.",

{prefect_client-3.2.6 → prefect_client-3.2.7}/src/prefect/settings/models/server/database.py

@@ -30,6 +30,20 @@ class SQLAlchemyConnectArgsSettings(PrefectBaseSettings):
         description="Controls the application_name field for connections opened from the connection pool when using a PostgreSQL database with the Prefect backend.",
     )
 
+    statement_cache_size: Optional[int] = Field(
+        default=None,
+        description="Controls statement cache size for PostgreSQL connections. Setting this to 0 is required when using PgBouncer in transaction mode. Defaults to None.",
+    )
+
+    prepared_statement_cache_size: Optional[int] = Field(
+        default=None,
+        description=(
+            "Controls the size of the statement cache for PostgreSQL connections. "
+            "When set to 0, statement caching is disabled. Defaults to None to use "
+            "SQLAlchemy's default behavior."
+        ),
+    )
+
 
 class SQLAlchemySettings(PrefectBaseSettings):
     """

prefect_client-3.2.6/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.2.6"
-__build_date__ = "2025-02-19 21:22:47.670607+00:00"
-__git_commit__ = "5ceb3ada542c5a752bab431af83fe790252d4dc8"
-__dirty__ = False