はじめに
Pythonでパスを扱うとき、文字列連結や os.path.join ではなく pathlib を使うと、OS差異を意識しやすくなります。ただし、実行OSと解析対象のパス形式は別です。Windows形式のパスをPOSIX上で解析するときは PureWindowsPath を使います。
この記事では、PureWindowsPath / PurePosixPath / Path の挙動を実測します。
環境
- Windows 11(ビルド 10.0.26200)
- Python 3.11.5
やったこと
1. Windowsパスを解析する
from pathlib import PureWindowsPath
w = PureWindowsPath(r"C:\work\data\report.csv")
print(w.name) # report.csv
print(w.stem) # report
print(w.suffix) # .csv
print(w.parent) # C:\work\data
print(w.with_suffix(".txt"))
print(w.as_posix())
print(w.parts)
結果:
report.csv
report
.csv
C:\work\data
C:\work\data\report.txt
C:/work/data/report.csv
('C:\\', 'work', 'data', 'report.csv')
as_posix() はバックスラッシュをスラッシュに変換します。URLや設定ファイルに埋め込むときに便利です。
2. 相対パスを得る
print(w.relative_to(r"C:\work"))
結果:
data\report.csv
relative_to() は、基準パスからの相対パスを返します。基準が親でない場合は ValueError になります。
3. POSIXパスを解析する
from pathlib import PurePosixPath
p = PurePosixPath("/var/log/app.log")
print(p.name, p.parent, p.as_posix())
結果:
app.log /var/log /var/log/app.log
4. 実行OSのPathと結合する
from pathlib import Path
print(Path("a") / "b" / "c")
Windowsでの結果:
a\b\c
Path は実行OSの形式で結合します。Windows上ではバックスラッシュ、POSIX上ではスラッシュになります。
5. 形式をまたぐときの注意
from pathlib import Path, PureWindowsPath
# Windows形式の文字列をPathで解析すると、POSIXでは1つのファイル名になる
w = PureWindowsPath(r"C:\work\data\report.csv")
print(w.name) # report.csv
ハマった点
Path は実行OS依存
Path(r"C:\work\data") は、Windowsではドライブ付きパスですが、POSIXではバックスラッシュを含む1つのファイル名として扱われます。解析対象の形式が分かっているなら PureWindowsPath / PurePosixPath を使います。
with_suffix は末尾の拡張子だけ
report.tar.gz の suffix は .gz です。.tar.gz をまとめて変えたい場合は with_name() や文字列処理が必要です。
resolve() は存在しないパスでも動くが、基準はカレント
Path("a/b").resolve() はカレントディレクトリを基準に絶対化します。存在しないパスでも例外になりません。存在確認は exists() で別途行います。
Windowsの予約名
CON、PRN、AUX、NUL、COM1 などはWindowsで特別な意味を持ちます。ユーザー入力からファイル名を作るときは、予約名と末尾のドット・スペースも確認します。
まとめ
-
PureWindowsPathはOSに依存せずWindowsパスを解析できる。 -
as_posix()でスラッシュ区切りにできる。 -
relative_to()は基準パスからの相対パスを返す。 -
Pathは実行OSの形式で結合する。形式が違う場合はPure系を使う。 -
suffixは最後の拡張子だけ。予約名にも注意する。