Working with os and shutil

Python’s os and shutil modules provide powerful tools for interacting with the file system, managing directories, and automating file-related tasks.

In this lesson, you’ll learn how to use these modules for tasks like file manipulation, directory management, and more.

What Is the os Module?

The os module provides functions for interacting with the operating system, such as creating directories, deleting files, and getting environment variables.

Creating Directories

You can create a new directory using the os.mkdir() or os.makedirs() functions:

# Creating directories
import os

os.mkdir("new_folder")  # Creates a single directory
os.makedirs("nested/folder/structure")  # Creates nested directories

Listing Directory Contents

Use the os.listdir() function to list the contents of a directory:

# Listing directory contents
files = os.listdir(".")  # Lists files and directories in the current directory
print(files)

Working with shutil

The shutil module is designed for high-level file operations, such as copying, moving, and deleting files or directories.

Copying Files

Use the shutil.copy() function to copy files:

# Copying files
import shutil

shutil.copy("source.txt", "destination.txt")  # Copies source.txt to destination.txt

Moving and Renaming Files

Use the shutil.move() function to move or rename files:

# Moving and renaming files
shutil.move("source.txt", "archive/source_renamed.txt")

Deleting Files and Directories

Use the os.remove() and shutil.rmtree() functions to delete files and directories:

# Deleting files and directories
os.remove("file_to_delete.txt")  # Deletes a single file
shutil.rmtree("folder_to_delete")  # Deletes a folder and its contents

Common Mistakes with os and shutil

Here are some mistakes to avoid:

• Not checking if a file or directory exists before trying to delete or copy it.
• Overwriting files unintentionally while copying or moving.
• Using hardcoded paths instead of dynamic paths with os.path.

What Did We Learn?

In this lesson, you learned:

• How to use the os module for directory and file management.
• How to use the shutil module for high-level file operations like copying and moving.
• Best practices to avoid common mistakes with file system automation.

Great job! Let’s move to the next topic.