pathlib.md
1> **Источник:** https://python-all.ru/3.6/library/pathlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 11.1. [`pathlib`](https://python-all.ru/3.6/library/pathlib.html#module-pathlib) – Объектно-ориентированные пути файловой системы89Новое в версии 3.4.1011**Исходный код:** [Lib/pathlib.py](https://python-all.ru/src/3.6/Lib/pathlib.py)1213---1415Этот модуль предоставляет классы, представляющие пути файловой системы с семантикой, подходящей для разных операционных систем. Классы путей делятся на [чистые пути](https://python-all.ru/3.6/library/pathlib.html#pure-paths), которые выполняют только вычислительные операции без ввода-вывода, и [конкретные пути](https://python-all.ru/3.6/library/pathlib.html#concrete-paths), которые наследуют чистые пути, но также предоставляют операции ввода-вывода.16171819Если вы никогда не пользовались этим модулем раньше или просто не уверены, какой класс подходит для вашей задачи, скорее всего, вам нужен [`Path`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path). Он создаёт экземпляр [конкретного пути](https://python-all.ru/3.6/library/pathlib.html#concrete-paths) для платформы, на которой выполняется код.2021Чистые пути полезны в некоторых особых случаях; например:22231. Если требуется манипулировать путями Windows на машине Unix (или наоборот). При работе на Unix нельзя создать экземпляр [`WindowsPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.WindowsPath), но можно создать [`PureWindowsPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PureWindowsPath).242. Если нужно, чтобы код только манипулировал путями без фактического обращения к ОС. В таком случае может быть полезно создать экземпляр одного из чистых классов, поскольку они просто не имеют операций доступа к ОС.2526> **См. также**27>28> [**PEP 428**](https://python-all.ru/3.6/library/pathlib.html): модуль pathlib – объектно-ориентированные пути файловой системы.2930> **См. также**31>32> Для низкоуровневых манипуляций с путями в виде строк можно также использовать модуль [`os.path`](https://python-all.ru/3.6/library/os.path.html#module-os.path).3334## 11.1.1. Базовое использование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## 11.1.2. Чистые пути8990Объекты чистых путей предоставляют операции обработки путей, которые не обращаются к файловой системе. Существует три способа доступа к этим классам, которые также называются *разновидностями*:9192#### `class pathlib.PurePath(*pathsegments)`9394Общий класс, представляющий разновидность пути системы (при создании экземпляра создаётся либо [`PurePosixPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePosixPath), либо [`PureWindowsPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PureWindowsPath)):9596```python97>>> PurePath('setup.py') # Запуск на Unix-машине98PurePosixPath('setup.py')99```100101Каждый элемент *pathsegments* может быть строкой, представляющей сегмент пути, объектом, реализующим интерфейс [`os.PathLike`](https://python-all.ru/3.6/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.6/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.6/library/os.html#os.PathLike), что позволяет использовать их везде, где этот интерфейс принимается.147148Изменено в версии 3.6: Добавлена поддержка интерфейса [`os.PathLike`](https://python-all.ru/3.6/library/os.html#os.PathLike).149150#### `class pathlib.PurePosixPath(*pathsegments)`151152Подкласс [`PurePath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath), эта разновидность путей представляет пути файловой системы, отличные от Windows:153154```python155>>> PurePosixPath('/etc')156PurePosixPath('/etc')157```158159Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath).160161#### `class pathlib.PureWindowsPath(*pathsegments)`162163Подкласс [`PurePath`](https://python-all.ru/3.6/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.6/library/pathlib.html#pathlib.PurePath).171172Независимо от используемой системы можно создавать экземпляры всех этих классов, поскольку они не предоставляют никаких операций, совершающих системные вызовы.173174### 11.1.2.1. Общие свойства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### 11.1.2.2. Операторы201202Оператор слэш помогает создавать дочерние пути, аналогично [`os.path.join()`](https://python-all.ru/3.6/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.6/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.6/library/stdtypes.html#bytes) для пути возвращает сырой путь файловой системы в виде объекта bytes, закодированный с помощью [`os.fsencode()`](https://python-all.ru/3.6/library/os.html#os.fsencode):236237```python238>>> bytes(p)239b'/etc'240```241242> **Примечание**243>244> Вызов [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) рекомендуется только в Unix. В Windows форма Unicode является каноническим представлением путей файловой системы.245246### 11.1.2.3. Доступ к отдельным частям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### 11.1.2.4. Методы и свойства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.6/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.6/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.6/library/pathlib.html#pathlib.PureWindowsPath) возвращает `True`, если путь считается зарезервированным в Windows, иначе `False`. С [`PurePosixPath`](https://python-all.ru/3.6/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>>> PureWindowsPath('b.py').match('*.PY')530True531```532533#### `PurePath.relative_to(*other)`534535Вычисляет версию этого пути относительно пути, представленного *other*. Если это невозможно, возбуждается ValueError:536537```python538>>> p = PurePosixPath('/etc/passwd')539>>> p.relative_to('/')540PurePosixPath('etc/passwd')541>>> p.relative_to('/etc')542PurePosixPath('passwd')543>>> p.relative_to('/usr')544Traceback (most recent call last):545 File "<stdin>", line 1, in <module>546 File "pathlib.py", line 694, in relative_to547 .format(str(self), str(formatted)))548ValueError: '/etc/passwd' does not start with '/usr'549```550551#### `PurePath.with_name(name)`552553Возвращает новый путь с изменённым [`name`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath.name). Если у исходного пути нет имени, вызывается ValueError:554555```python556>>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz')557>>> p.with_name('setup.py')558PureWindowsPath('c:/Downloads/setup.py')559>>> p = PureWindowsPath('c:/')560>>> p.with_name('setup.py')561Traceback (most recent call last):562 File "<stdin>", line 1, in <module>563 File "/home/antoine/cpython/default/Lib/pathlib.py", line 751, in with_name564 raise ValueError("%r has an empty name" % (self,))565ValueError: PureWindowsPath('c:/') has an empty name566```567568#### `PurePath.with_suffix(suffix)`569570Возвращает новый путь с изменённым [`suffix`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath.suffix). Если у исходного пути нет суффикса, вместо него добавляется новый *suffix*. Если *suffix* – пустая строка, исходный суффикс удаляется:571572```python573>>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz')574>>> p.with_suffix('.bz2')575PureWindowsPath('c:/Downloads/pathlib.tar.bz2')576>>> p = PureWindowsPath('README')577>>> p.with_suffix('.txt')578PureWindowsPath('README.txt')579>>> p = PureWindowsPath('README.txt')580>>> p.with_suffix('')581PureWindowsPath('README')582```583584## 11.1.3. Конкретные пути585586Конкретные пути – это подклассы чистых классов путей. В дополнение к операциям, предоставляемым последними, они также предоставляют методы для выполнения системных вызовов над объектами путей. Есть три способа создания конкретных путей:587588#### `class pathlib.Path(*pathsegments)`589590Подкласс [`PurePath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath); этот класс представляет конкретные пути, соответствующие flavour данной файловой системы (при создании экземпляра создаётся либо [`PosixPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PosixPath), либо [`WindowsPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.WindowsPath)):591592```python593>>> Path('setup.py')594PosixPath('setup.py')595```596597Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath).598599#### `class pathlib.PosixPath(*pathsegments)`600601Подкласс [`Path`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path) и [`PurePosixPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePosixPath); этот класс представляет конкретные пути для файловых систем, отличных от Windows:602603```python604>>> PosixPath('/etc')605PosixPath('/etc')606```607608Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath).609610#### `class pathlib.WindowsPath(*pathsegments)`611612Подкласс [`Path`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path) и [`PureWindowsPath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PureWindowsPath); этот класс представляет конкретные пути файловой системы Windows:613614```python615>>> WindowsPath('c:/Program Files/')616WindowsPath('c:/Program Files')617```618619Параметр *pathsegments* задаётся так же, как [`PurePath`](https://python-all.ru/3.6/library/pathlib.html#pathlib.PurePath).620621Можно создать экземпляр только того flavour класса, который соответствует системе (использование системных вызовов для несовместимых flavour путей может привести к ошибкам или сбоям в приложении):622623```python624>>> import os625>>> os.name626'posix'627>>> Path('setup.py')628PosixPath('setup.py')629>>> PosixPath('setup.py')630PosixPath('setup.py')631>>> WindowsPath('setup.py')632Traceback (most recent call last):633 File "<stdin>", line 1, in <module>634 File "pathlib.py", line 798, in __new__635 % (cls.__name__,))636NotImplementedError: cannot instantiate 'WindowsPath' on your system637```638639### 11.1.3.1. Методы640641Конкретные пути предоставляют следующие методы в дополнение к методам чистых путей методы. Многие из этих методов могут вызвать [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError), если системный вызов завершится неудачей (например, потому что путь не существует):642643#### `classmethod Path.cwd()`644645Возвращает новый объект пути, представляющий текущий каталог (как возвращается [`os.getcwd()`](https://python-all.ru/3.6/library/os.html#os.getcwd)):646647```python648>>> Path.cwd()649PosixPath('/home/antoine/pathlib')650```651652#### `classmethod Path.home()`653654Возвращает новый объект пути, представляющий домашний каталог пользователя (как возвращается [`os.path.expanduser()`](https://python-all.ru/3.6/library/os.path.html#os.path.expanduser) с конструкцией `~`):655656```python657>>> Path.home()658PosixPath('/home/antoine')659```660661Новое в версии 3.5.662663#### `Path.stat()`664665Возвращает информацию об этом пути (аналогично [`os.stat()`](https://python-all.ru/3.6/library/os.html#os.stat)). Результат запрашивается при каждом вызове этого метода.666667```python668>>> p = Path('setup.py')669>>> p.stat().st_size670956671>>> p.stat().st_mtime6721327883547.852554673```674675#### `Path.chmod(mode)`676677Изменяет режим файла и права доступа, как [`os.chmod()`](https://python-all.ru/3.6/library/os.html#os.chmod):678679```python680>>> p = Path('setup.py')681>>> p.stat().st_mode68233277683>>> p.chmod(0o444)684>>> p.stat().st_mode68533060686```687688#### `Path.exists()`689690Указывает ли путь на существующий файл или каталог:691692```python693>>> Path('.').exists()694True695>>> Path('setup.py').exists()696True697>>> Path('/etc').exists()698True699>>> Path('nonexistentfile').exists()700False701```702703> **Примечание**704>705> Если путь указывает на символическую ссылку, [`exists()`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path.exists) возвращает, *указывает ли* симлинк на существующий файл или каталог.706707#### `Path.expanduser()`708709Возвращает новый путь с развёрнутыми конструкциями `~` и `~user`, как возвращается функцией [`os.path.expanduser()`](https://python-all.ru/3.6/library/os.path.html#os.path.expanduser):710711```python712>>> p = PosixPath('~/films/Monty Python')713>>> p.expanduser()714PosixPath('/home/eric/films/Monty Python')715```716717Новое в версии 3.5.718719#### `Path.glob(pattern)`720721Выполняет поиск по заданному *шаблону* в каталоге, представленном этим путём, возвращая все соответствующие файлы (любого типа):722723```python724>>> sorted(Path('.').glob('*.py'))725[PosixPath('pathlib.py'), PosixPath('setup.py'), PosixPath('test_pathlib.py')]726>>> sorted(Path('.').glob('*/*.py'))727[PosixPath('docs/conf.py')]728```729730Шаблон «`**`» означает «этот каталог и все его подкаталоги рекурсивно». Другими словами, он включает рекурсивный поиск по шаблону:731732```python733>>> sorted(Path('.').glob('**/*.py'))734[PosixPath('build/lib/pathlib.py'),735 PosixPath('docs/conf.py'),736 PosixPath('pathlib.py'),737 PosixPath('setup.py'),738 PosixPath('test_pathlib.py')]739```740741> **Примечание**742>743> Использование шаблона «`**`» в больших деревьях каталогов может занять чрезмерно много времени.744745#### `Path.group()`746747Возвращает имя группы-владельца файла. [`KeyError`](https://python-all.ru/3.6/library/exceptions.html#KeyError) вызывается, если gid файла не найден в системной базе данных.748749#### `Path.is_dir()`750751Возвращает `True`, если путь указывает на каталог (или символическую ссылку на каталог), и `False`, если указывает на файл другого типа.752753`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.754755#### `Path.is_file()`756757Возвращает `True`, если путь указывает на обычный файл (или символическую ссылку на обычный файл), и `False`, если указывает на файл другого типа.758759`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.760761#### `Path.is_symlink()`762763Возвращает `True`, если путь указывает на символическую ссылку, иначе `False`.764765`False` также возвращается, если путь не существует; другие ошибки (например, ошибки прав доступа) передаются дальше.766767#### `Path.is_socket()`768769Возвращает `True`, если путь указывает на сокет Unix (или на символическую ссылку, указывающую на сокет Unix), `False` если он указывает на файл другого типа.770771`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.772773#### `Path.is_fifo()`774775Возвращает `True`, если путь указывает на FIFO (или на символическую ссылку, указывающую на FIFO), `False` если он указывает на файл другого типа.776777`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.778779#### `Path.is_block_device()`780781Возвращает `True`, если путь указывает на блочное устройство (или на символическую ссылку, указывающую на блочное устройство), `False` если он указывает на файл другого типа.782783`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.784785#### `Path.is_char_device()`786787Возвращает `True`, если путь указывает на символьное устройство (или на символическую ссылку, указывающую на символьное устройство), `False` если он указывает на файл другого типа.788789`False` также возвращается, если путь не существует или является битой символьной ссылкой; другие ошибки (например, ошибки прав доступа) передаются.790791#### `Path.iterdir()`792793Если путь указывает на каталог, возвращает объекты пути для его содержимого:794795```python796>>> p = Path('docs')797>>> for child in p.iterdir(): child798...799PosixPath('docs/conf.py')800PosixPath('docs/_templates')801PosixPath('docs/make.bat')802PosixPath('docs/index.rst')803PosixPath('docs/_build')804PosixPath('docs/_static')805PosixPath('docs/Makefile')806```807808#### `Path.lchmod(mode)`809810Как [`Path.chmod()`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path.chmod), но если путь указывает на символьную ссылку, то изменяется режим самой символьной ссылки, а не её цели.811812#### `Path.lstat()`813814Как [`Path.stat()`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path.stat), но если путь указывает на симлинк, возвращает информацию о симлинке, а не о его цели.815816#### `Path.mkdir(mode=0o777, parents=False, exist_ok=False)`817818Создаёт новый каталог по указанному пути. Если указан параметр *mode*, он комбинируется со значением `umask` процесса для определения режима файла и флагов доступа. Если путь уже существует, [`FileExistsError`](https://python-all.ru/3.6/library/exceptions.html#FileExistsError) вызывается.819820Если *parents* равен true, любые отсутствующие родительские каталоги этого пути создаются по мере необходимости; они создаются с правами по умолчанию без учёта *mode* (имитируя команду POSIX `mkdir -p`).821822Если *parents* равен false (по умолчанию), отсутствие родительского каталога вызывает [`FileNotFoundError`](https://python-all.ru/3.6/library/exceptions.html#FileNotFoundError).823824Если *exist\_ok* равен false (по умолчанию), [`FileExistsError`](https://python-all.ru/3.6/library/exceptions.html#FileExistsError) возбуждается, если целевой каталог уже существует.825826Если *exist\_ok* имеет значение true, [`FileExistsError`](https://python-all.ru/3.6/library/exceptions.html#FileExistsError) исключения будут проигнорированы (аналогично поведению команды POSIX `mkdir -p`), но только если последний компонент пути не является существующим файлом, отличным от каталога.827828Изменено в версии 3.5: Добавлен параметр *exist\_ok*.829830#### `Path.open(mode='r', buffering=-1, encoding=None, errors=None, newline=None)`831832Открывает файл, на который указывает путь, как это делает встроенная функция [`open()`](https://python-all.ru/3.6/library/functions.html#open) :833834```python835>>> p = Path('setup.py')836>>> with p.open() as f:837... f.readline()838...839'#!/usr/bin/env python3\n'840```841842#### `Path.owner()`843844Возвращает имя пользователя-владельца файла. [`KeyError`](https://python-all.ru/3.6/library/exceptions.html#KeyError) вызывается, если uid файла не найден в системной базе данных.845846#### `Path.read_bytes()`847848Возвращает двоичное содержимое файла, на который указывает путь, в виде объекта bytes:849850```python851>>> p = Path('my_binary_file')852>>> p.write_bytes(b'Binary file contents')85320854>>> p.read_bytes()855b'Binary file contents'856```857858Новое в версии 3.5.859860#### `Path.read_text(encoding=None, errors=None)`861862Возвращает декодированное содержимое файла, на который указывает путь, в виде строки:863864```python865>>> p = Path('my_text_file')866>>> p.write_text('Text file contents')86718868>>> p.read_text()869'Text file contents'870```871872Файл открывается, а затем закрывается. Необязательные параметры имеют тот же смысл, что и в [`open()`](https://python-all.ru/3.6/library/functions.html#open).873874Новое в версии 3.5.875876#### `Path.rename(target)`877878Переименовывает этот файл или каталог в указанный *target*. В Unix, если *target* существует и является файлом, он будет бесшумно заменён, если у пользователя есть соответствующие права. *target* может быть как строкой, так и другим объектом пути:879880```python881>>> p = Path('foo')882>>> p.open('w').write('some text')8839884>>> target = Path('bar')885>>> p.rename(target)886>>> target.open().read()887'some text'888```889890#### `Path.replace(target)`891892Переименовывает этот файл или каталог в указанный *target*. Если *target* указывает на существующий файл или каталог, он будет безусловно заменён.893894#### `Path.resolve(strict=False)`895896Делает путь абсолютным, разрешая все символические ссылки. Возвращается новый объект пути:897898```python899>>> p = Path()900>>> p901PosixPath('.')902>>> p.resolve()903PosixPath('/home/antoine/pathlib')904```905906“`..`” компоненты также удаляются (это единственный метод, который это делает):907908```python909>>> p = Path('docs/../setup.py')910>>> p.resolve()911PosixPath('/home/antoine/pathlib/setup.py')912```913914Если путь не существует и *strict* равен `True`, возникает [`FileNotFoundError`](https://python-all.ru/3.6/library/exceptions.html#FileNotFoundError). Если *strict* равен `False`, путь разрешается настолько, насколько возможно, и остаток добавляется без проверки на существование. Если во время разрешения пути встречается бесконечный цикл, возникает [`RuntimeError`](https://python-all.ru/3.6/library/exceptions.html#RuntimeError).915916Новое в версии 3.6: Аргумент *strict*.917918#### `Path.rglob(pattern)`919920Это похоже на вызов [`Path.glob()`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path.glob) с добавлением “`**`” перед заданным *шаблоном*:921922```python923>>> sorted(Path().rglob("*.py"))924[PosixPath('build/lib/pathlib.py'),925 PosixPath('docs/conf.py'),926 PosixPath('pathlib.py'),927 PosixPath('setup.py'),928 PosixPath('test_pathlib.py')]929```930931#### `Path.rmdir()`932933Удаляет этот каталог. Каталог должен быть пустым.934935#### `Path.samefile(other_path)`936937Возвращает, указывает ли этот путь на тот же файл, что и *other\_path*, который может быть как объектом Path, так и строкой. Семантика аналогична [`os.path.samefile()`](https://python-all.ru/3.6/library/os.path.html#os.path.samefile) и [`os.path.samestat()`](https://python-all.ru/3.6/library/os.path.html#os.path.samestat).938939Исключение [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError) может быть возбуждено, если какой-либо из файлов недоступен по какой-либо причине.940941```python942>>> p = Path('spam')943>>> q = Path('eggs')944>>> p.samefile(q)945False946>>> p.samefile('spam')947True948```949950Новое в версии 3.5.951952#### `Path.symlink_to(target, target_is_directory=False)`953954Сделать этот путь символической ссылкой на *target*. В Windows *target\_is\_directory* должно иметь значение true (по умолчанию `False`), если цель ссылки является каталогом. В POSIX значение *target\_is\_directory* игнорируется.955956```python957>>> p = Path('mylink')958>>> p.symlink_to('setup.py')959>>> p.resolve()960PosixPath('/home/antoine/pathlib/setup.py')961>>> p.stat().st_size962956963>>> p.lstat().st_size9648965```966967> **Примечание**968>969> Порядок аргументов (ссылка, цель) обратный по сравнению с [`os.symlink()`](https://python-all.ru/3.6/library/os.html#os.symlink).970971#### `Path.touch(mode=0o666, exist_ok=True)`972973Создаёт файл по указанному пути. Если задан *mode*, он комбинируется со значением `umask` процесса для определения режима файла и флагов доступа. Если файл уже существует, функция завершается успешно, если *exist\_ok* равен true (при этом время изменения файла обновляется до текущего), в противном случае вызывается исключение [`FileExistsError`](https://python-all.ru/3.6/library/exceptions.html#FileExistsError).974975#### `Path.unlink()`976977Удаляет этот файл или символическую ссылку. Если путь указывает на каталог, используйте [`Path.rmdir()`](https://python-all.ru/3.6/library/pathlib.html#pathlib.Path.rmdir).978979#### `Path.write_bytes(data)`980981Открывает файл в байтовом режиме, записывает в него *data* и закрывает файл:982983```python984>>> p = Path('my_binary_file')985>>> p.write_bytes(b'Binary file contents')98620987>>> p.read_bytes()988b'Binary file contents'989```990991Существующий файл с таким же именем перезаписывается.992993Новое в версии 3.5.994995#### `Path.write_text(data, encoding=None, errors=None)`996997Открывает файл в текстовом режиме, записывает в него *data* и закрывает файл:998999```python1000>>> p = Path('my_text_file')1001>>> p.write_text('Text file contents')1002181003>>> p.read_text()1004'Text file contents'1005```10061007Новое в версии 3.5.1008