Как переименовать файл в Python: практическое руководство с кодом

Пример 1: Переименование с заменой существующего файла

Использование os.replace() для атомарной замены (кроссплатформенно):

import os

# Создаём демонстрационные файлы
with open('source.txt', 'w') as f: f.write('source')
with open('target.txt', 'w') as f: f.write('target')

os.replace('source.txt', 'target.txt')
print('source.txt' in os.listdir('.'))  # False
print('target.txt' in os.listdir('.'))  # True

# Очистка
os.remove('target.txt')

False
True

Пример 2: Переименование с изменением расширения

Заменить расширение .html на .htm для всех файлов в папке:

import os
from pathlib import Path

folder = 'pages'
for path in Path(folder).glob('*.html'):
    new_name = path.stem + '.htm'
    new_path = path.with_name(new_name)
    path.rename(new_path)
    print(f'{path.name} -> {new_name}')

index.html -> index.htm
about.html -> about.htm

Пример 3: Переименование с добавлением даты в имя файла

Использование текущей даты для создания уникального имени:

from pathlib import Path
from datetime import datetime

file = Path('report.txt')
if file.exists():
    date_str = datetime.now().strftime('%Y%m%d_%H%M%S')
    new_name = f'{file.stem}_{date_str}{file.suffix}'
    file.rename(new_name)
    print(f'Переименован в {new_name}')

Переименован в report_20250309_153045.txt

Пример 4: Безопасное переименование с использованием временного файла

Если процесс может прерваться, для сохранения целостности данных создают временную копию:

import os
import tempfile

src = 'critical_data.bin'
tmp = tempfile.mktemp(dir=os.path.dirname(src))

try:
    # Сначала копируем во временный файл
    with open(src, 'rb') as f_in, open(tmp, 'wb') as f_out:
        f_out.write(f_in.read())
    # Затем заменяем оригинал
    os.replace(tmp, src)
    print('Файл безопасно переименован')
except Exception as e:
    # Если ошибка, удаляем временный файл
    if os.path.exists(tmp):
        os.remove(tmp)
    print(f'Ошибка: {e}')

Пример 5: Переименование файла с проверкой прав доступа (Linux/Mac)

Проверка, может ли текущий пользователь переименовать файл:

import os
import stat

path = 'restricted.txt'
try:
    st = os.stat(path)
    # Проверка, есть ли право на запись в родительской директории
    if os.access(os.path.dirname(path) or '.', os.W_OK):
        os.rename(path, 'renamed_restricted.txt')
        print('Успешно')
    else:
        print('Нет прав на переименование')
except FileNotFoundError:
    print('Файл не найден')

Нет прав на переименование