Pythonでファイルの存在確認から安全な削除までを徹底解説

import os

# 存在を確認したいパスを文字列で指定
path = "example.txt"

# os.path.existsは、ファイルまたはディレクトリが存在すればTrueを返します
if os.path.exists(path):
    print(f"{path} は存在します。")
else:
    print(f"{path} は存在しません。")

from pathlib import Path

# Pathオブジェクトを生成します
path = Path("example.txt")

# existsメソッドで存在確認
if path.exists():
    print(f"{path} は存在します。")
else:
    print(f"{path} は存在しません。")

from pathlib import Path

path = Path("data")

# ファイルかどうかを判定
if path.is_file():
    print(f"{path} はファイルです。")

# ディレクトリかどうかを判定
elif path.is_dir():
    print(f"{path} はディレクトリです。")

# どちらでもない場合(存在しない場合など)
else:
    print(f"{path} は存在しない、または通常のファイル/ディレクトリではありません。")

import os
from pathlib import Path

# osモジュールで現在の作業ディレクトリを取得
print("os.getcwd():", os.getcwd())

# pathlibで現在の作業ディレクトリを取得
print("Path.cwd():", Path.cwd())

from pathlib import Path

relative_path = Path("data/example.txt")

# resolveメソッドで絶対パスに変換(存在しないパスでも変換可能)
absolute_path = relative_path.resolve()

print("相対パス:", relative_path)
print("絶対パス:", absolute_path)
print("存在するか:", absolute_path.exists())

import os

file_path = "example.txt"

# まずは存在確認を行うことが安全
if os.path.exists(file_path):
    # ファイルを削除します
    os.remove(file_path)
    print(f"{file_path} を削除しました。")
else:
    print(f"{file_path} は存在しません。削除は行いません。")

import os

file_path = "example.txt"

if os.path.exists(file_path):
    # removeの代わりにunlinkを呼び出しても同様に削除されます
    os.unlink(file_path)
    print(f"{file_path} をunlinkで削除しました。")
else:
    print(f"{file_path} は存在しません。")

from pathlib import Path

def safe_remove(path_str: str) -> None:
    """指定されたパスのファイルが存在する場合のみ削除する安全な関数"""
    path = Path(path_str)

    # ファイルであるかどうかまでチェックしてから削除する
    if path.is_file():
        path.unlink()  # Path.unlink() は os.unlink と同じ働きです
        print(f"{path} を削除しました。")
    elif path.exists():
        # ここに来るのは「ファイルではないが何かは存在する」ケース(ディレクトリなど)
        print(f"{path} はファイルではありません(削除しません)。")
    else:
        print(f"{path} は存在しません。")

# 実行例
safe_remove("example.txt")

import os

def remove_with_error_handling(path: str) -> None:
    """削除時に発生しうる代表的な例外をハンドリングする例"""
    try:
        os.remove(path)
        print(f"{path} を削除しました。")
    except FileNotFoundError:
        # ファイルがすでに存在しなかった場合
        print(f"{path} は存在しません(すでに削除された可能性があります)。")
    except PermissionError:
        # 権限が不足している場合(読み取り専用・他ユーザー所有など)
        print(f"{path} を削除する権限がありません。")
    except IsADirectoryError:
        # ディレクトリに対して remove を呼んだ場合
        print(f"{path} はディレクトリです。ファイル削除関数では削除できません。")
    except OSError as e:
        # その他のOSレベルのエラーを包括的にキャッチ
        print(f"予期しないエラーが発生しました: {e}")

# 実行例
remove_with_error_handling("example.txt")

import shutil
from pathlib import Path

dir_path = Path("old_logs")

if dir_path.exists() and dir_path.is_dir():
    # ディレクトリと中身を再帰的に削除します
    shutil.rmtree(dir_path)
    print(f"{dir_path} ディレクトリを再帰的に削除しました。")
else:
    print(f"{dir_path} は存在しないか、ディレクトリではありません。")

import glob
import os

def remove_logs(pattern: str) -> None:
    """globパターンにマッチするファイルを一括削除する例"""
    # パターンにマッチするパス一覧を取得
    for path in glob.glob(pattern):
        # 念のためファイルかどうかを確認
        if os.path.isfile(path):
            os.remove(path)
            print(f"{path} を削除しました。")
        else:
            print(f"{path} はファイルではないため削除しません。")

# 実行例: カレントディレクトリ内の *.log ファイルを削除
remove_logs("*.log")

import os
import stat

def safe_remove_with_permission_check(path: str) -> None:
    """読み取り専用ファイルへの対処の雰囲気を示す例"""
    try:
        os.remove(path)
        print(f"{path} を削除しました。")
    except PermissionError:
        print(f"{path} を削除できません(PermissionError)。読み取り専用の可能性があります。")
        # 必要であれば、以下のように権限を変更して再試行することもあります
        try:
            # 書き込み権限を付与(所有者に書き込み権限を追加)
            os.chmod(path, stat.S_IWRITE)
            os.remove(path)
            print(f"権限を変更して {path} を削除しました。")
        except Exception as e:
            print(f"権限変更後も削除に失敗しました: {e}")

# 実行例
safe_remove_with_permission_check("read_only.txt")

pip install send2trash

from send2trash import send2trash
from pathlib import Path

def move_to_trash(path_str: str) -> None:
    """ファイルを即削除せず、ごみ箱に移動する関数"""
    path = Path(path_str)

    if not path.exists():
        print(f"{path} は存在しません。")
        return

    # 実際には削除せず、ごみ箱に移動します
    send2trash(path)
    print(f"{path} をごみ箱に移動しました。")

# 実行例
move_to_trash("important.txt")

from pathlib import Path

def confirm_and_delete(path_str: str) -> None:
    """ユーザーに確認してから削除する安全な関数"""
    path = Path(path_str).resolve()

    if not path.exists():
        print(f"{path} は存在しません。")
        return

    print(f"削除対象: {path}")
    answer = input("本当に削除しますか？(y/N): ").strip().lower()

    # デフォルトは「削除しない」
    if answer == "y":
        if path.is_file():
            path.unlink()
            print("ファイルを削除しました。")
        elif path.is_dir():
            # ディレクトリ削除はさらに慎重に
            print("これはディレクトリです。別の関数で削除してください。")
        else:
            print("通常のファイル/ディレクトリではないため削除しません。")
    else:
        print("削除をキャンセルしました。")

# 実行例(対話形式のため実行結果は環境に依存します)

import logging
from pathlib import Path

# ログの基本設定(ファイル出力)
logging.basicConfig(
    filename="deletion.log",
    level=logging.INFO,
    format="%(asctime)s [%(levelname)s] %(message)s",
)

logger = logging.getLogger(__name__)

def logged_delete(path_str: str) -> None:
    """削除処理をログに記録する例"""
    path = Path(path_str).resolve()

    if not path.exists():
        msg = f"{path} は存在しません。"
        print(msg)
        logger.warning(msg)
        return

    if path.is_file():
        try:
            path.unlink()
            msg = f"ファイル削除: {path}"
            print(msg)
            logger.info(msg)
        except Exception as e:
            msg = f"ファイル削除失敗: {path} error={e}"
            print(msg)
            logger.error(msg)
    else:
        msg = f"{path} はファイルではないため、削除対象外です。"
        print(msg)
        logger.warning(msg)

# 実行例
logged_delete("example.txt")

import tempfile
from pathlib import Path

def use_temp_file() -> None:
    """一時ファイルを使って処理を行い、最後に削除する例"""
    # delete=True の場合、ファイルはクローズ時に自動削除されます
    with tempfile.NamedTemporaryFile(mode="w+", delete=True, suffix=".txt") as tmp:
        print(f"作成された一時ファイル: {tmp.name}")

        # 一時ファイルにデータを書き込み
        tmp.write("一時的なデータです。\n")
        tmp.flush()

        # 必要ならここで別処理が tmp.name を使って読み取り可能
        path = Path(tmp.name)
        print(f"一時ファイルは存在しますか？ {path.exists()}")

    # withブロックを抜けると自動的に削除されます
    print(f"ブロック終了後、一時ファイルは存在しますか？ {Path(tmp.name).exists()}")

# 実行例
use_temp_file()