`pathlib.md`

1081 строк · 53.7 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.8/library/pathlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`pathlib`](https://python-all.ru/3.8/library/pathlib.html#module-pathlib) – Объектно-ориентированные пути файловой системы89Новое в версии 3.4.1011**Исходный код:** [Lib/pathlib.py](https://python-all.ru/src/3.8/Lib/pathlib.py)1213---1415Этот модуль предоставляет классы, представляющие пути файловой системы с семантикой, подходящей для разных операционных систем. Классы путей делятся на [чистые пути](https://python-all.ru/3.8/library/pathlib.html#pure-paths), которые выполняют только вычислительные операции без ввода-вывода, и [конкретные пути](https://python-all.ru/3.8/library/pathlib.html#concrete-paths), которые наследуют чистые пути, но также предоставляют операции ввода-вывода.1617![../_images/pathlib-inheritance.png](https://python-all.ru/3.8/_images/pathlib-inheritance.png)1819Если вы никогда не пользовались этим модулем раньше или просто не уверены, какой класс подходит для вашей задачи, скорее всего, вам нужен [`Path`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path). Он создаёт экземпляр [конкретного пути](https://python-all.ru/3.8/library/pathlib.html#concrete-paths) для платформы, на которой выполняется код.2021Чистые пути полезны в некоторых особых случаях; например:22231. Если требуется манипулировать путями Windows на машине Unix (или наоборот). При работе на Unix нельзя создать экземпляр [`WindowsPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.WindowsPath), но можно создать [`PureWindowsPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PureWindowsPath).242. Если нужно, чтобы код только манипулировал путями без фактического обращения к ОС. В таком случае может быть полезно создать экземпляр одного из чистых классов, поскольку они просто не имеют операций доступа к ОС.2526> **См. также**27>28> [**PEP 428**](https://python-all.ru/3.8/library/pathlib.html): модуль pathlib – объектно-ориентированные пути файловой системы.2930> **См. также**31>32> Для низкоуровневых манипуляций с путями в виде строк можно также использовать модуль [`os.path`](https://python-all.ru/3.8/library/os.path.html#module-os.path).3334## Основное использование3536Импорт основного класса:3738```python39>>> from pathlib import Path40```4142Список подкаталогов:4344```python45>>> p = Path('.')46>>> [x for x in p.iterdir() if x.is_dir()]47[PosixPath('.hg'), PosixPath('docs'), PosixPath('dist'),48 PosixPath('__pycache__'), PosixPath('build')]49```5051Список исходных файлов Python в этом дереве каталогов:5253```python54>>> list(p.glob('**/*.py'))55[PosixPath('test_pathlib.py'), PosixPath('setup.py'),56 PosixPath('pathlib.py'), PosixPath('docs/conf.py'),57 PosixPath('build/lib/pathlib.py')]58```5960Навигация по дереву каталогов:6162```python63>>> p = Path('/etc')64>>> q = p / 'init.d' / 'reboot'65>>> q66PosixPath('/etc/init.d/reboot')67>>> q.resolve()68PosixPath('/etc/rc.d/init.d/halt')69```7071Запрос свойств пути:7273```python74>>> q.exists()75True76>>> q.is_dir()77False78```7980Открытие файла:8182```python83>>> with q.open() as f: f.readline()84...85'#!/bin/bash\n'86```8788## Чистые пути8990Объекты чистых путей предоставляют операции обработки путей, которые не обращаются к файловой системе. Существует три способа доступа к этим классам, которые также называются *разновидностями*:9192#### `class pathlib.PurePath(*pathsegments)`9394Общий класс, представляющий разновидность пути системы (при создании экземпляра создаётся либо [`PurePosixPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePosixPath), либо [`PureWindowsPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PureWindowsPath)):9596```python97>>> PurePath('setup.py')      # Запуск на Unix-машине98PurePosixPath('setup.py')99```100101Каждый элемент *pathsegments* может быть строкой, представляющей сегмент пути, объектом, реализующим интерфейс [`os.PathLike`](https://python-all.ru/3.8/library/os.html#os.PathLike), который возвращает строку, или другим объектом пути:102103```python104>>> PurePath('foo', 'some/path', 'bar')105PurePosixPath('foo/some/path/bar')106>>> PurePath(Path('foo'), Path('bar'))107PurePosixPath('foo/bar')108```109110Когда *pathsegments* пуст, подразумевается текущий каталог:111112```python113>>> PurePath()114PurePosixPath('.')115```116117Когда передано несколько абсолютных путей, последний используется как привязка (по аналогии с поведением [`os.path.join()`](https://python-all.ru/3.8/library/os.path.html#os.path.join)):118119```python120>>> PurePath('/etc', '/usr', 'lib64')121PurePosixPath('/usr/lib64')122>>> PureWindowsPath('c:/Windows', 'd:bar')123PureWindowsPath('d:bar')124```125126Однако в пути Windows смена локального корня не отбрасывает предыдущую настройку диска:127128```python129>>> PureWindowsPath('c:/Windows', '/Program Files')130PureWindowsPath('c:/Program Files')131```132133Лишние косые черты и одиночные точки схлопываются, но двойные точки (`'..'`) – нет, так как это изменило бы смысл пути при наличии символических ссылок:134135```python136>>> PurePath('foo//bar')137PurePosixPath('foo/bar')138>>> PurePath('foo/./bar')139PurePosixPath('foo/bar')140>>> PurePath('foo/../bar')141PurePosixPath('foo/../bar')142```143144(наивный подход сделал бы `PurePosixPath('foo/../bar')` эквивалентным `PurePosixPath('bar')`, что неверно, если `foo` является символической ссылкой на другой каталог)145146Объекты чистых путей реализуют интерфейс [`os.PathLike`](https://python-all.ru/3.8/library/os.html#os.PathLike), что позволяет использовать их везде, где этот интерфейс принимается.147148Изменено в версии 3.6: Добавлена поддержка интерфейса [`os.PathLike`](https://python-all.ru/3.8/library/os.html#os.PathLike).149150#### `class pathlib.PurePosixPath(*pathsegments)`151152Подкласс [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath), эта разновидность путей представляет пути файловой системы, отличные от Windows:153154```python155>>> PurePosixPath('/etc')156PurePosixPath('/etc')157```158159Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath).160161#### `class pathlib.PureWindowsPath(*pathsegments)`162163Подкласс [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath), этот вариант пути представляет пути файловой системы Windows:164165```python166>>> PureWindowsPath('c:/Program Files/')167PureWindowsPath('c:/Program Files')168```169170Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath).171172Независимо от используемой системы можно создавать экземпляры всех этих классов, поскольку они не предоставляют никаких операций, совершающих системные вызовы.173174### Общие свойства175176Пути неизменяемы и хешируемы. Пути одного варианта сравнимы и упорядочиваемы. Эти свойства учитывают семантику регистрозависимости данного варианта:177178```python179>>> PurePosixPath('foo') == PurePosixPath('FOO')180False181>>> PureWindowsPath('foo') == PureWindowsPath('FOO')182True183>>> PureWindowsPath('FOO') in { PureWindowsPath('foo') }184True185>>> PureWindowsPath('C:') < PureWindowsPath('d:')186True187```188189Пути разных разновидностей неравны и не упорядочиваются:190191```python192>>> PureWindowsPath('foo') == PurePosixPath('foo')193False194>>> PureWindowsPath('foo') < PurePosixPath('foo')195Traceback (most recent call last):196  File "<stdin>", line 1, in <module>197TypeError: '<' not supported between instances of 'PureWindowsPath' and 'PurePosixPath'198```199200### Операторы201202Оператор слэш помогает создавать дочерние пути, аналогично [`os.path.join()`](https://python-all.ru/3.8/library/os.path.html#os.path.join):203204```python205>>> p = PurePath('/etc')206>>> p207PurePosixPath('/etc')208>>> p / 'init.d' / 'apache2'209PurePosixPath('/etc/init.d/apache2')210>>> q = PurePath('bin')211>>> '/usr' / q212PurePosixPath('/usr/bin')213```214215Объект пути можно использовать везде, где принимается объект, реализующий [`os.PathLike`](https://python-all.ru/3.8/library/os.html#os.PathLike):216217```python218>>> import os219>>> p = PurePath('/etc')220>>> os.fspath(p)221'/etc'222```223224Строковое представление пути – это сам сырой путь файловой системы (в нативном виде, например с обратными слешами в Windows), который можно передать любой функции, принимающей путь к файлу в виде строки:225226```python227>>> p = PurePath('/etc')228>>> str(p)229'/etc'230>>> p = PureWindowsPath('c:/Program Files')231>>> str(p)232'c:\\Program Files'233```234235Аналогично, вызов [`bytes`](https://python-all.ru/3.8/library/stdtypes.html#bytes) для пути возвращает сырой путь файловой системы в виде объекта bytes, закодированный с помощью [`os.fsencode()`](https://python-all.ru/3.8/library/os.html#os.fsencode):236237```python238>>> bytes(p)239b'/etc'240```241242> **Примечание**243>244> Вызов [`bytes`](https://python-all.ru/3.8/library/stdtypes.html#bytes) рекомендуется только в Unix. В Windows форма Unicode является каноническим представлением путей файловой системы.245246### Доступ к отдельным частям247248Для доступа к отдельным «частям» (компонентам) пути используйте следующее свойство:249250#### `PurePath.parts`251252Кортеж, предоставляющий доступ к различным компонентам пути:253254```python255>>> p = PurePath('/usr/bin/python3')256>>> p.parts257('/', 'usr', 'bin', 'python3')258259>>> p = PureWindowsPath('c:/Program Files/PSF')260>>> p.parts261('c:\\', 'Program Files', 'PSF')262```263264(обратите внимание, как диск и локальный корень объединены в одну часть)265266### Методы и свойства267268Чистые пути предоставляют следующие методы и свойства:269270#### `PurePath.drive`271272Строка, представляющая букву или имя диска, если таковой имеется:273274```python275>>> PureWindowsPath('c:/Program Files/').drive276'c:'277>>> PureWindowsPath('/Program Files/').drive278''279>>> PurePosixPath('/etc').drive280''281```282283UNC-ресурсы также считаются дисками:284285```python286>>> PureWindowsPath('//host/share/foo.txt').drive287'\\\\host\\share'288```289290#### `PurePath.root`291292Строка, представляющая (локальный или глобальный) корень, если таковой имеется:293294```python295>>> PureWindowsPath('c:/Program Files/').root296'\\'297>>> PureWindowsPath('c:Program Files/').root298''299>>> PurePosixPath('/etc').root300'/'301```302303UNC-ресурсы всегда имеют корень:304305```python306>>> PureWindowsPath('//host/share').root307'\\'308```309310#### `PurePath.anchor`311312Объединение диска и корневого каталога:313314```python315>>> PureWindowsPath('c:/Program Files/').anchor316'c:\\'317>>> PureWindowsPath('c:Program Files/').anchor318'c:'319>>> PurePosixPath('/etc').anchor320'/'321>>> PureWindowsPath('//host/share').anchor322'\\\\host\\share\\'323```324325#### `PurePath.parents`326327Неизменяемая последовательность, обеспечивающая доступ к логическим предкам пути:328329```python330>>> p = PureWindowsPath('c:/foo/bar/setup.py')331>>> p.parents[0]332PureWindowsPath('c:/foo/bar')333>>> p.parents[1]334PureWindowsPath('c:/foo')335>>> p.parents[2]336PureWindowsPath('c:/')337```338339#### `PurePath.parent`340341Логический родитель пути:342343```python344>>> p = PurePosixPath('/a/b/c/d')345>>> p.parent346PurePosixPath('/a/b/c')347```348349Нельзя выйти за пределы anchor или пустого пути:350351```python352>>> p = PurePosixPath('/')353>>> p.parent354PurePosixPath('/')355>>> p = PurePosixPath('.')356>>> p.parent357PurePosixPath('.')358```359360> **Примечание**361>362> Это чисто лексическая операция, поэтому поведение следующее:363>364> ```python365> >>> p = PurePosixPath('foo/..')366> >>> p.parent367> PurePosixPath('foo')368> ```369>370> Если нужно подняться вверх по произвольному пути файловой системы, рекомендуется сначала вызвать [`Path.resolve()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.resolve), чтобы разрешить символические ссылки и убрать компоненты *“..”*.371372#### `PurePath.name`373374Строка, представляющая последний компонент пути, исключая диск и корневой каталог (если они есть):375376```python377>>> PurePosixPath('my/library/setup.py').name378'setup.py'379```380381UNC-имена дисков не учитываются:382383```python384>>> PureWindowsPath('//some/share/setup.py').name385'setup.py'386>>> PureWindowsPath('//some/share').name387''388```389390#### `PurePath.suffix`391392Расширение файла последнего компонента, если таковое имеется:393394```python395>>> PurePosixPath('my/library/setup.py').suffix396'.py'397>>> PurePosixPath('my/library.tar.gz').suffix398'.gz'399>>> PurePosixPath('my/library').suffix400''401```402403#### `PurePath.suffixes`404405Список расширений файлов пути:406407```python408>>> PurePosixPath('my/library.tar.gar').suffixes409['.tar', '.gar']410>>> PurePosixPath('my/library.tar.gz').suffixes411['.tar', '.gz']412>>> PurePosixPath('my/library').suffixes413[]414```415416#### `PurePath.stem`417418Последний компонент пути без суффикса:419420```python421>>> PurePosixPath('my/library.tar.gz').stem422'library.tar'423>>> PurePosixPath('my/library.tar').stem424'library'425>>> PurePosixPath('my/library').stem426'library'427```428429#### `PurePath.as_posix()`430431Возвращает строковое представление пути с прямыми слэшами (`/`):432433```python434>>> p = PureWindowsPath('c:\\windows')435>>> str(p)436'c:\\windows'437>>> p.as_posix()438'c:/windows'439```440441#### `PurePath.as_uri()`442443Представляет путь в виде `file` URI. [`ValueError`](https://python-all.ru/3.8/library/exceptions.html#ValueError) возбуждается, если путь не является абсолютным.444445```python446>>> p = PurePosixPath('/etc/passwd')447>>> p.as_uri()448'file:///etc/passwd'449>>> p = PureWindowsPath('c:/Windows')450>>> p.as_uri()451'file:///c:/Windows'452```453454#### `PurePath.is_absolute()`455456Возвращает, является ли путь абсолютным. Путь считается абсолютным, если у него есть и корень, и (если это допускает разновидность) диск:457458```python459>>> PurePosixPath('/a/b').is_absolute()460True461>>> PurePosixPath('a/b').is_absolute()462False463464>>> PureWindowsPath('c:/a/b').is_absolute()465True466>>> PureWindowsPath('/a/b').is_absolute()467False468>>> PureWindowsPath('c:').is_absolute()469False470>>> PureWindowsPath('//some/share').is_absolute()471True472```473474#### `PurePath.is_reserved()`475476С [`PureWindowsPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PureWindowsPath) возвращает `True`, если путь считается зарезервированным в Windows, иначе `False`. С [`PurePosixPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePosixPath) всегда возвращается `False`.477478```python479>>> PureWindowsPath('nul').is_reserved()480True481>>> PurePosixPath('nul').is_reserved()482False483```484485Вызовы файловой системы для зарезервированных путей могут приводить к неожиданным ошибкам или непредвиденным последствиям.486487#### `PurePath.joinpath(*other)`488489Вызов этого метода эквивалентен последовательному объединению пути с каждым из аргументов *other*:490491```python492>>> PurePosixPath('/etc').joinpath('passwd')493PurePosixPath('/etc/passwd')494>>> PurePosixPath('/etc').joinpath(PurePosixPath('passwd'))495PurePosixPath('/etc/passwd')496>>> PurePosixPath('/etc').joinpath('init.d', 'apache2')497PurePosixPath('/etc/init.d/apache2')498>>> PureWindowsPath('c:').joinpath('/Program Files')499PureWindowsPath('c:/Program Files')500```501502#### `PurePath.match(pattern)`503504Сопоставляет этот путь с предоставленным шаблоном в стиле glob. Возвращает `True` в случае успешного сопоставления, иначе `False`.505506Если *pattern* является относительным, путь может быть как относительным, так и абсолютным, и сопоставление выполняется с правого конца:507508```python509>>> PurePath('a/b.py').match('*.py')510True511>>> PurePath('/a/b/c.py').match('b/*.py')512True513>>> PurePath('/a/b/c.py').match('a/*.py')514False515```516517Если *pattern* является абсолютным, путь должен быть абсолютным, и должен совпадать весь путь:518519```python520>>> PurePath('/a.py').match('/*.py')521True522>>> PurePath('a/b.py').match('/*.py')523False524```525526Как и в других методах, чувствительность к регистру определяется по умолчанию платформой:527528```python529>>> PurePosixPath('b.py').match('*.PY')530False531>>> PureWindowsPath('b.py').match('*.PY')532True533```534535#### `PurePath.relative_to(*other)`536537Вычисляет версию этого пути относительно пути, представленного *other*. Если это невозможно, возбуждается ValueError:538539```python540>>> p = PurePosixPath('/etc/passwd')541>>> p.relative_to('/')542PurePosixPath('etc/passwd')543>>> p.relative_to('/etc')544PurePosixPath('passwd')545>>> p.relative_to('/usr')546Traceback (most recent call last):547  File "<stdin>", line 1, in <module>548  File "pathlib.py", line 694, in relative_to549    .format(str(self), str(formatted)))550ValueError: '/etc/passwd' does not start with '/usr'551```552553#### `PurePath.with_name(name)`554555Возвращает новый путь с изменённым [`name`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.name). Если у исходного пути нет имени, вызывается ValueError:556557```python558>>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz')559>>> p.with_name('setup.py')560PureWindowsPath('c:/Downloads/setup.py')561>>> p = PureWindowsPath('c:/')562>>> p.with_name('setup.py')563Traceback (most recent call last):564  File "<stdin>", line 1, in <module>565  File "/home/antoine/cpython/default/Lib/pathlib.py", line 751, in with_name566    raise ValueError("%r has an empty name" % (self,))567ValueError: PureWindowsPath('c:/') has an empty name568```569570#### `PurePath.with_suffix(suffix)`571572Возвращает новый путь с изменённым [`suffix`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.suffix). Если у исходного пути нет суффикса, вместо него добавляется новый *suffix*. Если *suffix* – пустая строка, исходный суффикс удаляется:573574```python575>>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz')576>>> p.with_suffix('.bz2')577PureWindowsPath('c:/Downloads/pathlib.tar.bz2')578>>> p = PureWindowsPath('README')579>>> p.with_suffix('.txt')580PureWindowsPath('README.txt')581>>> p = PureWindowsPath('README.txt')582>>> p.with_suffix('')583PureWindowsPath('README')584```585586## Конкретные пути587588Конкретные пути – это подклассы чистых классов путей. В дополнение к операциям, предоставляемым последними, они также предоставляют методы для выполнения системных вызовов над объектами путей. Есть три способа создания конкретных путей:589590#### `class pathlib.Path(*pathsegments)`591592Подкласс [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath); этот класс представляет конкретные пути, соответствующие flavour данной файловой системы (при создании экземпляра создаётся либо [`PosixPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PosixPath), либо [`WindowsPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.WindowsPath)):593594```python595>>> Path('setup.py')596PosixPath('setup.py')597```598599Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath).600601#### `class pathlib.PosixPath(*pathsegments)`602603Подкласс [`Path`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path) и [`PurePosixPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePosixPath); этот класс представляет конкретные пути для файловых систем, отличных от Windows:604605```python606>>> PosixPath('/etc')607PosixPath('/etc')608```609610Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath).611612#### `class pathlib.WindowsPath(*pathsegments)`613614Подкласс [`Path`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path) и [`PureWindowsPath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PureWindowsPath); этот класс представляет конкретные пути файловой системы Windows:615616```python617>>> WindowsPath('c:/Program Files/')618WindowsPath('c:/Program Files')619```620621Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath).622623Можно создать экземпляр только того flavour класса, который соответствует системе (использование системных вызовов для несовместимых flavour путей может привести к ошибкам или сбоям в приложении):624625```python626>>> import os627>>> os.name628'posix'629>>> Path('setup.py')630PosixPath('setup.py')631>>> PosixPath('setup.py')632PosixPath('setup.py')633>>> WindowsPath('setup.py')634Traceback (most recent call last):635  File "<stdin>", line 1, in <module>636  File "pathlib.py", line 798, in __new__637    % (cls.__name__,))638NotImplementedError: cannot instantiate 'WindowsPath' on your system639```640641### Методы642643Конкретные пути предоставляют следующие методы в дополнение к методам чистых путей методы. Многие из этих методов могут вызывать [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError), если системный вызов завершается неудачей (например, из-за того, что путь не существует).644645Изменено в версии 3.8: Методы [`exists()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.exists), [`is_dir()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_dir), [`is_file()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_file), [`is_mount()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_mount), [`is_symlink()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_symlink), [`is_block_device()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_block_device), [`is_char_device()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_char_device), [`is_fifo()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_fifo), [`is_socket()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_socket) теперь возвращают `False` вместо возбуждения исключения для путей, содержащих символы, непредставимые на уровне ОС.646647#### `classmethod Path.cwd()`648649Возвращает новый объект пути, представляющий текущий каталог (как возвращается [`os.getcwd()`](https://python-all.ru/3.8/library/os.html#os.getcwd)):650651```python652>>> Path.cwd()653PosixPath('/home/antoine/pathlib')654```655656#### `classmethod Path.home()`657658Возвращает новый объект пути, представляющий домашний каталог пользователя (как возвращается [`os.path.expanduser()`](https://python-all.ru/3.8/library/os.path.html#os.path.expanduser) с конструкцией `~`):659660```python661>>> Path.home()662PosixPath('/home/antoine')663```664665Новое в версии 3.5.666667#### `Path.stat()`668669Возвращает объект [`os.stat_result`](https://python-all.ru/3.8/library/os.html#os.stat_result), содержащий информацию об этом пути, например [`os.stat()`](https://python-all.ru/3.8/library/os.html#os.stat). Результат запрашивается при каждом вызове этого метода.670671```python672>>> p = Path('setup.py')673>>> p.stat().st_size674956675>>> p.stat().st_mtime6761327883547.852554677```678679#### `Path.chmod(mode)`680681Изменяет режим файла и права доступа, как [`os.chmod()`](https://python-all.ru/3.8/library/os.html#os.chmod):682683```python684>>> p = Path('setup.py')685>>> p.stat().st_mode68633277687>>> p.chmod(0o444)688>>> p.stat().st_mode68933060690```691692#### `Path.exists()`693694Указывает ли путь на существующий файл или каталог:695696```python697>>> Path('.').exists()698True699>>> Path('setup.py').exists()700True701>>> Path('/etc').exists()702True703>>> Path('nonexistentfile').exists()704False705```706707> **Примечание**708>709> Если путь указывает на символическую ссылку, [`exists()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.exists) возвращает, *указывает ли* симлинк на существующий файл или каталог.710711#### `Path.expanduser()`712713Возвращает новый путь с развёрнутыми конструкциями `~` и `~user`, как возвращается функцией [`os.path.expanduser()`](https://python-all.ru/3.8/library/os.path.html#os.path.expanduser):714715```python716>>> p = PosixPath('~/films/Monty Python')717>>> p.expanduser()718PosixPath('/home/eric/films/Monty Python')719```720721Новое в версии 3.5.722723#### `Path.glob(pattern)`724725Выполняет поиск по заданному относительному *pattern* в каталоге, представленном этим путем, возвращая все совпадающие файлы (любого типа):726727```python728>>> sorted(Path('.').glob('*.py'))729[PosixPath('pathlib.py'), PosixPath('setup.py'), PosixPath('test_pathlib.py')]730>>> sorted(Path('.').glob('*/*.py'))731[PosixPath('docs/conf.py')]732```733734Шаблон «`**`» означает «этот каталог и все его подкаталоги рекурсивно». Другими словами, он включает рекурсивный поиск по шаблону:735736```python737>>> sorted(Path('.').glob('**/*.py'))738[PosixPath('build/lib/pathlib.py'),739 PosixPath('docs/conf.py'),740 PosixPath('pathlib.py'),741 PosixPath('setup.py'),742 PosixPath('test_pathlib.py')]743```744745> **Примечание**746>747> Использование шаблона «`**`» в больших деревьях каталогов может занять чрезмерно много времени.748749#### `Path.group()`750751Возвращает имя группы-владельца файла. [`KeyError`](https://python-all.ru/3.8/library/exceptions.html#KeyError) вызывается, если gid файла не найден в системной базе данных.752753#### `Path.is_dir()`754755Возвращает `True`, если путь указывает на каталог (или символическую ссылку на каталог), и `False`, если указывает на файл другого типа.756757`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.758759#### `Path.is_file()`760761Возвращает `True`, если путь указывает на обычный файл (или символическую ссылку на обычный файл), и `False`, если указывает на файл другого типа.762763`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.764765#### `Path.is_mount()`766767Возвращает `True`, если путь является *точкой монтирования*: точкой в файловой системе, куда смонтирована другая файловая система. На POSIX функция проверяет, находится ли родительский каталог *path*, `path/..`, на другом устройстве, чем *path*, или указывают ли `path/..` и *path* на один и тот же индексный дескриптор на одном устройстве – это должно определять точки монтирования для всех вариантов Unix и POSIX. Не реализовано в Windows.768769Добавлено в версии 3.7.770771#### `Path.is_symlink()`772773Возвращает `True`, если путь указывает на символическую ссылку, иначе `False`.774775`False` также возвращается, если путь не существует; другие ошибки (например, ошибки прав доступа) передаются дальше.776777#### `Path.is_socket()`778779Возвращает `True`, если путь указывает на сокет Unix (или на символическую ссылку, указывающую на сокет Unix), `False` если он указывает на файл другого типа.780781`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.782783#### `Path.is_fifo()`784785Возвращает `True`, если путь указывает на FIFO (или на символическую ссылку, указывающую на FIFO), `False` если он указывает на файл другого типа.786787`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.788789#### `Path.is_block_device()`790791Возвращает `True`, если путь указывает на блочное устройство (или на символическую ссылку, указывающую на блочное устройство), `False` если он указывает на файл другого типа.792793`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.794795#### `Path.is_char_device()`796797Возвращает `True`, если путь указывает на символьное устройство (или на символическую ссылку, указывающую на символьное устройство), `False` если он указывает на файл другого типа.798799`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.800801#### `Path.iterdir()`802803Если путь указывает на каталог, возвращает объекты пути для его содержимого:804805```python806>>> p = Path('docs')807>>> for child in p.iterdir(): child808...809PosixPath('docs/conf.py')810PosixPath('docs/_templates')811PosixPath('docs/make.bat')812PosixPath('docs/index.rst')813PosixPath('docs/_build')814PosixPath('docs/_static')815PosixPath('docs/Makefile')816```817818Дочерние элементы возвращаются в произвольном порядке, а специальные записи `'.'` и `'..'` не включаются. Если файл удалён или добавлен в каталог после создания итератора, будет ли включён объект пути для этого файла – не определено.819820#### `Path.lchmod(mode)`821822Как [`Path.chmod()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.chmod), но если путь указывает на символьную ссылку, то изменяется режим самой символьной ссылки, а не её цели.823824#### `Path.lstat()`825826Как [`Path.stat()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.stat), но если путь указывает на симлинк, возвращает информацию о симлинке, а не о его цели.827828#### `Path.mkdir(mode=0o777, parents=False, exist_ok=False)`829830Создаёт новый каталог по указанному пути. Если указан параметр *mode*, он комбинируется со значением `umask` процесса для определения режима файла и флагов доступа. Если путь уже существует, [`FileExistsError`](https://python-all.ru/3.8/library/exceptions.html#FileExistsError) вызывается.831832Если *parents* равен true, любые отсутствующие родительские каталоги этого пути создаются по мере необходимости; они создаются с правами по умолчанию без учёта *mode* (имитируя команду POSIX `mkdir -p`).833834Если *parents* равен false (по умолчанию), отсутствие родительского каталога вызывает [`FileNotFoundError`](https://python-all.ru/3.8/library/exceptions.html#FileNotFoundError).835836Если *exist\_ok* равен false (по умолчанию), [`FileExistsError`](https://python-all.ru/3.8/library/exceptions.html#FileExistsError) возбуждается, если целевой каталог уже существует.837838Если *exist\_ok* имеет значение true, [`FileExistsError`](https://python-all.ru/3.8/library/exceptions.html#FileExistsError) исключения будут проигнорированы (аналогично поведению команды POSIX `mkdir -p`), но только если последний компонент пути не является существующим файлом, отличным от каталога.839840Изменено в версии 3.5: Добавлен параметр *exist\_ok*.841842#### `Path.open(mode='r', buffering=-1, encoding=None, errors=None, newline=None)`843844Открывает файл, на который указывает путь, как это делает встроенная функция [`open()`](https://python-all.ru/3.8/library/functions.html#open) :845846```python847>>> p = Path('setup.py')848>>> with p.open() as f:849...     f.readline()850...851'#!/usr/bin/env python3\n'852```853854#### `Path.owner()`855856Возвращает имя пользователя-владельца файла. [`KeyError`](https://python-all.ru/3.8/library/exceptions.html#KeyError) вызывается, если uid файла не найден в системной базе данных.857858#### `Path.read_bytes()`859860Возвращает двоичное содержимое файла, на который указывает путь, в виде объекта bytes:861862```python863>>> p = Path('my_binary_file')864>>> p.write_bytes(b'Binary file contents')86520866>>> p.read_bytes()867b'Binary file contents'868```869870Новое в версии 3.5.871872#### `Path.read_text(encoding=None, errors=None)`873874Возвращает декодированное содержимое файла, на который указывает путь, в виде строки:875876```python877>>> p = Path('my_text_file')878>>> p.write_text('Text file contents')87918880>>> p.read_text()881'Text file contents'882```883884Файл открывается, а затем закрывается. Необязательные параметры имеют тот же смысл, что и в [`open()`](https://python-all.ru/3.8/library/functions.html#open).885886Новое в версии 3.5.887888#### `Path.rename(target)`889890Переименовывает этот файл или каталог в указанный *target* и возвращает новый объект Path, указывающий на *target*. В Unix, если *target* существует и является файлом, он будет бесшумно заменён, если у пользователя есть права. *target* может быть как строкой, так и другим объектом пути:891892```python893>>> p = Path('foo')894>>> p.open('w').write('some text')8959896>>> target = Path('bar')897>>> p.rename(target)898PosixPath('bar')899>>> target.open().read()900'some text'901```902903Целевой путь может быть абсолютным или относительным. Относительные пути интерпретируются относительно текущей рабочей директории, а *не* директории объекта Path.904905Изменено в версии 3.8: Добавлено возвращаемое значение – теперь возвращается новый экземпляр Path.906907#### `Path.replace(target)`908909Переименовывает этот файл или каталог в указанный *target* и возвращает новый экземпляр Path, указывающий на *target*. Если *target* указывает на существующий файл или каталог, он будет безусловно заменён.910911Целевой путь может быть абсолютным или относительным. Относительные пути интерпретируются относительно текущей рабочей директории, а *не* директории объекта Path.912913Изменено в версии 3.8: Добавлено возвращаемое значение – теперь возвращается новый экземпляр Path.914915#### `Path.resolve(strict=False)`916917Делает путь абсолютным, разрешая все символические ссылки. Возвращается новый объект пути:918919```python920>>> p = Path()921>>> p922PosixPath('.')923>>> p.resolve()924PosixPath('/home/antoine/pathlib')925```926927“`..`” компоненты также удаляются (это единственный метод, который это делает):928929```python930>>> p = Path('docs/../setup.py')931>>> p.resolve()932PosixPath('/home/antoine/pathlib/setup.py')933```934935Если путь не существует и *strict* равен `True`, возникает [`FileNotFoundError`](https://python-all.ru/3.8/library/exceptions.html#FileNotFoundError). Если *strict* равен `False`, путь разрешается настолько, насколько возможно, и остаток добавляется без проверки на существование. Если во время разрешения пути встречается бесконечный цикл, возникает [`RuntimeError`](https://python-all.ru/3.8/library/exceptions.html#RuntimeError).936937Новое в версии 3.6: Аргумент *strict* (поведение до версии 3.6 – строгое).938939#### `Path.rglob(pattern)`940941Это аналогично вызову [`Path.glob()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.glob) с добавлением «`**/`» перед указанным относительным *pattern*:942943```python944>>> sorted(Path().rglob("*.py"))945[PosixPath('build/lib/pathlib.py'),946 PosixPath('docs/conf.py'),947 PosixPath('pathlib.py'),948 PosixPath('setup.py'),949 PosixPath('test_pathlib.py')]950```951952#### `Path.rmdir()`953954Удаляет этот каталог. Каталог должен быть пустым.955956#### `Path.samefile(other_path)`957958Возвращает, указывает ли этот путь на тот же файл, что и *other\_path*, который может быть как объектом Path, так и строкой. Семантика аналогична [`os.path.samefile()`](https://python-all.ru/3.8/library/os.path.html#os.path.samefile) и [`os.path.samestat()`](https://python-all.ru/3.8/library/os.path.html#os.path.samestat).959960Исключение [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError) может быть возбуждено, если какой-либо из файлов недоступен по какой-либо причине.961962```python963>>> p = Path('spam')964>>> q = Path('eggs')965>>> p.samefile(q)966False967>>> p.samefile('spam')968True969```970971Новое в версии 3.5.972973#### `Path.symlink_to(target, target_is_directory=False)`974975Сделать этот путь символической ссылкой на *target*. В Windows *target\_is\_directory* должно иметь значение true (по умолчанию `False`), если цель ссылки является каталогом. В POSIX значение *target\_is\_directory* игнорируется.976977```python978>>> p = Path('mylink')979>>> p.symlink_to('setup.py')980>>> p.resolve()981PosixPath('/home/antoine/pathlib/setup.py')982>>> p.stat().st_size983956984>>> p.lstat().st_size9858986```987988> **Примечание**989>990> Порядок аргументов (ссылка, цель) обратный по сравнению с [`os.symlink()`](https://python-all.ru/3.8/library/os.html#os.symlink).991992#### `Path.link_to(target)`993994Создаёт жёсткую ссылку *target* на этот путь.995996> **Предупреждение**997>998> Эта функция не создаёт жёсткую ссылку на *target* для данного пути, несмотря на название функции и имена аргументов. Порядок аргументов (target, link) обратен порядку в [`Path.symlink_to()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.symlink_to), но совпадает с порядком в [`os.link()`](https://python-all.ru/3.8/library/os.html#os.link).9991000Новое в версии 3.8.10011002#### `Path.touch(mode=0o666, exist_ok=True)`10031004Создаёт файл по указанному пути. Если задан *mode*, он комбинируется со значением `umask` процесса для определения режима файла и флагов доступа. Если файл уже существует, функция завершается успешно, если *exist\_ok* равен true (при этом время изменения файла обновляется до текущего), в противном случае вызывается исключение [`FileExistsError`](https://python-all.ru/3.8/library/exceptions.html#FileExistsError).10051006#### `Path.unlink(missing_ok=False)`10071008Удаляет этот файл или символическую ссылку. Если путь указывает на каталог, используйте [`Path.rmdir()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.rmdir).10091010Если *missing\_ok* равно false (по умолчанию), [`FileNotFoundError`](https://python-all.ru/3.8/library/exceptions.html#FileNotFoundError) вызывается, если путь не существует.10111012Если *missing\_ok* равно true, исключения [`FileNotFoundError`](https://python-all.ru/3.8/library/exceptions.html#FileNotFoundError) будут игнорироваться (аналогично поведению команды POSIX `rm -f`).10131014Изменено в версии 3.8: Добавлен параметр *missing\_ok*.10151016#### `Path.write_bytes(data)`10171018Открывает файл в байтовом режиме, записывает в него *data* и закрывает файл:10191020```python1021>>> p = Path('my_binary_file')1022>>> p.write_bytes(b'Binary file contents')1023201024>>> p.read_bytes()1025b'Binary file contents'1026```10271028Существующий файл с таким же именем перезаписывается.10291030Новое в версии 3.5.10311032#### `Path.write_text(data, encoding=None, errors=None)`10331034Открывает файл в текстовом режиме, записывает в него *data* и закрывает файл:10351036```python1037>>> p = Path('my_text_file')1038>>> p.write_text('Text file contents')1039181040>>> p.read_text()1041'Text file contents'1042```10431044Существующий файл с таким же именем перезаписывается. Необязательные параметры имеют тот же смысл, что и в [`open()`](https://python-all.ru/3.8/library/functions.html#open).10451046Новое в версии 3.5.10471048## Соответствие инструментам в модуле [`os`](https://python-all.ru/3.8/library/os.html#module-os)10491050Ниже представлена таблица, сопоставляющая различные функции [`os`](https://python-all.ru/3.8/library/os.html#module-os) с их эквивалентами в [`PurePath`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath)/[`Path`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path).10511052> **Примечание**1053>1054> Хотя [`os.path.relpath()`](https://python-all.ru/3.8/library/os.path.html#os.path.relpath) и [`PurePath.relative_to()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.relative_to) имеют некоторые пересекающиеся случаи использования, их семантика различается настолько, что не позволяет считать их эквивалентными.10551056| os and os.path | pathlib |1057| --- | --- |1058| [`os.path.abspath()`](https://python-all.ru/3.8/library/os.path.html#os.path.abspath) | [`Path.resolve()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.resolve) |1059| [`os.chmod()`](https://python-all.ru/3.8/library/os.html#os.chmod) | [`Path.chmod()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.chmod) |1060| [`os.mkdir()`](https://python-all.ru/3.8/library/os.html#os.mkdir) | [`Path.mkdir()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.mkdir) |1061| [`os.rename()`](https://python-all.ru/3.8/library/os.html#os.rename) | [`Path.rename()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.rename) |1062| [`os.replace()`](https://python-all.ru/3.8/library/os.html#os.replace) | [`Path.replace()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.replace) |1063| [`os.rmdir()`](https://python-all.ru/3.8/library/os.html#os.rmdir) | [`Path.rmdir()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.rmdir) |1064| [`os.remove()`](https://python-all.ru/3.8/library/os.html#os.remove), [`os.unlink()`](https://python-all.ru/3.8/library/os.html#os.unlink) | [`Path.unlink()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.unlink) |1065| [`os.getcwd()`](https://python-all.ru/3.8/library/os.html#os.getcwd) | [`Path.cwd()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.cwd) |1066| [`os.path.exists()`](https://python-all.ru/3.8/library/os.path.html#os.path.exists) | [`Path.exists()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.exists) |1067| [`os.path.expanduser()`](https://python-all.ru/3.8/library/os.path.html#os.path.expanduser) | [`Path.expanduser()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.expanduser) и [`Path.home()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.home) |1068| [`os.listdir()`](https://python-all.ru/3.8/library/os.html#os.listdir) | [`Path.iterdir()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.iterdir) |1069| [`os.path.isdir()`](https://python-all.ru/3.8/library/os.path.html#os.path.isdir) | [`Path.is_dir()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_dir) |1070| [`os.path.isfile()`](https://python-all.ru/3.8/library/os.path.html#os.path.isfile) | [`Path.is_file()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_file) |1071| [`os.path.islink()`](https://python-all.ru/3.8/library/os.path.html#os.path.islink) | [`Path.is_symlink()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.is_symlink) |1072| [`os.link()`](https://python-all.ru/3.8/library/os.html#os.link) | [`Path.link_to()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.link_to) |1073| [`os.symlink()`](https://python-all.ru/3.8/library/os.html#os.symlink) | [`Path.symlink_to()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.symlink_to) |1074| [`os.stat()`](https://python-all.ru/3.8/library/os.html#os.stat) | [`Path.stat()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.stat), [`Path.owner()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.owner), [`Path.group()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.group) |1075| [`os.path.isabs()`](https://python-all.ru/3.8/library/os.path.html#os.path.isabs) | [`PurePath.is_absolute()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.is_absolute) |1076| [`os.path.join()`](https://python-all.ru/3.8/library/os.path.html#os.path.join) | [`PurePath.joinpath()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.joinpath) |1077| [`os.path.basename()`](https://python-all.ru/3.8/library/os.path.html#os.path.basename) | [`PurePath.name`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.name) |1078| [`os.path.dirname()`](https://python-all.ru/3.8/library/os.path.html#os.path.dirname) | [`PurePath.parent`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.parent) |1079| [`os.path.samefile()`](https://python-all.ru/3.8/library/os.path.html#os.path.samefile) | [`Path.samefile()`](https://python-all.ru/3.8/library/pathlib.html#pathlib.Path.samefile) |1080| [`os.path.splitext()`](https://python-all.ru/3.8/library/os.path.html#os.path.splitext) | [`PurePath.suffix`](https://python-all.ru/3.8/library/pathlib.html#pathlib.PurePath.suffix) |1081