Lesson 3.3: File Handling and Data Persistence

Introduction

Welcome to Lesson 3.3 of Foundation Computing! 🎉 Today, we're going to dive into the world of file handling and data persistence. By the end of this lesson, you will be able to read from and write to text files, making your programs much more versatile and powerful.

Learning Objectives

By the end of this lesson, you should be able to:

• Open, close, and handle files using the with statement in Python.
• Read and write structured data, such as CSV files, line by line.
• Append content to existing files and handle errors related to missing files.
• Understand the concept of data persistence and why it is important for data to outlive a single program run.
• Safely read from and write to text or CSV files.

What is File Handling? 📂

File handling refers to the way you manage files in your programs. Python gives us straightforward methods to manipulate files—essentially allowing your code to interact with external data. Let's break down the essential operations:

Opening and Closing Files

In Python, files need to be opened before you can read or write data to them. You can open a file using the built-in open() function. Here's how it works:

file = open('example.txt', 'r')  # 'r' indicates read mode

After you're done with the file, it's crucial to close it to free up resources:

file.close()

Using the with Statement

Python simplifies file handling with the with statement. This automatically closes the file for you when you're finished, preventing resource leaks. Here’s an example:

with open('example.txt', 'r') as file:
    data = file.read()

When using the with statement, you don't have to worry about closing the file manually. It's more efficient and prevents errors! 🙌

Reading from Text Files 📖

Let’s explore how to read data from text files. Once you have your file opened, you can read its content using several methods:

Reading All Content

To read the entire content of a file, you can use the read() method:

with open('example.txt', 'r') as file:
    content = file.read()
    print(content)

Reading Line by Line

Sometimes you might want to read the file line by line. You can do this using a for loop:

with open('example.txt', 'r') as file:
    for line in file:
        print(line)

Structured Data: CSV Files

Comma-Separated Values (CSV) files are a way to store structured data in a plain text format. Let's say you have a CSV file called data.csv with the following content:

Name, Age, City
Alice, 30, New York
Bob, 25, Los Angeles

You can process this file line by line as follows:

import csv

with open('data.csv', 'r') as file:
    reader = csv.reader(file)
    for row in reader:
        print(row)  # Each row is a list!

Writing to Text Files ✍️

Now that we've covered reading files, let’s discuss how to write data to files:

Creating or Overwriting a File

To create a new file or overwrite an existing one, use the w mode when opening it:

with open('newfile.txt', 'w') as file:
    file.write('Hello, World!')

Appending Data to Existing Files

If you want to add content without deleting the existing data, use the a (append) mode:

with open('newfile.txt', 'a') as file:
    file.write('\nAppended Line!')

Error Handling in File Operations ⚠️

When dealing with files, errors can arise, such as a missing file. It’s good practice to handle these exceptions using try and except:

try:
    with open('non_existent_file.txt', 'r') as file:
        content = file.read()
except FileNotFoundError:
    print('The file does not exist!')

Data Persistence: Why It Matters?

Data persistence ensures that the data you work with remains available even after your program stops running. For instance, if we just printed user input without saving it, that data would be lost once the program ends! By writing data to files, we can preserve it for future use. This is crucial in many applications, such as databases and web applications, where data needs to be retained.

Conclusion

In today's lesson, we explored the essential elements of file handling in Python! We learned how to read from and write to files, handled structured CSV data, and discussed the importance of file operations. Mastering these skills will equip you with the tools to create versatile applications that can save and retrieve information seamlessly.

Study Notes

• Use the open() function to access files.
• The with statement automatically closes files.
• Use read() to read the entire content of a file.
• Use csv module to work with CSV files.
• Use w mode for writing, a mode for appending.
• Handle errors using try and except for safer file operations.
• Data persistence allows your data to exist beyond a single run of the program.