find e xargs sem surpresas: nomes separados por NUL, -exec + e simulações prévias

Objetivo

Selecionar arquivos por nome, tipo, idade ou tamanho e executar um comando sobre eles de forma que nomes incomuns não causem falhas e que a ação nunca recaia sobre o conjunto errado.

Pré-requisitos

GNU findutils ou outra implementação com -print0 e xargs -0. É preciso saber que o find avalia seus argumentos como uma única expressão, da esquerda para a direita.

Passos

1. Escreva primeiro a seleção e apenas a imprima: find . -type f -name '*.log' -mtime +30 -print. Leia a lista. -maxdepth 1 limita a profundidade; -path ./node_modules -prune -o -type f -print ignora uma subárvore.
2. Escolha como executar o comando. Para um único comando sobre muitos arquivos, use -exec cmd {} +: segundo a man page, a linha de comando é montada acrescentando os nomes, como faz o xargs, o que resulta em muito menos invocações do que -exec cmd {} \;, que executa uma vez por arquivo. -execdir executa o comando a partir do diretório do arquivo; a man page o recomenda em vez de -exec por razões de segurança.
3. Quando outro programa precisar consumir os nomes, separe-os com NUL: find ... -print0 | xargs -0 cmd. A página do xargs explica que seus separadores padrão (espaços em branco e quebras de linha, com aspas e barras invertidas tratadas de forma especial) tratam mal nomes que os contenham, enquanto -0 interpreta cada byte literalmente.
4. Acrescente -r (--no-run-if-empty) ao xargs. Sem essa opção, afirma a man page, o comando é executado uma vez mesmo sem nenhuma entrada, o que, para alguns comandos, significa "tudo".
5. Use -I{} quando o nome precisar aparecer no meio do comando (isso implica um item por invocação), -n 1 para um item por vez e -P 4 junto com -n para execuções em paralelo.
6. Antes de ações destrutivas, coloque echo na frente do comando ou mantenha -print; só depois substitua -print por -delete. A man page alerta que -delete escrito no início apaga tudo abaixo dos pontos de partida e que ele ativa -depth, o que torna -prune ineficaz.
7. Verifique os códigos de saída: o xargs retorna 123 se alguma invocação falhou, 124 se um comando terminou com 255 (o que também interrompe o xargs) e 126 ou 127 se o comando não pôde ser executado ou não foi encontrado.

Resultado esperado

Uma linha de comando que lida com qualquer nome de arquivo, executa a ferramenta o menor número de vezes necessário, não faz nada quando a seleção está vazia e foi revisada como listagem antes de tocar em qualquer coisa.

Limites e base de verificação

O comportamento segue as man pages do GNU citadas; a página do xargs informa que -0 e -r só entraram no POSIX na edição de 2024, e -delete e -execdir não fazem parte do POSIX, portanto outras implementações podem não tê-los. Tanto -exec ... + quanto o xargs dividem listas longas em várias invocações, de modo que o comando precisa ser seguro para execução em lotes. Nenhuma medição de tempo é apresentada.

Simulações que correspondem à exclusão

-delete implica -depth, e com -depth a ação -prune não tem efeito; assim, uma seleção visualizada com -prune ... -print e depois executada com -delete também apaga dentro da subárvore que deveria ser ignorada. A visualização e a execução precisam usar a mesma travessia. Ou se acrescenta -depth à visualização e se troca o prune por um teste que não selecione a subárvore (find . -depth -not -path './node_modules/*' -name '*.log' -print, e depois o mesmo com -delete), ou se mantém -prune e se apaga por meio de um pipe: find . -path ./node_modules -prune -o -name '*.log' -print0 | xargs -0r rm --. Qualquer que seja a forma escolhida, execute-a uma vez com -print ou com echo rm na frente e compare a lista antes de executá-la de verdade.