Um script em Python que renomeia centenas de arquivos de uma vez pelas suas regras: datas, números, palavras ou uma lista

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

Renomear arquivos um por um leva uma tarde inteira quando são centenas: fotos de um ensaio, documentos digitalizados, imagens de produtos, notas fiscais numa pasta. Este script em Python os renomeia pelas regras que você definir: inclui uma data tirada do arquivo, um prefixo ou uma numeração sequencial, substitui ou remove palavras, muda maiúsculas e minúsculas ou pega os novos nomes de uma lista CSV com nomes antigos e novos. Antes de renomear qualquer coisa, ele mostra como cada arquivo vai se chamar, e nunca sobrescreve um arquivo que já tem aquele nome. Envie as regras e alguns nomes atuais com os nomes que você quer. Você mesmo roda o script no seu computador, então teste antes em uma cópia da pasta. Ele muda só os nomes: não edita o conteúdo dos arquivos.

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 regras; o código também aparece na página do pedido.
• Prévia antesUma lista de nomes antigos e novos antes de qualquer arquivo ser renomeado
• Suas regras de nomesDatas, números, prefixos, palavras substituídas ou uma lista CSV
• Nada sobrescritoSe um nome já existir, o arquivo ganha um número em vez de substituir outro
• Qualquer tipo de arquivoFotos, PDFs, documentos e outros arquivos no Windows, macOS ou Linux
• Código legívelCom comentários, para mudar uma regra com facilidade depois

Como funciona

1. 1
   RegrasVocê descreve as regras e envia alguns nomes atuais e desejados
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê roda em uma cópia da pasta e confere a prévia
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Qual pasta você quer renomear e o que há nela (fotos, PDFs, documentos), quantos arquivos mais ou menos e as regras: o que entra no novo nome e em que ordem. Uma lista de 5 a 10 nomes atuais ao lado dos nomes desejados mostra isso melhor. Se os nomes vierem de uma lista, algumas linhas desse arquivo CSV ou Excel. Se há subpastas, e o seu sistema: Windows, macOS ou Linux.

Vamos perguntar:

• Quais arquivos você quer renomear?
• Como os novos nomes devem ficar?
• Onde ele vai rodar?
• Algo que ele nunca deve fazer

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte