Taps (сторонние репозитории)

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

Команда brew tap

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

  $ brew tap
  petere/postgresql

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

• Команда 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.

• Команда 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-», когда это необходимо.

Формулы с одинаковыми именами

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

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

• формулы из core
• формулы из других подключённых репозиториев

Если необходимо установить формулу из определённого подключённого репозитория, укажите её полное имя.

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

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

Поэтому мы рекомендуем давать пользовательским формулам новые имена, чтобы их было проще устанавливать. Обратите внимание: заменить зависимости формул из core зависимостями из других подключённых репозиториев намеренно невозможно.