# homebrew-google-terminal-search Instale google-terminal-search com um único comando brew — tap oficial do autor. - URL: https://fernando.moretes.com/open-source/homebrew-google-terminal-search - Markdown: https://fernando.moretes.com/open-source/homebrew-google-terminal-search/guide.md?lang=pt - GitHub: https://github.com/fernandofatech/homebrew-google-terminal-search - Homepage: https://fernando.moretes.com - Language: Ruby - Topics: cli, developer-tools, homebrew, homebrew-tap, moretes, package-manager, portfolio, ruby - Stars: 1 - Forks: 0 - Updated: 2026-05-16T01:15:09Z --- Este repositório é o Homebrew tap oficial para o google-terminal-search — ele não contém a ferramenta em si, mas a fórmula Ruby que permite instalar, atualizar e remover o binário via `brew` em qualquer Mac. ## O que é um Homebrew tap e por que este existe O Homebrew resolve dependências de fórmulas que vivem em repositórios Git com uma convenção de nomenclatura específica: `homebrew-`. Quando você executa `brew tap fernandofatech/google-terminal-search`, o Homebrew clona este repositório em `$(brew --repository)/Library/Taps/fernandofatech/` e passa a enxergar todas as fórmulas dentro dele como candidatas ao `brew install`. Este tap existe por uma razão prática: o `google-terminal-search` não está no repositório central do Homebrew (`homebrew/core`), e submeter uma fórmula lá exige critérios de popularidade que uma ferramenta de portfólio pessoal dificilmente atende de imediato. Manter um tap próprio é a alternativa correta — dá controle total sobre o ciclo de release, sem depender de revisores externos ou de timelines do projeto upstream. A fórmula em si é um arquivo Ruby (`.rb`) que descreve de onde baixar o binário ou o código-fonte, qual o checksum esperado, quais dependências são necessárias e como instalar os artefatos no prefix do Homebrew. É o contrato entre o gerenciador de pacotes e o software distribuído. ## Estrutura e papel deste repositório no ecossistema Um tap minimalista como este tende a ter uma estrutura bastante enxuta. O que importa é a pasta `Formula/` contendo o arquivo `google-terminal-search.rb`. Esse arquivo é o único artefato funcional — todo o resto (README, badges, LICENSE) é documentação e metadado de portfólio. Este repositório faz parte de um ecossistema maior chamado **Fernando Moretes**, que reúne ferramentas de produtividade para desenvolvedores, automações e demonstrações de arquitetura. O tap é a camada de distribuição: ele não define o comportamento da ferramenta, apenas garante que qualquer pessoa com Homebrew instalado consiga obter a versão correta com um único comando, sem precisar compilar nada manualmente ou gerenciar PATH. Do ponto de vista de manutenção, quando uma nova versão do `google-terminal-search` é publicada, a atualização necessária aqui é mínima: trocar a URL do artefato e o SHA256 na fórmula. Isso torna o tap barato de manter e fácil de automatizar via CI se necessário no futuro. ## Como o tap funciona — fluxo de instalação Sequência de eventos desde o comando do usuário até o binário disponível no PATH. ### 💻 Developer Machine - Developer brew tap / install (user) - Homebrew CLI (edge) - Homebrew Prefix /usr/local or /opt/homebrew (storage) ### ☁️ GitHub (Remote) - homebrew-google- terminal-search (this repo) (external) - Formula/ google-terminal-search.rb (compute) - google-terminal-search release artifact / source (storage) ### Fluxos - user -> brew: brew tap + brew install - brew -> tap_repo: git clone do tap - tap_repo -> formula: lê fórmula Ruby - formula -> artifact: resolve URL + SHA256 - artifact -> brew: download + verificação - brew -> prefix: instala binário no prefix - prefix -> user: binário disponível no PATH ## Como instalar e usar 1. **Pré-requisito: Homebrew instalado** — Você precisa do Homebrew no macOS ou Linux. Se ainda não tiver: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` 2. **Adicionar o tap** — Registre este repositório como fonte de fórmulas no Homebrew. Isso só precisa ser feito uma vez por máquina. 3. **Instalar a ferramenta** — Com o tap registrado, instale o `google-terminal-search` normalmente. O Homebrew resolverá a fórmula deste tap automaticamente. 4. **Atualizar para novas versões** — Quando uma nova versão for publicada e a fórmula atualizada neste tap, basta rodar o upgrade padrão do Homebrew. 5. **Remover se necessário** — Desinstalar a ferramenta e, opcionalmente, remover o tap do registro local. _Sequência completa de instalação e uso_ ```bash # 1. Add the tap (once per machine) brew tap fernandofatech/google-terminal-search # 2. Install the tool brew install google-terminal-search # 3. Verify the installation google-terminal-search --version # 4. Upgrade when a new version is available brew update && brew upgrade google-terminal-search # 5. Uninstall the tool brew uninstall google-terminal-search # 6. (Optional) Remove the tap from local registry brew untap fernandofatech/google-terminal-search ``` ## O que este tap entrega - Instalação com um único comando — sem compilar manualmente, sem gerenciar PATH à mão. - Distribuição independente do `homebrew/core` — controle total sobre o ciclo de release. - Atualização nativa via `brew upgrade` — integrado ao fluxo padrão de manutenção do desenvolvedor. - Fórmula em Ruby seguindo as convenções do Homebrew — compatível com qualquer Mac (Intel e Apple Silicon). - Remoção limpa via `brew uninstall` — sem resíduos no sistema. > **Este repositório é o tap, não a ferramenta:** Se você está procurando o código-fonte do `google-terminal-search` em si — a lógica de busca, a interface de terminal, os testes — esse código vive em um repositório separado. Este repositório contém apenas a fórmula de distribuição Homebrew. A separação é intencional: mantém o ciclo de release da ferramenta desacoplado do mecanismo de distribuição. > **Quer criar seu próprio tap?:** A convenção é simples: crie um repositório público chamado `homebrew-`, adicione uma pasta `Formula/` com um arquivo `.rb` seguindo a DSL do Homebrew, e qualquer pessoa poderá instalar sua ferramenta com `brew tap / && brew install `. Este repositório serve como exemplo de referência para essa estrutura. ## Perguntas frequentes ### Funciona no Linux? O Homebrew tem suporte oficial ao Linux (Linuxbrew). Se a fórmula não tiver restrições de plataforma explícitas, o `brew install` deve funcionar. Dito isso, o foco principal é macOS. ### Como sei qual versão da ferramenta está sendo instalada? A versão está declarada na fórmula Ruby dentro deste repositório. Você pode inspecionar com `brew info fernandofatech/google-terminal-search/google-terminal-search` após adicionar o tap. ### Preciso clonar este repositório manualmente? Não. O `brew tap` clona o repositório automaticamente no diretório correto do Homebrew. O clone manual mostrado no README é apenas para quem quer inspecionar o código da fórmula diretamente. ### Como reportar um problema com a instalação? Abra uma issue neste repositório descrevendo o erro, a saída do `brew install --verbose` e a versão do Homebrew (`brew --version`). PRs com correções na fórmula também são bem-vindos. ## Para quem é este repositório Se você usa macOS e quer instalar o `google-terminal-search` sem atrito, este tap é o caminho certo — dois comandos e pronto. Se você é um desenvolvedor avaliando como estruturar a distribuição Homebrew de uma ferramenta própria, este repositório serve como referência concreta de um tap funcional e bem documentado. Não há complexidade oculta aqui: é exatamente o que parece — uma fórmula de distribuição mantida pelo autor da ferramenta, integrada ao ecossistema de portfólio público Fernando Moretes. ## Referências - [homebrew-google-terminal-search — GitHub](https://github.com/fernandofatech/homebrew-google-terminal-search) - [Fernando Azevedo — Portfolio](https://fernando.moretes.com) - [Homebrew — How to Create and Maintain a Tap](https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap) - [Homebrew Formula Cookbook](https://docs.brew.sh/Formula-Cookbook) ## Links - [GitHub repository](https://github.com/fernandofatech/homebrew-google-terminal-search) - [Homepage](https://fernando.moretes.com)