prefect 3.7.1.dev1__tar.gz → 3.7.1.dev2__tar.gz

{prefect-3.7.1.dev1 → prefect-3.7.1.dev2}/PKG-INFO

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

prefect-3.7.1.dev2/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.1.dev2"
+__build_date__ = "2026-05-08 08:40:15.034303+00:00"
+__git_commit__ = "7b04d8f79b6541cb914d55f2860a83cf85bd9d5f"
+__dirty__ = False

{prefect-3.7.1.dev1 → prefect-3.7.1.dev2}/src/prefect/cli/experimental.py

@@ -14,6 +14,11 @@ experimental_app: cyclopts.App = cyclopts.App(
     version_flags=[],
     help_flags=["--help"],
 )
+experimental_app.command(
+    "prefect.cli.result_storage:result_storage_app",
+    name="result-storage",
+    help="Manage default result storage.",
+)
 
 plugins_app: cyclopts.App = cyclopts.App(
     name="plugins",

prefect-3.7.1.dev2/src/prefect/cli/result_storage.py

@@ -0,0 +1,172 @@
+"""
+Manage default result storage.
+"""
+
+from typing import Annotated
+from uuid import UUID
+
+import cyclopts
+import orjson
+from rich.table import Table
+
+import prefect.cli._app as _cli
+from prefect.cli._utilities import (
+    exit_with_error,
+    exit_with_success,
+    with_cli_exception_handling,
+)
+from prefect.client.orchestration import PrefectClient, get_client
+from prefect.exceptions import ObjectNotFound
+
+result_storage_app: cyclopts.App = cyclopts.App(
+    name="result-storage",
+    help="Manage default result storage.",
+)
+
+
+def _display_default_result_storage(
+    default_result_storage_block_id: UUID,
+    block_slug: str | None,
+) -> Table:
+    storage_table = Table(show_header=True, header_style="bold")
+    storage_table.add_column("Setting", style="cyan")
+    storage_table.add_column("Value")
+    storage_table.add_row(
+        "default_result_storage_block_id", str(default_result_storage_block_id)
+    )
+    if block_slug is not None:
+        storage_table.add_row("block", block_slug)
+    return storage_table
+
+
+async def _read_block_slug(
+    client: PrefectClient, block_document_id: UUID
+) -> str | None:
+    try:
+        block_document = await client.read_block_document(
+            block_document_id, include_secrets=False
+        )
+    except ObjectNotFound:
+        return None
+
+    block_type_slug = getattr(block_document.block_type, "slug", None)
+    if block_type_slug is None:
+        return block_document.name
+    return f"{block_type_slug}/{block_document.name}"
+
+
+async def _resolve_block_document_id(
+    client: PrefectClient,
+    block: str | None,
+    block_id: UUID | None,
+) -> UUID:
+    if block is None and block_id is None:
+        exit_with_error("Must provide a block slug or id.")
+    if block is not None and block_id is not None:
+        exit_with_error("Provide either a block slug or id, not both.")
+    if block_id is not None:
+        return block_id
+
+    assert block is not None
+    if "/" not in block:
+        exit_with_error(
+            f"{block!r} is not valid. Slug must contain a '/', e.g. "
+            "'local-file-system/my-results'."
+        )
+
+    block_type_slug, block_document_name = block.split("/", 1)
+    try:
+        block_document = await client.read_block_document_by_name(
+            block_document_name,
+            block_type_slug,
+            include_secrets=False,
+        )
+    except ObjectNotFound:
+        exit_with_error(f"Block {block!r} not found!")
+
+    return block_document.id
+
+
+@result_storage_app.command(name="inspect")
+@with_cli_exception_handling
+async def result_storage_inspect(
+    *,
+    output: Annotated[
+        str | None,
+        cyclopts.Parameter(
+            "--output",
+            alias="-o",
+            help="Specify an output format. Currently supports: json",
+        ),
+    ] = None,
+):
+    """Inspect the configured default result storage."""
+    if output and output.lower() != "json":
+        exit_with_error("Only 'json' output format is supported.")
+
+    async with get_client() as client:
+        configuration = await client.read_server_default_result_storage()
+        block_document_id = configuration.default_result_storage_block_id
+
+        if block_document_id is None:
+            if output and output.lower() == "json":
+                _cli.console.print(
+                    orjson.dumps(
+                        {"default_result_storage_block_id": None},
+                        option=orjson.OPT_INDENT_2,
+                    ).decode(),
+                    soft_wrap=True,
+                )
+            else:
+                _cli.console.print("No default result storage is configured.")
+            return
+
+        block_slug = await _read_block_slug(client, block_document_id)
+        if output and output.lower() == "json":
+            _cli.console.print(
+                orjson.dumps(
+                    {
+                        "default_result_storage_block_id": str(block_document_id),
+                        "block": block_slug,
+                    },
+                    option=orjson.OPT_INDENT_2,
+                ).decode(),
+                soft_wrap=True,
+            )
+        else:
+            _cli.console.print(
+                _display_default_result_storage(block_document_id, block_slug)
+            )
+
+
+@result_storage_app.command(name="set")
+@with_cli_exception_handling
+async def result_storage_set(
+    block: Annotated[
+        str | None,
+        cyclopts.Parameter(
+            help="A block slug in the form <BLOCK_TYPE_SLUG>/<BLOCK_NAME>."
+        ),
+    ] = None,
+    *,
+    block_id: Annotated[
+        UUID | None,
+        cyclopts.Parameter("--id", help="A block document id."),
+    ] = None,
+):
+    """Set the default result storage block."""
+    async with get_client() as client:
+        block_document_id = await _resolve_block_document_id(client, block, block_id)
+        await client.update_server_default_result_storage(block_document_id)
+
+    exit_with_success("Set default result storage.")
+
+
+@result_storage_app.command(name="clear")
+@with_cli_exception_handling
+async def result_storage_clear():
+    """Clear the configured default result storage."""
+    async with get_client() as client:
+        await client.clear_server_default_result_storage()
+
+    exit_with_success("Cleared default result storage.")

{prefect-3.7.1.dev1 → prefect-3.7.1.dev2}/src/prefect/server/api/flow_runs.py

@@ -7,6 +7,7 @@ import csv
 import datetime
 import io
 from typing import TYPE_CHECKING, Any, Dict, List, Optional
+from urllib.parse import quote
 from uuid import UUID
 
 import orjson
@@ -999,16 +1000,25 @@ async def download_logs(
         if not flow_run:
             raise HTTPException(status.HTTP_404_NOT_FOUND, detail="Flow run not found")
 
-        async def generate():
-            data = io.StringIO()
-            csv_writer = csv.writer(data)
-            csv_writer.writerow(
-                ["timestamp", "level", "flow_run_id", "task_run_id", "message"]
-            )
+        filename = quote(f"{flow_run.name}-logs.csv", safe="")
+
+    async def generate():
+
+        data = io.StringIO()
+        csv_writer = csv.writer(data)
+
+        csv_writer.writerow(
+            ["timestamp", "level", "flow_run_id", "task_run_id", "message"]
+        )
+        data.seek(0)
+        yield data.read()
+        data.seek(0)
+        data.truncate(0)
 
-            offset = 0
-            limit = FLOW_RUN_LOGS_DOWNLOAD_PAGE_LIMIT
+        offset = 0
+        limit = FLOW_RUN_LOGS_DOWNLOAD_PAGE_LIMIT
 
+        async with db.session_context() as session:
             while True:
                 results = await models.logs.read_logs(
                     session=session,
@@ -1040,13 +1050,15 @@ async def download_logs(
                     data.seek(0)
                     data.truncate(0)
 
-        return StreamingResponse(
-            generate(),
-            media_type="text/csv",
-            headers={
-                "Content-Disposition": f"attachment; filename={flow_run.name}-logs.csv"
-            },
-        )
+    return StreamingResponse(
+        generate(),
+        media_type="text/csv; charset=utf-8",
+        headers={
+            "Content-Disposition": (
+                f"attachment; filename=\"flow-run-logs.csv\"; filename*=UTF-8''{filename}"
+            )
+        },
+    )
 
 
 @router.patch("/{id:uuid}/labels", status_code=status.HTTP_204_NO_CONTENT)

{prefect-3.7.1.dev1 → prefect-3.7.1.dev2}/src/prefect/utilities/templating/AGENTS.md

@@ -17,3 +17,4 @@ Note: this module is *not* a Jinja renderer. For Jinja hydration of `__prefect_k
 ## Pitfalls
 
 - **`resolve_block_document_references` raises `ValueError` for malformed block placeholders.** Placeholders must follow the format `prefect.blocks.<block-type-slug>.<block-document-name>` (at least two dot-separated parts after the prefix). A placeholder like `{{ prefect.blocks.only-type }}` (missing the document name) raises `ValueError` before any network call is made.
+- **Inline vs. whole-string block resolution behave differently.** When a block placeholder is the *entire* string value (`"{{ prefect.blocks.secret.my-token }}"`), the resolved value is returned as-is — it can be a `dict`, `list`, or scalar. When a block placeholder is *embedded* in surrounding text (`"{{ prefect.blocks.secret.my-token }}/my-image"`), the value is coerced to `str`; if it resolves to a `dict` or `list`, a `ValueError` is raised. A template string can mix block placeholders and standard `{{ variable }}` placeholders — non-block placeholders are left intact for later resolution.

prefect-3.7.1.dev1/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.1.dev1"
-__build_date__ = "2026-05-07 09:01:53.547055+00:00"
-__git_commit__ = "2691cc6539774f7ecefc718395f6abe8301fe76f"
-__dirty__ = False