os.stat ()

os.stat ( path, *, dir_fd=None, follow_symlinks=True )

Получает статус файла или файлового дескриптора. Выполняет эквивалент системного вызова stat () по заданному пути path. Путь path может быть указан как строка или байты - прямо или косвенно через интерфейс PathLike - или как дескриптор открытого файла. Возвращает объект stat_result.

Эта функция обычно следует за символическими ссылками; чтобы указать символическую ссылку, добавьте аргумент follow_symlinks = False или используйте lstat ().

Эта функция может поддерживать указание дескриптора файла, а не переход по символическим ссылкам.

В Windows передача follow_symlinks = False отключит отслеживание всех точек повторной обработки суррогата имени, включая символические ссылки и соединения каталогов. Другие типы точек повторной обработки, которые не похожи на ссылки или по которым операционная система не может перейти, будут открываться напрямую. При следовании цепочке из нескольких ссылок это может привести к возврату исходной ссылки вместо несвязки, которая препятствовала полному переходу. В этом случае для получения результатов статистики для конечного пути используйте функцию os.path.realpath (), чтобы разрешить имя пути, насколько это возможно, и вызовите lstat () для результата. Это не относится к висячим символическим ссылкам или точкам соединения, которые вызывают обычные исключения.

Пример:

>>> import os
>>> statinfo = os.stat('somefile.txt')
>>> statinfo
os.stat_result(st_mode=33188, st_ino=7876932, st_dev=234881026,
st_nlink=1, st_uid=501, st_gid=501, st_size=264, st_atime=1297230295,
st_mtime=1297230027, st_ctime=1297230027)
>>> statinfo.st_size
264

Смотрите также: функции fstat () и lstat ().

Новое в версии 3.3: добавлены аргументы dir_fd и follow_symlinks, указывающие дескриптор файла вместо пути.

Изменено в версии 3.6: Принимает объект, подобный пути (path-like object ).

Изменено в версии 3.8: в Windows теперь отслеживаются все точки повторной обработки, которые могут быть разрешены операционной системой, а передача follow_symlinks = False отключает отслеживание всех точек повторной обработки суррогатных имен. Если операционная система достигает точки повторной обработки, которой она не может следовать, stat теперь возвращает информацию для исходного пути, как если бы была указана follow_symlinks = False, вместо того, чтобы вызывать ошибку.