Working with Python files is one of the best ways to save your work so it does not disappear when you close your script. If you build a tiny app that takes user notes, you need a place to keep those words safe. Files give your computer code a real memory on your hard drive.
The good news is that opening, reading, and changing files in Python takes only a few lines of basic code. You do not need to install extra tools or learn complex rules. Python handles plain text files right out of the box with built in tools that work on any computer.
How Do You Open and Read a Text File in Python?
To read a file in Python, you use the built in open function along with a simple command called read. Imagine you have a text file named notes.txt sitting in the exact same folder as your Python script. You want to bring its text into your script so you can print it on your screen.
Here is the absolute simplest way to open and view what is inside that file:
my_file = open("notes.txt", "r")
content = my_file.read()
print(content)
my_file.close()Look at that letter r inside the open command. That r stands for read mode, which tells your computer that you only want to look at the words, not change them. When you finish, calling close is very key. It frees up your computer memory and lets other apps use the file again. If you like playing with text inside your scripts, learning Python String Methods: How to Clean Text in Your Code will help you clean up lines after you read them.
What if your file has 500 lines of data? Reading the whole thing at once might get messy. You can read a file line by line using a standard loop, which reads one single line at a time without breaking a sweat.
my_file = open("notes.txt", "r")
for line in my_file:
print(line.strip())
my_file.close()The strip tool removes extra blank spaces and new line breaks at the end of each sentence. It makes your terminal output look super clean and easy to scan with your eyes.
The Safe Way to Handle Python Files with With Statements
Forgetting to close a file is a huge mistake that even grown-up software workers make. If your code stops working due to an error before reaching the close line, the file stays open in the background. That can lock your file or waste your system RAM.
Python has a special trick to fix this exact issue. It is called the with block, and it closes your file on its own, even if your code crashes in the middle of running.
with open("notes.txt", "r") as my_file:
content = my_file.read()
print(content)Notice how there is no close command anywhere in that small snippet. As soon as your script finishes running the lines inside the indented block, Python closes the file for you automatically. It is clean, safe, and saves you from weird bugs later on.
I used to forget to close my text files all the time when I was starting out. My code would crash, and then my text editor would tell me the file was locked by another program. Switching to the with block cured that headaches overnight.
You can also check out our guide to Python basic tools to see how other built in features handle system resources safely like this.
How to Write New Data to a Python File
Reading data is only half the fun. Most real scripts need to save stuff, like scores from a tiny game, shopping lists, or daily log messages. To write new text into a file, you swap that letter r for a letter w.
with open("notes.txt", "w") as my_file:
my_file.write("I just added this new line of text!")Be super careful here! The w mode stands for write, but it also completely wipes out everything that was previously inside that file. If notes.txt already had ten paragraphs of text, running that code with w will delete all ten paragraphs and replace them with your single new line.
If notes.txt does not exist yet, Python creates a brand new blank file with that name inside your project folder. So you do not even need to create the file manually using your desktop mouse.
Appending Words Without Erasing Existing Text
So how do you add new text to an old file without wiping out your precious data? You use append mode, which is written as a letter a.
with open("notes.txt", "a") as my_file:
my_file.write("\nHere is another line added to the bottom!")The letter a tells Python to stick new words straight onto the very end of the file. Your old data stays completely safe at the top. Putting that little slash n character right before your message forces Python to start your new text on a fresh line instead of sticking it to the last word.
Here is a quick cheat sheet for file modes in Python:
- r - Read mode. Opens a file to look at text. Fails if the file does not exist.
- w - Write mode. Erases old file contents or makes a brand new file to write text.
- a - Append mode. Adds brand new text to the end of a file without wiping old content.
- r+ - Read and write mode. Lets you read and edit a file at the exact same time.
Handling Errors When Files Are Missing
What happens if your script tries to read a file that is not on your computer? Your script instantly crashes and throws a red error message called FileNotFoundError. That looks ugly to anyone using your app.
You can catch that missing file error before it breaks your entire code run. Python has try and except blocks that act like safety nets for your programs.
try:
with open("secret_plans.txt", "r") as my_file:
print(my_file.read())
except FileNotFoundError:
print("Oops! That file does not exist in this folder yet.")Now, instead of dropping a scary computer panic message on the user, your code prints a nice helpful note and keeps running smoothly. Building software that stays calm during tiny mistakes makes your work look much more professional.
If you want to read more about text formatting tricks after opening files, view our guide on Python String Methods: How to Clean Text in Your Code to transform your incoming data easily.
Working with CSV Files for Simple Spreadsheets
Plain text files are great for simple notes, but what if you have tables of data, like names and phone numbers? That is where CSV files come in. CSV stands for comma separated values. They are basic text files that open right up in spreadsheet programs like Excel.
Python has a module built right into it named csv. You do not have to install anything to use it. You just add one import line at the top of your Python file.
import csv
data = [
["Name", "Favorite Food"],
["Alex", "Pizza"],
["Sam", "Tacos"],
["Jordan", "Sushi"]
]
with open("food.csv", "w", newline="") as my_file:
writer = csv.writer(my_file)
writer.writerows(data)When you run that script, Python creates a file called food.csv. You can double click that file, and your computer spreadsheet app will open it up into clean columns and rows just like magic. If you are learning how to manage lists of data like this, check out our helpful post on learning Python data tricks for clear advice on organizing your info.
To read data back out of that spreadsheet file, you use the csv reader tool like this:
import csv
with open("food.csv", "r") as my_file:
reader = csv.reader(my_file)
for row in reader:
print(row)Each row comes back as a small list of items. The first item is the name, and the second item is the food. It makes handling big collections of facts so much simpler than doing it by hand.
Tips to Remember When Working With Python Files
Now that you know how to read, write, and append data, here are three simple rules you can keep in your head whenever you work on file scripts today:
First, always stick to using the with statement. It saves you from forgetting to close files and keeps your memory usage light and fast. It takes less typing and stops file lock bugs instantly.
Second, double check your file path locations. If your script says it cannot find your text file, make sure the file is saved in the exact same directory folder as your main Python script file. You can also use complete file paths like C:/Users/Name/Desktop/notes.txt if you want to pull data from a completely different folder on your hard drive.
Third, remember that writing mode wipes your data completely clean. Before using w on a file that already has stuff in it, ask yourself if you really mean to use a for append mode instead. Making a backup copy of important text files before testing new code on them is always a smart idea.
What kind of app are you planning to build with Python file handling? Try creating a small script that asks for your daily to-do list items and saves them into a text file right now!
