Add new function to create a PathPlus object from a file URI

Author: domdfcoding

domdf_python_tools/paths.py

@@ -52,6 +52,7 @@
 import stat
 import sys
 import tempfile
+import urllib.parse
 from collections import defaultdict, deque
 from operator import methodcaller
 from typing import (
@@ -65,6 +66,7 @@
 		List,
 		Optional,
 		Sequence,
+		Type,
 		TypeVar,
 		Union
 		)
@@ -832,6 +834,25 @@ def iterchildren(
 			if file.is_dir():
 				yield from file.iterchildren(exclude_dirs, match)
 
+	@classmethod
+	def from_uri(cls: Type[_PP], uri: str) -> _PP:
+		"""
+		Construct a :class:`~.PathPlus` from a ``file`` URI returned by :meth:`pathlib.PurePath.as_uri`.
+
+		.. versionadded:: 2.9.0
+
+		:param uri:
+		"""
+
+		parseresult = urllib.parse.urlparse(uri)
+
+		if parseresult.scheme != "file":
+			raise ValueError(f"Unsupported URI scheme {parseresult.scheme!r}")
+		if parseresult.netloc or parseresult.params or parseresult.query or parseresult.fragment:
+			raise ValueError("Malformed file URI")
+
+		return cls(urllib.parse.unquote_to_bytes(parseresult.path).decode("UTF-8"))
+
 
 class PosixPathPlus(PathPlus, pathlib.PurePosixPath):
 	"""

tests/test_paths.py

@@ -15,6 +15,7 @@
 import sys
 from tempfile import TemporaryDirectory
 from textwrap import dedent
+from typing import Type
 
 # 3rd party
 import pytest
@@ -880,3 +881,24 @@ def test_sort_paths():
 			PathPlus("foo.txt"),
 			]
 	assert sort_paths(*paths) == expected
+
+
+if platform.system() == "Windows":
+	_from_uri_paths = [
+			"c:/",
+			"c:/users/domdf/☃.txt",
+			"c:/a/b.c",
+			"c:/a/b%#c",
+			"c:/a/bé",
+			"//some/share/",
+			"//some/share/a/b.c",
+			"//some/share/a/b%#cé"
+			]
+else:
+	_from_uri_paths = ['/', "/home/domdf/☃.txt", "/a/b.c", "/a/b%#c"]
+
+
+@pytest.mark.parametrize("path", _from_uri_paths)
+@pytest.mark.parametrize("left_type", [pathlib.PurePath, pathlib.Path, PathPlus])
+def test_pathplus_from_uri(path: str, left_type: Type):
+	assert PathPlus.from_uri(left_type(path).as_uri()).as_posix() == path