homebrew-google-terminal-search

O google-terminal-search é um script Bash curto, sem dependências, que abre uma busca no Google a partir do terminal. Ele mora em outro repositório, o tool-google-terminal-search. Este aqui não tem código da ferramenta: tem só a receita de instalação.

A pergunta que importa não é "dá para instalar sem Homebrew?". Dá: basta copiar o arquivo para /usr/local/bin e dar chmod +x. A pergunta é como você atualiza isso daqui a seis meses em três máquinas. Script copiado à mão não tem versão, não tem hash e não tem upgrade. Cada máquina fica numa revisão diferente e ninguém sabe qual.

Com o tap, a versão instalada é a que a fórmula aponta, o download é conferido contra um sha256 fixo e brew upgrade resolve o resto. O custo de manter não é escrever a fórmula, que leva minutos. É lembrar de atualizar url e sha256 a cada release, e é isso que a esteira do repositório existe para tornar rotina.

Uma fórmula Homebrew é uma classe Ruby que herda de Formula. Quatro campos fazem o trabalho:

• url: aponta para o artefato de uma versão específica, uma tag ou tarball de release do repositório da ferramenta.
• sha256: o hash que o download precisa bater. Se o arquivo mudar no servidor, o brew aborta antes de executar qualquer coisa.
• depends_on: o que precisa existir antes. Num script Bash sem dependências, a lista tende a ser vazia.
• install: onde cada arquivo vai, tipicamente bin.install, que copia para a Cellar e cria o symlink no PATH.

O sha256 é o campo que mais importa e o que mais falha em silêncio. Fórmula apontando para main sem hash instala o que estiver no branch naquele minuto: duas máquinas que rodaram brew install em dias diferentes podem ter scripts diferentes sob a mesma versão. Por isso a fórmula precisa apontar para artefato imutável.

O tap é por natureza de terceiro: o brew não audita o conteúdo como faz com o homebrew-core. Quem instala confia em quem mantém. Abra o .rb antes de instalar; são poucas linhas e é o único jeito de saber o que vai rodar na sua máquina.

O repositório segue as convenções de fernandofatech/platform, as mesmas de todo o portfólio:

• Branch: <tipo>/<escopo>, com feat/, fix/, chore/ ou docs/.
• Commit e título de PR: Conventional Commits.
• Versão: sai dos commits. Ninguém escreve número de versão à mão.

A esteira (pr-lint, CI, segurança e release) vem dos workflows reutilizáveis do platform. Corrigir a régua é mudar um arquivo lá, não aqui. Para um repositório deste tamanho isso parece exagero, e seria, se fosse só um. Com dezenas de repositórios pequenos, a régua centralizada é o que impede cada um de ter um CI próprio meio quebrado que ninguém lembra de atualizar.

Antes de abrir PR mexendo na fórmula, rode localmente brew install --build-from-source google-terminal-search e brew audit --strict google-terminal-search. O audit pega o que passa no olho: hash faltando, URL sem HTTPS, campo fora de ordem.