Функция replace() модуля os в Python

Заменить имя файл из кода Python

Синтаксис:

import os

os.replace(src, dst, *, src_dir_fd=None, dst_dir_fd=None)

Параметры:

• src - str, исходное имя файла или каталога,
• dst - str, новое имя файла или каталога,
• src_dir_fd=None - int, исходный дескриптор каталога,
• dst_dir_fd=None - int, новый дескриптор каталога,

Возвращаемое значение:

• None

Описание:

Функция replace() модуля os переименовывает файл или пустой каталог с исходным именем src в dst.

Аргумент src и dst могут принимать объекты, представляющие путь файловой системы, такие как pathlib.PurePath.

• Если src - это файл, а dst - это каталог или наоборот, то будет вызвано исключение OSError.
• Если dst существует и является файлом, он будет автоматически заменен, если у пользователя есть разрешение.
• Операция может завершиться ошибкой, если src и dst находятся в разных файловых системах.
• В случае успеха переименование будет атомарной операцией (это требование POSIX).

Функция os.replace() может поддерживать указание src_dir_fd и/или dst_dir_fd для предоставления путей относительно дескриптора каталога.

Вызывает событие аудита os.rename с аргументами src, dst, src_dir_fd, dst_dir_fd.

Примеры использования:

>>> import os
>>> scr_dir, dst_dir = 'test_dir', 'rename_dir'
>>> os.mkdir(scr_dir, 0o774)
# переименовывание
>>> os.replace(scr_dir, dst_dir)
>>> os.path.isdir(dst_dir)
# True
>>> os.rmdir(dst_dir)

>>> scr_f, dst_f = 'test_file.txt', 'rename_file.txt'
# создадим файл
>>> fp = open(scr_f, 'w')
>>> fp.write('data string')
>>> fp.close()
# переименовывание
>>> os.replace(scr_f, dst_f)
>>> os.path.isfile(dst_f)
# True
>>> os.unlink(dst_f)