doc/get_path_uuid

rwx/fs/__init__.py

@@ -33,27 +33,44 @@ def empty_file(path: Path) -> None:
     write(path, "")
 
 
-def get_mount_uuid(path: str) -> str:
+def get_mount_uuid(path: Path) -> str:
-    """Return the filesystem UUID of a mountpoint path."""
+    """Return the filesystem UUID of a mountpoint path.
+
+    :param path: mountpoint path
+    :type path: Path
+    :rtype: str
+    """
     return ps.run_line(
-        ("findmnt",),
+        "findmnt",
-        ("--noheadings",),
+        "--noheadings",
         ("--output", "UUID"),
-        (path,),
+        str(path),
     )
 
 
-def get_path_mount(path: str) -> str:
+def get_path_mount(path: Path) -> Path:
-    """Return the mountpoint path of an arbitrary path."""
+    """Return the mountpoint path of an arbitrary path.
-    return ps.run_line(
+
-        "stat",
+    :param path: arbitrary path
-        ("--format", "%m"),
+    :type path: Path
-        path,
+    :rtype: Path
+    """
+    return Path(
+        ps.run_line(
+            "stat",
+            ("--format", "%m"),
+            str(path),
+        )
     )
 
 
-def get_path_uuid(path: str) -> str:
+def get_path_uuid(path: Path) -> str:
-    """Return the filesystem UUID of an arbitrary path."""
+    """Return the filesystem UUID of an arbitrary path.
+
+    :param path: arbitrary path
+    :type path: Path
+    :rtype: str
+    """
     return get_mount_uuid(get_path_mount(path))