Python Filesystem & Pathlib Operations

🐍 Python 3.12+ 🟢 Chapter 28 of 65 📂 Phase 6: Exception and File Handling 📅 2026 Edition

📌 Covered in this chapter: pathlib.Path Mastery · Directory Creation (mkdir) · Existence Checks · Renaming & Deleting · Recursive Globbing

Master professional filesystem automation in Python: object-oriented path manipulation with pathlib.Path, checking file existence, creating nested folders with mkdir(parents=True), renaming, deleting, and recursive file searching with rglob().

1Object-Oriented Path Traversal with pathlib.Path

Modern Python (PEP 428) replaces legacy string path concatenation (os.path.join()) with pathlib.Path, treating paths as rich, platform-independent objects.

Legacy Approach: os.path.join("data", "exports", "2026", "report.pdf") Modern Approach: Path("data") / "exports" / "2026" / "report.pdf" (Clean slash operator!)

Key Path Properties:

path.name: Full filename with extension ("report.pdf").
path.stem: Filename without extension ("report").
path.suffix: File extension (".pdf").
path.parent: Immediate parent directory object.
path.resolve(): Absolute canonical filesystem path resolving symlinks.

💻 Example 1: Object-Oriented Path Inspection with pathlib.Path

Python 3 ▶ Run in Compiler

from pathlib import Path

# Constructing cross-platform paths using the / slash operator:
project_dir = Path("my_enterprise_app")
sub_path = project_dir / "src" / "controllers" / "auth_controller.py"

print("Full Path String: ", sub_path)
print("Filename (name):  ", sub_path.name)
print("Filename stem:    ", sub_path.stem)
print("Extension (suffix):", sub_path.suffix)
print("Parent Directory: ", sub_path.parent)
print("Grandparent Dir:  ", sub_path.parent.parent)

🔍 Cross-Platform Guarantee:

pathlib automatically renders forward slashes on Linux/macOS and backslashes on Windows without any conditional platform code.

2Directory Management: Creating Nested Folders (mkdir)

Creating folders manually can crash if the parent folders do not exist, or if the folder already exists. pathlib.Path.mkdir() solves this cleanly with two critical flags:

parents=True: Automatically creates all missing intermediate parent directories (like mkdir -p in Unix).
exist_ok=True: Does not crash if the target folder already exists!

💻 Example 2: Creating Nested Directories Safely with mkdir

Python 3 ▶ Run in Compiler

from pathlib import Path

# Define a deeply nested target folder:
backup_folder = Path("backups") / "2026" / "august" / "database_dumps"

# Create nested directory tree in ONE line safely:
backup_folder.mkdir(parents=True, exist_ok=True)
print(f"✅ Verified / Created directory: {backup_folder}")
print("Does folder exist?", backup_folder.exists())
print("Is it a directory?", backup_folder.is_dir())

🔍 Production Standard:

Always pass parents=True, exist_ok=True when preparing upload or log folders to ensure idempotent script execution.

3File Lifecycle: Checking, Renaming, Moving & Deleting

Perform complete CRUD operations on files using built-in Path methods:

path.exists(): Returns True if file or folder exists.
path.is_file() / path.is_dir(): Type verification.
path.rename(new_path): Renames or moves file to a new path.
path.unlink(missing_ok=True): Deletes a file (with missing_ok=True to prevent errors if already deleted!).
path.rmdir(): Deletes an empty directory.

💻 Example 3: File Lifecycle Management (Create, Rename, Read, Delete)

Python 3 ▶ Run in Compiler

from pathlib import Path

temp_file = Path("temporary_draft.txt")

# 1. Write text directly to file with write_text():
temp_file.write_text("This is temporary draft content.", encoding="utf-8")
print(f"1. Created {temp_file.name} | Exists? {temp_file.exists()}")

# 2. Rename / Move file:
archived_file = Path("archived_draft.txt")
temp_file.rename(archived_file)
print(f"2. Renamed to {archived_file.name} | Old exists? {temp_file.exists()}")

# 3. Read back text directly with read_text():
content = archived_file.read_text(encoding="utf-8")
print(f"3. Read content: '{content}'")

# 4. Clean up / Delete file with unlink():
archived_file.unlink(missing_ok=True)
print(f"4. Deleted file | Exists? {archived_file.exists()}")

🔍 One-Liner Helpers:

Path.write_text() and Path.read_text() encapsulate opening, encoding, reading/writing, and closing files into a single, clean line of code!

4Recursive File Searching with Pattern Globbing (rglob)

Search across your entire project folder hierarchy using recursive pattern matching:

path.glob("*.py"): Searches matching files in the current folder only.
path.rglob("*.py"): Recursive Glob — searches the current directory AND all nested sub-folders at any depth!

💻 Example 4: Recursive File Discovery with Path.glob

Python 3 ▶ Run in Compiler

from pathlib import Path

# Search current workspace for all HTML tutorial files:
workspace = Path(".")
html_files = list(workspace.glob("*.html"))

print(f"🔍 Found {len(html_files)} HTML files in root folder.")
for f in html_files[:4]:
    # Inspect file size in bytes:
    size_kb = f.stat().st_size / 1024
    print(f"• {f.name:30} | {size_kb:.1f} KB")

🔍 Memory Efficiency:

Path.glob() returns a lazy generator, allowing your program to iterate through hundreds of thousands of files without loading all filenames into RAM at once.

⚠️ Common Developer Pitfall: Using string concatenation (+) instead of the / operator for Paths

Writing path = folder + "/" + filename can result in double slashes (folder//file) or fail on Windows if backslashes are hardcoded. Always use pathlib.Path(folder) / filename.

💻 Hands-on Interactive Practice Challenge

Use pathlib to create a folder "my_test_dir", write a file "hello.txt" inside it, read its content, and clean up both file and folder.

Python 3 Practice Challenge ▶ Run in Compiler

from pathlib import Path

test_dir = Path("my_test_dir")
test_dir.mkdir(exist_ok=True)

test_file = test_dir / "hello.txt"
test_file.write_text("Hello from Pathlib! 🚀", encoding="utf-8")

print("File Content:", test_file.read_text(encoding="utf-8"))

# Cleanup:
test_file.unlink()
test_dir.rmdir()
print("Cleaned up directory successfully! ✅")

Run This Challenge in Online Python IDE →

❓ Frequently Asked Questions (FAQ)

Q What is the difference between unlink() and rmdir() in pathlib?

unlink() deletes a physical file. rmdir() deletes an empty directory. If a directory contains files, rmdir() will raise an OSError (use shutil.rmtree() for recursive directory deletion).

Q Why is pathlib.Path preferred over the os.path module?

pathlib provides an object-oriented, readable interface with built-in path methods (.read_text(), .write_text(), .mkdir(), .glob()) and natural slash (/) path joining.

Q How do I convert a pathlib.Path object to a string for older third-party libraries?

Simply call str(my_path) or pass the Path object directly, as all standard Python 3.6+ functions accept Path objects seamlessly via the os.PathLike interface.

Written by Our Compiler Technical Editorial Team
Reviewed for accuracy & tested on Python 3.12+ runtime · Last updated August 2026