StackTips

Files

Python allows you to work with the file system, which includes both files and directories. Using the built-in system functions, you can access, manipulate, open, read, write, append, and close files.

Opening a File

In Python, you can open a file using the built-in open function. This function accepts two required arguments: the name of the file you want to open and the mode in which you want to open it.

Here's an example:

file = open("example.txt", "r")

In the above code, "example.txt" is the name of the file you want to open and "r" is the mode. The mode "r" stands for "read" and it opens the file for reading. There are several other modes you can use:

  • "r": Read mode (default) - used for reading the contents of an existing file "w": Write mode - used for creating a new file or overwriting an existing file
  • "a": Append mode - used for appending data to an existing file
  • "x": Exclusive creation mode - used for creating a new file, but will raise an error if the file already exists
  • "b": Binary mode - used for reading or writing binary data You can combine the modes with "b" to open a file in binary mode.

For example, "rb" means to open the file in binary read mode, and "wb" means to open the file in binary write mode.

Reading a File

Here's an example of how you can read the contents of a file:


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

In this example, the read method is used to read the contents of the file, and then the close method is used to close the file after you're done with it. It's a good idea to always close your files when you're done with them, to ensure that the resources they use are properly released.

You can also use the with statement to automatically close the file for you, like this:

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

In this example, the file is automatically closed after the with block is exited, even if an exception is raised.

Read File Line by Line

Maybe instead of getting the entire file, you want to read it line by line. Thankfully, there is already a built-in function for this. The readline() function reads a file line by line each time. If you use it twice, the second time will return the second line.

file = open("file.txt", "r")
print(file.readline())
print(file.readline())
Hello!
Welcome to StackTips!

Alternatively, you can just loop over the lines, like so:

file = open("file.txt", "r")
for line in file:
    print(line)
Hello!
Welcome to StackTips!
Have fun!

Closing a File

Closing a file is important because it is sometimes needed to ensure any changes to a file are propagated in the file system.

This is how to close a file once you're finished with it:

file = open("file.txt", "r")
for line in file:
    print(line)
file.close()

Our file is now closed!

Appending to Existing File

You can append text to an existing file pretty easily. Simply switch the mode when you open and use the write() function:

file = open("file.txt", "a")
file.write("Coding is fun!")
file.close()

file = open("file.txt", "r")
print(file.read())
Hello!
Welcome to StackTips!
Have fun!
Coding is fun!

Overwriting an Existing File

The only difference between appending and overwriting an existing file is the mode. Here is how you overwrite a file entirely:

file = open("file.txt", "w")
file.write("Coding is fun!")
file.close()

file = open("file.txt", "r")
print(file.read())
Coding is fun!

Creating new Empty Files

You can create a brand new file without any content in it by changing the mode to x:

file = open("file.txt", "x")
file.close()

A new blank file has been created!

Renaming a File

To rename a file using Python, we must import the os module, then use its rename() function.

Here's how that looks:

import os
os.rename("old_name.txt", "new_name.txt")

Pretty simple!

Deleting a File

Deleting a file also requires the use of the os module.

Here's how you do it:

import os

os.remove("file.txt")

Check if a File Exists

To avoid an error with trying to remove a file that does not exist, you should check if the file exists before trying to remove it.

This is how you do it:

import os

path = "file.txt"

if os.path.exists(path):
    os.remove(path)
else:
    print("This path does not exist: " + path)