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

Расширенные примеры демонстрируют комбинирование подходов для создания устойчивых имён файлов в реальных сценариях.

Пример 1. Создание безопасного имени из пользовательского ввода

Пользователь вводит название отчёта. Необходимо заменить недопустимые символы, транслитерировать кириллицу и сформировать полный путь.

import re
from pathlib import Path

def safe_filename(user_input: str, extension: str = ".txt") -> str:
    # 1. Транслитерация (упрощённая таблица)
    trans = {
        'а':'a','б':'b','в':'v','г':'g','д':'d','е':'e','ё':'yo',
        'ж':'zh','з':'z','и':'i','й':'y','к':'k','л':'l','м':'m',
        'н':'n','о':'o','п':'p','р':'r','с':'s','т':'t','у':'u',
        'ф':'f','х':'kh','ц':'ts','ч':'ch','ш':'sh','щ':'shch',
        'ъ':'','ы':'y','ь':'','э':'e','ю':'yu','я':'ya'
    }
    # Замена русских букв
    latin = ''.join(trans.get(ch, ch) for ch in user_input.lower())
    # Удаляем недопустимые символы (кроме точки и подчёркивания)
    safe = re.sub(r'[\\/:*?"<>|\s]+', '_', latin)
    # Убираем множественные подчёркивания
    safe = re.sub(r'_+', '_', safe).strip('_')
    return safe + extension

user_title = "Отчёт: (2025) - финальная версия!"
name = safe_filename(user_title)
full_path = Path("output_reports") / name
print(full_path)

output_reports/otchjot_2025_finalnaya_versiya_.txt

Пример 2. Генерация уникального имени с временной меткой и UUID

При массовой обработке данных нужно избежать перезаписи существующих файлов.

from pathlib import Path
from datetime import datetime
import uuid

def unique_filename(prefix: str, suffix: str = ".log") -> str:
    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
    uid = uuid.uuid4().hex[:8]
    return f"{prefix}_{timestamp}_{uid}{suffix}"

name = unique_filename("processor")
path = Path("logs") / name
print(f"Создан файл: {path}")

Создан файл: logs/processor_20250322_184532_a1b2c3d4.log

Пример 3. Транслитерация с помощью библиотеки transliterate

Показан полный цикл: от ввода с кириллицей до безопасного имени с заменой пробелов.

import re
from pathlib import Path
from transliterate import translit

original_name = "Список клиентов (2025).xlsx"
latin = translit(original_name, reversed=True)  # кириллица -> латиница
# Заменяем недопустимые символы: пробелы, скобки
safe = re.sub(r'[()\s]+', '_', latin)
safe = safe.replace('__', '_')
print(f"Оригинал: {original_name}")
print(f"Безопасное имя: {safe}")

Оригинал: Список клиентов (2025).xlsx
Безопасное имя: Spisok_klientov_2025_.xlsx

Пример 4. Автоматическое добавление суффикса при конфликте имён

Если файл уже существует, можно вставить номер, не изменяя остальную часть имени.

from pathlib import Path

def resolve_collision(filepath: Path) -> Path:
    if not filepath.exists():
        return filepath
    counter = 1
    stem = filepath.stem
    suffix = filepath.suffix
    while True:
        new_name = filepath.parent / f"{stem}_{counter}{suffix}"
        if not new_name.exists():
            return new_name
        counter += 1

path = Path("downloads") / "document.pdf"
# Предположим, что такой файл уже есть
path.touch()  # имитация существующего файла
resolved = resolve_collision(path)
print(f"Исходный путь: {path}")
print(f"Разрешённый: {resolved}")

Исходный путь: downloads/document.pdf
Разрешённый: downloads/document_1.pdf