はじめに
一時ファイルは「使い終わったら消える」と思って使うと、Windowsで思わぬ例外に当たります。NamedTemporaryFile の delete=True は、ファイルを開いている間は別のハンドルから再オープンできないためです。
この記事では、TemporaryDirectory と NamedTemporaryFile の挙動をWindowsで実測し、安全な使い分けをまとめます。
環境
- Windows 11(ビルド 10.0.26200)
- Python 3.11.5
やったこと
1. TemporaryDirectoryはブロックを抜けると消える
import tempfile
from pathlib import Path
with tempfile.TemporaryDirectory() as d:
dp = Path(d)
(dp / "a.txt").write_text("x", encoding="utf-8")
print("中:", dp.exists(), [p.name for p in dp.iterdir()])
print("後:", Path(d).exists())
結果:
中: True ['a.txt']
後: False
with ブロックを抜けた時点で、中身ごと削除されます。後片付けを書き忘れる心配がありません。
2. delete=Falseなら閉じた後に再オープンできる
import tempfile
from pathlib import Path
nt = tempfile.NamedTemporaryFile(delete=False, suffix=".txt")
nt.write(b"hello")
nt.close()
print(Path(nt.name).exists()) # True
print(Path(nt.name).read_text()) # hello
Path(nt.name).unlink()
結果:
True
hello
delete=False は自動削除されない代わりに、閉じた後は通常のファイルとして扱えます。自分で unlink() する責任が残ります。
3. delete=Trueのまま再オープンするとPermissionError
import tempfile
from pathlib import Path
nt = tempfile.NamedTemporaryFile(delete=True)
try:
Path(nt.name).read_text()
except Exception as e:
print(type(e).__name__, e)
finally:
nt.close()
結果:
PermissionError [Errno 13] Permission denied: '...'
Windowsでは、NamedTemporaryFile が開いている間、ファイルは共有モードなしでロックされます。同じプロセスでも別ハンドルからの読み取りは拒否されます。
4. 使い分けの目安
| 用途 | 使うもの |
|---|---|
| 一時ディレクトリごと消す | TemporaryDirectory |
| 子プロセスや外部ツールにパスを渡す |
NamedTemporaryFile(delete=False) + 自分で削除 |
| 同じプロセス内で書き込んで読み直す |
TemporaryFile(名前なし)か、一度closeする |
| 消し忘れを防ぎたい |
TemporaryDirectory にファイルを作る |
5. 外部プロセスに渡すときの注意
NamedTemporaryFile(delete=True) のパスを外部ツールへ渡すと、外部ツールは開けません。Windowsでは特に顕著です。外部ツールに渡すなら delete=False にし、処理後に削除します。
import subprocess
import tempfile
from pathlib import Path
with tempfile.NamedTemporaryFile(delete=False, suffix=".txt") as nt:
nt.write(b"data")
path = nt.name
try:
subprocess.run(["cmd", "/c", "type", path], check=True)
finally:
Path(path).unlink(missing_ok=True)
ハマった点
Linuxの感覚でdelete=Trueを使うと壊れる
Linuxでは開いたままでも別ハンドルから読めることがあります。Windowsでは共有モードの指定がないため読めません。クロスプラットフォームのコードでは、delete=False + 明示削除が無難です。
削除漏れはディスクを圧迫する
delete=False にした場合、例外で処理が飛ぶとファイルが残ります。try/finally で unlink(missing_ok=True) を必ず通します。
一時ファイルに秘密情報を置かない
一時ディレクトリは他のユーザーから読める場所に作られることがあります。トークンや個人情報を平文で置く場合は、保存場所とアクセス権を確認します。
まとめ
-
TemporaryDirectoryはブロックを抜けると中身ごと消える。 -
NamedTemporaryFile(delete=False)は閉じた後に再オープンできる。削除は自分で行う。 -
delete=Trueのまま再オープンすると、WindowsではPermissionError。 - 外部プロセスにパスを渡すなら
delete=False。 - 例外時も削除されるよう
try/finallyを書く。