prefect-client 3.4.8.dev1__tar.gz → 3.4.8.dev3__tar.gz

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.4.8.dev1
+Version: 3.4.8.dev3
 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.8.dev3/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.4.8.dev3"
+__build_date__ = "2025-07-02 08:09:25.725513+00:00"
+__git_commit__ = "8f38dd54f10623fac36f1e92fee6f3747c5053f3"
+__dirty__ = False

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/_internal/uuid7.py

@@ -74,17 +74,19 @@ def uuid7(
     Examples
     --------
 
-    >>> uuid7()
-    UUID('061cb26a-54b8-7a52-8000-2124e7041024')
-
-    >>> for fmt in ('bytes', 'hex', 'int', 'str', 'uuid', None):
-    ...     print(fmt, repr(uuid7(as_type=fmt)))
-    bytes b'\x06\x1c\xb8\xfe\x0f\x0b|9\x80\x00\tjt\x85\xb3\xbb'
-    hex '061cb8fe0f0b7c3980011863b956b758'
-    int 8124504378724980906989670469352026642
-    str '061cb8fe-0f0b-7c39-8003-d44a7ee0bdf6'
-    uuid UUID('061cb8fe-0f0b-7c39-8004-0489578299f6')
-    None UUID('061cb8fe-0f0f-7df2-8000-afd57c2bf446')
+    ```python
+    uuid7()
+    # UUID('061cb26a-54b8-7a52-8000-2124e7041024')
+
+    for fmt in ('bytes', 'hex', 'int', 'str', 'uuid', None):
+        print(fmt, repr(uuid7(as_type=fmt)))
+    # bytes b'\x06\x1c\xb8\xfe\x0f\x0b|9\x80\x00\tjt\x85\xb3\xbb'
+    # hex '061cb8fe0f0b7c3980011863b956b758'
+    # int 8124504378724980906989670469352026642
+    # str '061cb8fe-0f0b-7c39-8003-d44a7ee0bdf6'
+    # uuid UUID('061cb8fe-0f0b-7c39-8004-0489578299f6')
+    # None UUID('061cb8fe-0f0f-7df2-8000-afd57c2bf446')
+    ```
     """
     if ms is None:
         ms = time_func()

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/client/__init__.py

@@ -7,10 +7,10 @@ Explore the client by communicating with an in-memory webserver - no setup requi
 ```
 $ # start python REPL with native await functionality
 $ python -m asyncio
->>> from prefect.client.orchestration import get_client
->>> async with get_client() as client:
-...     response = await client.hello()
-...     print(response.json())
+from prefect.client.orchestration import get_client
+async with get_client() as client:
+    response = await client.hello()
+    print(response.json())
 👋
 ```
 </div>

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/client/orchestration/__init__.py

@@ -292,15 +292,13 @@ class PrefectClient(
 
         Say hello to a Prefect REST API
 
-        <div class="terminal">
-        ```
-        >>> async with get_client() as client:
-        >>>     response = await client.hello()
-        >>>
-        >>> print(response.json())
+        ```python
+        async with get_client() as client:
+            response = await client.hello()
+
+        print(response.json())
         👋
         ```
-        </div>
     """
 
     def __init__(
@@ -1157,15 +1155,13 @@ class SyncPrefectClient(
 
         Say hello to a Prefect REST API
 
-        <div class="terminal">
-        ```
-        >>> with get_client(sync_client=True) as client:
-        >>>     response = client.hello()
-        >>>
-        >>> print(response.json())
+        ```python
+        with get_client(sync_client=True) as client:
+            response = client.hello()
+
+        print(response.json())
         👋
         ```
-        </div>
     """
 
     def __init__(

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/client/schemas/objects.py

@@ -305,48 +305,58 @@ class State(TimeSeriesBaseModel, ObjectBaseModel, Generic[R]):
         Examples:
             Get the result from a flow state
 
-            >>> @flow
-            >>> def my_flow():
-            >>>     return "hello"
-            >>> my_flow(return_state=True).result()
-            hello
+            ```python
+            @flow
+            def my_flow():
+                return "hello"
+            my_flow(return_state=True).result()
+            # hello
+            ```
 
             Get the result from a failed state
 
-            >>> @flow
-            >>> def my_flow():
-            >>>     raise ValueError("oh no!")
-            >>> state = my_flow(return_state=True)  # Error is wrapped in FAILED state
-            >>> state.result()  # Raises `ValueError`
+            ```python
+            @flow
+            def my_flow():
+                raise ValueError("oh no!")
+            state = my_flow(return_state=True)  # Error is wrapped in FAILED state
+            state.result()  # Raises `ValueError`
+            ```
 
             Get the result from a failed state without erroring
 
-            >>> @flow
-            >>> def my_flow():
-            >>>     raise ValueError("oh no!")
-            >>> state = my_flow(return_state=True)
-            >>> result = state.result(raise_on_failure=False)
-            >>> print(result)
-            ValueError("oh no!")
+            ```python
+            @flow
+            def my_flow():
+                raise ValueError("oh no!")
+            state = my_flow(return_state=True)
+            result = state.result(raise_on_failure=False)
+            print(result)
+            # ValueError("oh no!")
+            ```
 
 
             Get the result from a flow state in an async context
 
-            >>> @flow
-            >>> async def my_flow():
-            >>>     return "hello"
-            >>> state = await my_flow(return_state=True)
-            >>> await state.result()
-            hello
+            ```python
+            @flow
+            async def my_flow():
+                return "hello"
+            state = await my_flow(return_state=True)
+            await state.result()
+            # hello
+            ```
 
             Get the result with `raise_on_failure` from a flow run in a different memory space
 
-            >>> @flow
-            >>> async def my_flow():
-            >>>     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) # Raises `ValueError("oh no!")`
+            ```python
+            @flow
+            async def my_flow():
+                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) # Raises `ValueError("oh no!")`
+            ```
         """
         from prefect.states import get_state_result
 

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/context.py

@@ -788,45 +788,55 @@ def tags(*new_tags: str) -> Generator[set[str], None, None]:
         The current set of tags
 
     Examples:
-        >>> from prefect import tags, task, flow
-        >>> @task
-        >>> def my_task():
-        >>>     pass
+        ```python
+        from prefect import tags, task, flow
+        @task
+        def my_task():
+            pass
+        ```
 
         Run a task with tags
 
-        >>> @flow
-        >>> def my_flow():
-        >>>     with tags("a", "b"):
-        >>>         my_task()  # has tags: a, b
+        ```python
+        @flow
+        def my_flow():
+            with tags("a", "b"):
+                my_task()  # has tags: a, b
+        ```
 
         Run a flow with tags
 
-        >>> @flow
-        >>> def my_flow():
-        >>>     pass
-        >>> with tags("a", "b"):
-        >>>     my_flow()  # has tags: a, b
+        ```python
+        @flow
+        def my_flow():
+            pass
+        with tags("a", "b"):
+            my_flow()  # has tags: a, b
+        ```
 
         Run a task with nested tag contexts
 
-        >>> @flow
-        >>> def my_flow():
-        >>>     with tags("a", "b"):
-        >>>         with tags("c", "d"):
-        >>>             my_task()  # has tags: a, b, c, d
-        >>>         my_task()  # has tags: a, b
+        ```python
+        @flow
+        def my_flow():
+            with tags("a", "b"):
+                with tags("c", "d"):
+                    my_task()  # has tags: a, b, c, d
+                my_task()  # has tags: a, b
+        ```
 
         Inspect the current tags
 
-        >>> @flow
-        >>> def my_flow():
-        >>>     with tags("c", "d"):
-        >>>         with tags("e", "f") as current_tags:
-        >>>              print(current_tags)
-        >>> with tags("a", "b"):
-        >>>     my_flow()
-        {"a", "b", "c", "d", "e", "f"}
+        ```python
+        @flow
+        def my_flow():
+            with tags("c", "d"):
+                with tags("e", "f") as current_tags:
+                     print(current_tags)
+        with tags("a", "b"):
+            my_flow()
+        # {"a", "b", "c", "d", "e", "f"}
+        ```
     """
     current_tags = TagsContext.get().current_tags
     _new_tags = current_tags.union(new_tags)

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/deployments/steps/core.py

@@ -53,8 +53,8 @@ def _strip_version(requirement: str) -> str:
 
     Examples:
         ```python
-        >>> _strip_version("s3fs>=2.0.0<3.0.0")
-        "s3fs"
+        _strip_version("s3fs>=2.0.0<3.0.0")
+        # "s3fs"
         ```
     """
     # split on any of the characters in the set [<>=!~]

{prefect_client-3.4.8.dev1 → prefect_client-3.4.8.dev3}/src/prefect/events/cli/automations.py

@@ -107,6 +107,12 @@ async def inspect(
     id: Optional[str] = typer.Option(None, "--id", help="An automation's id"),
     yaml: bool = typer.Option(False, "--yaml", help="Output as YAML"),
     json: bool = typer.Option(False, "--json", help="Output as JSON"),
+    output: Optional[str] = typer.Option(
+        None,
+        "--output",
+        "-o",
+        help="Specify an output format. Currently supports: json, yaml",
+    ),
 ):
     """
     Inspect an automation.
@@ -129,8 +135,12 @@ async def inspect(
 
         $ prefect automation inspect "my-automation" --yaml
 
-        $ prefect automation inspect "my-automation" --json
+        $ prefect automation inspect "my-automation" --output json
+        $ prefect automation inspect "my-automation" --output yaml
     """
+    if output and output.lower() not in ["json", "yaml"]:
+        exit_with_error("Only 'json' and 'yaml' output formats are supported.")
+
     if not id and not name:
         exit_with_error("Please provide either a name or an id.")
 
@@ -148,7 +158,7 @@ async def inspect(
             except (PrefectHTTPStatusError, ValueError):
                 exit_with_error(f"Automation with id {id!r} not found.")
 
-    if yaml or json:
+    if yaml or json or (output and output.lower() in ["json", "yaml"]):
 
         def no_really_json(obj: Type[BaseModel]):
             # Working around a weird bug where pydantic isn't rendering enums as strings
@@ -165,9 +175,9 @@ async def inspect(
         elif isinstance(automation, Automation):
             automation = no_really_json(automation)
 
-        if yaml:
+        if yaml or (output and output.lower() == "yaml"):
             app.console.print(pyyaml.dump(automation, sort_keys=False))
-        elif json:
+        elif json or (output and output.lower() == "json"):
             app.console.print(
                 orjson.dumps(automation, option=orjson.OPT_INDENT_2).decode()
             )