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

prefect/_build_info.py

@@ -1,5 +1,5 @@
 # Generated by versioningit
-__version__ = "3.4.7.dev7"
-__build_date__ = "2025-06-24 08:09:27.221869+00:00"
-__git_commit__ = "3614ff28a5600b1965c957a04e880aaf38442ad5"
+__version__ = "3.4.7.dev8"
+__build_date__ = "2025-06-25 08:09:28.547496+00:00"
+__git_commit__ = "f2c59127b60d3a91a1da167603522185fac2be50"
 __dirty__ = False

prefect/artifacts.py

@@ -55,7 +55,7 @@ class Artifact(ArtifactRequest):
             client: The PrefectClient
 
         Returns:
-            - The created artifact.
+            The created artifact.
         """
 
         local_client_context = asyncnullcontext(client) if client else get_client()
@@ -93,7 +93,7 @@ class Artifact(ArtifactRequest):
             client: The PrefectClient
 
         Returns:
-            - The created artifact.
+            The created artifact.
         """
 
         # Create sync client since this is a sync method.
@@ -417,6 +417,23 @@ def create_link_artifact(
 
     Returns:
         The table artifact ID.
+
+    Example:
+        ```python
+        from prefect import flow
+        from prefect.artifacts import create_link_artifact
+
+        @flow
+        def my_flow():
+            create_link_artifact(
+                link="https://www.prefect.io",
+                link_text="Prefect",
+                key="prefect-link",
+                description="This is a link to the Prefect website",
+            )
+
+        my_flow()
+        ```
     """
     new_artifact = LinkArtifact(
         key=key,
@@ -475,6 +492,22 @@ def create_markdown_artifact(
 
     Returns:
         The table artifact ID.
+
+    Example:
+        ```python
+        from prefect import flow
+        from prefect.artifacts import create_markdown_artifact
+
+        @flow
+        def my_flow():
+            create_markdown_artifact(
+                markdown="## Prefect",
+                key="prefect-markdown",
+                description="This is a markdown artifact",
+            )
+
+        my_flow()
+        ```
     """
     new_artifact = MarkdownArtifact(
         key=key,
@@ -533,6 +566,22 @@ def create_table_artifact(
 
     Returns:
         The table artifact ID.
+
+    Example:
+        ```python
+        from prefect import flow
+        from prefect.artifacts import create_table_artifact
+
+        @flow
+        def my_flow():
+            create_table_artifact(
+                table=[{"name": "John", "age": 30}, {"name": "Jane", "age": 25}],
+                key="prefect-table",
+                description="This is a table artifact",
+            )
+
+        my_flow()
+        ```
     """
 
     new_artifact = TableArtifact(

prefect/events/schemas/labelling.py

@@ -8,6 +8,7 @@ class LabelDiver:
     presenting the labels as a graph of objects that may be accessed by attribute.  For
     example:
 
+        ```python
         diver = LabelDiver({
             'hello.world': 'foo',
             'hello.world.again': 'bar'
@@ -15,6 +16,7 @@ class LabelDiver:
 
         assert str(diver.hello.world) == 'foo'
         assert str(diver.hello.world.again) == 'bar'
+        ```
 
     """
 

prefect/settings/context.py

@@ -33,20 +33,23 @@ def temporary_settings(
     See `Settings.copy_with_update` for details on different argument behavior.
 
     Examples:
-        >>> from prefect.settings import PREFECT_API_URL
-        >>>
-        >>> with temporary_settings(updates={PREFECT_API_URL: "foo"}):
-        >>>    assert PREFECT_API_URL.value() == "foo"
-        >>>
-        >>>    with temporary_settings(set_defaults={PREFECT_API_URL: "bar"}):
-        >>>         assert PREFECT_API_URL.value() == "foo"
-        >>>
-        >>>    with temporary_settings(restore_defaults={PREFECT_API_URL}):
-        >>>         assert PREFECT_API_URL.value() is None
-        >>>
-        >>>         with temporary_settings(set_defaults={PREFECT_API_URL: "bar"})
-        >>>             assert PREFECT_API_URL.value() == "bar"
-        >>> assert PREFECT_API_URL.value() is None
+
+        ```python
+        from prefect.settings import PREFECT_API_URL
+
+        with temporary_settings(updates={PREFECT_API_URL: "foo"}):
+           assert PREFECT_API_URL.value() == "foo"
+
+           with temporary_settings(set_defaults={PREFECT_API_URL: "bar"}):
+                assert PREFECT_API_URL.value() == "foo"
+
+           with temporary_settings(restore_defaults={PREFECT_API_URL}):
+                assert PREFECT_API_URL.value() is None
+
+                with temporary_settings(set_defaults={PREFECT_API_URL: "bar"})
+                    assert PREFECT_API_URL.value() == "bar"
+        assert PREFECT_API_URL.value() is None
+        ```
     """
     import prefect.context
 

prefect/utilities/collections.py

@@ -629,12 +629,12 @@ def get_from_dict(
         The fetched value if the key exists, or the default value if it does not.
 
     Examples:
-    >>> get_from_dict({'a': {'b': {'c': [1, 2, 3, 4]}}}, 'a.b.c[1]')
-    2
-    >>> get_from_dict({'a': {'b': [0, {'c': [1, 2]}]}}, ['a', 'b', 1, 'c', 1])
-    2
-    >>> get_from_dict({'a': {'b': [0, {'c': [1, 2]}]}}, 'a.b.1.c.2', 'default')
-    'default'
+
+    ```python
+    get_from_dict({'a': {'b': {'c': [1, 2, 3, 4]}}}, 'a.b.c[1]') # 2
+    get_from_dict({'a': {'b': [0, {'c': [1, 2]}]}}, ['a', 'b', 1, 'c', 1]) # 2
+    get_from_dict({'a': {'b': [0, {'c': [1, 2]}]}}, 'a.b.1.c.2', 'default') # 'default'
+    ```
     """
     if isinstance(keys, str):
         keys = keys.replace("[", ".").replace("]", "").split(".")

prefect/utilities/engine.py

@@ -72,9 +72,12 @@ async def collect_task_run_inputs(
     found.
 
     Examples:
-        >>> task_inputs = {
-        >>>    k: await collect_task_run_inputs(v) for k, v in parameters.items()
-        >>> }
+
+        ```python
+        task_inputs = {
+            k: await collect_task_run_inputs(v) for k, v in parameters.items()
+         }
+        ```
     """
     # TODO: This function needs to be updated to detect parameters and constants
 
@@ -120,9 +123,11 @@ def collect_task_run_inputs_sync(
     found.
 
     Examples:
-        >>> task_inputs = {
-        >>>    k: collect_task_run_inputs_sync(v) for k, v in parameters.items()
-        >>> }
+        ```python
+        task_inputs = {
+            k: collect_task_run_inputs_sync(v) for k, v in parameters.items()
+         }
+        ```
     """
     # TODO: This function needs to be updated to detect parameters and constants
 

prefect/workers/base.py

@@ -208,10 +208,12 @@ class BaseJobConfiguration(BaseModel):
         Defaults to using the job configuration parameter name as the template variable name.
 
         e.g.
+        ```python
         {
             key1: '{{ key1 }}',     # default variable template
             key2: '{{ template2 }}', # `template2` specifically provide as template
         }
+        ```
         """
         configuration: dict[str, Any] = {}
         properties = cls.model_json_schema()["properties"]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.4.7.dev7
+Version: 3.4.7.dev8
 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.dev7.dist-info → prefect_client-3.4.7.dev8.dist-info}/RECORD

@@ -2,12 +2,12 @@ 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=cJqOi7wQGRupy4Rsu7Su9cZXMkfbV29ES1HTg1M-8LQ,185
+prefect/_build_info.py,sha256=vtIbRKEkWF6yy5x3d3LhHvxh02unYDsxXxlBnW3k6Dc,185
 prefect/_result_records.py,sha256=S6QmsODkehGVSzbMm6ig022PYbI6gNKz671p_8kBYx4,7789
 prefect/_versioning.py,sha256=YqR5cxXrY4P6LM1Pmhd8iMo7v_G2KJpGNdsf4EvDFQ0,14132
 prefect/_waiters.py,sha256=Ia2ITaXdHzevtyWIgJoOg95lrEXQqNEOquHvw3T33UQ,9026
 prefect/agent.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
-prefect/artifacts.py,sha256=dMBUOAWnUamzjb5HSqwB5-GR2Qb-Gxee26XG5NDCUuw,22720
+prefect/artifacts.py,sha256=ZdMLJeJGK82hibtRzbsVa-g95dMa0D2UP1LiESoXmf4,23951
 prefect/automations.py,sha256=ZzPxn2tINdlXTQo805V4rIlbXuNWxd7cdb3gTJxZIeY,12567
 prefect/cache_policies.py,sha256=jH1aDW6vItTcsEytuTCrNYyjbq87IQPwdOgF0yxiUts,12749
 prefect/context.py,sha256=2yhyJmomB0S8n18vCYZIykqZFmUAiqTH06qigAsoGtk,32648
@@ -166,7 +166,7 @@ prefect/events/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 prefect/events/schemas/automations.py,sha256=GVAfgyNoTxr8NpEw_Ao-1Prfd_MSsrhrLsXv6SLKUdY,14775
 prefect/events/schemas/deployment_triggers.py,sha256=OX9g9eHe0nqJ3PtVEzqs9Ub2LaOHMA4afLZSvSukKGU,3191
 prefect/events/schemas/events.py,sha256=r8sSx2Q1A0KIofnZR_Bri7YT1wzXKV3YS-LnxpeIXHE,9270
-prefect/events/schemas/labelling.py,sha256=bU-XYaHXhI2MEBIHngth96R9D02m8HHb85KNcHZ_1Gc,3073
+prefect/events/schemas/labelling.py,sha256=McGy7dq6Ry2GY3ejnMQnkuL_h77F5MnHXQkyCdePlLU,3103
 prefect/infrastructure/__init__.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/infrastructure/base.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/infrastructure/provisioners/__init__.py,sha256=NTDdbkBE37FiBcroja5huuyWr4xYljjQp3ZnD7oplrA,1801
@@ -245,7 +245,7 @@ prefect/server/api/ui/task_runs.py,sha256=6CMrHmY-ybJGHXz7YlVVP2ZTmvq7w-XA9GUHqC
 prefect/settings/__init__.py,sha256=3jDLzExmq9HsRWo1kTSE16BO_3B3JlVsk5pR0s4PWEQ,2136
 prefect/settings/base.py,sha256=VtBSwBLowLvtBVDq3ZY5oKAwosMqsDMt2gcXLAiFf5k,9682
 prefect/settings/constants.py,sha256=5NjVLG1Km9J9I-a6wrq-qmi_dTkPdwEk3IrY9bSxWvw,281
-prefect/settings/context.py,sha256=yKxnaDJHX8e2jmAVtw1RF9o7X4V3AOcz61sVeQyPX2c,2195
+prefect/settings/context.py,sha256=VtMJsBtjwq_P3La9_SRYedBkyjmMNqV_4X_U4h_-6wM,2142
 prefect/settings/legacy.py,sha256=KG00GwaURl1zbwfCKAjwNRdJjB2UdTyo80gYF7U60jk,5693
 prefect/settings/profiles.py,sha256=Mk-fcfDUuJx5zIpp87Ar8d9jLFTgCOM83vEJWgmECBc,12795
 prefect/settings/profiles.toml,sha256=kTvqDNMzjH3fsm5OEI-NKY4dMmipor5EvQXRB6rPEjY,522
@@ -297,12 +297,12 @@ prefect/utilities/_git.py,sha256=bPYWQdr9xvH0BqxR1ll1RkaSb3x0vhwylhYD5EilkKU,863
 prefect/utilities/annotations.py,sha256=0Elqgq6LR7pQqezNqT5wb6U_0e2pDO_zx6VseVL6kL8,4396
 prefect/utilities/asyncutils.py,sha256=xcfeNym2j3WH4gKXznON2hI1PpUTcwr_BGc16IQS3C4,19789
 prefect/utilities/callables.py,sha256=57adLaN2QGJEE0YCdv1jS1L5R3vi4IuzPiNVZ7cCcEk,25930
-prefect/utilities/collections.py,sha256=c3nPLPWqIZQQdNuHs_nrbQJwuhQSX4ivUl-h9LtzXto,23243
+prefect/utilities/collections.py,sha256=HP1s3B1d10woWzzRG8GU5Qwvq5yp4dKQ97u9Szz-d0k,23248
 prefect/utilities/compat.py,sha256=nnPA3lf2f4Y-l645tYFFNmj5NDPaYvjqa9pbGKZ3WKE,582
 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=nMtKaTDOIbMbUmDR3PcA_BOjOFKuginmrOERwfzub04,28316
+prefect/utilities/engine.py,sha256=4__SXJb_Rl9PrKFYALWTPzzpE_VUAlvWaA6xyQCucSo,28357
 prefect/utilities/filesystem.py,sha256=Pwesv71PGFhf3lPa1iFyMqZZprBjy9nEKCVxTkf_hXw,5710
 prefect/utilities/generics.py,sha256=o77e8a5iwmrisOf42wLp2WI9YvSw2xDW4vFdpdEwr3I,543
 prefect/utilities/hashing.py,sha256=7jRy26s46IJAFRmVnCnoK9ek9N4p_UfXxQQvu2tW6dM,2589
@@ -323,13 +323,13 @@ prefect/utilities/schema_tools/__init__.py,sha256=At3rMHd2g_Em2P3_dFQlFgqR_EpBwr
 prefect/utilities/schema_tools/hydration.py,sha256=NkRhWkNfxxFmVGhNDfmxdK_xeKaEhs3a42q83Sg9cT4,9436
 prefect/utilities/schema_tools/validation.py,sha256=Wix26IVR-ZJ32-6MX2pHhrwm3reB-Q4iB6_phn85OKE,10743
 prefect/workers/__init__.py,sha256=EaM1F0RZ-XIJaGeTKLsXDnfOPHzVWk5bk0_c4BVS44M,64
-prefect/workers/base.py,sha256=_Puzm_f2Q7YLI89G_u9oM3esvwUWIKZ3fpfPqi-KMQk,62358
+prefect/workers/base.py,sha256=umyfDUcyn1Ao4FCrtDH52t1KXLLIy0k3LYNIjPNxbGw,62388
 prefect/workers/block.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 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.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,,
+prefect_client-3.4.7.dev8.dist-info/METADATA,sha256=cmb5kLIW8kQyoy34VabdVPMInMhwbOKr08OAj6rwq_M,7517
+prefect_client-3.4.7.dev8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+prefect_client-3.4.7.dev8.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.4.7.dev8.dist-info/RECORD,,