Inherit from pathlib_abc.ReadablePath and pathlib_abc.WritablePath

.flake8

@@ -16,8 +16,6 @@ max-complexity = 15
 select = B,C,E,F,W,T4,B902,T,P
 show_source = true
 count = true
-per-file-ignores =
-    upath/__init__.py: F401
 exclude =
     .noxfile,
     .nox,

.github/workflows/tests.yml

@@ -60,7 +60,12 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: |
+            3.9
+            3.10
+            3.11
+            3.12
+            3.13
 
       - name: Install nox
         run: python -m pip install --upgrade nox

README.md

@@ -645,15 +645,7 @@ installation of a newer version of its upstream dependencies. Below you can find
 a list of known issues and their solutions. We attempt to keep this list updated
 whenever we encounter more:
 
-- **UPath().glob()**:
-  `fsspec` fixed glob behavior when handling `**` patterns in `fsspec>=2023.9.0`
-- **GCSPath().mkdir()**:
-  a few mkdir quirks are solved by installing `gcsfs>=2022.7.1`
-- **fsspec.filesystem(WebdavPath().protocol)**
-  the webdav protocol was added to fsspec in version `fsspec>=2022.5.0`
-- **stat.S_ISDIR(HTTPPath().stat().st_mode)**
-  requires `fsspec>=2024.2.0` to correctly return `True` for directories
-
+- currently none :sparkles:
 
 ## Contributing
 

noxfile.py

@@ -8,14 +8,15 @@
 nox.options.reuse_existing_virtualenvs = True
 nox.options.sessions = "lint", "tests"
 locations = ("upath",)
-hide_pip_install = os.environ.get("CI", "") == ""
+running_in_ci = os.environ.get("CI", "") != ""
 
 
 @nox.session(python=["3.9", "3.10", "3.11", "3.12", "3.13"])
 def tests(session: nox.Session) -> None:
     # workaround in case no aiohttp binary wheels are available
     session.env["AIOHTTP_NO_EXTENSIONS"] = "1"
-    session.install(".[tests,dev]", silent=hide_pip_install)
+    session.install(".[tests,dev]")
+    session.run("python", "-m", "pip", "freeze", silent=not running_in_ci)
     session.run(
         "pytest",
         "-m",
@@ -29,7 +30,8 @@ def tests(session: nox.Session) -> None:
 
 @nox.session(python="3.9", name="tests-minversion")
 def tests_minversion(session: nox.Session) -> None:
-    session.install("fsspec==2022.1.0", ".[tests,dev]")
+    session.install("fsspec==2024.5.0", ".[tests,dev]")
+    session.run("python", "-m", "pip", "freeze", silent=not running_in_ci)
     session.run(
         "pytest",
         "-m",
@@ -92,7 +94,7 @@ def type_checking(session):
     session.run("python", "-m", "mypy")
 
 
-@nox.session
+@nox.session(python=["3.9", "3.10", "3.11", "3.12", "3.13"])
 def typesafety(session):
     session.install("-e", ".[tests]")
     session.run(

pyproject.toml

@@ -15,7 +15,7 @@ maintainers = [
 ]
 requires-python = ">=3.9"
 dependencies = [
-    "fsspec >=2022.1.0,!=2024.3.1",
+    "fsspec >=2024.5.0",
     "pathlib-abc ==0.4.3",
 ]
 classifiers = [
@@ -45,11 +45,11 @@ tests = [
     "packaging",
 ]
 dev = [
-    "adlfs",
+    "adlfs>=2024",
     "aiohttp",
     "requests",
-    "gcsfs>=2022.1.0",
-    "s3fs>=2022.1.0",
+    "gcsfs>=2024.5.0",
+    "s3fs>=2024.5.0",
     "moto[s3,server]",
     "webdav4[fsspec]",
     "paramiko",
@@ -164,6 +164,10 @@ ignore_missing_imports = true
 module = "pathlib_abc.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "smbprotocol.*"
+ignore_missing_imports = true
+
 [tool.pylint.format]
 max-line-length = 88
 

typesafety/test_upath_interface.yml

@@ -64,7 +64,7 @@
     from upath import UPath
 
     p = UPath("abc")
-    reveal_type(p.parts)  # N: Revealed type is "builtins.tuple[builtins.str, ...]"
+    reveal_type(p.parts)  # N: Revealed type is "typing.Sequence[builtins.str]"
 
 - case: upath_drive
   disable_cache: false
@@ -294,14 +294,14 @@
   main: |
     from upath import UPath
 
-    reveal_type(UPath("abc").glob("efg"))  # N: Revealed type is "typing.Generator[upath.core.UPath, None, None]"
+    reveal_type(UPath("abc").glob("efg"))  # N: Revealed type is "typing.Iterator[upath.core.UPath]"
 
 - case: upath_rglob
   disable_cache: false
   main: |
     from upath import UPath
 
-    reveal_type(UPath("abc").rglob("efg"))  # N: Revealed type is "typing.Generator[upath.core.UPath, None, None]"
+    reveal_type(UPath("abc").rglob("efg"))  # N: Revealed type is "typing.Iterator[upath.core.UPath]"
 
 - case: upath_is_dir
   disable_cache: false
@@ -364,7 +364,7 @@
   main: |
     from upath import UPath
 
-    reveal_type(UPath("abc").iterdir())  # N: Revealed type is "typing.Generator[upath.core.UPath, None, None]"
+    reveal_type(UPath("abc").iterdir())  # N: Revealed type is "typing.Iterator[upath.core.UPath]"
 
 - case: upath_lchmod
   disable_cache: false
@@ -534,33 +534,15 @@
 
     reveal_type(UPath("abc").write_text("efg"))  # N: Revealed type is "builtins.int"
 
-- case: upath_link_to_py39
+- case: upath_link_to
   disable_cache: false
-  mypy_config: python_version = 3.9
-  main: |
-    from upath import UPath
-
-    UPath("abc").link_to
-
-- case: upath_link_to_py312plus
-  disable_cache: false
-  mypy_config: python_version = 3.12
   main: |
     from upath import UPath
 
     UPath("abc").link_to  # E: "UPath" has no attribute "link_to"  [attr-defined]
 
-- case: upath_walk_py39
-  disable_cache: false
-  mypy_config: python_version = 3.9
-  main: |
-    from upath import UPath
-
-    UPath("abc").walk  # E: "UPath" has no attribute "walk"  [attr-defined]
-
-- case: upath_walk_py312plus
+- case: upath_walk
   disable_cache: false
-  mypy_config: python_version = 3.12
   main: |
       from upath import UPath
 

upath/__init__.py

@@ -1,7 +1,5 @@
 """Pathlib API extended to use fsspec backends."""
 
-import sys
-
 try:
     from upath._version import __version__
 except ImportError: