yarn autoclean

Limpa e remove arquivos desnecessários das dependências do pacote.

yarn autoclean [-I/--init] [-F/--force]

O comando autoclean libera espaço em disco removendo arquivos e pastas desnecessários das dependências. Isso reduz o número de arquivos na pasta node_modules do seu projeto, isso é útil em um ambiente onde pacotes são checados no controle de versão diretamente.

Nota: Esse comando é considerado somente para casos avançados de uso. A menos que você esteja enfrentando problemas com a quantidade de arquivos que estão instalados na pasta node_modules não é recomendado o uso desse comando. Isso irá excluir permanentemente arquivos na pasta node_modules, o que pode fazer com que pacotes parem de funcionar.

A funcionalidade de limpeza automática (autoclean) está desativada por padrão. Para ativá-la, crie manualmente um arquivo .yarnclean ou execute yarn autoclean --init para criar o arquivo com as entradas padrão. Recomendamos adicionar o arquivo .yarnclean ao controle de versão.

Caso o arquivo .yarnclean exista em um pacote, a funcionalidade de limpeza automática será ativada. A limpeza será realizada:

  • Após uma instalação (yarn install)
  • Após uma adição (yarn add)
  • Caso seja executado yarn autoclean --force

A limpeza é realizada ao ler cada linha do arquivo .yarnclean e usar cada uma como um padrão glob dos arquivos a serem excluídos.

Opções:

-I/--init: Cria o arquivo .yarnclean caso ele não exista e adiciona as entradas padrão. Este arquivo deve então ser revisto e editado para personalizar quais arquivos serão excluídos. Se o arquivo já existir, ele não será sobrescrito.

-F/--force: Se o arquivo .yarnclean existir, executa o processo de limpeza. Se o arquivo não existir, não faz nada.

Padrões:

Quando o comando yarn autoclean --init é usado para criar um arquivo .yarnclean, ele será preenchido com um conjunto padrão de itens a serem excluídos. Esta lista padrão é um palpite do que provavelmente não é necessário. É impossível prever todos os diretórios e arquivos que realmente são desnecessários em todos os atuais e futuros pacotes do NPM existentes. Por isso, há a possibilidade dessa lista padrão fazer um pacote deixar de funcionar.

Recomendamos fortemente que você revise manualmente todas as entradas no .yarnclean e as personalize de acordo com suas necessidades.

Caso você descubra que o processo de limpeza automática está excluindo arquivos necessários para o funcionamento de um pacote, você deve remover a entrada correspondente do arquivo .yarnclean.

Exemplo:

Você decide que todos os arquivos YAML e Markdown em todas as suas dependências instaladas no node_modules podem ser excluídas com segurança. Você cria um arquivo .yarnclean contendo:

*.yaml
*.md

Você então executa yarn install ou yarn autoclean --force. O processo de limpeza irá excluir todos os arquivos *.yaml and *.md dentro da pasta node_modules/ de forma recursiva (incluindo dependências transitivas aninhadas).