asanypath 2.0.1__tar.gz → 2.1.0__tar.gz

{asanypath-2.0.1 → asanypath-2.1.0}/.github/workflows/publish.yml

@@ -102,7 +102,7 @@ jobs:
           rm rust/Cargo.toml.bak
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
         with:
           enable-cache: false
 
@@ -128,7 +128,7 @@ jobs:
           persist-credentials: false
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
         with:
           enable-cache: false
 

{asanypath-2.0.1 → asanypath-2.1.0}/.github/workflows/unittests.yml

@@ -44,7 +44,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
 
       - name: Ruff checks
         run: uvx ruff check src tests && uvx ruff format --check src tests

{asanypath-2.0.1 → asanypath-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: asanypath
-Version: 2.0.1
+Version: 2.1.0
 Summary: Async pathlib for local and cloud storage
 License-Expression: MIT
 License-File: LICENSE
@@ -19,17 +19,17 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: anyio>=4
-Requires-Dist: asanypath-native~=2.0.0
+Requires-Dist: asanypath-native~=2.1.0
 Requires-Dist: msgspec>=0.21.1
 Requires-Dist: yarl>=1.2
 Provides-Extra: all
 Requires-Dist: aioftp>=0.21; extra == 'all'
-Requires-Dist: asyncssh>=2.14; extra == 'all'
 Requires-Dist: keyring>=24; extra == 'all'
 Provides-Extra: bench
 Requires-Dist: adlfs; extra == 'bench'
 Requires-Dist: aiobotocore; extra == 'bench'
 Requires-Dist: aiofiles; extra == 'bench'
+Requires-Dist: asyncssh>=2.14; extra == 'bench'
 Requires-Dist: azure-storage-blob; extra == 'bench'
 Requires-Dist: cloudpathlib[all]; extra == 'bench'
 Requires-Dist: fsspec; extra == 'bench'
@@ -43,7 +43,6 @@ Provides-Extra: credstore
 Requires-Dist: keyring>=24; extra == 'credstore'
 Provides-Extra: dev
 Requires-Dist: aioftp>=0.21; extra == 'dev'
-Requires-Dist: asyncssh>=2.14; extra == 'dev'
 Requires-Dist: keyring>=24; extra == 'dev'
 Requires-Dist: pre-commit>=4; extra == 'dev'
 Requires-Dist: pytest-asyncio>=1.3; extra == 'dev'
@@ -52,8 +51,6 @@ Requires-Dist: pytest>=8; extra == 'dev'
 Requires-Dist: rich-click>=1.9.7; extra == 'dev'
 Provides-Extra: ftp
 Requires-Dist: aioftp>=0.21; extra == 'ftp'
-Provides-Extra: ssh
-Requires-Dist: asyncssh>=2.14; extra == 'ssh'
 Description-Content-Type: text/markdown
 
 ©2026 Axis Communications AB. AXIS COMMUNICATIONS, AXIS, ARTPEC and VAPIX are registered trademarks of Axis AB in various jurisdictions. All other trademarks are the property of their respective owners.
@@ -76,6 +73,9 @@ locally before connecting to a cloud account.
 
 - Python 3.10 through 3.14.
 - Access credentials for each cloud service that your application uses.
+
+S3 authentication accepts explicit keys or uses the AWS SDK credential provider
+chain (including shared profiles and IAM roles) when keys are not supplied.
 - A POSIX-compatible shell such as Bash or Zsh for the terminal commands below.
     Windows users can use Windows Subsystem for Linux or adapt the commands for
     PowerShell.
@@ -182,8 +182,8 @@ uv sync
 # With CLI
 uv sync --extra cli
 
-# With SSH, FTP backend support
-uv sync --extra ssh --extra ftp
+# With FTP backend support (SSH/SFTP is built in — no extra needed)
+uv sync --extra ftp
 
 # With OS keyring-backed credential cache
 uv sync --extra credstore
@@ -343,63 +343,66 @@ uv run --extra bench python scripts/bench.py --backend art --rounds 3 --concurre
 
 | Operation | asanypath | s3fs | aiobotocore | cloudpathlib |
 |-----------|-----------|------|-------------|--------------|
-| write | 8.47 ms | 9.52 ms | 43.39 ms | 48.02 ms |
-| read | 4.03 ms | 9.43 ms | 20.16 ms | 13.30 ms |
-| exists | 3.58 ms | 4.54 ms | 20.49 ms | 4.48 ms |
-| iterdir | 38.91 ms | 39.33 ms | 57.76 ms | 41.95 ms |
+| write | **8.80 ms** | 12.67 ms | 28.07 ms | 41.75 ms |
+| read | **3.78 ms** | 9.10 ms | 23.15 ms | 12.83 ms |
+| exists | **3.57 ms** | 4.25 ms | 21.92 ms | 4.02 ms |
+| iterdir | 40.55 ms | 39.16 ms | 56.49 ms | **39.07 ms** |
 
 ### Azure — Azurite emulator (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | azure-sdk | adlfs | cloudpathlib |
 |-----------|-----------|-----------|-------|--------------|
-| write | 1.77 ms | 1.86 ms | 1.93 ms | 8.29 ms |
-| read | 0.68 ms | 1.15 ms | 2.50 ms | 3.46 ms |
-| exists | 0.56 ms | 0.83 ms | 1.04 ms | 1.02 ms |
-| iterdir | 1.34 ms | 2.21 ms | 4.37 ms | 2.59 ms |
+| write | **1.24 ms** | 1.79 ms | 2.34 ms | 7.88 ms |
+| read | **0.51 ms** | 1.15 ms | 2.44 ms | 3.19 ms |
+| exists | **0.35 ms** | 0.95 ms | 0.98 ms | 1.04 ms |
+| iterdir | **0.88 ms** | 2.40 ms | 4.11 ms | 2.72 ms |
 
 ### GCS — fake-gcs-server emulator (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | gcloud-aio | cloudpathlib | gcsfs |
 |-----------|-----------|------------|--------------|-------|
-| write | 0.22 ms | 0.24 ms | 2.88 ms | 0.33 ms |
-| read | 0.12 ms | 0.14 ms | 1.34 ms | 0.19 ms |
-| exists | 0.12 ms | 0.14 ms | 0.44 ms | 0.41 ms |
-| iterdir | 0.20 ms | 0.16 ms | 0.55 ms | 0.24 ms |
+| write | **0.45 ms** | 0.51 ms | 3.53 ms | 0.58 ms |
+| read | 0.22 ms | **0.18 ms** | 1.48 ms | 0.30 ms |
+| exists | **0.15 ms** | 0.18 ms | 0.50 ms | 0.46 ms |
+| iterdir | **0.19 ms** | 0.25 ms | 0.69 ms | 0.33 ms |
 
 ### Artifactory — live server (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | aiohttp | requests |
 |-----------|-----------|---------|----------|
-| write | 39.77 ms | 38.00 ms | 36.67 ms |
-| read | 4.29 ms | 4.75 ms | 5.43 ms |
-| exists | 2.97 ms | 3.02 ms | 4.52 ms |
-| iterdir | 4.59 ms | 4.18 ms | 6.26 ms |
+| write | **54.49 ms** | 54.75 ms | 57.57 ms |
+| read | **2.83 ms** | 3.09 ms | 12.01 ms |
+| exists | 2.33 ms | **2.18 ms** | 4.61 ms |
+| iterdir | **2.85 ms** | 3.07 ms | 7.88 ms |
 
 ### SSH / SFTP — localhost emulator (median of 20 rounds, 10 objects, c=1)
 
+asanypath uses a built-in native russh SFTP transport (off-GIL); `asyncssh` is
+shown only as a benchmark baseline.
+
 | Operation | asanypath | asyncssh |
 |-----------|-----------|----------|
-| write | 0.32 ms | 0.27 ms |
-| read | 0.34 ms | 0.33 ms |
-| exists | 0.11 ms | 0.11 ms |
-| iterdir | 0.52 ms | 0.40 ms |
+| write | **0.16 ms** | 0.33 ms |
+| read | **0.21 ms** | 0.36 ms |
+| exists | **0.07 ms** | 0.11 ms |
+| iterdir | **0.23 ms** | 0.44 ms |
 
 ### FTP — localhost emulator (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | aioftp |
 |-----------|-----------|--------|
-| write | 0.40 ms | 0.34 ms |
-| read | 0.36 ms | 0.32 ms |
-| exists | 1.12 ms | 0.92 ms |
-| iterdir | 1.10 ms | 0.92 ms |
+| write | **0.35 ms** | 0.41 ms |
+| read | **0.35 ms** | 0.40 ms |
+| exists | **1.00 ms** | 1.13 ms |
+| iterdir | 1.09 ms | **1.04 ms** |
 
 Latencies are per-operation medians over 20 rounds. S3 and Artifactory ran
 against live services; Azure, GCS, SSH/SFTP, and FTP against local emulators
 (Azurite, fake-gcs-server, and localhost sftp/ftp), so those figures reflect
-client-library overhead, not WAN latency. (A direct live-remote SSH run confirms
-the tie — asanypath vs asyncssh within noise.) asanypath matches or beats
-dedicated client libraries on most operations while providing a single unified
-API across all backends.
+client-library overhead, not WAN latency. The SSH/SFTP transport is a built-in
+native russh backend that runs SFTP off-GIL and beats asyncssh on every
+operation. asanypath matches or beats dedicated client libraries on most
+operations while providing a single unified API across all backends.
 
 ## How It Works
 
@@ -413,9 +416,17 @@ API across all backends.
 | `az://`, `azure://` | `AzurePath` | reqwest + SharedKey |
 | `art://` | `ArtifactoryPath` | reqwest + Bearer |
 | `http://`, `https://` | `HTTPPath` / `HTTPSPath` | reqwest |
-
-All network I/O is handled by `asanypath-native` (Rust/PyO3 + reqwest) with
-jittered exponential backoff retry for transient errors.
+| `ssh://` | `SSHPath` | native russh (SFTP) |
+| `ftp://` | `FTPPath` | `aioftp` |
+| `ftps://` | `FTPSPath` | `aioftp` + TLS |
+| any other scheme | `UnsupportedProtocolPath` | none — pure-path only |
+
+Cloud and HTTP network I/O is handled by `asanypath-native` (Rust/PyO3 + reqwest)
+with jittered exponential backoff retry for transient errors. SSH/SFTP uses a
+built-in off-GIL native russh transport (no Python SSH dependency); FTP/FTPS use
+`aioftp`. Unknown schemes construct an `UnsupportedProtocolPath`: pure-path
+operations (`.name`, `.parent`, joins) work, while any backend operation raises
+`UnsupportedProtocolError`.
 
 ## API Reference
 

{asanypath-2.0.1 → asanypath-2.1.0}/README.md

@@ -18,6 +18,9 @@ locally before connecting to a cloud account.
 
 - Python 3.10 through 3.14.
 - Access credentials for each cloud service that your application uses.
+
+S3 authentication accepts explicit keys or uses the AWS SDK credential provider
+chain (including shared profiles and IAM roles) when keys are not supplied.
 - A POSIX-compatible shell such as Bash or Zsh for the terminal commands below.
     Windows users can use Windows Subsystem for Linux or adapt the commands for
     PowerShell.
@@ -124,8 +127,8 @@ uv sync
 # With CLI
 uv sync --extra cli
 
-# With SSH, FTP backend support
-uv sync --extra ssh --extra ftp
+# With FTP backend support (SSH/SFTP is built in — no extra needed)
+uv sync --extra ftp
 
 # With OS keyring-backed credential cache
 uv sync --extra credstore
@@ -285,63 +288,66 @@ uv run --extra bench python scripts/bench.py --backend art --rounds 3 --concurre
 
 | Operation | asanypath | s3fs | aiobotocore | cloudpathlib |
 |-----------|-----------|------|-------------|--------------|
-| write | 8.47 ms | 9.52 ms | 43.39 ms | 48.02 ms |
-| read | 4.03 ms | 9.43 ms | 20.16 ms | 13.30 ms |
-| exists | 3.58 ms | 4.54 ms | 20.49 ms | 4.48 ms |
-| iterdir | 38.91 ms | 39.33 ms | 57.76 ms | 41.95 ms |
+| write | **8.80 ms** | 12.67 ms | 28.07 ms | 41.75 ms |
+| read | **3.78 ms** | 9.10 ms | 23.15 ms | 12.83 ms |
+| exists | **3.57 ms** | 4.25 ms | 21.92 ms | 4.02 ms |
+| iterdir | 40.55 ms | 39.16 ms | 56.49 ms | **39.07 ms** |
 
 ### Azure — Azurite emulator (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | azure-sdk | adlfs | cloudpathlib |
 |-----------|-----------|-----------|-------|--------------|
-| write | 1.77 ms | 1.86 ms | 1.93 ms | 8.29 ms |
-| read | 0.68 ms | 1.15 ms | 2.50 ms | 3.46 ms |
-| exists | 0.56 ms | 0.83 ms | 1.04 ms | 1.02 ms |
-| iterdir | 1.34 ms | 2.21 ms | 4.37 ms | 2.59 ms |
+| write | **1.24 ms** | 1.79 ms | 2.34 ms | 7.88 ms |
+| read | **0.51 ms** | 1.15 ms | 2.44 ms | 3.19 ms |
+| exists | **0.35 ms** | 0.95 ms | 0.98 ms | 1.04 ms |
+| iterdir | **0.88 ms** | 2.40 ms | 4.11 ms | 2.72 ms |
 
 ### GCS — fake-gcs-server emulator (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | gcloud-aio | cloudpathlib | gcsfs |
 |-----------|-----------|------------|--------------|-------|
-| write | 0.22 ms | 0.24 ms | 2.88 ms | 0.33 ms |
-| read | 0.12 ms | 0.14 ms | 1.34 ms | 0.19 ms |
-| exists | 0.12 ms | 0.14 ms | 0.44 ms | 0.41 ms |
-| iterdir | 0.20 ms | 0.16 ms | 0.55 ms | 0.24 ms |
+| write | **0.45 ms** | 0.51 ms | 3.53 ms | 0.58 ms |
+| read | 0.22 ms | **0.18 ms** | 1.48 ms | 0.30 ms |
+| exists | **0.15 ms** | 0.18 ms | 0.50 ms | 0.46 ms |
+| iterdir | **0.19 ms** | 0.25 ms | 0.69 ms | 0.33 ms |
 
 ### Artifactory — live server (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | aiohttp | requests |
 |-----------|-----------|---------|----------|
-| write | 39.77 ms | 38.00 ms | 36.67 ms |
-| read | 4.29 ms | 4.75 ms | 5.43 ms |
-| exists | 2.97 ms | 3.02 ms | 4.52 ms |
-| iterdir | 4.59 ms | 4.18 ms | 6.26 ms |
+| write | **54.49 ms** | 54.75 ms | 57.57 ms |
+| read | **2.83 ms** | 3.09 ms | 12.01 ms |
+| exists | 2.33 ms | **2.18 ms** | 4.61 ms |
+| iterdir | **2.85 ms** | 3.07 ms | 7.88 ms |
 
 ### SSH / SFTP — localhost emulator (median of 20 rounds, 10 objects, c=1)
 
+asanypath uses a built-in native russh SFTP transport (off-GIL); `asyncssh` is
+shown only as a benchmark baseline.
+
 | Operation | asanypath | asyncssh |
 |-----------|-----------|----------|
-| write | 0.32 ms | 0.27 ms |
-| read | 0.34 ms | 0.33 ms |
-| exists | 0.11 ms | 0.11 ms |
-| iterdir | 0.52 ms | 0.40 ms |
+| write | **0.16 ms** | 0.33 ms |
+| read | **0.21 ms** | 0.36 ms |
+| exists | **0.07 ms** | 0.11 ms |
+| iterdir | **0.23 ms** | 0.44 ms |
 
 ### FTP — localhost emulator (median of 20 rounds, 10 objects, c=1)
 
 | Operation | asanypath | aioftp |
 |-----------|-----------|--------|
-| write | 0.40 ms | 0.34 ms |
-| read | 0.36 ms | 0.32 ms |
-| exists | 1.12 ms | 0.92 ms |
-| iterdir | 1.10 ms | 0.92 ms |
+| write | **0.35 ms** | 0.41 ms |
+| read | **0.35 ms** | 0.40 ms |
+| exists | **1.00 ms** | 1.13 ms |
+| iterdir | 1.09 ms | **1.04 ms** |
 
 Latencies are per-operation medians over 20 rounds. S3 and Artifactory ran
 against live services; Azure, GCS, SSH/SFTP, and FTP against local emulators
 (Azurite, fake-gcs-server, and localhost sftp/ftp), so those figures reflect
-client-library overhead, not WAN latency. (A direct live-remote SSH run confirms
-the tie — asanypath vs asyncssh within noise.) asanypath matches or beats
-dedicated client libraries on most operations while providing a single unified
-API across all backends.
+client-library overhead, not WAN latency. The SSH/SFTP transport is a built-in
+native russh backend that runs SFTP off-GIL and beats asyncssh on every
+operation. asanypath matches or beats dedicated client libraries on most
+operations while providing a single unified API across all backends.
 
 ## How It Works
 
@@ -355,9 +361,17 @@ API across all backends.
 | `az://`, `azure://` | `AzurePath` | reqwest + SharedKey |
 | `art://` | `ArtifactoryPath` | reqwest + Bearer |
 | `http://`, `https://` | `HTTPPath` / `HTTPSPath` | reqwest |
-
-All network I/O is handled by `asanypath-native` (Rust/PyO3 + reqwest) with
-jittered exponential backoff retry for transient errors.
+| `ssh://` | `SSHPath` | native russh (SFTP) |
+| `ftp://` | `FTPPath` | `aioftp` |
+| `ftps://` | `FTPSPath` | `aioftp` + TLS |
+| any other scheme | `UnsupportedProtocolPath` | none — pure-path only |
+
+Cloud and HTTP network I/O is handled by `asanypath-native` (Rust/PyO3 + reqwest)
+with jittered exponential backoff retry for transient errors. SSH/SFTP uses a
+built-in off-GIL native russh transport (no Python SSH dependency); FTP/FTPS use
+`aioftp`. Unknown schemes construct an `UnsupportedProtocolPath`: pure-path
+operations (`.name`, `.parent`, joins) work, while any backend operation raises
+`UnsupportedProtocolError`.
 
 ## API Reference
 

{asanypath-2.0.1 → asanypath-2.1.0}/pyproject.toml

@@ -57,9 +57,9 @@ dev = [
 ]
 cli = ["rich-click>=1.9.7"]
 ftp = ["aioftp>=0.21"]
-ssh = ["asyncssh>=2.14"]
 credstore = ["keyring>=24"]
 bench = [
+    "asyncssh>=2.14",
     "fsspec",
     "s3fs",
     "adlfs",
@@ -71,7 +71,7 @@ bench = [
     "aiofiles",
     "requests",
 ]
-all = ["asanypath[ssh,credstore,ftp]"]
+all = ["asanypath[credstore,ftp]"]
 [project.scripts]
 asanypath = "asanypath.cli:main"
 

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.0.1'
-__version_tuple__ = version_tuple = (2, 0, 1)
+__version__ = version = '2.1.0'
+__version_tuple__ = version_tuple = (2, 1, 0)
 
 __commit_id__ = commit_id = None

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/artifactory.py

@@ -170,6 +170,18 @@ class ArtifactoryPath(CloudPathMixin):
     def _item_path(self) -> str:
         return self._repo_path
 
+    def _bind_path_attrs(self) -> None:
+        raw = str(self)[len("art://") :]
+        idx = raw.find("/artifactory/")
+        if idx >= 0:
+            self._base_url = raw[: idx + len("/artifactory")]
+            self._repo_path = raw[idx + len("/artifactory/") :]
+        else:
+            self._base_url = raw.split("/")[0]
+            self._repo_path = "/".join(raw.split("/")[1:])
+        self._is_folder = None
+        self._cached_info = None
+
     @property
     def _native_kwargs(self) -> dict:
         return {
@@ -234,9 +246,7 @@ class ArtifactoryPath(CloudPathMixin):
         containers = await self._list_containers()
         if containers is not None:
             for uri in containers:
-                child = type(self)(uri)
-                child._token = self._token
-                yield child
+                yield self._child(uri)
             return
         batcher = self._get_batcher()
         results = await batcher.list(
@@ -247,10 +257,7 @@ class ArtifactoryPath(CloudPathMixin):
         base = str(self).rstrip("/")
         for uri, is_folder in results:
             child_name = uri.rsplit("/", 1)[-1]
-            child_path = type(self)(f"{base}/{child_name}")
-            child_path._token = self._token
-            child_path._is_folder = is_folder
-            yield child_path
+            yield self._child(f"{base}/{child_name}", _is_folder=is_folder)
 
     async def _list_containers(self) -> list[str] | None:
         """List repositories when at the server root (``art://<host>/artifactory/``).

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/azure.py

@@ -162,6 +162,10 @@ class AzurePath(CloudPathMixin):
     def _item_path(self) -> str:
         return self._blob_path
 
+    def _bind_path_attrs(self) -> None:
+        self._container = self._path.host or ""
+        self._blob_path = self._path.path.lstrip("/")
+
     @property
     def _native_kwargs(self) -> dict:
         return {

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/cli.py

@@ -504,7 +504,7 @@ def _maybe_rewrite_scp_style(value: str, check_config: bool = True) -> str:
             return value
         if not _discover_ssh_config():
             return value
-        resolved_host, _, _ = _resolve_alias(host, None, None)
+        resolved_host, _, _, _ = _resolve_alias(host, None, None)
         if resolved_host == host:
             # No Host block matched — leave alone (don't probe DNS).
             return value

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/cloud.py

@@ -23,6 +23,8 @@ if TYPE_CHECKING:
 
 from os import linesep
 
+from yarl import URL
+
 from asanypath._transfer import (
     async_destination_state,
     has_async_transfer_api,
@@ -108,7 +110,7 @@ class CloudPathMixin(CommonPurePathMixin):
                 else None
             ),
             "use_h2": False,
-            **self._native_kwargs,
+            **(await self._get_native_kwargs()),
         }
         await type(self)._copy_batch_fn(**kwargs)
         if not want_size:
@@ -134,11 +136,47 @@ class CloudPathMixin(CommonPurePathMixin):
         """The backend-specific object / blob / key path.  Override in subclasses."""
         raise NotImplementedError(f"{type(self).__name__} must define _item_path")
 
+    def _spawn(self, uri: str) -> Self:
+        """Build a sibling path from a canonical URI, inheriting this path's
+        credentials and config without re-parsing the scheme or re-reading env.
+
+        Used by ``iterdir``/``glob``/``walk`` where many children share the
+        parent's connection settings and differ only in their object key.
+        """
+        obj = object.__new__(type(self))
+        obj.__dict__.update(self.__dict__)
+        obj._path = URL(uri, encoded="?" in uri)
+        obj._bind_path_attrs()
+        return obj
+
+    def _bind_path_attrs(self) -> None:
+        """Recompute path-derived attributes after ``_path`` is reassigned.
+
+        Subclasses that store path-derived attributes override this.
+        """
+
+    def _child(self, uri: str, **attrs: object) -> Self:
+        """Spawn an ``iterdir``/listing child from a canonical URI and attach
+        attributes already known from the listing (cached stat, folder hint,
+        trailing-slash hint) so the child needn't re-fetch them.
+
+        One fast path for every backend: no per-child ``__init__`` (scheme
+        re-parse, env read, ssh_config resolution) and no re-stat.
+        """
+        child = self._spawn(uri)
+        for name, value in attrs.items():
+            setattr(child, name, value)
+        return child
+
     @property
     def _native_kwargs(self) -> dict:
         """Auth / endpoint kwargs forwarded to batcher and native calls."""
         raise NotImplementedError(f"{type(self).__name__} must define _native_kwargs")
 
+    async def _get_native_kwargs(self) -> dict:
+        """Resolve request credentials asynchronously when a backend needs it."""
+        return self._native_kwargs
+
     async def is_dir(self) -> bool:
         """Check if path is a directory prefix. Override in subclasses."""
         raise NotImplementedError(f"{type(self).__name__} must define is_dir()")
@@ -203,9 +241,10 @@ class CloudPathMixin(CommonPurePathMixin):
 
     async def exists(self) -> bool:
         """Check if object exists."""
+        native_kwargs = await self._get_native_kwargs()
         return await self._get_batcher().exists(
             item=self._item_path,
-            **self._native_kwargs,
+            **native_kwargs,
         )
 
     async def is_file(self) -> bool:
@@ -216,9 +255,10 @@ class CloudPathMixin(CommonPurePathMixin):
 
     async def read_bytes(self) -> bytes:
         """Read object content as bytes."""
+        native_kwargs = await self._get_native_kwargs()
         return await self._get_batcher().get(
             item=self._item_path,
-            **self._native_kwargs,
+            **native_kwargs,
         )
 
     async def iter_bytes(self, chunk_size: int | None = None) -> AsyncIterator[bytes]:
@@ -249,7 +289,12 @@ class CloudPathMixin(CommonPurePathMixin):
         from asanypath_native import range_read
 
         return bytes(
-            await range_read(path=self._item_path, start=start, end=end, **self._native_kwargs)
+            await range_read(
+                path=self._item_path,
+                start=start,
+                end=end,
+                **(await self._get_native_kwargs()),
+            )
         )
 
     async def read_text(
@@ -275,13 +320,14 @@ class CloudPathMixin(CommonPurePathMixin):
         options_json = (
             msgspec.json.encode(backend_options).decode() if backend_options is not None else "{}"
         )
+        native_kwargs = await self._get_native_kwargs()
         await self._get_batcher().put(
             item=(
                 self._item_path,
                 data,
                 options_json,
             ),
-            **self._native_kwargs,
+            **native_kwargs,
         )
         return len(data)
 
@@ -307,9 +353,10 @@ class CloudPathMixin(CommonPurePathMixin):
     async def unlink(self, missing_ok: bool = False) -> None:
         """Delete object."""
         try:
+            native_kwargs = await self._get_native_kwargs()
             await self._get_batcher().delete(
                 item=self._item_path,
-                **self._native_kwargs,
+                **native_kwargs,
             )
         except FileNotFoundError:  # pragma: no cover
             if not missing_ok:  # pragma: no cover
@@ -321,9 +368,10 @@ class CloudPathMixin(CommonPurePathMixin):
         if containers is not None:
             return containers
         try:
+            native_kwargs = await self._get_native_kwargs()
             return await self._get_batcher().list(
                 item=self._item_path,
-                **self._native_kwargs,
+                **native_kwargs,
             )
         except FileNotFoundError:
             raise NotADirectoryError(20, f"Not a directory: '{self}'")
@@ -362,7 +410,7 @@ class CloudPathMixin(CommonPurePathMixin):
                 ts, uris = entry
                 if (time.monotonic() - ts) < self.listing_cache_ttl:
                     for uri in uris:
-                        yield type(self)(uri)
+                        yield self._child(uri)
                     return
 
         uris = await self._fetch_listing()
@@ -371,7 +419,7 @@ class CloudPathMixin(CommonPurePathMixin):
             cache[cache_key] = (time.monotonic(), uris)
 
         for uri in uris:
-            yield type(self)(uri)
+            yield self._child(uri)
 
     def chmod(self, mode: int, *, follow_symlinks: bool = True) -> None:
         raise NotImplementedError(f"{type(self).__name__} does not support chmod")
@@ -803,7 +851,7 @@ class CloudPathMixin(CommonPurePathMixin):
             is_dir_results = await batch_fn(
                 prefixes=prefixes,
                 use_h2=len(prefixes) >= H2_BATCH_THRESHOLD,
-                **self._native_kwargs,
+                **(await self._get_native_kwargs()),
             )
         elif entries:
             import asyncio
@@ -976,10 +1024,9 @@ class _CloudFile:
         if "r" in self._mode:
             if self._path._supports_range_read:
                 try:
+                    native_kwargs = runner.run(self._path._get_native_kwargs())
                     headers = runner.run(
-                        self._path._get_batcher().head(
-                            item=self._path._item_path, **self._path._native_kwargs
-                        )
+                        self._path._get_batcher().head(item=self._path._item_path, **native_kwargs)
                     )
                     size = self._get_size(headers)
                     if size is not None and size > self._chunk_size:
@@ -1016,8 +1063,9 @@ class _CloudFile:
         if "r" in self._mode:
             if self._path._supports_range_read:
                 try:
+                    native_kwargs = await self._path._get_native_kwargs()
                     headers = await self._path._get_batcher().head(
-                        item=self._path._item_path, **self._path._native_kwargs
+                        item=self._path._item_path, **native_kwargs
                     )
                     size = self._get_size(headers)
                     if size is not None and size > self._chunk_size:

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/ftp.py

@@ -485,7 +485,7 @@ class FTPPath(CloudPathMixin):
         except aioftp.StatusCodeError as e:
             raise NotADirectoryError(20, f"Not a directory: '{self}'") from e
         for entry_path, _info in entries:
-            yield self / entry_path.name
+            yield self._child(str(self._path / entry_path.name))
 
     async def walk(
         self,

{asanypath-2.0.1 → asanypath-2.1.0}/src/asanypath/gcs.py

@@ -129,6 +129,10 @@ class GCSPath(CloudPathMixin):
     def _item_path(self) -> str:
         return self._object_path
 
+    def _bind_path_attrs(self) -> None:
+        self._bucket = self._path.host or ""
+        self._object_path = self._path.path.lstrip("/")
+
     @property
     def _native_kwargs(self) -> dict:
         return {