все Python 3shutilфункция

shutil.copy()

копирование файлов

Копирует файл вместе с битами прав; dst может быть каталогом — тогда копия ляжет внутрь под тем же именем.

Синтаксис

shutil.copy(src, dst, *, follow_symlinks=True) -> path

copy = copyfile + copymode: права переносятся, а время изменения — нет, у копии оно станет «сейчас». Если важна дата (бэкап, синхронизация), нужен copy2. Возвращает путь созданного файла — удобно, когда dst был каталогом. Каталоги copy не копирует: на каталоге в src будет IsADirectoryError, для них copytree.

Примеры

import os, shutil
os.mkdir('backup')
open('a.txt', 'w').close()
os.utime('a.txt', (0, 1_000_000))
dst = shutil.copy('a.txt', 'backup')
print(dst)  # → ? backup/a.txt — разделитель зависит от ОС
print(os.stat(dst).st_mtime == 1_000_000)  # → False — время не перенесено

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности