shutil.copy2() ⚬ Entries

↩ 🔵 🔵 🔵

---

Primary

၊၊||၊|။

shutil.copy2() ⚬｜Documentation｜1st｜20251021204955-00-⌔

shutil — High-level file operations — Python 3 documentation#shutil.copy2

shutil.copy2(src, dst, ﹡, follow_symlinks=True)

Identical to copy() except that copy2() also attempts to preserve file metadata.

When follow_symlinks is false, and src is a symbolic link, copy2() attempts to copy all metadata from the src symbolic link to the newly created dst symbolic link. However, this functionality is not available on all platforms. On platforms where some or all of this functionality is unavailable, copy2() will preserve all the metadata it can; copy2() never raises an exception because it cannot preserve file metadata.

copy2() uses copystat() to copy the file metadata. Please see copystat() for more information about platform support for modifying symbolic link metadata.

Raises an auditing event shutil.copyfile with arguments src, dst.

Raises an auditing event shutil.copystat with arguments src, dst.

Changed in version 3.3: Added follow_symlinks argument, try to copy extended file system attributes too (currently Linux only). Now returns path to the newly created file.

Changed in version 3.8: Platform-specific fast-copy syscalls may be used internally in order to copy the file more efficiently. See Platform-dependent efficient copy operations section.

Printed 2026-06-28.

(echo:: @ ᯤ)

Link to original

Secondary

• • •

---