pathlib vs os.path: Uma Forma Moderna de Lidar com Caminhos de Arquivos

Por muitos anos, os.path foi a forma padrão de manipular caminhos de arquivos no Python. Ele funciona de forma confiável, mas trata caminhos como simples strings, o que frequentemente resulta em código mais verboso e menos expressivo.

Com a introdução do pathlib, o Python adotou uma abordagem mais moderna e orientada a objetos. Em vez de operar sobre strings cruas, você trabalha com objetos Path que encapsulam diretamente o comportamento do sistema de arquivos.

A Diferença Principal

A principal distinção está na representação:

• os.path trabalha com strings
• pathlib usa objetos Path

Compare:

# os.path
import os
path = os.path.join("data", "input", "file.csv")

# pathlib
from pathlib import Path
path = Path("data") / "input" / "file.csv"

A versão com Path não é apenas mais curta, mas também mais clara. O operador / representa a composição de caminhos de forma natural.

Trabalhando com Arquivos na Prática

Considere um script simples de ETL que combina múltiplos arquivos CSV.

Usando os.path

import os
import pandas as pd

input_dir = "data/input"
output_dir = "data/output"

csv_files = [f for f in os.listdir(input_dir) if f.endswith(".csv")]

dfs = [pd.read_csv(os.path.join(input_dir, f)) for f in csv_files]
result = pd.concat(dfs)
result.to_csv(os.path.join(output_dir, "merged.csv"), index=False)

Usando pathlib

from pathlib import Path
import pandas as pd

input_dir = Path("data/input")
output_dir = Path("data/output")

dfs = [pd.read_csv(file) for file in input_dir.glob("*.csv")]
result = pd.concat(dfs)
result.to_csv(output_dir / "merged.csv", index=False)

A versão com pathlib se aproxima mais da intenção do código. Ela evita manipulação manual de strings e reduz código repetitivo.

Métodos Úteis do Path

pathlib oferece vários métodos convenientes:

file = Path("data/input/report.csv")

file.exists()
file.stem
file.suffix
file.with_suffix(".json")
file.read_text()
file.write_text("content")

Essas operações são naturais porque o próprio caminho sabe como se comportar.

Path vs PurePath

Path interage com o sistema de arquivos real.
PurePath lida apenas com a lógica de caminhos sem acessar o disco.

Na maioria das aplicações, Path é a escolha correta. PurePath é útil quando você precisa apenas de manipulação estrutural de caminhos.

Por Que pathlib Importa

• API orientada a objetos
• Consistência entre plataformas
• Composição limpa com /
• Operações de arquivo integradas
• Melhor integração com bibliotecas modernas

Em pipelines de dados e scripts de automação, pathlib torna o código mais declarativo e menos frágil.

Boas Práticas

• Use objetos Path de forma consistente no projeto
• Evite misturar strings e Path desnecessariamente
• Prefira .glob() e .rglob() para descoberta de arquivos
• Use .resolve() ao trabalhar com caminhos absolutos

Consideração Final

os.path continua funcionando e é totalmente válido. No entanto, pathlib oferece um modelo mais claro e expressivo para trabalhar com o sistema de arquivos.

Adotar pathlib não significa substituir código antigo sem critério. Significa escolher uma abstração mais legível e sustentável para projetos modernos em Python.