Support relative paths (#405)

* tests: add relative path tests
* upath: initial relative path implementation
* tests: adjust relative_to tests
* Various fixes for windows and typesafety
* upath: don't make cwd() abstract in mixin
* upath: as_uri() for relative paths
* upath: add tests for file access on relative paths
* upath: relative path drive,root,anchor fixes
* upath: more relative path tests
* tests: fix typo in relative path suffixes test
* tests: add .parent tests for relative paths
* upath: repr for relative paths
* tests: relpath tests for parent(s), protocol, storage_options, path, fs and home
* tests: parser and resolve tests
* tests: add tests for relative path .match
* tests: add tests for joinpath
* upath: return dynamically created subclasses for untested protocols
* upath: fix relative-path support for with_segments
* upath: fix __vfspath__ for relative paths
* upath: fix parent for relative paths
* upath: .parents implementation for relative paths
* upath: fix FilePath.cwd() and FilePath.home()
* upath: fix pickling of dynamically created classes
* tests: fix .cwd and .home tests in core
* upath: fix remaining relative path tests
* tests: fix windows path separator comparisons
* tests: fix file uri comparison
* tests: relative joinpath fix windows separator comparison
* upath.implementations.cloud: fix GCSPath.exists() for gcsfs<2025.5.0
* tests: add mulitple join tests for different local/fsspec combinations
* upath: fix joinpath for relative upaths
* upath: fix local joinpath stringification

Author: ap--

upath/_flavour.py

@@ -17,6 +17,7 @@
 from fsspec.registry import registry as _class_registry
 from fsspec.spec import AbstractFileSystem
 
+import upath
 from upath._flavour_sources import FileSystemFlavourBase
 from upath._flavour_sources import flavour_registry
 from upath._protocol import get_upath_protocol
@@ -239,12 +240,14 @@ def local_file(self) -> bool:
     def stringify_path(pth: PathOrStr) -> str:
         if isinstance(pth, str):
             out = pth
+        elif isinstance(pth, upath.UPath) and not pth.is_absolute():
+            out = str(pth)
         elif getattr(pth, "__fspath__", None) is not None:
             assert hasattr(pth, "__fspath__")
             out = pth.__fspath__()
         elif isinstance(pth, os.PathLike):
             out = str(pth)
-        elif hasattr(pth, "path"):  # type: ignore[unreachable]
+        elif isinstance(pth, upath.UPath) and pth.is_absolute():
             out = pth.path
         else:
             out = str(pth)
@@ -288,7 +291,7 @@ def join(self, path: PathOrStr, *paths: PathOrStr) -> str:
         if self.local_file:
             return os.path.join(
                 self.strip_protocol(path),
-                *paths,  # type: ignore[arg-type]
+                *map(self.stringify_path, paths),
             )
         if self.netloc_is_anchor:
             drv, p0 = self.splitdrive(path)

upath/_protocol.py

@@ -105,7 +105,12 @@ def compatible_protocol(
     *args: str | os.PathLike[str] | PurePath | JoinablePath,
 ) -> bool:
     """check if UPath protocols are compatible"""
+    from upath.core import UPath
+
     for arg in args:
+        if isinstance(arg, UPath) and not arg.is_absolute():
+            # relative UPath are always compatible
+            continue
         other_protocol = get_upath_protocol(arg)
         # consider protocols equivalent if they match up to the first "+"
         other_protocol = other_protocol.partition("+")[0]