File Modes (Read, Write, Append, Binary)

🏷️ File Handling / Opening and Closing Files

📚 All-in-One📖 Theory Only💻 Code Only

🧭 Context Introduction

When working with files in Python, you need to tell the program how you want to interact with the file. Do you want to read its contents? Write new data? Add to existing content? Work with images or binary data? This is where file modes come in. A file mode is a simple string you pass when opening a file, and it determines exactly what operations are allowed. Understanding these modes is essential for safely and effectively handling files in any automation or data processing task.

⚙️ What Are File Modes?

A file mode is a character or combination of characters that defines the purpose of opening a file. The mode is passed as the second argument to the open() function. The most common modes are:

'r' — Read mode (default)
'w' — Write mode
'a' — Append mode
'b' — Binary mode (used with other modes)

You can also combine modes, such as 'rb' (read binary) or 'w+' (write and read).

📊 Comparison of Common File Modes

Mode	Name	What It Does	File Must Exist?	Overwrites Content?
'r'	Read	Opens file for reading only	Yes	No
'w'	Write	Opens file for writing (creates new or truncates existing)	No	Yes
'a'	Append	Opens file for writing at the end (creates if missing)	No	No
'r+'	Read + Write	Opens file for both reading and writing	Yes	No
'w+'	Write + Read	Opens file for writing and reading (truncates)	No	Yes
'a+'	Append + Read	Opens file for appending and reading	No	No
'rb'	Read Binary	Opens binary file for reading	Yes	No
'wb'	Write Binary	Opens binary file for writing	No	Yes
'ab'	Append Binary	Opens binary file for appending	No	No

🕵️ Detailed Breakdown of Each Mode

📖 Read Mode ('r')

This is the default mode. Use it when you only need to look at file contents without making changes.

The file must already exist or Python will raise an error.
The file pointer starts at the beginning of the file.
You cannot write or modify the file in this mode.

Example usage: Opening a configuration file to read its settings, or reading a log file to check for errors.

✍️ Write Mode ('w')

Use this when you want to create a new file or completely replace an existing file's contents.

If the file does not exist, Python creates it.
If the file exists, Python truncates it (deletes all existing content) before writing.
The file pointer starts at the beginning of the file.
Caution: Any existing data is lost immediately when you open the file.

Example usage: Writing a fresh report every day, or saving output from a script to a new file.

➕ Append Mode ('a')

Use this when you want to add new data to the end of an existing file without removing what is already there.

If the file does not exist, Python creates it.
If the file exists, the original content is preserved.
The file pointer starts at the end of the file.
You cannot read from the file in this mode (unless combined with '+').

Example usage: Adding new log entries to a log file, or recording timestamps to a history file.

🔄 Read + Write Mode ('r+')

This mode allows you to both read and write to the same file without destroying existing content.

The file must already exist.
The file pointer starts at the beginning.
Writing will overwrite characters at the current pointer position, not the entire file.
Useful when you need to update specific parts of a file.

🔁 Write + Read Mode ('w+')

Similar to 'w', but also allows reading after writing.

The file is truncated (emptied) when opened.
You can write data and then read it back within the same file object.
Useful for temporary files or when you need to verify what was written.

🔗 Append + Read Mode ('a+')

Combines append and read capabilities.

The file pointer starts at the end for writing.
You can seek back to the beginning to read the entire file.
Existing content is never deleted.

🛠️ Binary Modes ('b')

Binary modes are used for non-text files such as images, videos, executables, or any file that contains raw bytes instead of human-readable text.

Add 'b' to any text mode: 'rb', 'wb', 'ab', 'rb+', etc.
Data is read and written as bytes objects, not strings.
No encoding or decoding happens — the raw bytes are preserved exactly.
Critical for engineers: Always use binary mode when working with files that are not plain text, or you may corrupt the data.

Examples of binary files: PNG images, ZIP archives, PDF documents, compiled programs.

🧪 Practical Tips for Engineers

Always close files after you finish working with them. Use the with statement to automatically handle closing: with open('file.txt', 'r') as f: — this ensures the file is closed even if an error occurs.
Use 'w' carefully. A single typo in your code can accidentally wipe out an important file. Consider using 'a' or 'r+' if you need to preserve existing data.
Binary mode is mandatory for non-text files. If you try to open a binary file in text mode, you may get encoding errors or corrupted output.
Test your mode choice. Before running a script that modifies files, test it on a copy of the data first.
Combine modes only when necessary. Using 'r+' or 'w+' adds complexity. Stick to simple modes unless you truly need both read and write access.

✅ Summary

Choosing the correct file mode is a fundamental skill in Python file handling. Each mode serves a specific purpose:

'r' for safe reading
'w' for creating or replacing files
'a' for adding to existing content
'b' for binary data (always combine with another mode)

By understanding these modes, you can confidently read, write, and manage files in your automation scripts, data pipelines, and system tools without accidentally losing data or corrupting files.

File modes tell Python how you intend to use a file — whether to read it, write to it, add to it, or work with binary data.

📖 Example 1: Reading a file with 'r' mode

This example opens a text file for reading only and displays its content.

file = open('sample.txt', 'r')
content = file.read()
print(content)
file.close()

📤 Output: Hello, this is sample text.

✏️ Example 2: Writing to a file with 'w' mode

This example creates a new file (or overwrites an existing one) with the text you provide.

file = open('output.txt', 'w')
file.write('This is new content.')
file.close()
file = open('output.txt', 'r')
content = file.read()
print(content)
file.close()

📤 Output: This is new content.

➕ Example 3: Appending to a file with 'a' mode

This example adds new text to the end of an existing file without removing what was already there.

file = open('output.txt', 'a')
file.write('\nThis line was appended.')
file.close()
file = open('output.txt', 'r')
content = file.read()
print(content)
file.close()

📤 Output: This is new content.\nThis line was appended.

🔢 Example 4: Reading a binary file with 'rb' mode

This example reads a binary file (like an image) as bytes instead of text.

file = open('image.png', 'rb')
binary_data = file.read()
print(type(binary_data))
print(len(binary_data))
file.close()

📤 Output:
📤 Output: 1024 (or whatever the file size is in bytes)

🛠️ Example 5: Writing binary data with 'wb' mode

This example writes raw bytes to a file, useful for saving images or other non-text data.

binary_content = b'\x89PNG\r\n\x1a\n'
file = open('new_image.png', 'wb')
file.write(binary_content)
file.close()
file = open('new_image.png', 'rb')
first_bytes = file.read(8)
print(first_bytes)
file.close()

📤 Output: b'\x89PNG\r\n\x1a\n'

📊 File Mode Comparison Table

Mode	Name	Creates file if missing	Overwrites existing content	Starts at end of file	Works with text	Works with binary
`r`	Read	No	No	No	Yes	No
`w`	Write	Yes	Yes	No	Yes	No
`a`	Append	Yes	No	Yes	Yes	No
`rb`	Read Binary	No	No	No	No	Yes
`wb`	Write Binary	Yes	Yes	No	No	Yes