Skip to content

shutil.move documentation conflicts with shutil.copy2 documentation #125676

New issue
New issue
Open
#137792
Open
shutil.move documentation conflicts with shutil.copy2 documentation#125676
#137792
Labels
docsDocumentation in the Doc dir
@JasonGross

Description

@JasonGross
JasonGross
opened on Oct 18, 2024

Documentation

cpython/Doc/library/shutil.rst

Lines 381 to 384 in a0f5c8e

:func:`copytree` is called, passing it the *copy_function*. The
default *copy_function* is :func:`copy2`. Using :func:`~shutil.copy` as the
*copy_function* allows the move to succeed when it is not possible to also
copy the metadata, at the expense of not copying any of the metadata.

cpython/Doc/library/shutil.rst

Lines 199 to 202 in a0f5c8e

On platforms where some or all of this functionality is
unavailable, :func:`copy2` will preserve all the metadata
it can; :func:`copy2` never raises an exception because it
cannot preserve file metadata.

Which is it? Does copy2 sometimes fail to copy files, or does move work fine even with copy2 on systems that cannot copy all metadata?

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    docs issues

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions