pathlib-next 0.8.2__tar.gz → 0.8.4__tar.gz

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.4] - 2026-07-18
+
+### Changed
+- Internal tidy-up (no behavior change): removed dead imports (`Source` in the
+  `az`/`gs`/`s3` schemes, `io` in `utils.archive`, `abc` in `utils.stat`), dropped
+  unused local variables, and de-f-string'd a placeholder-less message. The
+  `RepoBackend` re-exports from the `github`/`gitlab` schemes are retained (public
+  API, marked `# noqa`).
+
+## [0.8.3] - 2026-07-18
+
+### Changed
+- **`AsyncsshSftpBackend` default `max_concurrency` raised 8 → 16.** A 128-file
+  loopback recursive-copy/rm sweep of `mc ∈ {1,2,4,8,16}` (median of 3) showed
+  recursive copy improving monotonically with concurrency (mc=8→16 ≈3% faster on
+  top of mc=1→8 ≈1.13x) and recursive remove flat within noise, with 16
+  fastest-or-tied and well inside asyncssh's SFTP request window. Exposed as
+  `AsyncsshSftpBackend.DEFAULT_MAX_CONCURRENCY`; pass `max_concurrency=` to
+  override. Loopback evidence only — a high-latency remote link may warrant a
+  different value; 16 is a safe modest default, not a tuned optimum.
+
 ## [0.8.2] - 2026-07-18
 
 ### Fixed
@@ -495,7 +516,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 - Sync error handling.
 - Generic Path Protocol based pathlib implementation for URI paths with file access support for sftp, http, file schemes.
 
-[Unreleased]: https://github.com/jose-pr/pathlib_next/compare/v0.8.2...HEAD
+[Unreleased]: https://github.com/jose-pr/pathlib_next/compare/v0.8.4...HEAD
+[0.8.4]: https://github.com/jose-pr/pathlib_next/compare/v0.8.3...v0.8.4
+[0.8.3]: https://github.com/jose-pr/pathlib_next/compare/v0.8.2...v0.8.3
 [0.8.2]: https://github.com/jose-pr/pathlib_next/compare/v0.8.1...v0.8.2
 [0.8.1]: https://github.com/jose-pr/pathlib_next/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/jose-pr/pathlib_next/compare/v0.7.0...v0.8.0

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pathlib_next
-Version: 0.8.2
+Version: 0.8.4
 Summary: Generic Path Protocol based pathlib
 Project-URL: Homepage, https://github.com/jose-pr/pathlib_next/
 Project-URL: Documentation, https://jose-pr.github.io/pathlib_next/

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/docs/benchmarks.md

@@ -142,6 +142,16 @@ Legend: `p` = `paramiko`, `a` = `asyncssh`.
   was fastest at `7.6068s`, with `4` at `14.2806s` and `8` at `13.3736s`.
   Treat this as workload-specific follow-up evidence, not as a default tuning
   decision.
+- **2026-07-18 (0.8.3): `AsyncsshSftpBackend` default `max_concurrency` raised
+  8 → 16.** A cleaner 128-file loopback sweep of `mc ∈ {1,2,4,8,16}` (median of
+  3, py3.14) showed recursive copy improving *monotonically* with concurrency
+  (mc=1 `1.66s` → mc=8 `1.47s` ≈ 1.13x → mc=16 `1.42s`, a further ≈3%), and
+  recursive remove flat within noise (median spread `0.498`..`0.551`, mc=16
+  marginally best). This supersedes the earlier "mc=1 fastest" loopback reading
+  (from the older code path / a different venv). 16 stays within asyncssh's SFTP
+  request window. **Loopback only** — no per-op latency; a high-latency remote
+  link may favour higher concurrency still, so 16 is a safe modest default, not
+  a tuned optimum. Override per backend via `AsyncsshSftpBackend(max_concurrency=…)`.
 - `python benchmarks/bench.py syncer` on the same local run reported
   PathSyncer copy of 128 local files at `0.4524s`, dry-run at `0.0534s`, and
   remove-missing plus copy at `0.9260s`. This suggests metadata reuse may be

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pathlib_next"
-version = "0.8.2"
+version = "0.8.4"
 authors = [{ name = "Jose A" }]
 description = "Generic Path Protocol based pathlib"
 readme = "README.md"

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/path.py

@@ -188,7 +188,7 @@ class Pathname(FsPathLike, _ty.Generic[_P]):
     def __truediv__(self, key: _ty.Self | str) -> _ty.Self:
         try:
             return type(self)(self, key)
-        except (TypeError, NotImplementedError) as _err:
+        except (TypeError, NotImplementedError):
             return NotImplemented
 
     def joinpath(self, *args: str | _ty.Self) -> _ty.Self:

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/__init__.py

@@ -263,7 +263,7 @@ class Uri(Pathname):
             elif os.name == "nt":
                 return f"//{self.source.host}/{self.path.removeprefix('/')}"
             else:
-                raise NotImplementedError(f"OS Support for not local fspath")
+                raise NotImplementedError("OS Support for not local fspath")
 
         raise NotImplementedError(f"fspath for {self.source.scheme}")
 
@@ -513,7 +513,7 @@ class UriPath(Uri, Path):
     def _schemes(cls) -> _ty.Sequence[str]:
         try:
             return getattr(cls, f"_{cls.__name__}__SCHEMES")
-        except AttributeError as _e:
+        except AttributeError:
             return ()
 
     @classmethod

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/schemes/az.py

@@ -5,7 +5,7 @@ import typing as _ty
 
 from ... import utils as _utils
 from ...utils.stat import FileStat
-from .. import Source, Uri, UriPath
+from .. import Uri, UriPath
 
 
 class BaseAzBackend(object):

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/schemes/github.py

@@ -6,7 +6,7 @@ import io as _io
 import urllib.parse as _urlparse
 
 from ...utils.stat import FileStat
-from ._gitrepo import RepoBackend, _RepoApiPath, _translate_repo_errors
+from ._gitrepo import RepoBackend, _RepoApiPath, _translate_repo_errors  # noqa: F401  (re-exported)
 
 
 class GitHubPath(_RepoApiPath):

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/schemes/gitlab.py

@@ -4,7 +4,7 @@ import io as _io
 import urllib.parse as _urlparse
 
 from ...utils.stat import FileStat
-from ._gitrepo import RepoBackend, _RepoApiPath, _translate_repo_errors
+from ._gitrepo import RepoBackend, _RepoApiPath, _translate_repo_errors  # noqa: F401  (re-exported)
 
 
 class GitLabPath(_RepoApiPath):

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/schemes/gs.py

@@ -5,7 +5,7 @@ import typing as _ty
 
 from ... import utils as _utils
 from ...utils.stat import FileStat
-from .. import Source, Uri, UriPath
+from .. import Uri, UriPath
 
 
 class BaseGsBackend(object):
@@ -247,5 +247,5 @@ class GsPath(UriPath):
             target = Uri(self.parent, target)
         dest_key = target.path.lstrip("/")
         source_blob = self._bucket.blob(self.key)
-        dest_blob = self._bucket.copy_blob(source_blob, self._bucket, dest_key)
+        self._bucket.copy_blob(source_blob, self._bucket, dest_key)
         source_blob.delete()

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/schemes/s3.py

@@ -8,7 +8,7 @@ import botocore.exceptions as _botoexc
 
 from ... import utils as _utils
 from ...utils.stat import FileStat
-from .. import Source, Uri, UriPath
+from .. import Uri, UriPath
 
 
 class BaseS3Backend(object):

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/uri/schemes/sftp/_asyncssh.py

@@ -482,14 +482,28 @@ class AsyncsshSftpBackend(BaseSftpBackend):
     #: real-world OpenSSH v3 servers, or the standard opcode against v5/v6).
     supports_hardlink = True
 
+    #: Default bound on concurrent SFTP requests during a recursive copy/rm.
+    #: 16 (raised from 8 in 0.8.3): a 128-file loopback sweep of mc in
+    #: {1,2,4,8,16} (median of 3, 3.14) showed recursive copy improving
+    #: monotonically with concurrency -- mc=1 -> mc=8 ~1.13x, mc=8 -> mc=16 a
+    #: further ~3% -- with recursive rm flat (spread within run-to-run noise) and
+    #: mc=16 fastest-or-tied for both. 16 stays well inside asyncssh's SFTP
+    #: request window, so the extra in-flight requests carry no overload risk.
+    #: NOTE: loopback evidence only (no per-op network latency); a high-latency
+    #: remote link may favour even higher concurrency, but 16 is a safe, modest
+    #: default. Override per-backend via ``max_concurrency=``.
+    DEFAULT_MAX_CONCURRENCY = 16
+
     def __init__(
         self,
         connect_opts: "dict[str, _ty.Any] | None" = None,
         *,
-        max_concurrency: int = 8,
+        max_concurrency: "int | None" = None,
         sftp_version: int = 4,
         ssh_config=_DEFAULT_SSH_CONFIG,
     ):
+        if max_concurrency is None:
+            max_concurrency = self.DEFAULT_MAX_CONCURRENCY
         self.connect_opts = {} if connect_opts is None else dict(connect_opts)
         if "config" not in self.connect_opts:
             if ssh_config is None:

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/utils/archive.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import io
 import tarfile
 import typing as _ty
 import zipfile

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/src/pathlib_next/utils/stat.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import abc as _abc
 import stat as _stat
 import typing as _ty
 

{pathlib_next-0.8.2 → pathlib_next-0.8.4}/tests/test_sftp_asyncssh.py

@@ -293,9 +293,12 @@ def test_asyncssh_backend_has_max_concurrency():
     assert backend.max_concurrency == 16
 
 
-def test_asyncssh_backend_max_concurrency_defaults_to_8():
+def test_asyncssh_backend_max_concurrency_defaults_to_16():
+    # Raised from 8 to 16 in 0.8.3 (loopback recursive-copy sweep); see
+    # DEFAULT_MAX_CONCURRENCY's rationale in _asyncssh.py.
     backend = backend_mod.AsyncsshSftpBackend()
-    assert backend.max_concurrency == 8
+    assert backend.max_concurrency == 16
+    assert backend.max_concurrency == backend_mod.AsyncsshSftpBackend.DEFAULT_MAX_CONCURRENCY
     assert "config" not in backend.connect_opts
 
 
@@ -757,3 +760,14 @@ def test_sftppath_rm_recursive_uses_concurrent_helper(monkeypatch):
     assert recorded["kwargs"]["max_concurrency"] == 6
     assert recorded["kwargs"]["missing_ok"] is True
     assert recorded["kwargs"]["on_error"](ValueError("ignored"), src) is True
+
+
+# --- default max_concurrency -------------------------------------------------
+
+
+def test_explicit_max_concurrency_overrides_default():
+    backend = backend_mod.AsyncsshSftpBackend({"config": None}, max_concurrency=4)
+    assert backend.max_concurrency == 4
+    # 0 is honored as given (the async helpers clamp to >=1 at use time via
+    # `max(1, max_concurrency)`), not silently replaced by the default.
+    assert backend_mod.AsyncsshSftpBackend({"config": None}, max_concurrency=1).max_concurrency == 1