copy the file more efficiently. See

:ref:`shutil-platform-dependent-efficient-copy-operations` section.

.. versionchanged:: 3.9

Accepts a :term:`path-like object` for both *src* and *dst*.

.. function:: disk_usage(path)

Return disk usage statistics about the given path as a :term:`named tuple`

rmtree.avoids_symlink_attacks = _use_fd_functions

def _basename(path):

# A basename() variant which first strips the trailing slash, if present.

# Thus we always get the last component of the path, even for directories.

"""A basename() variant which first strips the trailing slash, if present.

Thus we always get the last component of the path, even for directories.

path: Union[PathLike, str]

e.g.

>>> os.path.basename('/bar/foo')

'foo'

>>> os.path.basename('/bar/foo/')

''

>>> _basename('/bar/foo/')

'foo'

"""

path = os.fspath(path)

sep = os.path.sep + (os.path.altsep or '')

return os.path.basename(path.rstrip(sep))

os.rename(src, dst)

return

# Using _basename instead of os.path.basename is important, as we must

# ignore any trailing slash to avoid the basename returning ''

real_dst = os.path.join(dst, _basename(src))

if os.path.exists(real_dst):

raise Error("Destination path '%s' already exists" % real_dst)

try:

# Move a file inside an existing dir on the same filesystem.

self._check_move_file(self.src_file, self.dst_dir, self.dst_file)

def test_move_file_to_dir_pathlike_src(self):

# Move a pathlike file to another location on the same filesystem.

src = pathlib.Path(self.src_file)

self._check_move_file(src, self.dst_dir, self.dst_file)

def test_move_file_to_dir_pathlike_dst(self):

# Move a file to another pathlike location on the same filesystem.

dst = pathlib.Path(self.dst_dir)

self._check_move_file(self.src_file, dst, self.dst_file)

@mock_rename

def test_move_file_other_fs(self):

# Move a file to an existing dir on another filesystem.

Update :func:`shutil.move` function to allow for Path objects to be used as

source argument. Patch by Emily Morehouse and Maxwell "5.13b" McKinnon.