Python Glossary English

Python 3.5+pathlibфункция

pathlib.Path.home()

создание

Возвращает домашний каталог пользователя как Path. Классовый метод — вызывается на самом Path, не на экземпляре.

Синтаксис

Path.home()

Домашний каталог вычисляется по окружению (HOME на Unix, USERPROFILE на Windows), поэтому в контейнере, в CI или под сервисным пользователем он легко окажется не тем, что вы видите в своей консоли; если определить его не удалось, поднимется RuntimeError. И учтите: сам pathlib тильду не раскрывает — путь с ~ внутри строки останется буквальным именем каталога, для раскрытия есть отдельный метод expanduser().

Примеры

from pathlib import Path
Path.home() # → PosixPath('/home/username')
Path.home() / 'Downloads' # → PosixPath('/home/username/Downloads')
Path.home().is_absolute()  # → True
Path.home().is_dir()  # → True
Path('~/notes.txt').expanduser() == Path.home() / 'notes.txt'  # → True

См. также

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