Master Python pathlib: Clean, Cross‑Platform Path Handling Made Easy

Why Choose pathlib?

pathlib offers an object‑oriented API, automatic cross‑platform path separator handling, a rich set of methods, and chainable calls, making file‑system work more natural and readable compared to the functional os.path module.

Getting Started with Path Objects

Import the class and instantiate it directly from a string or use class methods to build absolute paths.

from pathlib import Path
# Directly from a string
path = Path('example.txt')
# Build an absolute path using Path.cwd()
absolute_path = Path.cwd() / 'subdir' / 'example.txt'

Inspecting Path Properties

Path objects expose attributes to query the file system.

print(path.is_file())      # Is it a file?
print(path.is_dir())       # Is it a directory?
print(path.parent)         # Parent directory
print(path.name)           # File name
print(path.suffix)         # Extension
print(path.stem)           # Name without extension

Manipulating Paths

Modify names, extensions, combine paths, or compute relative paths.

new_path = path.with_name('new_example.txt')   # Change file name
renamed_path = path.with_suffix('.md')        # Change extension
combined_path = path / 'subfolder'            # Append subdirectory
relative_to_path = path.relative_to('/home/user')  # Relative path

File and Directory Operations

Read, write, create, and delete files and directories directly through Path.

# Write to a file
with path.open('w') as file:
    file.write('Hello, pathlib!')
# Read from a file
with path.open('r') as file:
    content = file.read()
print(content)
# Create a new directory
subdir = path.parent / 'new_folder'
subdir.mkdir(parents=True, exist_ok=True)
# Delete a file
try:
    path.unlink()
except FileNotFoundError:
    print('File not found')
# Delete an empty directory
try:
    subdir.rmdir()
except OSError:
    print('Directory not empty or does not exist')

Traversing Directories

Iterate over children, filter files, or match patterns with glob.

for child in subdir.iterdir():
    print(child)               # All entries
for file in subdir.glob('*.txt'):
    print(file)               # Only .txt files
for dir in subdir.glob('*/'):
    print(dir)                # Only subdirectories

Advanced Usage

Handle symbolic links and perform pattern matching.

symlink_path = Path('symlink_to_example')
symlink_path.symlink_to(path)          # Create symlink
print(symlink_path.resolve())          # Resolve to real path
# Glob with custom pattern
for match in subdir.glob('*.?xt'):
    print(match)                       # Matches files like .txt, .axt, etc.

Conclusion

By adopting pathlib, you gain a consistent, elegant interface for simple file I/O as well as complex directory management, leading to cleaner and more efficient Python code.