Um script em Python que organiza uma pasta bagunçada em subpastas por tipo, data ou nome, pelas suas regras

Exemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Pasta: sales/2026-10, 9 arquivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 linhas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 linhas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 linhas sem preço ignoradas (linhas 88, 412, 913)
2026-11-02 09:14:05 INFO  Pronto: 10.412 linhas -> report-2026-10.xlsx (abas "Vendas" e "Totais")

[columns]
date = Data, Data da venda, Dia
product = Produto, Item, Descrição
quantity = Qtd, Quantidade, Unid
price = Preço, Preço unitário

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lê o arquivo de uma loja e dá a ele os nomes de colunas do relatório."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: nenhuma coluna para '{name}' (procuradas: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Sobre este serviço

Uma pasta Downloads, uma pasta compartilhada de digitalizações ou um cartão de câmera logo vira milhares de arquivos misturados. Este script em Python coloca cada um no seu lugar pelas suas regras: por tipo (PDFs em Documentos, fotos em Imagens), por data em pastas de ano e mês ou por palavras no nome, como o nome de um cliente ou o número de uma nota fiscal. Ele pode copiar ou mover os arquivos, cria as pastas necessárias e, quando já existe um arquivo com o mesmo nome, inclui um número em vez de substituí-lo. Envie a estrutura de pastas que você quer e as regras. Você mesmo roda o script no seu computador, então teste antes em uma cópia. Nada é apagado: os arquivos só mudam de lugar, e só dentro das pastas que você indicar.

O que está incluído

• O que você recebeUm arquivo ZIP com o script em Python, um README com instruções passo a passo e, a partir do Padrão, um arquivo de configurações com as suas pastas e regras; o código também aparece na página do pedido.
• Por tipo, data ou nomeAs regras que você definir, na ordem que você definir
• Copiar ou moverVocê escolhe; os originais podem ficar onde estão
• Cuidado com os nomesUm arquivo com nome já existente ganha um número, nada é substituído
• Execução de testeA partir do Padrão, uma execução que só lista o que iria para onde
• Código legívelCom comentários, fácil de incluir uma regra depois

Como funciona

1. 1
   RegrasVocê descreve as pastas que quer e como os arquivos vão para elas
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê roda em uma cópia da pasta
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Qual pasta organizar e mais ou menos quantos arquivos ela tem, as pastas que você quer no final e a regra de cada uma: tipos de arquivo, data (tirada do arquivo ou do nome) ou palavras no nome. Se os arquivos devem ser copiados ou movidos, o que fazer com arquivos que não se encaixam em nenhuma regra e o seu sistema: Windows, macOS ou Linux. Uma captura de tela da pasta ou uma lista de 10 a 20 nomes de arquivos ajuda muito.

Vamos perguntar:

• Qual pasta precisa de organização?
• Quais pastas ele deve criar e o que vai em cada uma?
• Copiar ou mover?
• Onde ele vai rodar?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte