Python os Module: Basic File and Folder Operations

Working with files and folders is one of the first real-world tasks you’ll do in Python. This page walks you through Python os module basics for files and folders: creating directories, listing files, joining paths, walking through directories, renaming/moving, and deleting safely. If you’re just starting your Python journey, this beginner guide to the Python os module for file handling uses simple, cross‑platform examples you can run right away. For more Python tutorials, visit the CodDesire Python hub.

What is the Python os module and why is it used?

The os module gives Python programs a cross‑platform way to talk to your operating system. For files and folders, it provides the low‑level building blocks to:

• Create directories (os.mkdir, os.makedirs)
• List and traverse directories (os.listdir, os.scandir, os.walk)
• Rename or move entries (os.rename, os.replace)
• Remove files and folders (os.remove/os.unlink, os.rmdir)
• Work with paths (os.path) and metadata (os.stat)

Modern best practice is to use os for these concrete operations, os.path or pathlib for building and inspecting paths, and shutil for higher‑level actions like copying or removing whole directory trees.

Getting started: current directory and basic setup

Before creating or listing files, it helps to know your current working directory (where your script is running from).

CWD: /home/student/projects

How to create and remove directories in Python with os

Creating folders is a common first step in a script—e.g., making a data or output directory. Here’s how:

Create a single folder

Create nested folders safely

Use os.makedirs to create parent directories automatically. With exist_ok=True, it won’t raise an error if the path already exists.

Remove an empty directory

Note: os.rmdir() removes only empty directories. To remove a folder with files inside, use shutil.rmtree() (shown later).

How do I list all files in a folder using Python os?

There are two primary ways: os.listdir() and os.scandir().

os.listdir: get names in a directory

os.listdir(path) returns a list of names (strings). It does not include full paths unless you join them yourself.

main.py
notes.txt
data
images

os.scandir: efficient iteration with file type checks

os.scandir() yields DirEntry objects with .is_file() and .is_dir() methods that are often faster because they can avoid extra system calls. This is useful for “python list files in directory” tasks that need filtering.

Python os path basics: building and inspecting paths

Never hard‑code path separators like / or . Use os.path to write portable code.

Joining and getting absolute paths with os.path

If you need to combine the safety of path objects with the power of os functions, pathlib works well too. Most os and shutil functions accept path‑like objects in modern Python.

os.path vs pathlib (quick comparison)

Walking a directory tree with os.walk

Use os.walk() to visit every subfolder and file. You’ll often see this used for searching, counting, or bulk operations.

Rename or move files and folders

Use os.rename(src, dst) to rename or move within the same filesystem. Be aware of overwrite behavior differences across operating systems. If you want to overwrite if the destination exists, prefer os.replace(src, dst) for portability.

class="cd-package">import os

# Simple rename(may fail if 'new.txt' exists depending on OS)
os.rename("old.txt", "new.txt")

# Overwrite if needed(more portable)
os.replace("temp.txt", "final.txt")

If you need to move across different disks or partitions, use shutil.move() instead. It can fall back to copy‑then‑delete if needed.

Python delete file safely

Deleting requires care. You can check existence or use try/except to handle “file not found” cases gracefully.

Delete a file with a safety check

class="cd-package">import os

path = "output/results.txt"

if os.path.isfile(path):
    os.remove(path)
    print("Deleted:", path)
else:
    print("No file to delete at:", path)

Delete a file using try/except

This pattern avoids a small timing window between the check and delete on busy systems.

Remove empty vs non-empty directories

os.rmdir() only removes empty directories. To remove a folder and everything in it, use shutil.rmtree().

File and folder metadata with os.stat

os.stat() returns size and timestamps; handy for quick checks.

Quick recipes: Python os module examples for listing files and folders

1) List only .txt files in a directory

2) Check if a file or directory exists in Python using os

3) Create multiple nested folders if missing

4) Join and get absolute paths in Python with os.path

5) Walk a tree and count Python files

6) Rename with overwrite using os.replace

class="cd-package">import os

src = "draft.txt"
dst = "final.txt"
os.replace(src, dst)

Common mistakes (and easy fixes)

• Using hard-coded slashes in paths. Fix: use os.path.join or pathlib.Path.
• Expecting os.rmdir() to remove non‑empty folders. Fix: use shutil.rmtree() for recursive deletion.
• Forgetting that os.listdir() returns names, not full paths. Fix: join with os.path.join(root, name).
• Assuming os.rename() always overwrites. Fix: use os.replace() for cross‑platform overwrite behavior.
• Creating nested directories with os.mkdir(). Fix: use os.makedirs(..., exist_ok=True).
• Deleting without handling “not found.” Fix: wrap os.remove() in try/except FileNotFoundError.

FAQ: People also ask

What is the Python os module and why is it used?

The os module provides a cross‑platform interface to your operating system. For files and folders, it lets you create directories, list and traverse folders, rename/move entries, remove files, and inspect metadata in a simple, portable way.

How do I list all files in a folder using Python os?

Use os.listdir(path) for a quick list of names, or os.scandir(path) to iterate efficiently and filter using entry.is_file() and entry.is_dir().

How can I create or delete a directory with Python os?

Create a single folder with os.mkdir("name"), or nested folders with os.makedirs("a/b/c", exist_ok=True). Delete an empty directory with os.rmdir("name"); for non‑empty directories, use shutil.rmtree("name").

What is the difference between os.path and pathlib in Python?

os.path is a set of string-based functions for path operations, while pathlib offers object-oriented paths (Path) with methods like exists() and the / operator for joining. Both are fully supported; use whichever feels clearer for your project.

How do I check if a file exists before deleting it in Python?

You can check with os.path.isfile(path), or safely try to delete and catch FileNotFoundError:

Why this approach is beginner-friendly and future-proof

The examples above stick to built-in modules and cross‑platform patterns. Python’s os, os.path, and shutil APIs have remained stable and are widely used in schools, colleges, and production code. When you’re ready, explore pathlib for cleaner path handling—most os/shutil functions accept path-like objects out of the box.

Keep practicing: build a small script to organize downloads, rename images, or archive reports. As you combine these small building blocks, you’ll quickly master how to use the os module in Python for everyday automation.

Continue learning on the CodDesire Python tutorials page.

Sources / Further reading

• Python docs: os — Operating system interfaces
• Python docs: os.path — Path manipulations
• Python docs: pathlib — Object-oriented filesystem paths
• Python docs: shutil — High-level file operations
• PEP 471 — os.scandir() function
• PEP 519 — File system path protocol