Python - File Handling

Python File Handling

Introduction to File Handling in Python

File handling in Python is one of the most important concepts for beginners as well as experienced programmers. In real-world applications, data is rarely stored only in variables or memory. Instead, data is stored permanently in files so that it can be accessed, modified, and reused later. Python provides powerful, simple, and flexible features to work with files, making it a popular choice for data processing, automation, web development, data science, and machine learning projects.

This detailed guide on Python file handling covers everything from basic concepts to advanced techniques. You will learn how to open, read, write, append, and close files, understand different file modes, handle text and binary files, work with file pointers, manage directories, and handle exceptions. All explanations are written in a clear learning-oriented format suitable for students and professionals.

What is File Handling in Python?

File handling refers to the process of creating, opening, reading, writing, appending, and closing files. A file is a collection of data stored permanently on a storage device such as a hard disk or SSD. Python treats files as objects and provides built-in functions and methods to manipulate them easily.

Python file handling is commonly used in:

Reading configuration files
Storing user input permanently
Log file management
Data analysis and reporting
Automation scripts
Web applications

Types of Files in Python

Before working with file handling in Python, it is important to understand the types of files:

1. Text Files

Text files store data in human-readable form using characters. Examples include files with extensions like .txt, .csv, .html, and .log. Python reads and writes text files using string data.

2. Binary Files

Binary files store data in binary format, which is not human-readable. Examples include image files, audio files, video files, and executable files. Binary files are handled using bytes data in Python.

Opening a File in Python

To perform any operation on a file, you must first open it. Python provides the built-in open function to open a file. The open function returns a file object that can be used to perform various operations.

Syntax to Open a File


file_object = open("filename", "mode")

Here, filename refers to the name or path of the file, and mode specifies the purpose for which the file is opened.

File Modes in Python

File modes define the type of operation that can be performed on a file. Python supports several file modes:

Read Mode (r)

This mode opens the file for reading. If the file does not exist, it raises an error.

Write Mode (w)

This mode opens the file for writing. If the file already exists, its contents are overwritten. If the file does not exist, a new file is created.

Append Mode (a)

This mode opens the file for appending data at the end. Existing content is not removed. If the file does not exist, a new file is created.

Read and Write Mode (r+)

This mode opens the file for both reading and writing. The file must already exist.

Write and Read Mode (w+)

This mode opens the file for both writing and reading. It overwrites the existing file.

Append and Read Mode (a+)

This mode opens the file for appending and reading. Data is written at the end of the file.

Reading Files in Python

Python provides multiple methods to read data from files. These methods allow developers to read entire files, specific lines, or line by line.

Reading Entire File Using read()


file = open("example.txt", "r")
content = file.read()
print(content)
file.close()

The read method reads the entire content of the file as a single string.

Reading File Line by Line Using readline()


file = open("example.txt", "r")
line = file.readline()
print(line)
file.close()

The readline method reads one line at a time from the file.

Reading All Lines Using readlines()


file = open("example.txt", "r")
lines = file.readlines()
print(lines)
file.close()

The readlines method returns a list of all lines in the file.

Writing to Files in Python

Writing data to files is essential for storing results, logs, and user-generated content. Python provides the write method to write data to a file.

Writing Data Using write()


file = open("example.txt", "w")
file.write("Welcome to Python File Handling")
file.close()

The write method writes data to the file. If the file already exists, its content is replaced.

Writing Multiple Lines Using writelines()


file = open("example.txt", "w")
lines = ["Line one\n", "Line two\n", "Line three\n"]
file.writelines(lines)
file.close()

Appending Data to Files

Appending allows you to add new data at the end of an existing file without deleting old data.


file = open("example.txt", "a")
file.write("\nThis line is appended")
file.close()

Closing a File

Closing a file is very important to free system resources and ensure data is saved properly. The close method is used to close a file.


file.close()

Using with Statement for File Handling

Python provides the with statement, which automatically handles file closing. This is the recommended and safest way to work with files.


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

Using the with statement ensures that the file is closed automatically after the block execution.

File Pointer and tell() and seek()

A file pointer indicates the current position in a file. Python provides tell and seek methods to manage the file pointer.

tell Method


file = open("example.txt", "r")
position = file.tell()
print(position)
file.close()

seek Method


file = open("example.txt", "r")
file.seek(0)
content = file.read()
print(content)
file.close()

Handling Binary Files in Python

Binary files are handled using binary modes such as rb, wb, and ab. These files are useful for images, videos, and other non-text data.


file = open("image.jpg", "rb")
data = file.read()
file.close()

Exception Handling in File Operations

Errors may occur during file handling, such as file not found or permission issues. Exception handling helps manage such errors gracefully.


try:
    file = open("data.txt", "r")
    content = file.read()
    print(content)
    file.close()
except FileNotFoundError:
    print("File not found")

Working with File System Using os Module

Python provides the os module to work with directories and file system operations.

Creating a Directory


import os
os.mkdir("myfolder")

Removing a File


import os
os.remove("example.txt")

Checking File Existence


import os
print(os.path.exists("example.txt"))