Como Renomear Arquivos em Python

Renomear arquivos é uma tarefa comum no dia a dia de quem trabalha com manipulação de dados e automação de processos. Python, com sua simplicidade e poder, oferece ferramentas eficientes para realizar essa tarefa. Neste tutorial, você aprenderá como renomear arquivos utilizando o Python de forma prática e eficiente.

Preparando o Ambiente

Antes de começarmos, é importante garantir que você tenha o Python instalado em seu sistema. Além disso, vamos utilizar o módulo os, que é parte da biblioteca padrão do Python e não requer instalação adicional.

Utilizando o Módulo os

O módulo os fornece uma maneira portátil de usar funcionalidades dependentes do sistema operacional. Para renomear arquivos, utilizaremos a função os.rename().

Sintaxe Básica

A função os.rename() requer dois argumentos: o caminho atual do arquivo e o novo caminho com o novo nome do arquivo.

import os

os.rename('caminho_atual/arquivo_atual.txt', 'caminho_atual/novo_nome.txt')

Exemplo Prático

Vamos supor que você tenha um arquivo chamado relatorio.txt e deseja renomeá-lo para relatorio_final.txt. Veja como é simples:

import os

# Definindo o nome atual e o novo nome do arquivo
nome_atual = 'relatorio.txt'
novo_nome = 'relatorio_final.txt'

# Renomeando o arquivo
os.rename(nome_atual, novo_nome)

print(f"Arquivo renomeado de {nome_atual} para {novo_nome} com sucesso!")

Tratando Exceções

É importante tratar exceções para evitar erros em tempo de execução, como tentar renomear um arquivo que não existe. Para isso, utilizamos o bloco try/except:

import os

try:
    os.rename('nome_inexistente.txt', 'novo_nome.txt')
except FileNotFoundError:
    print("O arquivo não foi encontrado.")
except Exception as e:
    print(f"Erro ao renomear arquivo: {e}")

Renomeando Múltiplos Arquivos

Para renomear múltiplos arquivos, como em uma pasta, você pode combinar os.rename() com um loop. Por exemplo, para adicionar um prefixo a todos os arquivos .txt em uma pasta, você faria:

import os

# Listando todos os arquivos na pasta atual
arquivos = os.listdir('.')

# Loop para renomear cada arquivo
for arquivo in arquivos:
    if arquivo.endswith('.txt'):
        os.rename(arquivo, f"prefixo_{arquivo}")

Conclusão

Renomear arquivos com Python é uma tarefa simples e direta, graças ao módulo os. Com o conhecimento adquirido neste tutorial, você pode começar a automatizar suas tarefas de renomeação de arquivos e integrá-las em seus scripts de automação.

Lembre-se de sempre testar seu código e tratar exceções para garantir que seu programa seja robusto e confiável. Com a prática, você se tornará cada vez mais eficiente na manipulação de arquivos com Python.