pathlib-next 0.9.7__tar.gz → 0.9.8__tar.gz

{pathlib_next-0.9.7 → pathlib_next-0.9.8}/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.9.8] - 2026-09-17
+
+### Fixed
+- **Joining a URI path no longer builds a backend.** 0.9.7 routed `/` and
+  `joinpath()` through the child builder a listing uses, which reads the
+  `backend` property -- and that property CREATES one, so spelling
+  `UriPath("sftp://h/x") / "y"` imported paramiko and raised `ImportError`
+  without the extra (`http:` wanted `requests`, `s3:` `botocore`). A join
+  is a pure-path operation and is lazy again; a child still shares its
+  parent's connection when one already exists, which is all the sharing was
+  ever for.
+
 ## [0.9.7] - 2026-09-17
 
 ### Added
@@ -1450,7 +1462,8 @@ 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.9.7...HEAD
+[Unreleased]: https://github.com/jose-pr/pathlib-next/compare/v0.9.8...HEAD
+[0.9.8]: https://github.com/jose-pr/pathlib-next/compare/v0.9.7...v0.9.8
 [0.9.7]: https://github.com/jose-pr/pathlib-next/compare/v0.9.6...v0.9.7
 [0.9.6]: https://github.com/jose-pr/pathlib-next/compare/v0.9.5...v0.9.6
 [0.9.5]: https://github.com/jose-pr/pathlib-next/compare/v0.9.4...v0.9.5

{pathlib_next-0.9.7 → pathlib_next-0.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pathlib-next
-Version: 0.9.7
+Version: 0.9.8
 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.9.7 → pathlib_next-0.9.8}/pyproject.toml

@@ -13,7 +13,7 @@ build-backend = "hatchling.build"
 # `import pathlib_next`) -- a hyphen is not legal in a Python identifier.
 # Distribution name and import name differing is ordinary and intended.
 name = "pathlib-next"
-version = "0.9.7"
+version = "0.9.8"
 authors = [{ name = "Jose A" }]
 description = "Generic Path Protocol based pathlib"
 readme = "README.md"

{pathlib_next-0.9.7 → pathlib_next-0.9.8}/src/pathlib_next/uri/__init__.py

@@ -1149,7 +1149,13 @@ class UriPath(Uri, Path):
     def _make_child_relpath(
         self, name: str, stat_hint: "FileStat" = None, **kwargs
     ) -> _ty.Self:
-        inst = super()._make_child_relpath(name, backend=self.backend, **kwargs)
+        # The backend ALREADY BUILT, never `self.backend` -- that property
+        # creates one, and naming a child is a pure-path operation: since
+        # `/` walks segments through here, reading the property made
+        # `UriPath("sftp://h/x") / "y"` import paramiko (and `http:` import
+        # requests) just to spell a path. A listing has one by the time it
+        # gets here, so its children still share the instance.
+        inst = super()._make_child_relpath(name, backend=self._backend, **kwargs)
         inst._stat_hint = stat_hint
         return inst
 

{pathlib_next-0.9.7 → pathlib_next-0.9.8}/tests/test_routing.py

@@ -74,7 +74,13 @@ def test_github_token_backend_does_not_follow_join_to_another_host():
     # A str join stays on the original host, so the token goes nowhere new.
     literal = root / "github://evil.invalid/x/y"
     assert literal.source.host == "github.com"
-    assert literal.backend is root.backend
+    assert literal.backend.token == "ghp_SECRET"
+    # Identity is only promised when the parent already HAS a backend: a
+    # join must not build one (it is a pure-path operation), so a child of a
+    # connectionless parent makes its own on first use.
+    assert root._backend is None
+    root.backend  # now it exists, and the next child shares it
+    assert (root / "docs").backend is root.backend
 
     # Crossing hosts needs a Uri argument, and that drops the token.
     evil = root / GitHubPath("github://evil.invalid/x/y")

{pathlib_next-0.9.7 → pathlib_next-0.9.8}/tests/test_uri_path.py

@@ -357,3 +357,29 @@ def test_a_same_endpoint_uri_destination_keeps_the_configured_backend():
         base._coerce_target("http://trusted.invalid/api/b.txt").backend is base.backend
     )
     assert base._coerce_target("http://other.invalid/b.txt").backend is not base.backend
+
+
+def test_joining_a_path_never_builds_a_backend():
+    """A join is a PURE-PATH operation. 0.9.7 routed `/` through
+    `_make_child_relpath()`, which read the `backend` property -- and that
+    property builds one, so spelling `UriPath("sftp://h/x") / "y"` imported
+    paramiko and raised ImportError without the extra. Every scheme, not
+    just the ones whose client happens to be installed."""
+    for uri in ("sftp://h/mnt", "http://h/a", "s3://b/k", "file:///tmp/x"):
+        base = UriPath(uri)
+        child = base / "child"
+        assert child.path.endswith("/child")
+        assert child._backend is None, uri
+        assert base._backend is None, uri
+        assert base.joinpath("a", "b")._backend is None, uri
+
+
+def test_joining_shares_a_backend_that_already_exists():
+    """What the property read was there for: children of a listing share the
+    parent's live connection. That still holds -- by then it exists."""
+    base = UriPath("http://h/a")
+    sentinel = object()
+    base._backend = sentinel
+    assert (base / "c")._backend is sentinel
+    assert base.joinpath("c", "d")._backend is sentinel
+    assert base._make_child_relpath("c")._backend is sentinel