Procurar texto dentro de ficheiros

Sobre pesquisar dentro de ficheiros

Toda a gente já procurou um ficheiro por algo escrito lá dentro — o nome de um cliente numa de duzentas faturas, uma palavra-passe antiga numa configuração, uma frase numa pasta de apontamentos. E toda a gente foi deixada mal pela caixa de pesquisa do seu sistema operativo.

A pesquisa do Windows indexa o conteúdo apenas para certas localizações e certos tipos de ficheiro, e quando não indexou alguma coisa devolve nada em vez de o dizer. Isso é pior do que um erro, porque leva a concluir que o texto não está lá. O Spotlight faz melhor, mas é igualmente calado sobre aquilo que não olhou.

Esta ferramenta abre todos os ficheiros candidatos e lê-os. Recebe o ficheiro, o número da linha e a própria linha — e, tão importante quanto isso, uma contagem de tudo o que não conseguiu ler.

Só de leitura: nada é enviado, nada é alterado.

Como se usa

• Clique em Escolher uma pasta para pesquisar e selecione-a. O navegador vai pedir autorização para a ler
• Escreva o que quer encontrar
• Assinale Distinguir maiúsculas, Palavra inteira ou Expressão regular se precisar
• Estreite com Apenas estes tipos — pesquisar só txt, md é bem mais rápido do que abrir tudo
• Prima Procurar e depois Copiar as ocorrências ou descarregue o CSV

Cada ocorrência mostra o número da linha e a linha, com o texto encontrado destacado. Uma linha muito longa é cortada à volta da ocorrência em vez de ser descartada, pelo que até um ficheiro minificado dá uma resposta aproveitável.

Diz-lhe o que ignorou

É exatamente isto que as pesquisas do sistema fazem mal, por isso fica no ecrã depois de cada pesquisa:

• Não é texto — um ficheiro que contém um byte NUL é binário. Procurar «fatura» dentro de um JPEG só pode produzir ruído, por isso esses são ignorados e contados
• Demasiado grande — tudo acima de 8 MB. Um único registo enorme não deve bloquear o separador
• Ilegível — bloqueado por outro programa, desaparecido a meio da leitura, ou recusado pelo sistema operativo

Se uma pesquisa vier vazia e o resumo disser que 40 ficheiros foram ignorados, já sabe que deve repetir com um filtro de tipos mais largo. Um zero silencioso não lhe teria dito nada.

Três formas de corresponder

• Texto simples — a predefinição. Tudo o que escrever é procurado à letra, pelo que uma pesquisa por preço ($) encontra exatamente isso sem ter de escapar nada
• Palavra inteira — gato encontra gato mas não gatos. Útil para nomes e identificadores
• Expressão regular — a variante completa do JavaScript. \d{4}-\d{2}-\d{2} para datas, TODO|FIXME para qualquer uma das duas, ^import para linhas que começam assim. Uma expressão inválida é comunicada como inválida em vez de, em silêncio, não encontrar nada

Distinguir maiúsculas aplica-se às três.

Para que serve

• Encontrar a fatura com o nome de um cliente no meio de centenas
• Localizar uma definição enterrada numa pasta de ficheiros de configuração
• Pesquisar numa pasta de apontamentos ou markdown uma frase de que se lembra em parte
• Verificar se uma chave de API ou palavra-passe está numa pasta de projeto
• Encontrar todos os ficheiros que mencionam uma função ou variável antes de a renomear
• Auditar CSV exportados à procura de um valor que não devia lá estar
• Obter uma lista com números de linha que possa colar num pedido

Bom saber

• Funciona em Windows, macOS, Linux e ChromeOS — é uma página web, portanto não há nada para instalar. Não pode funcionar em iPhone, iPad ou Android: os navegadores móveis não têm forma de entregar uma pasta a uma página web
• Aqui todos os navegadores dão a mesma resposta. Ler o conteúdo de um ficheiro é algo que tanto o seletor de pastas moderno como o mecanismo mais antigo conseguem fazer
• Nada é enviado. Cada ficheiro é aberto e pesquisado na página
• Não há índice, por isso a primeira pesquisa numa pasta grande demora o tempo de a ler. É também por isso que nunca pode estar desatualizada
• São guardadas até 50 ocorrências por ficheiro e mostrados 300 ficheiros; o CSV contém todas as ocorrências
• Os ficheiros são lidos como UTF-8. Um ficheiro numa codificação regional antiga pode mostrar caracteres estranhos, embora a pesquisa em si continue a funcionar para texto ASCII simples
• A pesquisa corre na página, por isso uma pasta muito grande manterá o separador ocupado. Uma barra de progresso mostra onde vai

Ferramentas relacionadas

• Lista de pastas e ficheiros — procurar por nome em vez de por conteúdo
• Localizar e substituir texto — alterar o texto depois de o encontrar
• Testador de regex — construir o padrão antes de o lançar sobre uma pasta
• Localizador de ficheiros duplicados — encontrar ficheiros idênticos em vez de texto parecido