Manipular caminhos com pathlib

Path faz parte de pathlib, um módulo da biblioteca padrão do Python. Portanto, não é necessário instalar um pacote. Você pode criar um valor Path passando um texto que represente um caminho.

Este código representa o caminho de um possível arquivo e o exibe. Ele não cria nem abre o arquivo.

A variável destino guarda uma representação que o programa pode manipular. Isso não significa que rascunho.txt exista no computador. Criar o Path ou passá-lo para print também não cria, abre nem modifica o destino.

Quando um dos valores é um Path, o operador / combina a base com o próximo componente. Assim, cada nome pode ser escrito separadamente, sem acrescentar \ ou / dentro dos textos.

from pathlib import Path

base = Path("projeto")
relatorio = base / "dados" / "relatorio.csv"

print(relatorio)

O resultado representa a hierarquia projeto → dados → relatorio.csv. Os separadores exibidos podem variar conforme o sistema operacional.

Execute este código para comparar a base com o caminho combinado. Ele apenas cria e exibe valores Path; não cria as pastas nem o arquivo.

Um caminho relativo não informa sozinho todo o trajeto até o destino. Seu ponto de partida é a pasta de trabalho do processo, que pode ser consultada com Path.cwd().

Um caminho absoluto inclui seu ponto de partida completo e, por isso, não depende da pasta de trabalho para ser interpretado.

Execute este código em seu computador e compare as três linhas exibidas:

A pasta de trabalho normalmente depende de onde o processo foi iniciado. Ela não precisa ser a pasta em que o arquivo .py está salvo.

Assim, o mesmo script pode produzir destinos absolutos diferentes para Path("saida") quando é executado a partir de pastas de trabalho diferentes.

Nos dois casos, o script representa saida/resultado.txt. O que muda é a pasta de trabalho usada como base.

resolve() produz a forma absoluta de um caminho. Por padrão, ele usa strict=False: o destino não precisa existir.

Portanto, o resultado não comprova existência e a chamada não cria pastas nem arquivos.

Um componente relativo continua a hierarquia da base. Já um componente absoluto substitui a base anterior:

Considere o caminho relatorios/2025/vendas.final.csv:

• parent retorna o caminho que contém o componente final: relatorios/2025.
• name retorna o nome completo do componente final: vendas.final.csv.
• stem retorna esse nome sem o último sufixo: vendas.final.
• suffix retorna o último sufixo, incluindo o ponto: .csv.

parent é outro valor Path. Já name, stem e suffix são textos (str). Essas propriedades apenas analisam a representação do caminho: o destino não precisa existir.

Execute o código e compare os valores e tipos exibidos. Nenhuma pasta ou arquivo é criado ou aberto.

As propriedades como name e suffix examinam apenas a representação do caminho. Para consultar o sistema de arquivos, use métodos:

• exists() indica se há um destino no caminho.
• is_file() indica se o destino é um arquivo regular.
• is_dir() indica se o destino é um diretório.

As três consultas retornam valores booleanos e não leem o conteúdo de arquivos.

Salve este código como consulta_caminhos.py e execute-o a partir da pasta em que foi salvo. Se o último nome já existir no seu computador, troque-o por outro nome que não exista.

O caminho relatorio.csv tem aparência de arquivo, mas o nome não prova que ele exista nem que seja um arquivo. Pode não haver destino algum ou pode até existir um diretório com esse nome. suffix examina o nome; exists(), is_file() e is_dir() consultam o estado observável no sistema de arquivos.

Cada linha representa uma combinação típica das três consultas.

Construir um Path apenas representa um caminho. Já o método mkdir() solicita a criação de um diretório no sistema de arquivos.

Para criar de uma vez todos os diretórios intermediários ausentes, use parents=True. Com exist_ok=True, a operação também pode ser repetida quando o diretório de destino já existe.

No terminal, vá até uma pasta em que você possa criar diretórios. Salve e execute o código abaixo nessa pasta. Ele usa a pasta de trabalho como base e cria somente diretórios com nomes próprios para a prática.

Execute o script duas vezes. A segunda execução deve terminar normalmente porque exist_ok=True aceita que o diretório final já exista.

Você pode trocar os três nomes por outros nomes de prática.

Ao executar mkdir(), a falha informa o que impediu a criação:

• FileNotFoundError: um diretório-pai necessário não existe quando parents=False.
• FileExistsError: o destino já existe de forma incompatível. Pode ser um diretório com exist_ok=False ou um arquivo ocupando o caminho — mesmo com exist_ok=True.
• PermissionError: o processo não tem permissão para realizar a operação naquele local.
• IsADirectoryError: outra operação exigia um arquivo, mas recebeu um diretório. Por enquanto, basta reconhecer esse diagnóstico.

Esses tipos pertencem à família OSError, que reúne falhas relacionadas ao sistema operacional.

Uma chamada anterior a exists(), is_file() ou is_dir() descreve apenas aquele instante. Antes de mkdir() executar, o destino pode mudar, ser ocupado por um arquivo ou deixar de estar acessível. Portanto, o try deve envolver a própria operação que pode falhar.

Adapte apenas os nomes dos componentes. O bloco try contém somente a criação do diretório; assim, cada except corresponde claramente à operação protegida.

Você vai executar um script que usa a pasta de trabalho como base, constrói saida/relatorios e representa o caminho de um futuro arquivo chamado resumo.txt. O script cria somente os diretórios. O caminho do arquivo poderá ser inspecionado, mas o arquivo não será criado.

Escolha uma pasta de prática em que você possa criar conteúdo e abra o terminal nela. Salve o código abaixo em um script e execute-o. Se quiser, troque apenas os nomes saida, relatorios e resumo.txt por nomes seguros de sua preferência.

Este script constrói os caminhos, mostra seus componentes e tenta criar somente a pasta de saída.