Como Renomear Arquivos e Diretórios em Python com os.rename() – Guia Passo a Passo

Como Renomear Arquivos e Diretórios em Python com os.rename() – Guia Passo a Passo

Renomeando Arquivos e Diretórios em Python

A função os.rename() do Python fornece uma maneira simples e multiplataforma de renomear arquivos ou diretórios. Seja limpando convenções de nomenclatura ou atualizando ativos de projeto, dominar este método é essencial para manipulação eficiente de arquivos.

Sintaxe

os.rename(origem, destino)

Parâmetros

origem: O caminho existente do arquivo ou diretório que você deseja renomear. Deve existir antes da chamada.

destino: O novo caminho (ou apenas o novo nome se permanecer no mesmo diretório). Este será o novo nome do arquivo ou diretório.

Exemplo

import os
os.rename('guru99.txt', 'carreira.guru99.txt')

Neste exemplo, o arquivo original guru99.txt é renomeado para carreira.guru99.txt dentro do mesmo diretório.

• Use os.rename() para renomear guru99.txt para carreira.guru99.txt.
• Após execução, o novo arquivo aparece ao lado do original no explorador de arquivos.

Código Completo Funcionando

import os
from os import path

def main():
    # Garante que o arquivo fonte existe
    if path.exists('guru99.txt'):
        # Resolve o caminho absoluto (opcional)
        origem = path.realpath('guru99.txt')
        # Realiza o rename
        os.rename('guru99.txt', 'carreira.guru99.txt')

if __name__ == "__main__":
    main()

Tratamento de Erros

Sempre proteja contra erros potenciais como FileNotFoundError ou PermissionError. Envolver a chamada rename em bloco try/except garante que seu script falhe graciosamente:

try:
    os.rename(origem, destino)
except FileNotFoundError:
    print(f"Arquivo fonte {origem} não encontrado.")
except PermissionError:
    print("Permissão negada.")
except Exception as e:
    print(f"Erro inesperado: {e}")