Python Directory Management

Python Directory Management: pathlib.Path & Traversal

Modern Python uses the object-oriented pathlib module for file system path operations, replacing legacy os.path string manipulations.

pathlib.Path Operations

flowchart TD
    A["Path('src/module/app.py')"] --> B[".name -> 'app.py'"]
    A --> C[".stem -> 'app'"]
    A --> D[".suffix -> '.py'"]
    A --> E[".parent -> Path('src/module')"]

Key pathlib Methods

• Path.mkdir(parents=True, exist_ok=True): Create directory hierarchy.
• Path.glob(pattern): Match files matching glob pattern in directory.
• Path.rglob(pattern): Recursively match files in directory tree.
• Path.is_file() / Path.is_dir() / Path.exists(): Inspection checks.

Practical Code Example

from pathlib import Path
from typing import List

def inspect_directory_structure(base_dir: Path) -> List[Path]:
    """Recursively scan directory for Python files using rglob."""
    python_files = list(base_dir.rglob("*.py"))
    return python_files

if __name__ == "__main__":
    current_dir = Path.cwd()
    print(f"Current Working Directory: {current_dir}")
    print(f"Directory Name: {current_dir.name}")
    print(f"Parent Directory: {current_dir.parent}")

    # Create temporary subdirectories
    sub_dir = current_dir / "scratch_test_dir" / "nested"
    sub_dir.mkdir(parents=True, exist_ok=True)
    print(f"Created Nested Directory: {sub_dir.exists()}")

    # Cleanup
    if (current_dir / "scratch_test_dir").exists():
        import shutil
        shutil.rmtree(current_dir / "scratch_test_dir")

Best Practices & Gotchas

• Use / Operator for Path Joining: Use Path("dir") / "subdir" / "file.txt" instead of os.path.join().
• Always Use parents=True and exist_ok=True: path.mkdir(parents=True, exist_ok=True) prevents FileExistsError and creates missing parent folders.
• Use rglob() for Recursive Searches: Path.rglob("*.txt") is clean and fast for searching nested folders.

Self-Check Challenge

Write a function that iterates over all files in the current working directory using Path.cwd().iterdir() and prints file names and sizes in bytes.