os.path から pathlib への移行

要点は4つです。連結は / 演算子、階層は .parent、拡張子は .stem と .suffix、探索は .glob()。

.stem は splitext の代わりにはなりません。splitext("a/b/c.txt")[0] はディレクトリを残した "a/b/c" を返しますが、.stem はファイル名だけの "c" です。パスとして拡張子を落とすなら .with_suffix("") を使います。.resolve() も完全な abspath 相当ではなく、.. の正規化に加えてシンボリックリンクまで辿ります。リンクのまま残したいなら向きません。

1
from pathlib import Path
2

3
for md in Path("src/content/posts").glob("*/index.md"):
4
    print(md.parent.name, md.read_text().splitlines()[0])

.parent は繋げられるので p.parent.parent で2階層上、p.parents[1] でも同じです。

文字列が必要になる場面は残ります。os.PathLike を受け取らない古いライブラリや、パスを含む文字列を組み立てるときは str(p) を挟みます。標準ライブラリと open() はそのまま Path を受け取れます。