Python - Como Copiar Arquivos Usando shutil

O Python oferece ferramentas poderosas para automação de tarefas no sistema operacional, e copiar arquivos entre diretórios é uma das operações mais comuns. Neste artigo, você vai aprender como usar o módulo shutil para copiar arquivos em sistemas Linux (e também compatível com Windows).

O que é o módulo shutil?

O módulo shutil faz parte da biblioteca padrão do Python e fornece uma série de funções de alto nível para manipulação de arquivos e diretórios. Entre suas funcionalidades estão:

• Cópia de arquivos e diretórios;
• Movimentação de arquivos;
• Remoção de diretórios e seus conteúdos;
• Obtenção de informações sobre o uso do disco.

Para copiar um arquivo de uma pasta para outra, usamos a função shutil.copy().

Exemplo básico de cópia de arquivo

Veja abaixo como copiar um arquivo chamado arquivo.txt de uma pasta de origem para uma pasta de destino:

import shutil

origem = '/caminho/da/pasta/origem/arquivo.txt'
destino = '/caminho/da/pasta/destino/arquivo.txt'

shutil.copy(origem, destino)

🔁 Essa operação copia o conteúdo do arquivo e seus metadados básicos (como data de modificação). Substitua os caminhos pelos diretórios reais do seu sistema. Certifique-se de que você tem permissão para leitura na pasta de origem e escrita na pasta de destino.

Explicando os parâmetros

• origem: Caminho completo do arquivo original a ser copiado;
• destino: Caminho completo do local onde o arquivo será salvo.

Outras funções úteis do módulo shutil

Além de copy(), o módulo shutil possui outras funções interessantes:

• shutil.copy2(): Copia o arquivo com todos os metadados;
• shutil.move(): Move (copia e remove) o arquivo;
• shutil.copytree(): Copia recursivamente um diretório inteiro;
• shutil.rmtree(): Remove um diretório e todo o seu conteúdo.

Dica extra: verifique se o destino existe

Para evitar erros, é uma boa prática verificar se o arquivo de destino já existe antes de copiar:

import os

if not os.path.exists(destino):
    shutil.copy(origem, destino)
else:
    print("Arquivo já existe no destino.")

Considerações de segurança

Ao automatizar tarefas com manipulação de arquivos, lembre-se de sempre validar os caminhos e tratar exceções para evitar sobrescrever dados importantes ou causar falhas inesperadas.

Documentação oficial

Para mais informações sobre o módulo shutil e suas funcionalidades, consulte a documentação oficial do Python:

https://docs.python.org/3/library/shutil.html

📌 Dica bônus: scripts de automação como esse podem ser executados via cron (no Linux) ou agendador de tarefas (no Windows) para automatizar cópias regulares de backup.

🔗 Para mais conteúdos e tutoriais, acesse o canal oficial no YouTube: @CanalQb