ProxyUPath._copy_from function signature incorrect

[jpweytjens]

Description

ProxyUPath._copy_from() has a fixed signature that only accepts follow_symlinks, but newer versions of fsspec pass additional keyword arguments like preserve_metadata. This causes a TypeError when using move() or copy() with a ProxyUPath subclass as the destination.

MWE

from upath import UPath
from upath.extensions import ProxyUPath

class MyProxyPath(ProxyUPath):
    def __init__(self, path):
        self._lazy = UPath(path)

    @property
    def __wrapped__(self):
        return self._lazy

    @classmethod
    def _from_upath(cls, upath, /):
        obj = object.__new__(cls)
        obj._lazy = upath
        return obj

# Local file to S3 (or any cross-filesystem move)
source = UPath("/tmp/test.txt")
source.write_text("hello")

destination = MyProxyPath("s3://my-bucket/test.txt")
source.move(destination)  # TypeError: ProxyUPath._copy_from() got an unexpected keyword argument 'preserve_metadata'

Expected Behavior

_copy_from() should forward all kwargs to the wrapped UPath:

def _copy_from(
    self, source: ReadablePath | Self, follow_symlinks: bool = True, **kwargs
) -> None:
    self.__wrapped__._copy_from(source, follow_symlinks=follow_symlinks, **kwargs)

Environment

Python: 3.14
universal-pathlib: 0.3.9
fsspec: 2026.2

[ap--]

Thanks for reporting ❤️
For future issue reports, always include full tracebacks.

Could you contribute a test copying from local to s3 to the test_suite in tests/test_extensions. This test will only fail on python 3.14, when copying to a ProxyUPath. The fsspec version should not matter, unless you observe that downgrading fsspec will restore behavior, which I think should have no effect.
Once you have an example of the failing test, reproducing your issue, the fix will be to just fix the function signature in ProxyUPath._copy_from to match:

universal_pathlib/upath/core.py

Lines 1341 to 1347 in 3a0df86

	def _copy_from(
	self,
	source: ReadablePath,
	follow_symlinks: bool = True,
	on_name_collision: OnNameCollisionFunc | None = None,
	**kwargs: Any,
	) -> None:

[jpweytjens]

The full traceback

Traceback (most recent call last):
  File "/Users/johannes/Desktop/universal_pathlib/copy_from.py", line 39, in <module>
    source.move(destination)
    ~~~~~~~~~~~^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/python@3.14/3.14.2_1/Frameworks/Python.framework/Versions/3.14/lib/python3.14/pathlib/__init__.py", line 1190, in move
    target = self.copy(target, follow_symlinks=False, preserve_metadata=True)
  File "/opt/homebrew/Cellar/python@3.14/3.14.2_1/Frameworks/Python.framework/Versions/3.14/lib/python3.14/pathlib/__init__.py", line 1103, in copy
    target._copy_from(self, **kwargs)
    ~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
TypeError: ProxyUPath._copy_from() got an unexpected keyword argument 'preserve_metadata'

The test and your solution are in #547.

Not sure if we need to pass on_name_colission and potential other **kwargs to __wrapped__ as well?