prefect-client 3.4.7.dev6__py3-none-any.whl → 3.4.7.dev7__py3-none-any.whl

prefect/_build_info.py

@@ -1,5 +1,5 @@
 # Generated by versioningit
-__version__ = "3.4.7.dev6"
-__build_date__ = "2025-06-21 08:08:06.814878+00:00"
-__git_commit__ = "db5b5e24387f38ce4aa55b62ce5e3993beacee9c"
+__version__ = "3.4.7.dev7"
+__build_date__ = "2025-06-24 08:09:27.221869+00:00"
+__git_commit__ = "3614ff28a5600b1965c957a04e880aaf38442ad5"
 __dirty__ = False

prefect/client/orchestration/_deployments/client.py

@@ -297,7 +297,7 @@ class DeploymentClient(BaseClient):
             deployment_id: the deployment ID of interest
 
         Returns:
-            a [Deployment model][prefect.client.schemas.objects.Deployment] representation of the deployment
+            a Deployment model representation of the deployment
         """
 
         from prefect.client.schemas.responses import DeploymentResponse
@@ -961,7 +961,7 @@ class DeploymentAsyncClient(BaseAsyncClient):
             deployment_id: the deployment ID of interest
 
         Returns:
-            a [Deployment model][prefect.client.schemas.objects.Deployment] representation of the deployment
+            a Deployment model representation of the deployment
         """
 
         from prefect.client.schemas.responses import DeploymentResponse

prefect/client/orchestration/_flows/client.py

@@ -31,7 +31,7 @@ class FlowClient(BaseClient):
         Create a flow in the Prefect API.
 
         Args:
-            flow: a [Flow][prefect.flows.Flow] object
+            flow: a `Flow` object
 
         Raises:
             httpx.RequestError: if a flow was not created for any reason
@@ -78,7 +78,7 @@ class FlowClient(BaseClient):
             flow_id: the flow ID of interest
 
         Returns:
-            a [Flow model][prefect.client.schemas.objects.Flow] representation of the flow
+            a Flow model representation of the flow
         """
         response = self.request("GET", "/flows/{id}", path_params={"id": flow_id})
         from prefect.client.schemas.objects import Flow
@@ -190,7 +190,7 @@ class FlowAsyncClient(BaseAsyncClient):
         Create a flow in the Prefect API.
 
         Args:
-            flow: a [Flow][prefect.flows.Flow] object
+            flow: a `Flow` object
 
         Raises:
             httpx.RequestError: if a flow was not created for any reason
@@ -237,7 +237,7 @@ class FlowAsyncClient(BaseAsyncClient):
             flow_id: the flow ID of interest
 
         Returns:
-            a [Flow model][prefect.client.schemas.objects.Flow] representation of the flow
+            a Flow model representation of the flow
         """
         response = await self.request("GET", "/flows/{id}", path_params={"id": flow_id})
         from prefect.client.schemas.objects import Flow

prefect/client/schemas/filters.py

@@ -462,6 +462,9 @@ class DeploymentFilterId(PrefectBaseModel):
     any_: Optional[List[UUID]] = Field(
         default=None, description="A list of deployment ids to include"
     )
+    not_any_: Optional[List[UUID]] = Field(
+        default=None, description="A list of deployment ids to exclude"
+    )
 
 
 class DeploymentFilterName(PrefectBaseModel):

prefect/flows.py

@@ -1,5 +1,5 @@
 """
-Module containing the base workflow class and decorator - for most use cases, using the [`@flow` decorator][prefect.flows.flow] is preferred.
+Module containing the base workflow class and decorator - for most use cases, using the `@flow` decorator is preferred.
 """
 
 from __future__ import annotations
@@ -145,9 +145,6 @@ class Flow(Generic[P, R]):
     """
     A Prefect workflow definition.
 
-    !!! note
-        We recommend using the [`@flow` decorator][prefect.flows.flow] for most use-cases.
-
     Wraps a function with an entrypoint to the Prefect engine. To preserve the input
     and output types, we use the generic type variables `P` and `R` for "Parameters" and
     "Returns" respectively.
@@ -500,23 +497,29 @@ class Flow(Generic[P, R]):
 
             Create a new flow from an existing flow and update the name:
 
-            >>> @flow(name="My flow")
-            >>> def my_flow():
-            >>>     return 1
-            >>>
-            >>> new_flow = my_flow.with_options(name="My new flow")
+            ```python
+            from prefect import flow
+
+            @flow(name="My flow")
+            def my_flow():
+                return 1
+
+            new_flow = my_flow.with_options(name="My new flow")
+            ```
 
             Create a new flow from an existing flow, update the task runner, and call
             it without an intermediate variable:
 
-            >>> from prefect.task_runners import ThreadPoolTaskRunner
-            >>>
-            >>> @flow
-            >>> def my_flow(x, y):
-            >>>     return x + y
-            >>>
-            >>> state = my_flow.with_options(task_runner=ThreadPoolTaskRunner)(1, 3)
-            >>> assert state.result() == 4
+            ```python
+            from prefect.task_runners import ThreadPoolTaskRunner
+
+            @flow
+            def my_flow(x, y):
+                return x + y
+
+            state = my_flow.with_options(task_runner=ThreadPoolTaskRunner)(1, 3)
+            assert state.result() == 4
+            ```
         """
         new_task_runner = (
             task_runner() if isinstance(task_runner, type) else task_runner
@@ -1653,22 +1656,27 @@ class Flow(Generic[P, R]):
 
             Define a flow
 
-            >>> @flow
-            >>> def my_flow(name):
-            >>>     print(f"hello {name}")
-            >>>     return f"goodbye {name}"
+            ```python
+            @flow
+            def my_flow(name):
+                print(f"hello {name}")
+                return f"goodbye {name}"
+            ```
 
             Run a flow
 
-            >>> my_flow("marvin")
-            hello marvin
-            "goodbye marvin"
+            ```python
+            my_flow("marvin")
+            ```
 
             Run a flow with additional tags
 
-            >>> from prefect import tags
-            >>> with tags("db", "blue"):
-            >>>     my_flow("foo")
+            ```python
+            from prefect import tags
+
+            with tags("db", "blue"):
+                my_flow("foo")
+            ```
         """
         from prefect.utilities.visualization import (
             get_task_viz_tracker,
@@ -1907,36 +1915,47 @@ class FlowDecorator:
         Examples:
             Define a simple flow
 
-            >>> from prefect import flow
-            >>> @flow
-            >>> def add(x, y):
-            >>>     return x + y
+            ```python
+            from prefect import flow
+
+            @flow
+            def add(x, y):
+                return x + y
+            ```
 
             Define an async flow
 
-            >>> @flow
-            >>> async def add(x, y):
-            >>>     return x + y
+            ```python
+            @flow
+            async def add(x, y):
+                return x + y
+            ```
 
             Define a flow with a version and description
 
-            >>> @flow(version="first-flow", description="This flow is empty!")
-            >>> def my_flow():
-            >>>     pass
+            ```python
+            @flow(version="first-flow", description="This flow is empty!")
+            def my_flow():
+                pass
+            ```
 
             Define a flow with a custom name
 
-            >>> @flow(name="The Ultimate Flow")
-            >>> def my_flow():
-            >>>     pass
+            ```python
+            @flow(name="The Ultimate Flow")
+            def my_flow():
+                pass
+            ```
 
             Define a flow that submits its tasks to dask
 
-            >>> from prefect_dask.task_runners import DaskTaskRunner
-            >>>
-            >>> @flow(task_runner=DaskTaskRunner)
-            >>> def my_flow():
-            >>>     pass
+            ```python
+            from prefect_dask.task_runners import DaskTaskRunner
+
+            @flow(task_runner=DaskTaskRunner)
+            def my_flow():
+                pass
+            ```
         """
         if __fn:
             return Flow(

prefect/tasks.py

@@ -1,5 +1,5 @@
 """
-Module containing the base workflow task class and decorator - for most use cases, using the [`@task` decorator][prefect.tasks.task] is preferred.
+Module containing the base workflow task class and decorator - for most use cases, using the `@task` decorator is preferred.
 """
 
 # This file requires type-checking with pyright because mypy does not yet support PEP612
@@ -301,9 +301,6 @@ class Task(Generic[P, R]):
     """
     A Prefect task definition.
 
-    !!! note
-        We recommend using [the `@task` decorator][prefect.tasks.task] for most use-cases.
-
     Wraps a function with an entrypoint to the Prefect engine. Calling this class within a flow function
     creates a new task run.
 

prefect/utilities/engine.py

@@ -333,8 +333,7 @@ async def propose_state(
         flow_run_id: an optional flow run id, used when proposing flow run states
 
     Returns:
-        a [State model][prefect.client.schemas.objects.State] representation of the
-            flow run state
+        a State model representation of the flow run state
 
     Raises:
         prefect.exceptions.Abort: if an ABORT instruction is received from
@@ -432,8 +431,7 @@ def propose_state_sync(
         flow_run_id: an optional flow run id, used when proposing flow run states
 
     Returns:
-        a [State model][prefect.client.schemas.objects.State] representation of the
-            flow run state
+        a State model representation of the flow run state
 
     Raises:
         ValueError: if flow_run_id is not provided

{prefect_client-3.4.7.dev6.dist-info → prefect_client-3.4.7.dev7.dist-info}/METADATA

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

{prefect_client-3.4.7.dev6.dist-info → prefect_client-3.4.7.dev7.dist-info}/RECORD

@@ -2,7 +2,7 @@ prefect/.prefectignore,sha256=awSprvKT0vI8a64mEOLrMxhxqcO-b0ERQeYpA2rNKVQ,390
 prefect/AGENTS.md,sha256=qmCZAuKIF9jQyp5TrW_T8bsM_97-QaiCoQp71A_b2Lg,1008
 prefect/__init__.py,sha256=iCdcC5ZmeewikCdnPEP6YBAjPNV5dvfxpYCTpw30Hkw,3685
 prefect/__main__.py,sha256=WFjw3kaYJY6pOTA7WDOgqjsz8zUEUZHCcj3P5wyVa-g,66
-prefect/_build_info.py,sha256=XFbHLh_Y6bYD4inBk5lsqzFre7U5XXTbgBSUjgk7jLI,185
+prefect/_build_info.py,sha256=cJqOi7wQGRupy4Rsu7Su9cZXMkfbV29ES1HTg1M-8LQ,185
 prefect/_result_records.py,sha256=S6QmsODkehGVSzbMm6ig022PYbI6gNKz671p_8kBYx4,7789
 prefect/_versioning.py,sha256=YqR5cxXrY4P6LM1Pmhd8iMo7v_G2KJpGNdsf4EvDFQ0,14132
 prefect/_waiters.py,sha256=Ia2ITaXdHzevtyWIgJoOg95lrEXQqNEOquHvw3T33UQ,9026
@@ -16,7 +16,7 @@ prefect/exceptions.py,sha256=wZLQQMRB_DyiYkeEdIC5OKwbba5A94Dlnics-lrWI7A,11581
 prefect/filesystems.py,sha256=v5YqGB4uXf9Ew2VuB9VCSkawvYMMVvEtZf7w1VmAmr8,18036
 prefect/flow_engine.py,sha256=JwnMqtrSgDVtsw4cyUOBkHhlNXhysb5SSNZtRe-NpqE,59100
 prefect/flow_runs.py,sha256=d3jfmrIPP3C19IJREvpkuN6fxksX3Lzo-LlHOB-_E2I,17419
-prefect/flows.py,sha256=xJKlXgVVdlZh45uE73PjA90qqmArVM2hzHgsniu02CY,120945
+prefect/flows.py,sha256=zKmskX31aW8NlArC9QkbXsFGxatcdwQMIQe2PHHcDqQ,120984
 prefect/futures.py,sha256=U1SdxwOWNdQz_xtlZ6J-_zjRntxbqu7kz53YRov-Dew,25000
 prefect/main.py,sha256=8V-qLB4GjEVCkGRgGXeaIk-JIXY8Z9FozcNluj4Sm9E,2589
 prefect/plugins.py,sha256=FPRLR2mWVBMuOnlzeiTD9krlHONZH2rtYLD753JQDNQ,2516
@@ -29,7 +29,7 @@ prefect/task_engine.py,sha256=-uGGvLnXVeGNzA3Hki6-epUEY00P3l3QBXTcahjfEM4,65506
 prefect/task_runners.py,sha256=Mc9KIbY2uqxQcO1XHPh6hId0Qk1ukjCaGHCn4LKo3tg,17000
 prefect/task_runs.py,sha256=7LIzfo3fondCyEUpU05sYFN5IfpZigBDXrhG5yc-8t0,9039
 prefect/task_worker.py,sha256=RifZ3bOl6ppoYPiOAd4TQp2_GEw9eDQoW483rq1q52Q,20805
-prefect/tasks.py,sha256=YU7_yvjBqHDgvH0Bw819hD8ENOweUV667LyZLM4SAsw,78292
+prefect/tasks.py,sha256=CKPF22f_6L5jQFtGgykMdTsQqwF7OnfWu5jjn1F-bLw,78165
 prefect/transactions.py,sha256=uIoPNudzJzH6NrMJhrgr5lyh6JxOJQqT1GvrXt69yNw,26068
 prefect/variables.py,sha256=dCK3vX7TbkqXZhnNT_v7rcGh3ISRqoR6pJVLpoll3Js,8342
 prefect/_experimental/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -107,11 +107,11 @@ prefect/client/orchestration/_blocks_types/client.py,sha256=alA4xD-yp3mycAbzMyRu
 prefect/client/orchestration/_concurrency_limits/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/client/orchestration/_concurrency_limits/client.py,sha256=r_oyY7hQbgyG1rntwe7WWcsraQHBKhk6MOPFUAHWiVc,23678
 prefect/client/orchestration/_deployments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-prefect/client/orchestration/_deployments/client.py,sha256=KMA_ldpBiUVqvV2-FSOgARyb3objs8MAAe1uD-RXcaE,48477
+prefect/client/orchestration/_deployments/client.py,sha256=h42dzlVStzTcmnXtQfIVoKTI3rarsJgoQeSKnTwGIyg,48387
 prefect/client/orchestration/_flow_runs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/client/orchestration/_flow_runs/client.py,sha256=fjh5J-LG8tsny7BGYEvynbuGuHDAudYHpx-PamL0GYQ,32220
 prefect/client/orchestration/_flows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-prefect/client/orchestration/_flows/client.py,sha256=21rqVFm-AsqFK1S-vK2TyXKZ_oL65SN0_hiiddi6vIo,11006
+prefect/client/orchestration/_flows/client.py,sha256=GLMT5qC_z-Ys7koz5UU5zYOPUOiXW7tUIBNgK7uY_Wc,10888
 prefect/client/orchestration/_logs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/client/orchestration/_logs/client.py,sha256=DYgdeVV_6ORIOuqZapDWZXuFjIUtWreAyl2uHWpGZfA,2996
 prefect/client/orchestration/_variables/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -120,7 +120,7 @@ prefect/client/orchestration/_work_pools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5
 prefect/client/orchestration/_work_pools/client.py,sha256=s1DfUQQBgB2sLiVVPhLNTlkueUDE6uFsh4mAzcSA1OE,19881
 prefect/client/schemas/__init__.py,sha256=9eCE4tzSxsB-uhXNagrb78jz1xtI4QPoZuH6TNav8M4,2831
 prefect/client/schemas/actions.py,sha256=R6WwzxBj1SuwUqGX0g6zEDxtdoNR7lTQLSpytP2HOgA,32482
-prefect/client/schemas/filters.py,sha256=qa--NNZduuSOcL1xw-YMd4FVIKMrDnBwPPY4m5Di0GA,35963
+prefect/client/schemas/filters.py,sha256=uEGvai0VtrvUtojFME-oflQ1T-Diw-TUrQwk4PwBOtU,36085
 prefect/client/schemas/objects.py,sha256=vL1yN-IqQynpVH9Sp0-aYyTfRHfy3eIsLnTAfw6aCbI,58215
 prefect/client/schemas/responses.py,sha256=Zdcx7jlIaluEa2uYIOE5mK1HsJvWPErRAcaWM20oY_I,17336
 prefect/client/schemas/schedules.py,sha256=sxLFk0SmFY7X1Y9R9HyGDqOS3U5NINBWTciUU7vTTic,14836
@@ -302,7 +302,7 @@ prefect/utilities/compat.py,sha256=nnPA3lf2f4Y-l645tYFFNmj5NDPaYvjqa9pbGKZ3WKE,5
 prefect/utilities/context.py,sha256=23SDMgdt07SjmB1qShiykHfGgiv55NBzdbMXM3fE9CI,1447
 prefect/utilities/dispatch.py,sha256=u6GSGSO3_6vVoIqHVc849lsKkC-I1wUl6TX134GwRBo,6310
 prefect/utilities/dockerutils.py,sha256=6DLVyzE195IzeQSWERiK1t3bDMnYBLe0zXIpMQ4r0c0,21659
-prefect/utilities/engine.py,sha256=_8jUE95Q7gRSplY7X6UD57_DimYYASVfQJs7qVymREk,28420
+prefect/utilities/engine.py,sha256=nMtKaTDOIbMbUmDR3PcA_BOjOFKuginmrOERwfzub04,28316
 prefect/utilities/filesystem.py,sha256=Pwesv71PGFhf3lPa1iFyMqZZprBjy9nEKCVxTkf_hXw,5710
 prefect/utilities/generics.py,sha256=o77e8a5iwmrisOf42wLp2WI9YvSw2xDW4vFdpdEwr3I,543
 prefect/utilities/hashing.py,sha256=7jRy26s46IJAFRmVnCnoK9ek9N4p_UfXxQQvu2tW6dM,2589
@@ -329,7 +329,7 @@ prefect/workers/cloud.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/workers/process.py,sha256=Yi5D0U5AQ51wHT86GdwtImXSefe0gJf3LGq4r4z9zwM,11090
 prefect/workers/server.py,sha256=2pmVeJZiVbEK02SO6BEZaBIvHMsn6G8LzjW8BXyiTtk,1952
 prefect/workers/utilities.py,sha256=VfPfAlGtTuDj0-Kb8WlMgAuOfgXCdrGAnKMapPSBrwc,2483
-prefect_client-3.4.7.dev6.dist-info/METADATA,sha256=JZOqcpRffzjFbguh99sOyvFUFDJS7yVVbOXy0QSXTOk,7517
-prefect_client-3.4.7.dev6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-prefect_client-3.4.7.dev6.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
-prefect_client-3.4.7.dev6.dist-info/RECORD,,
+prefect_client-3.4.7.dev7.dist-info/METADATA,sha256=YJvQqTJ9Dj42ijE5NXHSfOkx0rZ7cSaNJyaRanfYQE8,7517
+prefect_client-3.4.7.dev7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+prefect_client-3.4.7.dev7.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.4.7.dev7.dist-info/RECORD,,