Python Directory Management

Python Directory Management: Navigating Trees with pathlib

Python's pathlib module gives you an object-oriented way to inspect, create, and search directories without wrestling with string slashes. Every Path object works identically across Windows, Linux, and macOS paths.

You can check your current working directory with Path.cwd(), create nested directories in one call, and filter files recursively with glob patterns.

Creating Folders and Scanning Files

Pass parents=True, exist_ok=True to mkdir() so Python creates missing parent folders and never crashes if the directory already exists.

from pathlib import Path

export_dir = Path("reports") / "2026" / "november"
export_dir.mkdir(parents=True, exist_ok=True)

# List immediate entries or search recursively
py_files = sorted(Path(".").glob("*.py"))
all_json = list(Path(".").rglob("*.json"))

print("Created:", export_dir.is_dir())
print("Top-level .py count:", len(py_files))

Walking Large Directory Trees

When you need fine-grained pruning (such as skipping .git or node_modules folders before descending), os.walk() (or Path.walk() in Python 3.12+) lets you remove skipped folders from dirnames in place.

import os

for root, dirs, files in os.walk("."):
    dirs[:] = [d for d in dirs if d not in {".git", ".venv", "__pycache__"}]
    # Process remaining files cleanly

Common Mistakes to Avoid

• Calling Path("a/b/c").mkdir() with defaults: Without parents=True, Python raises FileNotFoundError if "a/b" does not exist yet.
• Using os.chdir() inside library functions: Changing the global working directory breaks relative paths elsewhere in the program; pass explicit Path objects instead.
• Assuming glob("*.py") searches subfolders: glob() checks only the immediate directory; use rglob("*.py") for recursive search.

Frequently Asked Questions

What is the difference between iterdir() and glob("*")?

iterdir() yields every immediate child (files and folders, including hidden dotfiles) quickly without pattern matching, while glob() filters names by wildcard pattern.

How do I get the folder containing the currently running Python script?

Use Path(__file__).resolve().parent to locate assets relative to your script regardless of where the user launched python from.

How do I move or rename a directory in Python?

Call Path("old_name").rename("new_name"), or shutil.move() when moving across different disk drives.