Desenvolvendo o Script de Manipulação de Arquivos e Dados

Desenvolvendo o Script de Manipulação de Arquivos e Dados — aula do módulo Script de Automação em Python, na trilha Seus Primeiros Projetos Práticos com IA da…

Leitura de aproximadamente 4 minutos.

Módulo: Script de Automação em Python · Curso: Seus Primeiros Projetos Práticos com IA · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Desenvolvendo o Script de Manipulação de Arquivos e Dados

O que você vai aprender

O poder da Biblioteca Padrão do Python (Standard Library) e por que não é necessário instalar nada extra para automatizar tarefas com arquivos.
Como o módulo moderno pathlib manipula caminhos, pastas e extensões de forma limpa e intuitiva.
Como mover arquivos com segurança e ler relatórios tabulares em formato CSV.
O fluxo de programação assistida para gerar e entender o código do script organizador.py.

1. As Ferramentas Nativas do Python

Uma das maiores vantagens do Python é sua filosofia de "baterias incluídas" (batteries included). Isso significa que, ao instalar o Python, você já recebe centenas de módulos prontos para manipular o sistema operacional, sem precisar baixar pacotes externos pelo comando pip.

Para o nosso organizador de arquivos, utilizaremos três módulos nativos: 1. pathlib: A ferramenta moderna e recomendada para representar e manipular caminhos de pastas e arquivos no Windows, Mac e Linux. 2. shutil: O módulo especializado em operações de alto nível no sistema de arquivos, como copiar e mover arquivos entre pastas. 3. csv: O módulo para ler e extrair informações de planilhas de texto separadas por vírgula ou ponto e vírgula.


+-------------------------------------------------------------+
|                 PIPELINE DO SCRIPT ORGANIZADOR              |
+-------------------------------------------------------------+
|                                                             |
|  [ 1. VARRER PASTA ] ──> Path("dados_brutos").glob("*")     |
|                                     │                       |
|                                     ▼                       |
|  [ 2. CLASSIFICAR ]  ──> Checar extensão (.csv, .pdf)       |
|                                     │                       |
|                                     ▼                       |
|  [ 3. CRIAR PASTAS ] ──> mkdir(parents=True, exist_ok=True) |
|                                     │                       |
|                                     ▼                       |
|  [ 4. MOVER ARQUIVO] ──> shutil.move(origem, destino)       |
|                                                             |
+-------------------------------------------------------------+

2. Dominando o Módulo `pathlib`

Historicamente, programadores usavam o módulo os.path com concatenação manual de strings para lidar com pastas. No Python moderno, o pathlib transforma caminhos em objetos inteligentes:

Path("dados_brutos").iterdir(): Lista todos os itens dentro de uma pasta.
arquivo.suffix: Retorna a extensão do arquivo (exemplo: .pdf ou .csv).
arquivo.name: Retorna o nome completo com extensão (exemplo: relatorio_vendas.csv).
arquivo.stem: Retorna apenas o nome sem a extensão (exemplo: relatorio_vendas).
pasta_destino.mkdir(parents=True, exist_ok=True): Cria toda a estrutura de pastas automaticamente, sem dar erro se a pasta já existir.

Comparativo de Abordagens no Python

| Abordagem | Exemplo de Código | Avaliação | |---|---|---| | Concatenação de Strings | "C:\\pasta\\" + nome | ❌ Frágil, quebra entre Windows e Linux | | Módulo Antigo (os.path) | os.path.join(pasta, nome) | ⚠️ Funcional, mas verboso | | Pathlib Moderno (Recomendado) | Path("pasta") / nome | ✅ Elegante, multiplataforma e seguro |

3. O Código do Script `organizador.py`

Vamos orientar a Inteligência Artificial a gerar um script modular, dividido em funções claras e de fácil leitura.

O script realiza três tarefas em sequência: 1. Localiza os arquivos na pasta dados_brutos/. 2. Identifica se o arquivo é uma planilha (.csv) ou documento (.pdf). 3. Move o arquivo para a pasta correspondente e, no caso de arquivos CSV, lê o total de linhas para exibir um resumo no terminal.

4. O Prompt para Geração do Código

Com a especificação que definimos na aula anterior, envie o seguinte prompt ao assistente:


Atue como um desenvolvedor Python sênior focado em código limpo, didático e seguro.
Com base na especificação do organizador de arquivos, gere o script organizador.py.

Siga rigorosamente estas diretrizes técnicas:
1. Use apenas a biblioteca padrão do Python (pathlib, shutil, csv).
2. Não use caminhos absolutos com letras de disco (como C:\...); use caminhos relativos ao local onde o script está rodando.
3. Crie as pastas de destino com mkdir(parents=True, exist_ok=True).
4. Organize arquivos .csv para "organizados/planilhas/" e .pdf para "organizados/documentos/".
5. Se o arquivo for .csv, use o módulo csv para contar quantas linhas existem e imprima essa informação no terminal.
6. Adicione comentários curtos explicando cada bloco para que alguém que nunca programou consiga acompanhar.

Entregue o código completo em um bloco único de código Python.

5. Armadilhas Comuns e Como Evitar

[!WARNING]

Usar caminhos absolutos fixos no código: Se você escrever no script caminhos como C:\Users\joao\projetos\..., o script só funcionará no seu computador exato e quebrará imediatamente se você trocar de pasta, de usuário ou tentar rodá-lo em um servidor Linux. Use sempre caminhos relativos como Path("dados_brutos"), garantindo portabilidade total.

Exercício Prático

Vamos executar seu primeiro script de automação no terminal:

1. Crie o arquivo organizador.py: Na pasta automacao-arquivos, crie o arquivo organizador.py e cole o código gerado pela IA. 2. Abra o terminal: Navegue até a pasta do projeto pelo terminal (Git Bash ou PowerShell). 3. Execute o script: Digite o comando:


   python organizador.py

4. Verifique os resultados: Abra seu explorador de arquivos e veja como a pasta organizados/ foi criada e os arquivos vendas_agosto.csv e recibo_01.pdf foram movidos com precisão para suas respectivas categorias.

Desenvolvendo o Script de Manipulação de Arquivos e Dados