Add a parameter create to resolve() to create the directory/file if it doesn't exist.

Author: JackAshwell11

arcade/resources/__init__.py

@@ -50,7 +50,7 @@ def resolve_resource_path(path: str | Path) -> Path:
     return resolve(path)
 
 
-def resolve(path: str | Path) -> Path:
+def resolve(path: str | Path, *, create: bool = False) -> Path:
     """
     Attempts to resolve a path to a resource including resource handles.
 
@@ -67,6 +67,7 @@ def resolve(path: str | Path) -> Path:
 
     Args:
         path: A Path or string
+        create: If True, create the path if it doesn't exist.
     """
     # Convert to a Path object and resolve resource handle
     if isinstance(path, str):
@@ -103,6 +104,15 @@ def resolve(path: str | Path) -> Path:
         else:
             path = Path(path)
 
+    if create:
+        if path.suffix:
+            # Path is a file so create a directory and file
+            path.parent.mkdir(parents=True, exist_ok=True)
+            path.touch(exist_ok=True)
+        else:
+            # Path is a directory so create it
+            path.mkdir(parents=True, exist_ok=True)
+
     try:
         path = Path(path.resolve(strict=True))
     except AttributeError:

tests/unit/resources/test_handles.py

@@ -18,6 +18,22 @@ def test_default_handles():
         resources.resolve(":system:images/cards/cardBack_blue1.png")
 
 
+def test_handle_create(tmp_path):
+    # Test directory creation
+    new_dir = tmp_path / "created_dir"
+    assert not new_dir.exists()
+    result_dir = resources.resolve(new_dir, create=True)
+    assert result_dir == new_dir.resolve()
+    assert new_dir.exists() and new_dir.is_dir()
+
+    # Test file creation
+    new_file = tmp_path / "created_file.txt"
+    assert not new_file.exists()
+    result_file = resources.resolve(new_file, create=True)
+    assert result_file == new_file.resolve()
+    assert new_file.exists() and new_file.is_file()
+
+
 def test_add_handles(monkeypatch):
     monkeypatch.setattr(resources, "handles", {})