パスを安全に扱う（pathlib）

invoices フォルダに請求書のファイルが入っています。「誰の請求書か」が分かるように、ファイル名から拡張子（.txt）を外した名前を一覧にしたい、という場面を考えます。基礎編の書き方（基礎編 Lesson 13 の os と、文字の操作）では、こうなります。

▶ 実行を押すと、ここに結果が出ます

動きはしますが、危ない点が2つあります。

• 文字で "/" をつなぐやり方は、Windows（区切りが \）とそれ以外で食い違います。
• split(".")[0] は、名前の途中に . があると、最後の行のように 2025 だけが取れてしまいます。

さらに、Windows のパスをそのまま文字として書くと、こんなエラーにもなります。

▶ 実行を押すと、ここに結果が出ます

\U が「特別な文字」と読み取られるためです（\n は改行、\t はタブになります）。パスを文字で書くと、こうしたつまずきが続きます。これをまとめて片づけてくれるのが、この回の主役の pathlib です。

同じことを、pathlib の Path で書きます。「実行」を押してください。

▶ 実行を押すと、ここに結果が出ます

.txt のファイルだけが対象になり、最後の行も 2025.10_invoice_tanaka と、正しく取れました。フォルダに / をつなぐこともできます。ファイルの中身を読むのも、1行です。

▶ 実行を押すと、ここに結果が出ます

/ は割り算ではなく、「パスをつなぐ記号」です。Windows で動かせば、自動で \ が使われます。

Path は、パスをただの文字ではなく、部品を持ったものとして扱います。1つのファイルのパスは、次の部品に分かれます。

invoice_tanaka.txt の部分（.stem と .suffix を合わせたもの）は .name で取れます。先ほどのコードを、1行ずつ日本語にします。

*.txt の * は「何でもよい（0文字以上）」という意味の記号で、これを使ってファイルを探す書き方をglob（グロブ）と呼びます。基礎編の endswith(".txt") で選ぶ代わりに、探す段階で絞り込めます。

import os

for name in sorted(os.listdir("invoices")):
  if name.endswith(".txt"):
      path = os.path.join("invoices", name)
      print(name.split(".")[0])

from pathlib import Path

for p in sorted(Path("invoices").glob("*.txt")):
  print(p.stem)

.suffix が返す .txt のような、名前の最後の部分を拡張子と呼びます。ドット（.）を含めた形で返ります。

① 深いところまで探す。 glob は、指定したフォルダの直下だけを探します。サブフォルダの中まで探すときは rglob を使います。ここでは、年ごと・月ごとのフォルダを作ってから探します。mkdir(parents=True, exist_ok=True) は、「途中のフォルダもまとめて作る。もうあってもエラーにしない」という意味です。

▶ 実行を押すと、ここに結果が出ます

直下には1つもないので glob は 0 件、rglob は 2 件です。（as_posix() は、/ 区切りの文字にして表示する指定です。）

② 名前の変更は、まず「予定」を表示する。 ファイル名の変更は、元に戻せないことがあります。いきなり変更せず、変更後の名前を表示するだけにして確かめます。このやり方を試し実行（ドライラン）と呼びます。

▶ 実行を押すと、ここに結果が出ます

予定が正しいと確かめられたら、次のように rename を足します。with_name は、フォルダはそのままで、名前の部分だけを入れ替えた新しい Path を作ります。

▶ 実行を押すと、ここに結果が出ます

iterdir() は、フォルダの中身を1つずつ取り出します。

③ ないファイルを読むと？ 存在しないパスを read_text で読むと、FileNotFoundError（ファイルが見つかりません）で止まります。読む前に p.exists() で調べるか、try / except（Lesson 09 で学びます）で備えます。

お題① invoices フォルダにあるファイルを、拡張子ごとに数えて、拡張子 件数 の形で表示してください。拡張子の順番は、sorted で並べます。

▶ 実行を押すと、ここに結果が出ます

from pathlib import Path

counts = {}
for p in Path("invoices").iterdir():
  counts[p.suffix] = counts.get(p.suffix, 0) + 1

for suffix, n in sorted(counts.items()):
  print(suffix, n)

お題② 請求書（.txt）の、名前の変更案を作ります。invoice_tanaka.txt を 2025-10-31_tanaka.txt のように、先頭の invoice_ を日付に替えた名前にして、今の名前 → 新しい名前 の形で表示してください。（名前は変更しません）

▶ 実行を押すと、ここに結果が出ます

from pathlib import Path

for p in sorted(Path("invoices").glob("*.txt")):
  new_name = p.name.replace("invoice_", "2025-10-31_")
  print(p.name, "→", new_name)

お題③ reports/2025-10 というフォルダを作り（途中の reports もまとめて）、その中の memo.txt に「確認済み」と書いて、書いた内容を読み直して表示してください。

▶ 実行を押すと、ここに結果が出ます

from pathlib import Path

folder = Path("reports") / "2025-10"
folder.mkdir(parents=True, exist_ok=True)
memo = folder / "memo.txt"
memo.write_text("確認済み", encoding="utf-8")
print(memo.read_text(encoding="utf-8"))