prefect-client 3.0.0rc3__py3-none-any.whl → 3.0.0rc5__py3-none-any.whl

prefect/utilities/collections.py

@@ -4,6 +4,7 @@ Utilities for extensions of and operations on Python collections.
 
 import io
 import itertools
+import types
 import warnings
 from collections import OrderedDict, defaultdict
 from collections.abc import Iterator as IteratorABC
@@ -220,25 +221,31 @@ class StopVisiting(BaseException):
 
 
 def visit_collection(
-    expr,
-    visit_fn: Union[Callable[[Any, dict], Any], Callable[[Any], Any]],
+    expr: Any,
+    visit_fn: Union[Callable[[Any, Optional[dict]], Any], Callable[[Any], Any]],
     return_data: bool = False,
     max_depth: int = -1,
     context: Optional[dict] = None,
     remove_annotations: bool = False,
-):
+    _seen: Optional[Set[int]] = None,
+) -> Any:
     """
-    This function visits every element of an arbitrary Python collection. If an element
-    is a Python collection, it will be visited recursively. If an element is not a
-    collection, `visit_fn` will be called with the element. The return value of
-    `visit_fn` can be used to alter the element if `return_data` is set.
+    Visits and potentially transforms every element of an arbitrary Python collection.
 
-    Note that when using `return_data` a copy of each collection is created to avoid
-    mutating the original object. This may have significant performance penalties and
-    should only be used if you intend to transform the collection.
+    If an element is a Python collection, it will be visited recursively. If an element
+    is not a collection, `visit_fn` will be called with the element. The return value of
+    `visit_fn` can be used to alter the element if `return_data` is set to `True`.
+
+    Note:
+    - When `return_data` is `True`, a copy of each collection is created only if
+      `visit_fn` modifies an element within that collection. This approach minimizes
+      performance penalties by avoiding unnecessary copying.
+    - When `return_data` is `False`, no copies are created, and only side effects from
+      `visit_fn` are applied. This mode is faster and should be used when no transformation
+      of the collection is required, because it never has to copy any data.
 
     Supported types:
-    - List
+    - List (including iterators)
     - Tuple
     - Set
     - Dict (note: keys are also visited recursively)
@@ -246,32 +253,41 @@ def visit_collection(
     - Pydantic model
     - Prefect annotations
 
+    Note that visit_collection will not consume generators or async generators, as it would prevent
+    the caller from iterating over them.
+
     Args:
-        expr (Any): a Python object or expression
-        visit_fn (Callable[[Any, Optional[dict]], Awaitable[Any]]): a function that
-            will be applied to every non-collection element of expr. The function can
-            accept one or two arguments. If two arguments are accepted, the second
-            argument will be the context dictionary.
-        return_data (bool): if `True`, a copy of `expr` containing data modified
-            by `visit_fn` will be returned. This is slower than `return_data=False`
-            (the default).
-        max_depth: Controls the depth of recursive visitation. If set to zero, no
-            recursion will occur. If set to a positive integer N, visitation will only
-            descend to N layers deep. If set to any negative integer, no limit will be
+        expr (Any): A Python object or expression.
+        visit_fn (Callable[[Any, Optional[dict]], Any] or Callable[[Any], Any]): A function
+            that will be applied to every non-collection element of `expr`. The function can
+            accept one or two arguments. If two arguments are accepted, the second argument
+            will be the context dictionary.
+        return_data (bool): If `True`, a copy of `expr` containing data modified by `visit_fn`
+            will be returned. This is slower than `return_data=False` (the default).
+        max_depth (int): Controls the depth of recursive visitation. If set to zero, no
+            recursion will occur. If set to a positive integer `N`, visitation will only
+            descend to `N` layers deep. If set to any negative integer, no limit will be
             enforced and recursion will continue until terminal items are reached. By
             default, recursion is unlimited.
-        context: An optional dictionary. If passed, the context will be sent to each
-            call to the `visit_fn`. The context can be mutated by each visitor and will
-            be available for later visits to expressions at the given depth. Values
+        context (Optional[dict]): An optional dictionary. If passed, the context will be sent
+            to each call to the `visit_fn`. The context can be mutated by each visitor and
+            will be available for later visits to expressions at the given depth. Values
             will not be available "up" a level from a given expression.
-
             The context will be automatically populated with an 'annotation' key when
-            visiting collections within a `BaseAnnotation` type. This requires the
-            caller to pass `context={}` and will not be activated by default.
-        remove_annotations: If set, annotations will be replaced by their contents. By
+            visiting collections within a `BaseAnnotation` type. This requires the caller to
+            pass `context={}` and will not be activated by default.
+        remove_annotations (bool): If set, annotations will be replaced by their contents. By
             default, annotations are preserved but their contents are visited.
+        _seen (Optional[Set[int]]): A set of object ids that have already been visited. This
+            prevents infinite recursion when visiting recursive data structures.
+
+    Returns:
+        Any: The modified collection if `return_data` is `True`, otherwise `None`.
     """
 
+    if _seen is None:
+        _seen = set()
+
     def visit_nested(expr):
         # Utility for a recursive call, preserving options and updating the depth.
         return visit_collection(
@@ -282,6 +298,7 @@ def visit_collection(
             max_depth=max_depth - 1,
             # Copy the context on nested calls so it does not "propagate up"
             context=context.copy() if context is not None else None,
+            _seen=_seen,
         )
 
     def visit_expression(expr):
@@ -290,7 +307,7 @@ def visit_collection(
         else:
             return visit_fn(expr)
 
-    # Visit every expression
+    # --- 1. Visit every expression
     try:
         result = visit_expression(expr)
     except StopVisiting:
@@ -298,47 +315,92 @@ def visit_collection(
         result = expr
 
     if return_data:
-        # Only mutate the expression while returning data, otherwise it could be null
+        # Only mutate the root expression if the user indicated we're returning data,
+        # otherwise the function could return null and we have no collection to check
         expr = result
 
-    # Then, visit every child of the expression recursively
+    # --- 2. Visit every child of the expression recursively
 
-    # If we have reached the maximum depth, do not perform any recursion
-    if max_depth == 0:
+    # If we have reached the maximum depth or we have already visited this object,
+    # return the result if we are returning data, otherwise return None
+    if max_depth == 0 or id(expr) in _seen:
         return result if return_data else None
+    else:
+        _seen.add(id(expr))
 
     # Get the expression type; treat iterators like lists
     typ = list if isinstance(expr, IteratorABC) and isiterable(expr) else type(expr)
     typ = cast(type, typ)  # mypy treats this as 'object' otherwise and complains
 
     # Then visit every item in the expression if it is a collection
-    if isinstance(expr, Mock):
+
+    # presume that the result is the original expression.
+    # in each of the following cases, we will update the result if we need to.
+    result = expr
+
+    # --- Generators
+
+    if isinstance(expr, (types.GeneratorType, types.AsyncGeneratorType)):
+        # Do not attempt to iterate over generators, as it will exhaust them
+        pass
+
+    # --- Mocks
+
+    elif isinstance(expr, Mock):
         # Do not attempt to recurse into mock objects
-        result = expr
+        pass
+
+    # --- Annotations (unmapped, quote, etc.)
 
     elif isinstance(expr, BaseAnnotation):
         if context is not None:
             context["annotation"] = expr
-        value = visit_nested(expr.unwrap())
+        unwrapped = expr.unwrap()
+        value = visit_nested(unwrapped)
 
-        if remove_annotations:
-            result = value if return_data else None
-        else:
-            result = expr.rewrap(value) if return_data else None
+        if return_data:
+            # if we are removing annotations, return the value
+            if remove_annotations:
+                result = value
+            # if the value was modified, rewrap it
+            elif value is not unwrapped:
+                result = expr.rewrap(value)
+            # otherwise return the expr
+
+    # --- Sequences
 
     elif typ in (list, tuple, set):
         items = [visit_nested(o) for o in expr]
-        result = typ(items) if return_data else None
+        if return_data:
+            modified = any(item is not orig for item, orig in zip(items, expr))
+            if modified:
+                result = typ(items)
+
+    # --- Dictionaries
 
     elif typ in (dict, OrderedDict):
         assert isinstance(expr, (dict, OrderedDict))  # typecheck assertion
         items = [(visit_nested(k), visit_nested(v)) for k, v in expr.items()]
-        result = typ(items) if return_data else None
+        if return_data:
+            modified = any(
+                k1 is not k2 or v1 is not v2
+                for (k1, v1), (k2, v2) in zip(items, expr.items())
+            )
+            if modified:
+                result = typ(items)
+
+    # --- Dataclasses
 
     elif is_dataclass(expr) and not isinstance(expr, type):
         values = [visit_nested(getattr(expr, f.name)) for f in fields(expr)]
-        items = {field.name: value for field, value in zip(fields(expr), values)}
-        result = typ(**items) if return_data else None
+        if return_data:
+            modified = any(
+                getattr(expr, f.name) is not v for f, v in zip(fields(expr), values)
+            )
+            if modified:
+                result = typ(**{f.name: v for f, v in zip(fields(expr), values)})
+
+    # --- Pydantic models
 
     elif isinstance(expr, pydantic.BaseModel):
         typ = cast(Type[pydantic.BaseModel], typ)
@@ -355,20 +417,21 @@ def visit_collection(
             }
 
         if return_data:
-            # Use construct to avoid validation and handle immutability
-            model_instance = typ.model_construct(
-                _fields_set=expr.model_fields_set, **updated_data
+            modified = any(
+                getattr(expr, field) is not updated_data[field]
+                for field in model_fields
             )
-            for private_attr in expr.__private_attributes__:
-                setattr(model_instance, private_attr, getattr(expr, private_attr))
-            result = model_instance
-        else:
-            result = None
+            if modified:
+                # Use construct to avoid validation and handle immutability
+                model_instance = typ.model_construct(
+                    _fields_set=expr.model_fields_set, **updated_data
+                )
+                for private_attr in expr.__private_attributes__:
+                    setattr(model_instance, private_attr, getattr(expr, private_attr))
+                result = model_instance
 
-    else:
-        result = result if return_data else None
-
-    return result
+    if return_data:
+        return result
 
 
 def remove_nested_keys(keys_to_remove: List[Hashable], obj):

prefect/utilities/dockerutils.py

@@ -9,6 +9,7 @@ from tempfile import TemporaryDirectory
 from types import TracebackType
 from typing import (
     TYPE_CHECKING,
+    Any,
     Generator,
     Iterable,
     List,
@@ -142,7 +143,7 @@ def build_image(
     pull: bool = False,
     platform: Optional[str] = None,
     stream_progress_to: Optional[TextIO] = None,
-    **kwargs,
+    **kwargs: Any,
 ) -> str:
     """Builds a Docker image, returning the image ID
 

prefect/utilities/urls.py

@@ -117,7 +117,7 @@ def url_for(
         if obj.id.startswith("prefect."):
             name = obj.id.split(".")[1]
         else:
-            logger.warning(f"No URL known for resource with ID: {obj.id}")
+            logger.debug(f"No URL known for resource with ID: {obj.id}")
             return None
     elif isinstance(obj, str):
         name = obj
@@ -133,10 +133,10 @@ def url_for(
         raise ValueError(f"Invalid URL type: {url_type}. Use 'ui' or 'api'.")
 
     if url_type == "ui" and name not in UI_URL_FORMATS:
-        logger.error("No UI URL known for this object: %s", name)
+        logger.debug("No UI URL known for this object: %s", name)
         return None
     elif url_type == "api" and name not in API_URL_FORMATS:
-        logger.error("No API URL known for this object: %s", name)
+        logger.debug("No API URL known for this object: %s", name)
         return None
 
     if isinstance(obj, str) and not obj_id:
@@ -152,7 +152,7 @@ def url_for(
     base_url = base_url or default_base_url
 
     if not base_url:
-        logger.warning(
+        logger.debug(
             f"No URL found for the Prefect {'UI' if url_type == 'ui' else 'API'}, "
             f"and no default base path provided."
         )
@@ -174,7 +174,7 @@ def url_for(
         else:
             obj_id = getattr(obj, "id", None)
         if not obj_id:
-            logger.error(
+            logger.debug(
                 "An ID is required to build a URL, but object did not have one: %s", obj
             )
             return ""

{prefect_client-3.0.0rc3.dist-info → prefect_client-3.0.0rc5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: prefect-client
-Version: 3.0.0rc3
+Version: 3.0.0rc5
 Summary: Workflow orchestration and management.
 Home-page: https://www.prefect.io
 Author: Prefect Technologies, Inc.
@@ -46,7 +46,7 @@ Requires-Dist: pathspec >=0.8.0
 Requires-Dist: pendulum <4,>=3.0.0
 Requires-Dist: pydantic <3.0.0,>=2.7
 Requires-Dist: pydantic-core <3.0.0,>=2.12.0
-Requires-Dist: pydantic-extra-types !=2.8.1,<3.0.0,>2.7
+Requires-Dist: pydantic-extra-types <3.0.0,>=2.8.2
 Requires-Dist: pydantic-settings
 Requires-Dist: python-dateutil <3.0.0,>=2.8.2
 Requires-Dist: python-slugify <9.0,>=5.0

{prefect_client-3.0.0rc3.dist-info → prefect_client-3.0.0rc5.dist-info}/RECORD

@@ -1,30 +1,30 @@
 prefect/.prefectignore,sha256=awSprvKT0vI8a64mEOLrMxhxqcO-b0ERQeYpA2rNKVQ,390
-prefect/__init__.py,sha256=7U1KgTkcvbIuof0yse4_i181D98rih8y_SkZhPQStyA,2952
+prefect/__init__.py,sha256=YmPor6iCXeKOr8jfH08qD9CBiRsEY6pXs4mRSQRo6ro,2873
 prefect/_version.py,sha256=I9JsXwt7BjAAbMEZgtmE3a6dJ2jqV-wqWto9D6msb3k,24597
 prefect/artifacts.py,sha256=G-jCyce3XGtTyQpCk_s3L7e-TWFyJY8Dcnk_i4_CsY4,12647
 prefect/automations.py,sha256=NlQ62GPJzy-gnWQqX7c6CQJKw7p60WLGDAFcy82vtg4,5613
-prefect/context.py,sha256=1dGUGcVXbx6rd04cwtz7Oz1qVPCMlIrAkF-Xo5GtcVY,23196
+prefect/context.py,sha256=OEmbC61D3l0E50HIaMlVNNJShhYC6I1-4TQhpP321tw,19480
 prefect/engine.py,sha256=asH7iMb1IfEOOIVIxM3ZalfvCe9PUp7f9ceKyT6isa8,2019
 prefect/exceptions.py,sha256=kRiEX6qpT9errs0SuYJDYG7ioMNddTvqK7gT8RVFajk,11076
 prefect/filesystems.py,sha256=HrPoehZKpuVxzWDXaTiuJqgVCgxlQ4lyTEZKSYKiZUc,17169
-prefect/flow_engine.py,sha256=4AekqZxCSrro_PL40jxdVELHby5YJ3QOaYbSFO0jjlI,23164
+prefect/flow_engine.py,sha256=3JM3LpgqCGLUsTbrh5-CL3IFnHSHRWHbqV9xMEC3nyM,26149
 prefect/flow_runs.py,sha256=7mHGjb3-6MfR4XKQjy9sJPS9dS0yTxVO6MYQ8YlGjGw,16071
-prefect/flows.py,sha256=XT-RPAsY4twN5hQOoM_8AsB5zfI_pLVuq7KL46hPr1A,81075
-prefect/futures.py,sha256=-ElpB4lcjJxMS1Jl-iHnUEofpgoSs2xCtMgR3_F4bTE,9139
+prefect/flows.py,sha256=fODMwvsgkNkIy1eWCqh5zHLDpLaL1LXCN17Ygpg0MdU,79204
+prefect/futures.py,sha256=mI3WuaH3k0LkqwPbM6V7WbG0ssT-NjpX1wROS7vSKE0,9882
 prefect/manifests.py,sha256=477XcmfdC_yE81wT6zIAKnEUEJ0lH9ZLfOVSgX2FohE,676
 prefect/plugins.py,sha256=-IqPJvQGoMZBioHCF0s1IDNHYA7OxIRaUlkaGM2CgLY,4164
 prefect/profiles.toml,sha256=Fs8hD_BdWHZgAijgk8pK_Zx-Pm-YFixqDIfEP6fM-qU,38
 prefect/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-prefect/results.py,sha256=oFJkqoZKXTvTdfDCY9Lz1pnCiTK_fZ74BwzUshf_pBg,25161
+prefect/results.py,sha256=qG-5mAlZTRV7GneuQVS7GpHHt3QXcZbwLwn03fHAi4M,27326
 prefect/serializers.py,sha256=8ON--RmaLX3Td3Rpd1lshGcqWyjlCFkmO3sblxsdT_c,8699
-prefect/settings.py,sha256=7SQtJWmHdJl5iA0EY-Q_FC3WZ9fCTwgnFT6N34p4STA,74607
-prefect/states.py,sha256=GDpFM6UUMB5MkCDWyqo8F9ELnkskr1BTg4YdU_bnv7Q,20395
-prefect/task_engine.py,sha256=LnHRiEZKjZjsSodnO2996OerVj-V-ozV0mAm3yDeF34,32179
+prefect/settings.py,sha256=JkCgcFO7Zw0Kv_azK9XLabx08ypVgL76E6r8nD-HZLM,74598
+prefect/states.py,sha256=JdN01UMYFelFybPoAEKbiPJNuPaj6pksLJ3o0_oNz5Q,20690
+prefect/task_engine.py,sha256=dzMID0AhbRlJnrm7U-PjJ8DxvW2J0j2jStOvDRuZDJs,32317
 prefect/task_runners.py,sha256=TQHyQATPkZE6BNVJ_JQBNmiL1kdgZRjY_Fjs3-N1UiE,11869
-prefect/task_runs.py,sha256=oeH1JKeg214UMpdEUoX1SOq1C2raGVOW-VwZLltzkK8,7175
-prefect/task_worker.py,sha256=Jw64k3Nigye3FgHvG4DM3z808YaTaLBneO4IB2wbBHc,13074
-prefect/tasks.py,sha256=fntgTe9X_XX1-i7X3ch45QVyMz2zOVV1e4oz5sSRCg8,60189
-prefect/transactions.py,sha256=gGf7La0AyhMZJoWIlmVxoHkFpcWb6roGrVf2DGlZfOE,9443
+prefect/task_runs.py,sha256=eDWYH5H1K4SyduhKmn3GzO6vM3fZSwOZxAb8KhkMGsk,7798
+prefect/task_worker.py,sha256=iawQZn4hNcrXR-CHtM4jzhlnotqeNHiRuHc-eumJ9Oc,16788
+prefect/tasks.py,sha256=-j9ZCxvfvgHkyUsaRuj9EhEWmfO4NLN76Pg2_yGCaL0,60243
+prefect/transactions.py,sha256=XhEXdhid1457m5V7VTz1U8JCek6U6jSFD7EffGhCLag,9149
 prefect/variables.py,sha256=-t5LVY0N-K4f0fa6YwruVVQqwnU3fGWBMYXXE32XPkA,4821
 prefect/_internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/_internal/_logging.py,sha256=HvNHY-8P469o5u4LYEDBTem69XZEt1QUeUaLToijpak,810
@@ -59,7 +59,6 @@ prefect/blocks/__init__.py,sha256=BUfh6gIwA6HEjRyVCAiv0he3M1zfM-oY-JrlBfeWeY8,18
 prefect/blocks/abstract.py,sha256=YLzCaf3yXv6wFCF5ZqCIHJNwH7fME1rLxC-SijARHzk,16319
 prefect/blocks/core.py,sha256=cgkPF1rpNl_4Asekh2RJ0RiMmjqtuQEbp52BDXgxdbY,46657
 prefect/blocks/fields.py,sha256=1m507VVmkpOnMF_7N-qboRjtw4_ceIuDneX3jZ3Jm54,63
-prefect/blocks/kubernetes.py,sha256=1AHzcI2hPeu5zOEKLC4FBjjv8VdZ8ianuv6oVEh4ou8,4016
 prefect/blocks/notifications.py,sha256=QV2ndeiERBbL9vNW2zR1LzH86llDY1sJVh2DN0sh1eo,28198
 prefect/blocks/redis.py,sha256=GUKYyx2QLtyNvgf5FT_dJxbgQcOzWCja3I23J1-AXhM,5629
 prefect/blocks/system.py,sha256=tkONKzDlaQgR6NtWXON0ZQm7nGuFKt0_Du3sj8ubs-M,3605
@@ -70,30 +69,34 @@ prefect/client/cloud.py,sha256=5T84QP9IRa_cqL7rmY3lR1wxFW6C41PajFZgelurhK0,4124
 prefect/client/collections.py,sha256=I9EgbTg4Fn57gn8vwP_WdDmgnATbx9gfkm2jjhCORjw,1037
 prefect/client/constants.py,sha256=Z_GG8KF70vbbXxpJuqW5pLnwzujTVeHbcYYRikNmGH0,29
 prefect/client/orchestration.py,sha256=0wK6LEWgKgsrgy6kF654EiweorId8nmX5nzXp-BtSgU,142641
-prefect/client/subscriptions.py,sha256=LGMxFO20fp4gRgGTIq62HZemTgVNHHSHzbpPn6syw0U,3374
+prefect/client/subscriptions.py,sha256=J9uK9NGHO4VX4Y3NGgBJ4pIG_0cf-dJWPhF3f3PGYL4,3388
 prefect/client/utilities.py,sha256=Ni1DsFDhnvxpXWerlvZpK8tCg-uZ8UyZwOmDTKEb1DI,3269
 prefect/client/schemas/__init__.py,sha256=KlyqFV-hMulMkNstBn_0ijoHoIwJZaBj6B1r07UmgvE,607
 prefect/client/schemas/actions.py,sha256=t-JJCikwa_ZrTPu7VJDwkLQ2fgNQuYHUwAi_3PHpwoU,28113
 prefect/client/schemas/filters.py,sha256=HyIYZQowhkHa_D6syj83zUp5uFEzA8UADLaS9mt1MTo,35305
 prefect/client/schemas/objects.py,sha256=htwlQ1CYcouNPWENVLyWyWSGRfjNXRIxvuYG_nKcnlE,53308
 prefect/client/schemas/responses.py,sha256=YnofjvPxaDE0kPw7SLfK5TuZSJ0IlqP2G17rQgz_buk,15135
-prefect/client/schemas/schedules.py,sha256=EIvVQN01ZnLf6Yu-3_Ar1iHybDwJ6C767AAnqMhVxWo,12846
+prefect/client/schemas/schedules.py,sha256=8rpqjOYtknu2-1n5_WD4cOplgu93P3mCyX86B22LfL4,13070
 prefect/client/schemas/sorting.py,sha256=EIQ6FUjUWMwk6fn6ckVLQLXOP-GI5kce7ftjUkDFWV0,2490
+prefect/client/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+prefect/client/types/flexible_schedule_list.py,sha256=F1VFAXGLM89dJRBLnVsxwAMGLmrRF2i81FirEMpbB5s,368
 prefect/concurrency/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-prefect/concurrency/asyncio.py,sha256=P9e69XYik9QBSlUYyq1OcyqyUJaFjvW8jm6nfMkZ7uA,4304
+prefect/concurrency/asyncio.py,sha256=sn5Wm6pOnU0bnfJiwltwWBcouj-rhGg27Zkzw7zfVuA,4684
 prefect/concurrency/events.py,sha256=rQLSBwcYCzvdKTXr7bLjgMIklllObxB33MAL6dylXAM,1802
-prefect/concurrency/services.py,sha256=JP74IUjdoDoljy-BdZQTa1IOEuSZZxMgsMyr7KJAYS0,2598
-prefect/concurrency/sync.py,sha256=gXyiiA0bul7jjpHWPm6su8pFdBiMOekhu9FHnjiPWBQ,3339
-prefect/deployments/__init__.py,sha256=9MnrUjil46PHWq-ni-3BLmgyJWAzlzORF5XZA-KdhYc,432
+prefect/concurrency/services.py,sha256=pxqfjA5DpzcpbU-E2TQT1Rq8BhOGf3Sfz5eTFE8sYu8,2981
+prefect/concurrency/sync.py,sha256=QtnPRfVX9GqVyuZOt6W9yJuT9G-PlCSVnxlZKFTjuKY,3271
+prefect/deployments/__init__.py,sha256=yAtuBvqhQNhlJHjPW6yQyjkPFCgew3t26NAKO2RnQyk,428
 prefect/deployments/base.py,sha256=j2VUHkghXCqbfYJD8Joeh12Ejh4KCzr2DgVPRpDpbLw,16600
 prefect/deployments/deployments.py,sha256=EvC9qBdvJRc8CHJqRjFTqtzx75SE8bpZOl5C-2eULyA,109
 prefect/deployments/flow_runs.py,sha256=eatcBD7pg-aaEqs9JxQQcKN_flf614O4gAvedAlRyNo,6803
-prefect/deployments/runner.py,sha256=5f3pFGxw_DOA9k169KFIzILTZ_TkKIWI9DLhl1iK1Ck,44716
-prefect/deployments/schedules.py,sha256=c8ONC9t_buAWVxfcWAQEGhuIkU5rAjetuvU87PLJx48,2031
+prefect/deployments/runner.py,sha256=wVz2Ltis_tOpWLvLzPuOBJBIsdWqs8aXY2oCOuwhssc,41763
+prefect/deployments/schedules.py,sha256=l1xOHBmJJ-VZFPTX4RWScJ802P-iE81Vzp4EniQ65k4,2004
 prefect/deployments/steps/__init__.py,sha256=Dlz9VqMRyG1Gal8dj8vfGpPr0LyQhZdvcciozkK8WoY,206
 prefect/deployments/steps/core.py,sha256=yKBVi8pi_7fzdng28kUD8vcSl5aED5yFnu9KxCdquKA,6627
 prefect/deployments/steps/pull.py,sha256=ylp3fd72hEfmY67LQs7sMwdcK6KKobsTZOeay-YUl8Q,7125
 prefect/deployments/steps/utility.py,sha256=s5mMBmHVCS1ZRBRUCunwPueU_7Dii_GK6CqCoznwUCc,8134
+prefect/docker/__init__.py,sha256=jumlacz2HY9l1ee0L9_kE0PFi9NO3l3pWINm9T5N9hs,524
+prefect/docker/docker_image.py,sha256=Y84_ooCYA9NGl6FElJul9-FaW3teT-eia2SiNtZ1LG8,2999
 prefect/events/__init__.py,sha256=GtKl2bE--pJduTxelH2xy7SadlLJmmis8WR1EYixhuA,2094
 prefect/events/actions.py,sha256=4kBV2NwFlC6oXVeMp9Qb2HMNqv1IZ7FcOqeXz1zlRf0,8983
 prefect/events/clients.py,sha256=nDP8AQCoPNOfRPgS9QbEvdpx0wKyE4_4gwxQEtsnuUA,19860
@@ -110,9 +113,9 @@ prefect/events/schemas/events.py,sha256=RqosMukGfHvLPnYDcyxkm6VuifCeH5-aQ4POdMPm
 prefect/events/schemas/labelling.py,sha256=bU-XYaHXhI2MEBIHngth96R9D02m8HHb85KNcHZ_1Gc,3073
 prefect/infrastructure/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/infrastructure/provisioners/__init__.py,sha256=wn240gHrQbien2g_g2A8Ujb2iFyjmDgMHLQ7tgQngf4,1706
-prefect/infrastructure/provisioners/cloud_run.py,sha256=A2q9LhYQbbOZd-W5VG_Uy8KbEkttXu7Fj2DiQrOUhL0,17758
-prefect/infrastructure/provisioners/container_instance.py,sha256=-PNd-A088SnEDhj3m7foSE9iBsmVqoHUEmtT26XtJt8,41294
-prefect/infrastructure/provisioners/ecs.py,sha256=PVH3ByIqm0aoJ39nDpW1LsSsi7rcERFBdqO16KxIUic,47736
+prefect/infrastructure/provisioners/cloud_run.py,sha256=K6_8AO_fZRfuI0hGx_EwvlRkiNPcmR5yD9P8B-QSjuc,17745
+prefect/infrastructure/provisioners/container_instance.py,sha256=ZaiaAOywMjbhZI6emzqsDQh-xBePajzjjMT_JY8lwNA,41281
+prefect/infrastructure/provisioners/ecs.py,sha256=8cqabILtoy7t3ISuX8VbFCcG3IOFr3ODWWLi3ls2NyU,47723
 prefect/infrastructure/provisioners/modal.py,sha256=4-VanBPqWlAj_5ckpXT7NonbqP0YwznTXFa4P8cthIs,9080
 prefect/input/__init__.py,sha256=Ue2h-YhYP71nEtsVJaslqMwO6C0ckjhjTYwwEgp-E3g,701
 prefect/input/actions.py,sha256=IGdWjVcesnRjLmPCzB4ZM7FkRWXDKCku6yhE-7p0vKk,3777
@@ -127,11 +130,11 @@ prefect/logging/loggers.py,sha256=qWM-5IxN3U5MlK7srfALOC9sCpGqt20Vu9WSxpU2zIs,11
 prefect/logging/logging.yml,sha256=UkEewf0c3_dURI2uCU4RrxkhI5Devoa1s93fl7hilcg,3160
 prefect/records/__init__.py,sha256=7q-lwyevfVgb5S7K9frzawmiJmpZ5ET0m5yXIHBYcVA,31
 prefect/records/cache_policies.py,sha256=2R6tQioujG2qr5rQgg7kPK-SLMM1lUHplEKcOfJbrh0,4761
-prefect/records/result_store.py,sha256=pyhMr5OKto1NhWuVrEVBd6-Z4Dc0N0xdYApwDAQL8IM,1557
+prefect/records/result_store.py,sha256=6Yh9zqqXMWjn0qWSfcjQBSfXCM7jVg9pve5TVsOodDc,1734
 prefect/records/store.py,sha256=eQM1p2vZDshXZYg6SkJwL-DP3kUehL_Zgs8xa2-0DZs,224
 prefect/runner/__init__.py,sha256=7U-vAOXFkzMfRz1q8Uv6Otsvc0OrPYLLP44srwkJ_8s,89
-prefect/runner/runner.py,sha256=7WhYpDXQwtO4XyfLKNk27QuFXnrLKD4rJPiSfUab6OI,45098
-prefect/runner/server.py,sha256=UN44qjP1SjuA5OCp5PoPhRAfKXMVGEm9E2b-bWB-suk,10519
+prefect/runner/runner.py,sha256=aR9Figoyvn0PAKv8zussaT7sJP9zM-SAmrcYZN19ZB8,45152
+prefect/runner/server.py,sha256=pXyNGDw2aBYCXRr3zyFCaflxUaQOG4M07zxwXiFngoQ,10676
 prefect/runner/storage.py,sha256=nuzkEjmAZYAjCEpXhuuZSGJAqBARICIBmDQNqDgI4yk,22316
 prefect/runner/submit.py,sha256=EpgYNR-tAub0VFVTIkijp8qwHcS1iojLAZN5NM0X39s,8552
 prefect/runner/utils.py,sha256=wVgVa7p5uUL7tfYfDOVuq6QIGf-I8U9dfAjYBmYf6n4,3286
@@ -141,16 +144,17 @@ prefect/runtime/flow_run.py,sha256=Fxbyc4r3kPj2m3AIJT8gud2PB5w9aKTwkI-g4dysikE,8
 prefect/runtime/task_run.py,sha256=B6v_nZiHy9nKZfnKFQF7izZjAjaiZOT0j80m-VcLxmY,3403
 prefect/server/api/collections_data/views/aggregate-worker-metadata.json,sha256=gqrwGyylzBEzlFSPOJcMuUwdoK_zojpU0SZaBDgK5FE,79748
 prefect/server/api/static/prefect-logo-mark-gradient.png,sha256=ylRjJkI_JHCw8VbQasNnXQHwZW-sH-IQiUGSD3aWP1E,73430
-prefect/types/__init__.py,sha256=SsjNhBX_O-z8gqtCm-ettrg481gqz1qVZUoxAY9fhrM,2169
+prefect/types/__init__.py,sha256=SAHJDtWEGidTKXQACJ38nj6fq8r57Gj0Pwo4Gy7pVWs,2234
+prefect/types/entrypoint.py,sha256=2FF03-wLPgtnqR_bKJDB2BsXXINPdu8ptY9ZYEZnXg8,328
 prefect/utilities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/utilities/annotations.py,sha256=bXB43j5Zsq5gaBcJe9qnszBlnNwCTwqSTgcu2OkkRLo,2776
 prefect/utilities/asyncutils.py,sha256=GRDiA3S9vGRpM3aKSq6iZnNP9XNBcfUg0NBwbjUFeAw,19200
 prefect/utilities/callables.py,sha256=rkPPzwiVFRoVszSUq612s9S0v3nxcMC-rIwfXoJTn0E,24915
-prefect/utilities/collections.py,sha256=9vUZA8j_NAOcsRZ45UWGYpO1EuUErcpcPTyZap5q28I,14883
+prefect/utilities/collections.py,sha256=2W7cgdB_c_LGMbHPmFSKJbwue_Ai8h5CukSmFoZ8svE,17248
 prefect/utilities/compat.py,sha256=mNQZDnzyKaOqy-OV-DnmH_dc7CNF5nQgW_EsA4xMr7g,906
 prefect/utilities/context.py,sha256=BThuUW94-IYgFYTeMIM9KMo8ShT3oiI7w5ajZHzU1j0,1377
 prefect/utilities/dispatch.py,sha256=c8G-gBo7hZlyoD7my9nO50Rzy8Retk-np5WGq9_E2AM,5856
-prefect/utilities/dockerutils.py,sha256=b3_kzba6kXRtzQNcgyigrY4N4LuH_jr6J_L2kOD9lHU,20310
+prefect/utilities/dockerutils.py,sha256=kRozGQ7JO6Uxl-ljWtDryzxhf96rHL78aHYDh255Em4,20324
 prefect/utilities/engine.py,sha256=E5WSLg9XsvkEN56M8Q5Wl4k0INUpaqmvdToQPFjYWNo,30160
 prefect/utilities/filesystem.py,sha256=frAyy6qOeYa7c-jVbEUGZQEe6J1yF8I_SvUepPd59gI,4415
 prefect/utilities/hashing.py,sha256=EOwZLmoIZImuSTxAvVqInabxJ-4RpEfYeg9e2EDQF8o,1752
@@ -165,7 +169,7 @@ prefect/utilities/slugify.py,sha256=57Vb14t13F3zm1P65KAu8nVeAz0iJCd1Qc5eMG-R5y8,
 prefect/utilities/templating.py,sha256=nAiOGMMHGbIDFkGYy-g-dzcbY311WfycdgAhsM3cLpY,13298
 prefect/utilities/text.py,sha256=eXGIsCcZ7h_6hy8T5GDQjL8GiKyktoOqavYub0QjgO4,445
 prefect/utilities/timeout.py,sha256=nxmuPxROIT-i8gPffpARuxnxu58H0vkmbjTVIgef0_0,805
-prefect/utilities/urls.py,sha256=Qw6IlI7CKAlA3t2Ii-b09fXRJTaHuqLFNM2KVhI_yQI,6400
+prefect/utilities/urls.py,sha256=GuiV3mk-XfzXx139ySyNQNbNaolA3T-hUZvW3T_PhXU,6396
 prefect/utilities/visualization.py,sha256=Lum4IvLQ0nHsdLt6GGzS3Wwo-828u1rmOKc5mmWu994,6502
 prefect/utilities/schema_tools/__init__.py,sha256=KsFsTEHQqgp89TkDpjggkgBBywoHQPxbx-m6YQhiNEI,322
 prefect/utilities/schema_tools/hydration.py,sha256=Nitnmr35Mcn5z9NXIvh9DuZW5nCZxpjyMc9RFawMsgs,8376
@@ -175,8 +179,8 @@ prefect/workers/base.py,sha256=62E0Q41pPr3eQdSBSUBfiR4WYx01OfuqUp5INRqHGgo,46942
 prefect/workers/process.py,sha256=vylkSSswaSCew-V65YW0HcxIxyKI-uqWkbSKpkkLamQ,9372
 prefect/workers/server.py,sha256=EfPiMxI7TVgkqpHkdPwSaYG-ydi99sG7jwXhkAcACbI,1519
 prefect/workers/utilities.py,sha256=VfPfAlGtTuDj0-Kb8WlMgAuOfgXCdrGAnKMapPSBrwc,2483
-prefect_client-3.0.0rc3.dist-info/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
-prefect_client-3.0.0rc3.dist-info/METADATA,sha256=S_JWxgOm7Nj3tN3KKouc_NzXeAMLWBZMyYW6BqZwfFo,7397
-prefect_client-3.0.0rc3.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-prefect_client-3.0.0rc3.dist-info/top_level.txt,sha256=MJZYJgFdbRc2woQCeB4vM6T33tr01TmkEhRcns6H_H4,8
-prefect_client-3.0.0rc3.dist-info/RECORD,,
+prefect_client-3.0.0rc5.dist-info/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.0.0rc5.dist-info/METADATA,sha256=fGHLD4XaLt3FzjMoZxnEJcK-rByrMfxN-Bpu27Y66Ao,7392
+prefect_client-3.0.0rc5.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+prefect_client-3.0.0rc5.dist-info/top_level.txt,sha256=MJZYJgFdbRc2woQCeB4vM6T33tr01TmkEhRcns6H_H4,8
+prefect_client-3.0.0rc5.dist-info/RECORD,,

prefect/blocks/kubernetes.py

@@ -1,115 +0,0 @@
-from pathlib import Path
-from typing import TYPE_CHECKING, Dict, Optional, Type
-
-import yaml
-from pydantic import Field, field_validator
-from typing_extensions import Self
-
-from prefect._internal.compatibility.deprecated import deprecated_class
-from prefect._internal.schemas.validators import validate_yaml
-from prefect.blocks.core import Block
-from prefect.utilities.collections import listrepr
-from prefect.utilities.importtools import lazy_import
-
-if TYPE_CHECKING:
-    import kubernetes
-    from kubernetes.client.api_client import ApiClient
-else:
-    kubernetes = lazy_import("kubernetes")
-
-
-@deprecated_class(
-    start_date="Mar 2024",
-    help="Use the KubernetesClusterConfig block from prefect-kubernetes instead.",
-)
-class KubernetesClusterConfig(Block):
-    """
-    Stores configuration for interaction with Kubernetes clusters.
-
-    See `from_file` for creation.
-
-    Attributes:
-        config: The entire loaded YAML contents of a kubectl config file
-        context_name: The name of the kubectl context to use
-
-    Example:
-        Load a saved Kubernetes cluster config:
-        ```python
-        from prefect.blocks.kubernetes import KubernetesClusterConfig
-
-        cluster_config_block = KubernetesClusterConfig.load("BLOCK_NAME")
-        ```
-    """
-
-    _block_type_name = "Kubernetes Cluster Config"
-    _logo_url = "https://cdn.sanity.io/images/3ugk85nk/production/2d0b896006ad463b49c28aaac14f31e00e32cfab-250x250.png"
-    _documentation_url = "https://docs.prefect.io/api-ref/prefect/blocks/kubernetes/#prefect.blocks.kubernetes.KubernetesClusterConfig"
-
-    config: Dict = Field(
-        default=..., description="The entire contents of a kubectl config file."
-    )
-    context_name: str = Field(
-        default=..., description="The name of the kubectl context to use."
-    )
-
-    @field_validator("config", mode="before")
-    @classmethod
-    def parse_yaml_config(cls, value):
-        return validate_yaml(value)
-
-    @classmethod
-    def from_file(
-        cls: Type[Self], path: Optional[Path] = None, context_name: Optional[str] = None
-    ) -> Self:
-        """
-        Create a cluster config from the a Kubernetes config file.
-
-        By default, the current context in the default Kubernetes config file will be
-        used.
-
-        An alternative file or context may be specified.
-
-        The entire config file will be loaded and stored.
-        """
-        kube_config = kubernetes.config.kube_config
-
-        path = Path(path or kube_config.KUBE_CONFIG_DEFAULT_LOCATION)
-        path = path.expanduser().resolve()
-
-        # Determine the context
-        existing_contexts, current_context = kube_config.list_kube_config_contexts(
-            config_file=str(path)
-        )
-        context_names = {ctx["name"] for ctx in existing_contexts}
-        if context_name:
-            if context_name not in context_names:
-                raise ValueError(
-                    f"Context {context_name!r} not found. "
-                    f"Specify one of: {listrepr(context_names, sep=', ')}."
-                )
-        else:
-            context_name = current_context["name"]
-
-        # Load the entire config file
-        config_file_contents = path.read_text()
-        config_dict = yaml.safe_load(config_file_contents)
-
-        return cls(config=config_dict, context_name=context_name)
-
-    def get_api_client(self) -> "ApiClient":
-        """
-        Returns a Kubernetes API client for this cluster config.
-        """
-        return kubernetes.config.kube_config.new_client_from_config_dict(
-            config_dict=self.config, context=self.context_name
-        )
-
-    def configure_client(self) -> None:
-        """
-        Activates this cluster configuration by loading the configuration into the
-        Kubernetes Python client. After calling this, Kubernetes API clients can use
-        this config's context.
-        """
-        kubernetes.config.kube_config.load_kube_config_from_dict(
-            config_dict=self.config, context=self.context_name
-        )