Taps (Репозитории сторонних разработчиков)

Команда brew tap добавляет дополнительные репозитории в список формул, которые Homebrew отслеживает, обновляет и устанавливает. По умолчанию, tap предполагает, что репозитории находятся на GitHub, но команда не ограничена каким-либо конкретным местом.

Команда brew tap

• brew tap без аргументов выводит список всех текущих подключённых репозиториев. Например:

  $ brew tap
  homebrew/cask
  homebrew/core
  petere/postgresql

• brew tap <user/repo> создаёт копию репозитория по адресу https://github.com/<user>/homebrew-<repo> в $(brew --repository)/Library/Taps. После этого, brew сможет работать с этими формулами так, как если бы они находились в каноническом репозитории Homebrew homebrew/core. Вы можете устанавливать и удалять их с помощью brew [un]install, а формулы автоматически обновляются при запуске brew update. (Подробности о том, как brew tap обрабатывает имена репозиториев, см. ниже).

• brew tap <user/repo> <URL> создаёт копию репозитория по адресу URL. В отличие от версии с одним аргументом, URL не предполагается быть GitHub, и не обязательно должен быть HTTP. Поддерживаются любые расположения и протоколы, которые поддерживает Git, хотя для репозиториев, отличных от GitHub, требуется запуск brew tap --force-auto-update <user/repo> для включения автоматического обновления.

• brew tap --repair мигрирует подключенные формулы из структуры на основе символических ссылок в структуру на основе каталогов. (Этот шаг необходимо выполнить только один раз.)

• brew untap user/repo [user/repo user/repo ...] удаляет указанные подключения. Репозитории удаляются, и brew больше не будет знать о их формулах. brew untap может обрабатывать несколько удалений одновременно.

Правила именования репозиториев и предположения

На GitHub, ваш репозиторий должен быть назван homebrew-something для использования одноаргументной формы brew tap. Префикс “homebrew-“ не является необязательным. (Двухаргументная форма не имеет этого ограничения, но заставляет вас явно указать полный URL.)

Однако, при использовании brew tap в командной строке, вы можете опустить префикс “homebrew-“ в командах. То есть, brew tap username/foobar может быть использован как сокращение для полной версии: brew tap username/homebrew-foobar. brew автоматически добавит префикс “homebrew-“ всякий раз, когда это необходимо.

Формулы с дублирующимися именами

Если ваш tap содержит формулу, которая также присутствует в homebrew/core, это допустимо, но вам потребуется указать её полное квалифицированное имя в формате <user>/<repo>/<formula> для установки вашей версии.

Всякий раз, когда выполняется команда brew install foo, brew выбирает используемую формулу, выполняя поиск в следующем порядке:

• формулы core
• другие tap'ы

Если вам нужна формула, установленная из конкретного tap'а, вы можете использовать полные квалифицированные имена для обращения к ним.

Если вы создадите tap для альтернативной формулы vim, поведение будет следующим:

brew install vim                     # installs from homebrew/core
brew install username/repo/vim       # installs from your custom repository

В результате, мы рекомендуем давать новые имена настроенным формулам, если вы хотите облегчить их установку. Обратите внимание, что нет (намеренно) возможности заменить зависимости формул core формулами из других tap'ов.