Introduction to Handling Exceptions in File I/O

When working with files, errors such as missing files, permission issues, or malformed data can occur. Python provides mechanisms to handle these errors gracefully using exception handling.

In this lesson, you’ll learn how to handle file-related exceptions to make your programs more robust.

Common File I/O Errors

Here are some common errors that occur during file operations:

• FileNotFoundError: The file does not exist.
• PermissionError: You don’t have permission to access the file.
• IsADirectoryError: The path is a directory, not a file.

Using try and except for File I/O

Wrap file operations in a try block to catch and handle exceptions:

# Handling file not found error
try:
    with open("nonexistent_file.txt", "r") as file:
        content = file.read()
except FileNotFoundError:
    print("The file does not exist.")

Handling Multiple Exceptions

You can handle multiple exceptions by specifying multiple except blocks:

# Handling multiple exceptions
try:
    with open("example.txt", "r") as file:
        content = file.read()
except FileNotFoundError:
    print("The file does not exist.")
except PermissionError:
    print("You don’t have permission to access this file.")

Using finally for Cleanup

The finally block is always executed, regardless of whether an exception occurred. It’s useful for cleanup actions like closing files:

# Using finally for cleanup
try:
    file = open("example.txt", "r")
    content = file.read()
except FileNotFoundError:
    print("The file does not exist.")
finally:
    print("Closing the file.")
    file.close()  # Ensures the file is closed

Using with for Automatic Cleanup

The with statement automatically handles resource cleanup, reducing the need for explicit finally blocks:

# Using with to handle automatic cleanup
try:
    with open("example.txt", "r") as file:
        content = file.read()
except FileNotFoundError:
    print("The file does not exist.")

Raising Exceptions Manually

You can raise exceptions manually using the raise keyword. This is useful for validating file operations:

# Raising an exception manually
file_path = "example.txt"

if not file_path.endswith(".txt"):
    raise ValueError("Only .txt files are supported.")

try:
    with open(file_path, "r") as file:
        content = file.read()
except FileNotFoundError:
    print("The file does not exist.")

Handling Errors in Writing Files

When writing to a file, exceptions like PermissionError can occur. Always ensure proper error handling:

# Handling write errors
try:
    with open("output.txt", "w") as file:
        file.write("Hello, World!")
except PermissionError:
    print("You don’t have permission to write to this file.")

Common Mistakes in File I/O Exception Handling

Here are some mistakes to avoid:

• Not catching specific exceptions (e.g., using a generic except block).
• Forgetting to close the file if with is not used.
• Not logging the exception message for debugging.

What Did We Learn?

In this lesson, you learned:

• How to use try, except, and finally blocks for handling file-related exceptions.
• How to handle multiple exceptions for different error types.
• How to raise exceptions manually to validate file operations.

Great job! Let’s move to the next topic.