core/tools/file: copy, move, and delete paths via shutil

Workspace-bound copy_path/move_path/delete_path for files and
directories; overwrite and recursive flags where needed.

tests/test_tools/test_fs_ops.py

@@ -0,0 +1,99 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from plyngent.tools.file import copy_path, delete_path, move_path, read_file, write_file
+from tests.test_tools.helpers import call_sync
+
+
+def test_copy_file(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    _ = call_sync(write_file, "a.txt", "hello")
+    out = call_sync(copy_path, "a.txt", "b.txt")
+    assert "copied" in out
+    assert call_sync(read_file, "b.txt") == "hello"
+    assert (workspace / "a.txt").is_file()
+
+
+def test_copy_directory(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    _ = call_sync(write_file, "src/x.txt", "x")
+    _ = call_sync(write_file, "src/nested/y.txt", "y")
+    out = call_sync(copy_path, "src", "dst")
+    assert "directory" in out
+    assert call_sync(read_file, "dst/x.txt") == "x"
+    assert call_sync(read_file, "dst/nested/y.txt") == "y"
+
+
+def test_copy_overwrite(workspace: object) -> None:
+    del workspace
+    _ = call_sync(write_file, "a.txt", "old")
+    _ = call_sync(write_file, "b.txt", "new")
+    assert "exists" in call_sync(copy_path, "b.txt", "a.txt")
+    out = call_sync(copy_path, "b.txt", "a.txt", overwrite=True)
+    assert "copied" in out
+    assert call_sync(read_file, "a.txt") == "new"
+
+
+def test_move_file(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    _ = call_sync(write_file, "old.txt", "data")
+    out = call_sync(move_path, "old.txt", "renamed.txt")
+    assert "moved" in out
+    assert not (workspace / "old.txt").exists()
+    assert call_sync(read_file, "renamed.txt") == "data"
+
+
+def test_move_directory(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    _ = call_sync(write_file, "d/a.txt", "a")
+    out = call_sync(move_path, "d", "e")
+    assert "moved" in out
+    assert not (workspace / "d").exists()
+    assert call_sync(read_file, "e/a.txt") == "a"
+
+
+def test_delete_file(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    _ = call_sync(write_file, "t.txt", "x")
+    out = call_sync(delete_path, "t.txt")
+    assert "deleted" in out
+    assert not (workspace / "t.txt").exists()
+
+
+def test_delete_empty_dir(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    (workspace / "empty").mkdir()
+    out = call_sync(delete_path, "empty")
+    assert "deleted" in out
+    assert not (workspace / "empty").exists()
+
+
+def test_delete_nonempty_requires_recursive(workspace: object) -> None:
+    assert isinstance(workspace, Path)
+    _ = call_sync(write_file, "box/a.txt", "a")
+    out = call_sync(delete_path, "box")
+    assert "not empty" in out
+    assert (workspace / "box" / "a.txt").is_file()
+    out2 = call_sync(delete_path, "box", recursive=True)
+    assert "recursive" in out2
+    assert not (workspace / "box").exists()
+
+
+def test_delete_workspace_root_forbidden(workspace: object) -> None:
+    del workspace
+    out = call_sync(delete_path, ".")
+    assert "workspace root" in out
+
+
+def test_move_workspace_root_forbidden(workspace: object) -> None:
+    del workspace
+    out = call_sync(move_path, ".", "elsewhere")
+    assert "workspace root" in out
+
+
+def test_missing_source(workspace: object) -> None:
+    del workspace
+    assert "does not exist" in call_sync(copy_path, "nope", "x")
+    assert "does not exist" in call_sync(move_path, "nope", "x")
+    assert "does not exist" in call_sync(delete_path, "nope")