Python Delete Files

Deletion Building Blocks

The os and pathlib modules provide deletion primitives:

• os.remove(path) or Path.unlink() to delete files.
• os.rmdir(path) or Path.rmdir() to remove empty directories.
• shutil.rmtree(path) for recursive directory removal.

Delete a Single File

Check that the file exists and confirm its type before deleting. Wrap calls in try/except to catch errors.

from pathlib import Path

path = Path("logs/old.log")

if path.exists() and path.is_file():
    path.unlink()
    print("File removed")
else:
    print("Nothing to delete")

Path.unlink(missing_ok=True) on Python 3.8+ suppresses FileNotFoundError.

Error Handling

Deletion may fail due to permissions, locks, or incorrect paths. Surface actionable guidance.

import os

try:
    os.remove("/protected/data.txt")
except FileNotFoundError:
    print("File already deleted.")
except PermissionError:
    print("Insufficient permissions.")
except IsADirectoryError:
    print("Target is a directory, not a file.")

Delete Directories

Empty directories can be removed with Path.rmdir(). For directories containing files, use shutil.rmtree().

from pathlib import Path
import shutil

reports = Path("reports/2022")

if reports.exists():
    shutil.rmtree(reports)
    print("Directory removed")

Be cautious—rmtree permanently deletes everything in the directory. Add confirmation prompts for user-facing tools.

Trash and Recycling

Instead of permanent deletion, move files to the system recycle bin with third-party libraries like send2trash. This enables recovery if the removal was accidental.

from send2trash import send2trash

send2trash("important.xlsx")

Platform Considerations

• Windows refuses deletion if a file is open in another program.
• Linux and macOS allow removing open files, but the storage remains allocated until all handles close.
• On Windows, use path.unlink(missing_ok=True) with caution. On Python 3.12+, the dir_fd parameter improves atomicity.

Safety Checklist

• Confirm the target path and ensure it points where you expect.
• Log deletions in audit trails for traceability.
• Use dry-run flags in automation scripts to preview deletions.
• Implement backup or snapshot strategies for critical datasets.

Next Steps

You now control the full lifecycle of files: creation, reading, writing, and deletion. Explore Python modules next to interact with larger ecosystems like NumPy and Pandas.

Check Before You Delete

Deleting a missing file raises FileNotFoundError. Check first, or catch the error.

import os

if os.path.exists("demo.txt"):
    os.remove("demo.txt")
else:
    print("File does not exist")

# modern alternative with pathlib
from pathlib import Path
Path("demo.txt").unlink(missing_ok=True)   # no error if absent (Py 3.8+)

Files vs Folders

Key Takeaways

• os.remove deletes files; os.rmdir empty folders.
• Check os.path.exists or catch FileNotFoundError.
• Deletion is permanent — verify the path first.