prefect-client 3.6.29.dev4__tar.gz → 3.6.30.dev2__tar.gz

{prefect_client-3.6.29.dev4 → prefect_client-3.6.30.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.6.29.dev4
+Version: 3.6.30.dev2
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -40,7 +40,7 @@ Requires-Dist: jsonpatch<2.0,>=1.32
 Requires-Dist: jsonschema<5.0.0,>=4.18.0
 Requires-Dist: opentelemetry-api<2.0.0,>=1.27.0
 Requires-Dist: orjson<4.0,>=3.7
-Requires-Dist: packaging<26.2,>=21.3
+Requires-Dist: packaging<26.3,>=21.3
 Requires-Dist: pathspec>=0.8.0
 Requires-Dist: pendulum<4,>=3.1.0; python_version < '3.13'
 Requires-Dist: prometheus-client>=0.20.0

{prefect_client-3.6.29.dev4 → prefect_client-3.6.30.dev2}/pyproject.toml

@@ -44,7 +44,7 @@ dependencies = [
     "jsonschema>=4.18.0,<5.0.0",
     "opentelemetry-api>=1.27.0,<2.0.0",
     "orjson>=3.7,<4.0",
-    "packaging>=21.3,<26.2",
+    "packaging>=21.3,<26.3",
     "pathspec>=0.8.0",
     "pendulum>=3.1.0,<4; python_version<'3.13'",
     "prometheus-client>=0.20.0",

{prefect_client-3.6.29.dev4 → prefect_client-3.6.30.dev2}/src/prefect/AGENTS.md

@@ -21,7 +21,7 @@ There is no formal public/private boundary beyond the `_` prefix convention. Mod
 
 - **Engine ordering matters.** The engines apply features (retries, caching, result persistence, transactions) in a specific order. Changing the order or forgetting a feature in one engine path is the most common source of breakage.
 - **Sync and async must stay in sync.** Both `flow_engine.py` and `task_engine.py` have sync and async paths. Any behavior change must be applied to both.
-- **Use `whenever` compat helpers for all datetime conversions on Python 3.13+.** `types/_datetime.py` provides `_whenever_to_stdlib()`, `_whenever_zdt_from_py()`, and `_whenever_pdt_from_py()` to abstract over API differences between whenever 0.7.x–0.9.x and ≥ 0.10.0. The `_WHENEVER_NEW_API` flag (True when whenever ≥ 0.10.0) guards version-specific code. Never call `ZonedDateTime.from_py_datetime()`, `PlainDateTime.from_py_datetime()`, or `.py_datetime()` directly — use the helpers instead. Violations will silently break on whichever whenever version the helpers weren't written for.
+- **Use `whenever` compat helpers for all datetime conversions on Python 3.13+.** `types/_datetime.py` provides `now()`, `_whenever_to_stdlib()`, `_whenever_zdt_from_py()`, and `_whenever_pdt_from_py()` to abstract over API differences between whenever 0.7.x–0.9.x and ≥ 0.10.0. The `_WHENEVER_NEW_API` flag (True when whenever ≥ 0.10.0) guards version-specific code. Never call `DateTime.now()` or `pendulum.now()` directly — use `now()` from `types/_datetime.py` instead. Never call `ZonedDateTime.from_py_datetime()`, `PlainDateTime.from_py_datetime()`, or `.py_datetime()` directly — use the helpers instead. Violations will silently break on whichever whenever version the helpers weren't written for.
 - **Flow and task engines advance state differently.** The flow engine makes blocking API calls to the server to propose and advance states. The task engine emits `prefect.task_run.*` events (delivered via WebSockets) but advances state locally through `set_state` calls with polling/backoff — do not assume the two engines work the same way.
 - **Flow state transitions go through the server.** The flow engine proposes states to the server, which accepts or rejects them via orchestration rules. The task engine, by contrast, manages state transitions locally via `set_state` and emits `prefect.task_run.*` events — it does not propose states to the server.
 - **`ProcessPoolTaskRunner` requires picklable data across subprocess boundaries.** `PrefectFuture` objects are not picklable and cannot be passed to worker subprocesses. Any `wait_for` futures must be waited on in the parent process and converted to `State` objects before submission. The subprocess task engine handles `State` objects via `resolve_to_final_result`, which raises `UpstreamTaskError` for non-completed upstreams.

prefect_client-3.6.30.dev2/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.6.30.dev2"
+__build_date__ = "2026-05-03 08:39:59.809966+00:00"
+__git_commit__ = "bfcf79d03050c7d9fd7e7b43ca2ec09b0f77fc64"
+__dirty__ = False

{prefect_client-3.6.29.dev4 → prefect_client-3.6.30.dev2}/src/prefect/filesystems.py

@@ -100,7 +100,7 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
             return value
         return stringify_path(value)
 
-    def _resolve_path(self, path: str, validate: bool = False) -> Path:
+    def _resolve_path(self, path: str) -> Path:
         # Only resolve the base path at runtime, default to the current directory
         basepath = (
             Path(self.basepath).expanduser().resolve()
@@ -117,14 +117,12 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
 
         if not resolved_path.is_absolute():
             resolved_path = basepath / resolved_path
-        else:
-            resolved_path = resolved_path.resolve()
+        resolved_path = resolved_path.resolve()
 
-        if validate:
-            if basepath not in resolved_path.parents and (basepath != resolved_path):
-                raise ValueError(
-                    f"Provided path {resolved_path} is outside of the base path {basepath}."
-                )
+        if basepath not in resolved_path.parents and basepath != resolved_path:
+            raise ValueError(
+                f"Provided path {resolved_path} is outside of the base path {basepath}."
+            )
         return resolved_path
 
     async def aget_directory(
@@ -236,7 +234,7 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
         Defaults to copying the entire contents of the current working directory to the block's basepath.
         An `ignore_file` path may be provided that can include gitignore style expressions for filepaths to ignore.
         """
-        destination_path = self._resolve_path(to_path, validate=True)
+        destination_path = self._resolve_path(to_path)
 
         if not local_path:
             local_path = Path(".").absolute()
@@ -271,7 +269,7 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
         Defaults to copying the entire contents of the current working directory to the block's basepath.
         An `ignore_file` path may be provided that can include gitignore style expressions for filepaths to ignore.
         """
-        destination_path = self._resolve_path(to_path, validate=True)
+        destination_path = self._resolve_path(to_path)
 
         if not local_path:
             local_path = Path(".")

{prefect_client-3.6.29.dev4 → prefect_client-3.6.30.dev2}/src/prefect/runner/AGENTS.md

@@ -106,6 +106,14 @@ The cancelling precheck (step 1a) still runs unconditionally even when `propose_
 
 ProcessWorker (src/prefect/workers/process.py) calls `Runner.execute_flow_run()` and `Runner.execute_bundle()` via the deprecated path, suppressing `PrefectDeprecationWarning` with `warnings.catch_warnings()`. It bypasses FlowRunExecutor, ProcessManager, and ProcessStarter entirely. This is a known migration target.
 
+## BlockStorageAdapter Pull Behavior
+
+`BlockStorageAdapter.pull_code()` **clears the destination directory before every pull**, not just on first use. If the destination exists, all children are deleted first (directories via `shutil.rmtree`, files and symlinks via `unlink`), then `block.get_directory()` writes fresh content.
+
+This matters because `get_directory` typically calls `shutil.copytree(..., dirs_exist_ok=True)`, which cannot overwrite read-only files — git pack files are mode `0o444` and will cause `PermissionError` on a second pull unless the destination is cleared first.
+
+**Symlink handling:** directory symlinks inside the destination are removed with `unlink()`, not `rmtree()`. This deletes the symlink but leaves the symlink target intact. Do not change this to `rmtree()` — that would follow the symlink and delete the target directory.
+
 ## GitRepository Input Validation
 
 `GitRepository.__init__` (storage.py) enforces two non-obvious constraints:

{prefect_client-3.6.29.dev4 → prefect_client-3.6.30.dev2}/src/prefect/runner/storage.py

@@ -811,7 +811,13 @@ class BlockStorageAdapter:
         return self._storage_base_path / self._name
 
     async def pull_code(self) -> None:
-        if not self.destination.exists():
+        if self.destination.exists():
+            for child in self.destination.iterdir():
+                if child.is_dir() and not child.is_symlink():
+                    shutil.rmtree(child)
+                else:
+                    child.unlink()
+        else:
             self.destination.mkdir(parents=True, exist_ok=True)
         await self._block.get_directory(local_path=str(self.destination))
 

prefect_client-3.6.29.dev4/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.6.29.dev4"
-__build_date__ = "2026-05-01 08:45:54.141867+00:00"
-__git_commit__ = "3efef430f43db3a1faf58166d6402db477fe9e62"
-__dirty__ = False