mrg - ferramenta para corrigir a separação de jamo no macOS e remover arquivos de metadados diversos

mrg é um utilitário CLI usado para remover arquivos diversos gerados no macOS ou normalizar nomes de arquivos em Unicode.

Recursos do mrg

• Normalização NFC de nomes de arquivo Unicode (--bad-unicode): corrige o problema de separação de jamo.
• Remoção de arquivos .DS_Store (--ds-store): apaga os arquivos .DS_Store gerados quando uma pasta é visualizada no Finder.
• Remoção de arquivos ._* (--dot): remove os arquivos ._* usados pelo macOS para armazenar metadados, informações de indexação etc.

Características do mrg

• Suporte a cores ANSI: o mrg oferece cores bonitas no terminal. Com as cores, você pode verificar intuitivamente o estado dos diretórios. Claro, também é possível desativá-las com a variável de ambiente NO_COLOR.
• Relatórios de análise elegantes: ao escanear ou organizar com o mrg, ele fornece uma análise visualmente agradável dos resultados. Assim, você pode ver de relance o que o mrg escaneou e organizou.
• Relatórios de análise em JSON: além da análise bonita para humanos, também são fornecidas análises em formato JSON legíveis por máquina.
• API em Python: o mrg também pode ser usado como módulo Python. Com o módulo mrg do Python, você pode executar ou personalizar o mrg via Python.
• Sem dependências externas: em tempo de execução, o mrg não usa nenhuma biblioteca externa além das bibliotecas padrão do Python.

Instalação

Você pode instalar o mrg via Homebrew.

brew tap ilotoki0804/homebrew-mrg  
brew install mrg  

Se você usa uv, também pode instalar com uvx mrg.

Como usar

O mrg recebe um caminho como argumento básico. Para verificar um diretório, basta informar o caminho após o comando mrg, como abaixo.

mrg .  

Se você executar apenas isso, sem outros argumentos, ele entra no modo padrão de "escaneamento".
Nesse estado, nenhum arquivo é alterado; ele apenas inspeciona o estado do diretório e fornece o resultado da análise.

Para de fato organizar ou modificar arquivos, é preciso adicionar argumentos. Você pode organizar o diretório usando um ou mais dos seguintes argumentos.

• --dot: remove arquivos ._*. Por padrão, ele só remove arquivos com tamanho considerado normal e quando o arquivo correspondente existe.
• --bad-unicode: normaliza nomes de arquivos/pastas Unicode que não estejam em NFC.
• --ds-store: remove arquivos .DS_Store.

Por exemplo, para normalizar em NFC todos os arquivos e diretórios dentro do diretório ., você pode usar o comando abaixo.

mrg . --bad-unicode  

Se quiser executar --bad-unicode, --ds-store e --dot ao mesmo tempo, você pode usar a flag --all.

mrg . --all  

O nome mrg é uma sigla derivada de uma combinação entre macOS e uma expressão coreana para “lixo”, no sentido de limpar arquivos inúteis gerados no macOS.

Para a descrição completa, consulte o link. É uma ferramenta open source publicada sob Apache 2.0, e PRs, issues etc. são todos bem-vindos.

Documentação (coreano) / Documentação (inglês)