os.path: работа с путями во второй версии Python

Расширенные примеры работы с путями в Python 2

В этом разделе приведены более сложные сценарии, которые часто встречаются в системном администрировании.

Рекурсивный обход каталогов с помощью os.walk

Функция os.walk() обходит дерево каталогов, возвращая кортежи из пути, списка подкаталогов и списка файлов. Пример подсчёта общего числа файлов в заданной директории.

import os

def count_files(root_dir):
    total = 0
    for root, dirs, files in os.walk(root_dir):
        total += len(files)
    return total

root = "/var/log"
print("Всего файлов в", root, ":", count_files(root))

Всего файлов в /var/log : 142

Получение относительного пути между двумя абсолютными путями

В Python 2.6 появилась функция os.path.relpath(), которая возвращает относительный путь от одного каталога до другого.

import os

start = "/home/user/docs"
target = "/home/user/docs/projects/python/script.py"
rel = os.path.relpath(target, start)
print("Относительный путь:", rel)

Относительный путь: projects/python/script.py

Создание файла только если родительская директория существует

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

import os

def safe_create_file(filepath):
    dirname = os.path.dirname(filepath)
    if not os.path.exists(dirname):
        os.makedirs(dirname)
    open(filepath, 'a').close()  # создаёт пустой файл

safe_create_file("/tmp/test/subdir/config.ini")
print("Файл создан, существует?", os.path.exists("/tmp/test/subdir/config.ini"))

Файл создан, существует? True

Разрешение последовательности ссылок с проверкой циклов

В сложных файловых системах символьные ссылки могут образовывать циклы. Пример функции, которая разрешает ссылки, избегая бесконечного цикла.

import os

def realpath_safe(path, seen=None):
    if seen is None:
        seen = set()
    if path in seen:
        return path  # цикл обнаружен
    seen.add(path)
    if os.path.islink(path):
        link_target = os.readlink(path)
        if not os.path.isabs(link_target):
            link_target = os.path.join(os.path.dirname(path), link_target)
        return realpath_safe(link_target, seen)
    return os.path.abspath(path)

link = "/tmp/loop_link"
if not os.path.exists(link):
    os.symlink("/tmp/loop_link", link)  # искусственный цикл
result = realpath_safe(link)
print("Результат с защитой от цикла:", result)

Результат с защитой от цикла: /tmp/loop_link

Работа с разделителями путей в разных операционных системах

Атрибут os.sep содержит разделитель, используемый в текущей ОС ( / на Unix, \ на Windows). Пример сборки пути вручную с проверкой.

import os

def make_path(*parts):
    return os.sep.join(parts)

path = make_path("usr", "local", "bin")
print("Собранный путь:", path)
print("Текущий разделитель:", repr(os.sep))

Собранный путь: usr/local/bin
Текущий разделитель: '/'

Примечание

На Windows результат будет содержать обратную косую черту. Использование os.path.join() предпочтительнее, так как он учитывает особенности кодировки и проверяет корректность.

Получение списка файлов с определённым расширением в каталоге

Комбинация os.listdir() и os.path.splitext() позволяет отфильтровать файлы по расширению.

import os

def find_files_with_ext(directory, ext):
    result = []
    for f in os.listdir(directory):
        full = os.path.join(directory, f)
        if os.path.isfile(full) and os.path.splitext(f)[1] == ext:
            result.append(f)
    return result

print("Файлы .py в текущем каталоге:", find_files_with_ext(".", ".py"))

Файлы .py в текущем каталоге: ['example.py', 'main.py']