Python Glossary English

Python 3.3+shutilфункция

shutil.disk_usage()

система и окружение

Сообщает объём диска, на котором лежит путь: именованный кортеж total, used, free в байтах.

Синтаксис

shutil.disk_usage(path) -> usage(total, used, free)

used + free обычно меньше total: на Unix free — место, доступное обычному пользователю, а резерв для root (часто 5 %) не входит ни туда, ни туда. Числа — в байтах, для гигабайтов делят на 1024**3. Путь должен существовать; на Windows с 3.8 можно передать и файл, не только каталог.

Примеры

import shutil
u = shutil.disk_usage('.')
print(u)  # → ? usage(total=..., used=..., free=...) — зависит от машины
print(f'{u.free / 1024**3:.1f} ГБ свободно')  # → ? 12.3 ГБ свободно
print(u.used + u.free <= u.total)  # → True

См. также

Открыть в полном глоссарииdocs.python.orgСообщить о неточности