`pathlib` --- 物件導向檔案系統路徑¶

在 3.4 版被加入.

原始碼：Lib/pathlib/

此模組提供代表檔案系統路徑的類別，能適用不同作業系統的語意。路徑類別分成兩種，一種是純路徑 (pure paths)，提供沒有 I/O 的單純計算操作，另一種是實體路徑 (concrete paths)，繼承自純路徑但也提供 IO 操作。

顯示 pathlib 中可用類別的繼承圖。最基礎的類別是 PurePath，它有三個直接子類別： PurePosixPath、PureWindowsPath 和 Path。除了這四個類別之外，還有兩個類別使用多重繼承： PosixPath 繼承自 PurePosixPath 和 Path，而 WindowsPath 繼承自 PureWindowsPath 和 Path。

如果你之前從未使用過此模組或不確定哪個類別適合你的任務，那你需要的最有可能是 Path。它針對程式執行所在的平台實例化一個實體路徑。

純路徑在某些特殊情境下是有用的，例如：

如果你想在 Unix 機器上處理 Windows 路徑（或反過來），你無法在 Unix 上實例化 WindowsPath，但你可以實例化 PureWindowsPath。
你想確保你的程式在操作路徑的時候不會真的存取到 OS。在這個情況下，實例化其中一種純路徑類別可能是有用的，因為它們不會有任何存取 OS 的操作。

也參考

PEP 428：pathlib 模組 -- 物件導向檔案系統路徑。

也參考

針對字串上的底層路徑操作，你也可以使用 os.path 模組。

基本用法¶

匯入主要類別：

>>> from pathlib import Path

列出子目錄：

>>> p = Path('.')
>>> [x for x in p.iterdir() if x.is_dir()]
[PosixPath('.hg'), PosixPath('docs'), PosixPath('dist'),
 PosixPath('__pycache__'), PosixPath('build')]

在目前目錄樹下列出 Python 原始碼檔案：

>>> list(p.glob('**/*.py'))
[PosixPath('test_pathlib.py'), PosixPath('setup.py'),
 PosixPath('pathlib.py'), PosixPath('docs/conf.py'),
 PosixPath('build/lib/pathlib.py')]

瀏覽目錄樹內部：

>>> p = Path('/etc')
>>> q = p / 'init.d' / 'reboot'
>>> q
PosixPath('/etc/init.d/reboot')
>>> q.resolve()
PosixPath('/etc/rc.d/init.d/halt')

查詢路徑屬性：

>>> q.exists()
True
>>> q.is_dir()
False

開啟檔案：

>>> with q.open() as f: f.readline()
...
'#!/bin/bash\n'

例外¶

exception pathlib.UnsupportedOperation¶: 繼承自 NotImplementedError 的例外，當在路徑物件上呼叫不支援的操作時會被引發。

在 3.13 版被加入.

純路徑¶

純路徑物件提供處理路徑的操作，實際上不會存取檔案系統。有三種方式可以存取這些類別，我們也稱之為類型 (flavours)：

class pathlib.PurePath(*pathsegments)¶

一個通用的類別，表示系統的路徑類型（實例化時會建立一個 PurePosixPath 或 PureWindowsPath)：

>>> PurePath('setup.py')      # 執行在 Unix 機器上
PurePosixPath('setup.py')

pathsegments 中的每個元素可以是以下的其中一種：一個表示路徑片段的字串，或一個物件，它實作了 os.PathLike 介面且其中的 __fspath__() 方法會回傳字串，就像是另一個路徑物件：

>>> PurePath('foo', 'some/path', 'bar')
PurePosixPath('foo/some/path/bar')
>>> PurePath(Path('foo'), Path('bar'))
PurePosixPath('foo/bar')

當沒有給 pathsegments 的時候，會假設是目前的目錄：

>>> PurePath()
PurePosixPath('.')

如果一個片段是絕對路徑，則所有之前的片段會被忽略（類似 os.path.join())：

>>> PurePath('/etc', '/usr', 'lib64')
PurePosixPath('/usr/lib64')
>>> PureWindowsPath('c:/Windows', 'd:bar')
PureWindowsPath('d:bar')

在 Windows 系統上，當遇到具有根目錄的相對路徑片段（例如 r'\foo'）時，磁碟機 (drive) 部分不會被重置：

>>> PureWindowsPath('c:/Windows', '/Program Files')
PureWindowsPath('c:/Program Files')

不必要的斜線和單點會被合併，但雙點 ('..') 和前置的雙斜線 ('//') 不會被合併，因為這樣會因為各種原因改變路徑的意義（例如符號連結 (symbolic links)、UNC 路徑）：

>>> PurePath('foo//bar')
PurePosixPath('foo/bar')
>>> PurePath('//foo/bar')
PurePosixPath('//foo/bar')
>>> PurePath('foo/./bar')
PurePosixPath('foo/bar')
>>> PurePath('foo/../bar')
PurePosixPath('foo/../bar')

（一個使得 PurePosixPath('foo/../bar') 等同於 PurePosixPath('bar') 的單純方法，但如果 foo 是指到另一個目錄的符號連結，就會是錯誤的。）

純路徑物件實作了 os.PathLike 介面，使得它們可以在任何接受該介面的地方使用。

在 3.6 版的變更: 新增了對於 os.PathLike 介面的支援。

class pathlib.PurePosixPath(*pathsegments)¶

PurePath 的一個子類別，該路徑類型表示非 Windows 檔案系統的路徑：

>>> PurePosixPath('/etc/hosts')
PurePosixPath('/etc/hosts')

pathsegments 的指定方式與 PurePath 類似。

class pathlib.PureWindowsPath(*pathsegments)¶

PurePath 的一個子類別，該路徑類型表示 Windows 檔案系統的路徑，包括 UNC paths：

>>> PureWindowsPath('c:/', 'Users', 'Ximénez')
PureWindowsPath('c:/Users/Ximénez')
>>> PureWindowsPath('//server/share/file')
PureWindowsPath('//server/share/file')

pathsegments 的指定方式與 PurePath 類似。

不論你使用的是什麼系統，你都可以實例化這些類別，因為它們不提供任何涉及系統呼叫的操作。

通用屬性¶

路徑物件是不可變 (immutable) 且可雜湊 (hashable) 的。相同類型的路徑物件可以被比較和排序。這些屬性遵守該類型的大小寫語意規則：

>>> PurePosixPath

pathlib --- 物件導向檔案系統路徑¶

基本用法¶

例外¶

純路徑¶

通用屬性¶

`pathlib` --- 物件導向檔案系統路徑¶