homebrew-google-terminal-search

O google-terminal-search é uma ferramenta de linha de comando minha para pesquisar no Google sem sair do terminal. Ele mora em outro repositório; este aqui não tem uma linha da ferramenta em si. O que tem é a fórmula: um arquivo Ruby que diz ao Homebrew de onde baixar a versão publicada, como verificar o sha256 do artefato, quais dependências resolver e onde colocar o binário no PATH.

A razão de existir é de manutenção, não de conveniência. Instalar uma CLI por git clone funciona no primeiro dia; no décimo mês ninguém lembra onde está o clone, qual versão está rodando nem se o alias no .zshrc ainda aponta para o lugar certo. Toda ferramenta que eu uso todo dia paga esse custo — a diferença é se ele fica visível ou não.

Com um tap, o Homebrew passa a ser o dono do ciclo de vida: brew install instala, brew upgrade atualiza, brew uninstall remove sem deixar resto, e brew list --versions responde "qual versão está aqui?" em uma linha. A fórmula é o contrato entre o repositório da ferramenta e a máquina de quem instala. Separar a fórmula em repositório próprio é convenção do Homebrew — o tap precisa ser um repositório Git cujo conteúdo o brew consegue clonar e ler sozinho.

Uma fórmula Homebrew é uma classe Ruby que herda de Formula. Os campos que fazem o trabalho: url aponta para o artefato de uma versão específica (tarball do release ou tag do Git), sha256 fixa o hash que o download precisa bater, depends_on declara o que precisa existir antes, e install diz para onde vai cada arquivo — normalmente bin.install "google-terminal-search". Um bloco test do fecha o ciclo: brew test executa a ferramenta instalada e falha se ela não responder.

Segurança: o sha256 é o que impede instalar um artefato trocado. Se o hash não bate, o Homebrew aborta antes de executar qualquer coisa. Por isso uma fórmula nunca deveria apontar para main sem hash — o "sempre pega o último" custa a garantia de que o que instalou é o que foi publicado.

Versionamento: a versão que a fórmula instala é a que está escrita nela. Subir a ferramenta não atualiza este tap sozinho; alguém — ou um workflow — precisa trocar url e sha256 e abrir commit. É o custo de manutenção real deste repositório: pequeno por release, mas recorrente.

Pipeline: o repositório segue as convenções do platform — branch <tipo>/<escopo>, Conventional Commits, versão derivada dos commits. O pr-lint, o CI e a checagem de segurança vêm de workflows reutilizáveis; corrigir a régua é mudar um arquivo lá, não aqui.