Spec-Zone.ru › Homebrew

brew(1) – Отсутствующий менеджер пакетов для macOS (или Linux)

СИНТЕЗ

brew --version
brew command [--verbose|-v] [options] [formula] …

ОПИСАНИЕ

Homebrew – самый простой и гибкий способ установки утилит UNIX, которых Apple не включила в macOS. Он также может устанавливать программное обеспечение, не упакованное для вашей дистрибуции Linux, в домашний каталог без необходимости sudo.

ТЕРМИНОЛОГИЯ

формула: определение пакета Homebrew, созданное из исходных кодов

каскад: определение пакета Homebrew, устанавливающее приложения macOS для родных платформ

кег: каталог назначения установки определённой версии формулы, например /usr/local/Cellar/foo/0.1

рейл: каталог, содержащий одну или несколько версионированных кегов, например /usr/local/Cellar/foo

только-кег: формула является только-кег, если она не является символической ссылкой в префикс Homebrew (например /usr/local)

погреб: каталог, содержащий один или несколько именованных рейлов, например /usr/local/Cellar

Caskroom: каталог, содержащий один или несколько именованных каскадов, например /usr/local/Caskroom

внешняя команда: brew подкоманда, определённая вне репозитория Homebrew/brew на GitHub

тап: каталог (и обычно репозиторий Git) формул, каскадов и/или внешних команд

бутылка: предварительно собранный кег, помещённый в погреб/рейл вместо сборки из исходных кодов

ОСНОВНЫЕ КОМАНДЫ

Полный список команд см. в разделе КОМАНДЫ.

С --verbose или --debug, многие команды выводят дополнительную информацию отладки. Обратите внимание, что эти параметры должны появляться только после команды.

Некоторые действия команд можно настроить с помощью переменных среды; см. раздел СРЕДА.

install formula

Установить formula.

formula обычно является именем формулы для установки, но у него есть другие синтаксисы, которые перечислены в разделе ОПРЕДЕЛЕНИЕ ФОРМУЛ.

uninstall formula

Удалить formula.

list

Вывести список всех установленных формул.

search [text|/text/]

Выполнить поиск подстроки в токенах каскада и именах формул для text. Если text обрамлено косыми чертами, оно интерпретируется как регулярное выражение. Поиск text расширен онлайн до homebrew/core и homebrew/cask. Если термин поиска не указан, выводятся все локально доступные формулы.

КОМАНДЫ

analytics [subcommand]

Управление анонимными аналитическими данными об использовании Homebrew. Подробнее см. https://docs.brew.sh/Analytics.

brew analytics [state]
Отображение текущего состояния аналитики Homebrew.

brew analytics (on|off)
Включить или выключить аналитику Homebrew соответственно.

brew analytics regenerate-uuid
Перегенерировать UUID, используемый для аналитики Homebrew.

autoremove [--dry-run]

Удалить формулы, которые были установлены только как зависимость другой формулы и больше не нужны.

  • -n, --dry-run: Вывести список того, что будет удалено, но не выполнять фактическое удаление.

casks

Вывод списка всех локально устанавливаемых каскадов, включая короткие имена.

cleanup [options] [formula|cask …]

Удаление устаревших файлов блокировки и устаревших загрузок для всех формул и каскадов, а также удаление старых версий установленных формул. Если заданы аргументы, выполняется только для указанных формул и каскадов. Удаляет все загрузки старше 120 дней. Это можно настроить с помощью HOMEBREW_CLEANUP_MAX_AGE_DAYS.

  • --prune: Удалить все файлы кэша, старше указанного days. Если нужно удалить всё, используйте --prune=all.
  • -n, --dry-run: Показать, что будет удалено, но не выполнять фактическое удаление.
  • -s: Очистить кэш, включая загрузки даже для последних версий. Обратите внимание, что загрузки для любых установленных формул или каскадов по-прежнему не будут удалены. Если вы хотите их тоже удалить: rm -rf "$(brew --cache)"
  • --prune-prefix: Очистить только ссылки и каталоги из префикса и не удалять другие файлы.

commands [--quiet] [--include-aliases]

Отображение списков встроенных и внешних команд.

  • -q, --quiet: Вывести только имена команд без заголовков категорий.
  • --include-aliases: Включить псевдонимы внутренних команд.

completions [subcommand]

Управление автоматическим подключением Homebrew к файлам внешнего завершения оболочки. Подробнее см. https://docs.brew.sh/Shell-Completion.

brew completions [state]
Отображение текущего состояния завершения Homebrew.

brew completions (link|unlink)
Подключить или отключить завершение Homebrew.

config, --config

Отображение информации о конфигурации Homebrew и системы, полезной для отладки. Если вы подаёте отчёт об ошибке, от вас потребуется предоставить эту информацию.

deps [options] [formula|cask …]

Отображение зависимостей для formula. Дополнительные параметры, специфичные для formula, могут быть добавлены к команде. При указании нескольких аргументов формулы выводится пересечение зависимостей для каждой формулы.

  • -n: Сортировать зависимости в топологическом порядке.
  • --1: Отобразить только зависимости на один уровень вниз, вместо рекурсии.
  • --union: Отобразить объединение зависимостей для нескольких formula, вместо пересечения.
  • --full-name: Вывести список зависимостей по полному имени.
  • --include-build: Включить зависимости :build для formula.
  • --include-optional: Включить зависимости :optional для formula.
  • --include-test: Включить зависимости :test для formula (не рекурсивно).
  • --skip-recommended: Пропустить зависимости :recommended для formula.
  • --include-requirements: Включить требования в дополнение к зависимостям для formula.
  • --tree: Отобразить зависимости как дерево. При указании нескольких аргументов формулы отобразить отдельные деревья для каждой формулы.
  • --graph: Отобразить зависимости как ориентированный граф.
  • --dot: Отобразить текстовое описание графа в формате DOT.
  • --annotate: Отметить любые зависимости от сборки, тестирования, опциональные или рекомендуемые зависимости как таковые в выводе.
  • --installed: Вывести список зависимостей для установленных в данный момент формул. Если указано formula, вывести только его зависимости, которые установлены в данный момент.
  • --all: Вывести список зависимостей для всех доступных формул.
  • --for-each: Переключиться в режим, используемый параметром --all, но вывести только зависимости для каждого предоставленного formula, одна формула в строке. Используется для отладки режима отображения --installed/--all.
  • --formula: Обрабатывать все именованные аргументы как формулы.
  • --cask: Обрабатывать все именованные аргументы как каскады.

desc [options] formula|cask|text|/regex/ […]

Отображение имени и однострочного описания formula. Описания формул кэшируются; кэш создаётся при первом поиске, делая этот поиск медленнее, чем последующие.

  • -s, --search: Поиск в именах и описаниях для text. Если text обрамлено косыми чертами, оно интерпретируется как регулярное выражение.
  • -n, --name: Поиск только в именах для text. Если text обрамлено косыми чертами, оно интерпретируется как регулярное выражение.
  • -d, --description: Поиск только в описаниях для text. Если text обрамлено косыми чертами, оно интерпретируется как регулярное выражение.
  • --formula: Обрабатывать все именованные аргументы как формулы.
  • --cask: Обрабатывать все именованные аргументы как каскады.

developer [subcommand]

Управление режимом разработчика Homebrew. Когда режим разработчика включён, brew update обновит Homebrew до последнего коммита на ветке master вместо последней стабильной версии вместе с некоторыми другими изменениями поведения.

brew developer [state]
Отображение текущего состояния режима разработчика Homebrew.

brew developer (on|off)
Включить или выключить режим разработчика Homebrew соответственно.

doctor, dr [--list-checks] [--audit-debug] [diagnostic_check …]

Проверка вашей системы на возможные проблемы. Завершит работу с ненулевым статусом, если будут обнаружены какие-либо потенциальные проблемы. Обратите внимание, что эти предупреждения используются только для помощи разработчикам Homebrew при отладке, если вы подаёте ошибку. Если всё, для чего вы используете Homebrew, работает нормально: не беспокойтесь и не подавайте ошибку; просто проигнорируйте это.

  • --list-checks: Вывести все методы аудита, которые можно запустить индивидуально, если они указаны в качестве аргументов.
  • -D, --audit-debug: Включить отладку и профилирование методов аудита.

fetch [options] formula|cask […]

Загрузка бутылки (если доступна) или исходных пакетов для formula и бинарных файлов для cask. Для файлов также выводится контрольная сумма SHA-256.

END_OF_DOCUMENT_MARKER
  • --bottle-tag: Загрузка бутылки для заданного тега.
  • --HEAD: Получение версии HEAD вместо стабильной версии.
  • -f, --force: Удаление предварительно кэшированной версии и повторное извлечение.
  • -v, --verbose: Выполнение подробной проверки VCS, если URL представляет VCS. Это полезно для проверки обновления кэша VCS.
  • --retry: Повторная попытка загрузки при сбое или повторная загрузка, если контрольная сумма предварительно кэшированной версии больше не совпадает.
  • --deps: Также загрузить зависимости для любых перечисленных formula.
  • -s, --build-from-source: Загрузка исходных пакетов вместо бутылки.
  • --build-bottle: Загрузка исходных пакетов (для последующего создания бутылок) вместо бутылки.
  • --force-bottle: Загрузка бутылки, если она существует для текущей или последней версии macOS, даже если она не будет использована во время установки.
  • --[no-]quarantine: Отключение/включение карантина загрузок (по умолчанию: включено).
  • --formula: Все именованные аргументы обрабатываются как формулы.
  • --cask: Все именованные аргументы обрабатываются как бочки.

formulae

Список всех локально устанавливаемых формул, включая короткие имена.

gist-logs [options] formula

Загрузка журналов неудачной сборки formula в новый Gist. Выводит сообщение об ошибке, если журналы не найдены.

  • --with-hostname: Включение хоста в Gist.
  • -n, --new-issue: Автоматическое создание новой проблемы в соответствующем репозитории GitHub после создания Gist.
  • -p, --private: Gist будет помечен как закрытый и не будет отображаться в списках, но будет доступен по ссылке.

home, homepage [--formula] [--cask] [formula|cask …]

Открытие домашней страницы formula или cask в браузере или домашней страницы Homebrew, если аргумент не указан.

  • --formula: Все именованные аргументы обрабатываются как формулы.
  • --cask: Все именованные аргументы обрабатываются как бочки.

info, abv [options] [formula|cask …]

Отображение краткой статистики вашей установки Homebrew.

Если предоставлена formula или cask, отобразить сводку информации о ней.

  • --analytics: Список глобальных аналитических данных Homebrew или, если указано, данных об ошибках установки и сборки для formula (при условии, что ни HOMEBREW_NO_ANALYTICS ни HOMEBREW_NO_GITHUB_API не установлены).
  • --days: Количество дней аналитических данных для извлечения. Значение для days должно быть 30, 90 или 365. По умолчанию 30.
  • --category: Тип аналитических данных для извлечения. Значение для category должно быть install, install-on-request или build-error; cask-install или os-version могут быть указаны, если formula не указано. По умолчанию install.
  • --github: Открыть страницу исходного кода GitHub для formula и cask в браузере. Для просмотра истории локально: brew log -p formula или cask
  • --json: Вывод JSON-представления. В настоящее время значение по умолчанию для version — v1 для formula. Для formula и cask используйте v2. См. документацию для примеров использования вывода JSON: https://docs.brew.sh/Querying-Brew
  • --installed: Вывод JSON установленных формул.
  • --all: Вывод JSON всех доступных формул.
  • --variations: Включение хэша вариаций в вывод JSON каждой формулы.
  • -v, --verbose: Отображение более подробных аналитических данных для formula.
  • --formula: Все именованные аргументы обрабатываются как формулы.
  • --cask: Все именованные аргументы обрабатываются как бочки.

install [options] formula|cask […]

Установка formula или cask. Дополнительные опции, специфичные для formula, могут быть добавлены к команде.

Если HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK не установлено, brew upgrade или brew reinstall будут выполнены для устаревших зависимостей и зависимостей с нарушенной связью соответственно.

Если HOMEBREW_NO_INSTALL_CLEANUP не установлено, brew cleanup будет выполнен для установленных формул или каждые 30 дней для всех формул.

Если HOMEBREW_NO_INSTALL_UPGRADE не установлено, brew install *formula* обновит formula, если оно уже установлено, но устарело.

  • -d, --debug: При сбое сборки открыть интерактивную сессию отладки с доступом к IRB или оболочке внутри временной директории сборки.
  • -f, --force: Установка формул без проверки предварительно установленных кег-только или не мигрированных версий. При установке бочек перезаписывать существующие файлы (исключаются бинарные файлы и ссылки, если они не из той же бочки).
  • -v, --verbose: Вывод этапов проверки и пост-установки.
  • --formula: Все именованные аргументы обрабатываются как формулы.
  • --ignore-dependencies: Неподдерживаемый флаг разработки Homebrew для пропуска установки любых зависимостей. Если зависимости отсутствуют, у формулы могут возникнуть проблемы. Если вы не разрабатываете Homebrew, рассмотрите настройку вашего PATH, а не использование этого флага.
  • --only-dependencies: Установка зависимостей со специфическими опциями, но без установки самой формулы.
  • --cc: Попытка компиляции с использованием указанного compiler, которое должно быть именем исполняемого файла компилятора, например, gcc-7 для GCC 7. Для использования clang от LLVM укажите llvm_clang. Для использования clang от Apple укажите clang. Этот параметр будет принимать только компиляторы, предоставляемые Homebrew или включённые в macOS. Не подавайте сообщения об ошибках, если у вас возникли проблемы при использовании этого параметра.
  • -s, --build-from-source: Компиляция formula из исходного кода, даже если бутылка предоставлена. Зависимости по-прежнему будут устанавливаться из бутылок, если они доступны.
  • --force-bottle: Установка из бутылки, если она существует для текущей или новейшей версии macOS, даже если она обычно не используется для установки.
  • --HEAD: Если formula определяет его, установить версию HEAD, т.е. main, trunk, unstable, master.
  • --fetch-HEAD: Загрузка репозитория upstream для обнаружения устаревания HEAD-установки формулы. В противном случае HEAD репозитория будет проверяться на обновления только при выпуске новой стабильной или тестовой версии.
  • --keep-tmp: Сохранение временных файлов, созданных во время установки.
  • --debug-symbols: Генерация отладочных символов при сборке. Исходный код будет сохранён в каталоге кэша.
  • --build-bottle: Подготовка формулы для последующего создания бутылки во время установки, пропуская шаги пост-установки.
  • --bottle-arch: Оптимизация бутылок для указанной архитектуры вместо самой старой архитектуры, поддерживаемой версией macOS, на которой построены бутылки.
  • --display-times: Вывод времени установки для каждого пакета в конце выполнения.
  • -g, --git: Создание репозитория Git, полезного для создания патчей к программному обеспечению.
  • --overwrite: Удаление файлов, которые уже существуют в префиксе во время создания ссылки.
  • --cask: Все именованные аргументы обрабатываются как бочки.
  • --[no-]binaries: Отключение/включение создания символьых ссылок на вспомогательные исполняемые файлы (по умолчанию: включено).
  • --require-sha: Требование к всем бочкам иметь контрольную сумму.
  • --[no-]quarantine: Отключение/включение карантина загрузок (по умолчанию: включено).
  • --skip-cask-deps: Пропуск установки зависимостей бочки.
  • --zap: Для использования с brew reinstall --cask. Удаление всех файлов, связанных с бочкой. Может удалить файлы, которые совместно используются между приложениями.

leaves [--installed-on-request] [--installed-as-dependency]

Список установленных формул, которые не являются зависимостями другой установленной формулы.

  • -r, --installed-on-request: Отображение только листьев, которые были установлены вручную.
  • -p, --installed-as-dependency: Отображение только листьев, которые были установлены в качестве зависимостей.

link, ln [options] installed_formula […]

Создание символических ссылок на все установленные файлы formula в префикс Homebrew. Это делается автоматически при установке формул, но может быть полезно для самостоятельных установок.

  • --overwrite: Удаление файлов, которые уже существуют в префиксе во время создания ссылки.
  • -n, --dry-run: Список файлов, которые будут связаны или удалены brew link --overwrite, без фактического связывания или удаления файлов.
  • -f, --force: Разрешение связи только формул кег.
  • --HEAD: Связывание версии HEAD формулы, если она установлена.

list, ls [options] [installed_formula|installed_cask …]

Список всех установленных формул и бочек.

Если указано formula, вывести сводку путей в его текущем кеге. Если указано cask, вывести его артефакты.

  • --formula: Список только формул или обработка всех именованных аргументов как формул.
  • --cask: Список только бочек или обработка всех именованных аргументов как бочек.
  • --full-name: Вывод формул с полными именами. Если не переданы --full-name, --versions или --pinned, другие параметры (т.е. -1, -l, -r и -t) передаются в ls(1), которая производит фактический вывод.
  • --versions: Отображение номера версии установленных формул или только указанных формул, если предоставлены formula.
  • --multiple: Отображение только формул с несколькими установленными версиями.
  • --pinned: Список только закреплённых формул или только указанных (закреплённых) формул, если предоставлены formula. См. также pin, unpin.
  • -1: Вывод по одной записи на строку. Это значение по умолчанию, когда вывод не направлен в терминал.
  • -l: Список формул и/или бочек в длинном формате. Не имеет эффекта, когда в качестве аргумента передано имя формулы или бочки.
  • -r: Изменение порядка сортировки формул и/или бочек на вывод самых старых записей в первую очередь.
  • -t: Сортировка формул и/или бочек по времени последнего изменения, выводя самые недавно изменённые первыми.

log [options] [formula|cask]

Показать git log для formula или cask, или показать журнал для репозитория Homebrew, если не указана формула или бочка.

  • -p, --patch: Также вывести патч из коммита.
  • --stat: Также вывести diffstat из коммита.
  • --oneline: Выводить только по одной строке на каждый коммит.
  • -1: Выводить только один коммит.
  • -n, --max-count: Выводить только указанное количество коммитов.
  • --formula: Обрабатывать все именованные аргументы как формулы.
  • --cask: Обрабатывать все именованные аргументы как бочки.

migrate [--force] [--dry-run] installed_formula […]

Переместить переименованные пакеты в новые имена, где formula - старые имена пакетов.

  • -f, --force: Обрабатывать установленные formula и предоставленные formula так, как будто они из тех же наборов инструментов, и всё равно их перемещать.
  • -n, --dry-run: Показать, что будет перемещено, но фактически ничего не перемещать.

missing [--hide=] [formula …]

Проверить указанные formula кеги на отсутствие зависимостей. Если formula не указаны, проверяются все кеги. Выход с ненулевым статусом, если какие-либо кеги имеют недостающие зависимости.

  • --hide: Действовать так, как будто ни один из указанных hidden не установлен. hidden должен быть списком формул, разделённых запятыми.

options [options] [formula …]

Показать опции установки, специфичные для formula.

  • --compact: Показать все параметры в одной строке, разделённые пробелами.
  • --installed: Показать параметры для формул, которые в настоящее время установлены.
  • --all: Показать параметры для всех доступных формул.
  • --command: Показать параметры для указанных command.

outdated [options] [formula|cask …]

Список установленных бочек и формул, для которых доступна обновлённая версия. По умолчанию информация о версии отображается в интерактивных оболочках и скрывается в противном случае.

  • -q, --quiet: Список только имён устаревших кегов (имеет приоритет над --verbose).
  • -v, --verbose: Включить подробную информацию о версии.
  • --formula: Список только устаревших формул.
  • --cask: Список только устаревших бочек.
  • --json: Вывод в формате JSON. Есть две версии: v1 и v2. v1 устарела и в настоящее время используется по умолчанию, если версия не указана. v2 выводит устаревшие формулы и бочки.
  • --fetch-HEAD: Загрузка репозитория upstream для определения устарелости установки формулы HEAD. В противном случае репозиторий HEAD будет проверяться на обновления только при выпуске новой стабильной или тестовой версии.
  • --greedy: Также включать устаревшие бочки с auto_updates true или version :latest.
  • --greedy-latest: Также включать устаревшие бочки, включая те, у которых version :latest.
  • --greedy-auto-updates: Также включать устаревшие бочки, включая те, у которых auto_updates true.

pin installed_formula […]

Закрепить указанные formula, предотвращая их обновление при выполнении команды brew upgrade formula. См. также unpin.

postinstall installed_formula […]

Повторить шаги пост-установки для formula.

readall [--aliases] [--syntax] [tap …]

Импортировать все элементы из указанного tap или из всех установленных наборов инструментов, если ни один не указан. Это может быть полезно для отладки проблем в рамках всех элементов при внесении значительных изменений в formula.rb, тестировании производительности загрузки всех элементов или проверке наличия проблем с Ruby у текущих формул/бочек.

  • --aliases: Проверить все символические ссылки псевдонима в каждом наборе инструментов.
  • --syntax: Проверить синтаксис всех Ruby-файлов Homebrew (если не передан *tap*).

reinstall [options] formula|cask […]

Удалить и затем переустановить formula или cask с использованием тех же параметров, что и при первоначальной установке, плюс любые дополнительные параметры, специфичные для formula.

Если HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK не установлено, brew upgrade или brew reinstall будут выполнены для устаревших зависимостей и зависимостей с нарушенной связью соответственно.

Если HOMEBREW_NO_INSTALL_CLEANUP не установлено, brew cleanup будет выполнено для переустановленных формул или, каждые 30 дней, для всех формул.

  • -d, --debug: При ошибке сборки откроется интерактивная сессия отладки с доступом к IRB или оболочке внутри временного каталога сборки.
  • -f, --force: Установка без проверки на наличие ранее установленных кегов только или не перемещённых версий.
  • -v, --verbose: Вывод шагов проверки и postinstall.
  • --formula: Обрабатывать все именованные аргументы как формулы.
  • -s, --build-from-source: Скомпилировать formula из исходного кода, даже если доступен образ.
  • -i, --interactive: Загрузить и применить патч к formula, затем открыть оболочку. Это позволяет пользователю запустить ./configure --help и, в противном случае, определить, как преобразовать пакет программного обеспечения в пакет Homebrew.
  • --force-bottle: Установить из образа, если он существует для текущей или новейшей версии macOS, даже если он обычно не используется для установки.
  • --keep-tmp: Сохранить временные файлы, созданные во время установки.
  • --debug-symbols: Генерировать символы отладки при сборке. Исходный код будет сохранён в кэше каталога.
  • --display-times: Печать времён установки каждой формулы в конце выполнения.
  • -g, --git: Создать репозиторий Git, полезный для создания патчей в программном обеспечении.
  • --cask: Обрабатывать все именованные аргументы как бочки.
  • --[no-]binaries: Отключить/включить связывание вспомогательных исполняемых файлов (по умолчанию: включено).
  • --require-sha: Требовать, чтобы все бочки имели контрольную сумму.
  • --[no-]quarantine: Отключить/включить карантин загрузок (по умолчанию: включено).
  • --skip-cask-deps: Пропустить установку зависимостей бочки.
  • --zap: Для использования с brew reinstall --cask. Удалить все файлы, связанные с бочкой. Возможно удаление файлов, которые используются совместно между приложениями.

search, -S [options] text|/regex/ […]

Выполнить поиск подстроки в токенах бочек и именах формул для text. Если text окружен слешами, он интерпретируется как регулярное выражение. Поиск text расширен онлайн до homebrew/core и homebrew/cask.

  • --formula: Поиск в сети и локально по формулам.
  • --cask: Поиск в сети и локально по бочкам.
  • --desc: Поиск формул с описанием, соответствующим text, и бочек с именем или описанием, соответствующим text.
  • --pull-request: Поиск GitHub pull запросов, содержащих text.
  • --open: Поиск только открытых GitHub pull запросов.
  • --closed: Поиск только закрытых GitHub pull запросов.
  • --repology: Поиск text в заданной базе данных.
  • --macports: Поиск text в заданной базе данных.
  • --fink: Поиск text в заданной базе данных.
  • --opensuse: Поиск text в заданной базе данных.
  • --fedora: Поиск text в заданной базе данных.
  • --archlinux: Поиск text в заданной базе данных.
  • --debian: Поиск text в заданной базе данных.
  • --ubuntu: Поиск text в заданной базе данных.

shellenv

Вывод инструкций экспорта. При запуске в оболочке эта установка Homebrew будет добавлена в ваш PATH, MANPATH, и INFOPATH.

Переменные HOMEBREW_PREFIX, HOMEBREW_CELLAR и HOMEBREW_REPOSITORY также экспортируются, чтобы избежать их многократного запроса. Для обеспечения идемпотентности данная команда не выводит ничего, когда директории bin и sbin Homebrew находятся соответственно на первом и втором месте в вашем PATH. Рассмотрите возможность добавления проверки вывода этой команды в ваши dotfiles (например, ~/.profile, ~/.bash_profile, или ~/.zprofile) с помощью: eval "$(brew shellenv)"

tap [options] [user/repo] [URL]

Добавить репозиторий формул.

Если аргументы не указаны, отобразятся все установленные добавления.

Если URL не указано, добавление репозитория формул с GitHub через HTTPS. Так как многие добавления размещаются на GitHub, эта команда является сокращением для brew tap user/repo https://github.com/user/homebrew-repo.

Если URL указано, добавление репозитория формул из любого источника, используя любой протокол передачи, который git(1) поддерживает. Однострочный формат tap упрощает, но и ограничивает. Эта двухстрочная команда не делает предположений, поэтому добавления могут быть клонированы из других источников, помимо GitHub, и с использованием других протоколов, помимо HTTPS, например, SSH, git, HTTP, FTP(S), rsync.

  • --[no-]force-auto-update: Автоматическое обновление добавления, даже если оно не размещено на GitHub. По умолчанию, автоматически обновляются только добавления с GitHub (по соображениям производительности).
  • --custom-remote: Установка или изменение добавления с пользовательским удалённым репозиторием. Полезно для зеркал.
  • --repair: Миграция формул добавления с ссылки на структуру каталогов.
  • --list-pinned: Отображение всех закреплённых добавлений.

tap-info [--installed] [--json] [tap …]

Показать подробную информацию об одном или нескольких tap.

Если имена tap не указаны, отобразятся краткие статистические данные для всех установленных добавлений.

  • --installed: Отобразить информацию обо всех установленных добавлениях.
  • --json: Вывод JSON представления tap. В настоящее время единственное допустимое значение для version — это v1. См. документацию для примеров использования вывода в формате JSON: https://docs.brew.sh/Querying-Brew

uninstall, remove, rm [options] installed_formula|installed_cask […]

Удалить formula или cask.

  • -f, --force: Удалить все установленные версии formula. Удалять, даже если cask не установлено, перезаписывать существующие файлы и игнорировать ошибки при удалении файлов.
  • --zap: Удалить все файлы, связанные с cask. Может удалить файлы, используемые совместно между приложениями.
  • --ignore-dependencies: Не завершать установку, даже если formula является зависимостью любой установленной формулы.
  • --formula: Все аргументы рассматривать как формулы.
  • --cask: Все аргументы рассматривать как casks.

unlink [--dry-run] installed_formula […]

Удалить символические ссылки на formula из префикса Homebrew. Это может быть полезно для временного отключения формулы: brew unlink formula && commands && brew link formula

  • -n, --dry-run: Отобразить файлы, которые будут удалены, без фактического удаления.

unpin installed_formula […]

Открепить formula, позволяя их обновлять brew upgrade formula. См. также pin.

untap [--force] tap […]

Удалить репозиторий формул.

  • -f, --force: Удалить даже если формулы или casks из этого добавления в настоящее время установлены.

update [options]

Получить самую новую версию Homebrew и всех формул с GitHub с помощью git(1) и выполнить все необходимые миграции.

  • --merge: Используйте git merge для применения обновлений (вместо git rebase).
  • --auto-update: Запустить при автоматических обновлениях (например, перед brew install). Пропускает некоторые более медленные шаги.
  • -f, --force: Всегда выполнять более медленную полную проверку обновления (даже если это не обязательно).

update-reset [repository …]

Получить и сбросить репозитории Homebrew и всех добавлений (или любой указанной repository) с помощью git(1) до их последних origin/HEAD.

Примечание: это уничтожит все ваши несохранённые или сохранённые изменения.

upgrade [options] [outdated_formula|outdated_cask …]

Обновить устаревшие casks и устаревшие, не закреплённые формулы с использованием тех же параметров, что и при их первоначальной установке, плюс любые добавленные параметры brew формулы. Если cask или formula указаны, обновляются только указанные cask или formula кеги (если они не закреплены; см. pin, unpin).

Если HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK не установлено, brew upgrade или brew reinstall будут запущены для устаревших зависимостей и зависимостей с нарушенной связью соответственно.

Если HOMEBREW_NO_INSTALL_CLEANUP не установлено, brew cleanup будет запущен для обновленных формул или, каждые 30 дней, для всех формул.

  • -d, --debug: При сбое компиляции открыть интерактивную сессию отладки с доступом к IRB или оболочке внутри временной директории сборки.
  • -f, --force: Устанавливать формулы без проверки наличия ранее установленных кег-только или не мигрированных версий. При установке casks перезаписывать существующие файлы (бинарные файлы и символические ссылки исключены, если они не из того же casks).
  • -v, --verbose: Вывести шаги проверки и послеустановки.
  • -n, --dry-run: Показать, что будет обновлено, но не выполнять обновление.
  • --formula: Все аргументы рассматривать как формулы. Если аргументы не указаны, обновляются только устаревшие формулы.
  • -s, --build-from-source: Компилировать formula из исходного кода, даже если доступна бутылка.
  • -i, --interactive: Скачать и применить исправление к formula, затем открыть оболочку. Это позволяет пользователю запустить ./configure --help и определить, как превратить пакет программного обеспечения в пакет Homebrew.
  • --force-bottle: Устанавливать из бутылки, если она существует для текущей или новой версии macOS, даже если она обычно не используется для установки.
  • --fetch-HEAD: Получить исходный репозиторий, чтобы определить, является ли текущая установка формулы устаревшей. В противном случае исходная точка репозитория будет проверяться на наличие обновлений только при выпуске новой стабильной или разработки.
  • --ignore-pinned: Установить успешный код выхода, даже если закреплённые формулы не обновлены.
  • --keep-tmp: Сохранить временные файлы, созданные во время установки.
  • --debug-symbols: Создавать отладочные символы во время сборки. Исходный код будет сохранён в каталоге кэша.
  • --display-times: Выводить время установки каждого пакета в конце выполнения.
  • --cask: Все аргументы рассматривать как casks. Если аргументы не указаны, обновляются только устаревшие casks.
  • --[no-]binaries: Отключить/включить связывание вспомогательных исполняемых файлов (по умолчанию: включено).
  • --require-sha: Требовать, чтобы у всех casks был контрольная сумма.
  • --[no-]quarantine: Отключить/включить проверку загрузок (по умолчанию: включено).
  • --skip-cask-deps: Пропустить установку зависимостей casks.
  • --greedy: Также включать casks с auto_updates true или version :latest.
  • --greedy-latest: Также включать casks с version :latest.
  • --greedy-auto-updates: Также включать casks с auto_updates true.

uses [options] formula […]

Отобразить формулы и casks, которые указывают formula в качестве зависимости; то есть, отобразить зависимости formula. При указании нескольких аргументов формулы отображается пересечение формул, использующих formula. По умолчанию, uses отображает все формулы и casks, которые указывают formula как необходимую или рекомендуемую зависимость для их стабильных сборок.

  • --recursive: Разрешить разрешение зависимостей более чем одного уровня.
  • --installed: Отобразить только формулы и casks, которые в настоящее время установлены.
  • --include-build: Включать все формулы, которые указывают formula как зависимость типа :build.
  • --include-test: Включать все формулы, которые указывают formula как зависимость типа :test.
  • --include-optional: Включать все формулы, которые указывают formula как зависимость типа :optional.
  • --skip-recommended: Пропустить все формулы, которые указывают formula как зависимость типа :recommended.
  • --formula: Отображать только формулы.
  • --cask: Отображать только casks.

--cache [options] [formula|cask …]

Отобразить кэш загрузок Homebrew. См. также HOMEBREW_CACHE.

Если formula указано, отобразить файл или каталог, используемый для кэширования formula.

  • -s, --build-from-source: Отобразить файл кэша, используемый при сборке из исходного кода.
  • --force-bottle: Отобразить файл кэша, используемый при заливке бутылки.
  • --bottle-tag: Отобразить файл кэша, используемый при заливке бутылки для данного тега.
  • --HEAD: Отобразить файл кэша, используемый при сборке из HEAD.
  • --formula: Отобразить только файлы кэша для формул.
  • --cask: Отобразить только файлы кэша для casks.

--caskroom [cask …]

Отобразить путь к Caskroom Homebrew.

Если указано cask, отобразить расположение в Caskroom, где будет установлен cask, без каких-либо версионированных каталогов в качестве последнего пути.

--cellar [formula …]

Отобразить путь к Cellar Homebrew. По умолчанию: $(brew --prefix)/Cellar, или если этот каталог не существует, $(brew --repository)/Cellar.

Если указано formula, отобразить расположение в Cellar, где будет установлен formula, без каких-либо версионированных каталогов в качестве последнего пути.

--env, environment [--shell=] [--plain] [formula …]

Сводка среды сборки Homebrew в виде простого списка.

Если вывод команды отправляется через конвейер и оболочка не указана, список форматируется для экспорта в bash(1), если не указан --plain.

  • --shell: Сгенерировать список переменных среды для указанной оболочки или --shell=auto, чтобы определить текущую оболочку.
  • --plain: Сгенерировать простой вывод даже при использовании конвейера.

--prefix [--unbrewed] [--installed] [formula …]

Отобразить путь установки Homebrew. По умолчанию:

  • macOS Intel: /usr/local
  • macOS ARM: /opt/homebrew
  • Linux: /home/linuxbrew/.linuxbrew

Если указано formula, отобразить расположение, где установлен или будет установлен formula.

  • --unbrewed: Список файлов в префиксе Homebrew, не установленных Homebrew.
  • --installed: Ничего не выводит и возвращает код ошибки, если formula не установлен.

--repository, --repo [tap …]

Отобразить расположение репозитория Homebrew в Git.

Если указано user/repo, отобразить расположение каталога таба user/repo.

--version, -v

Вывести номера версий Homebrew, Homebrew/homebrew-core и Homebrew/homebrew-cask (если подключён) в стандартный вывод.

КОМАНДЫ ДЛЯ РАЗРАБОТЧИКОВ

audit [options] [formula|cask …]

Проверить formula на соответствие стилю кодирования Homebrew. Это следует делать перед отправкой новой формулы или casks. Если не указаны formula|cask, проверяются все доступные локально формулы и casks, и проверки стиля пропускаются. Выход с ненулевым статусом, если обнаружены какие-либо ошибки.

  • --strict: Выполнить дополнительные, более строгие проверки стиля.
  • --git: Выполнить дополнительные, более медленные проверки стиля, проходящие по репозиторию Git.
  • --online: Выполнить дополнительные, более медленные проверки стиля, требующие подключения к сети.
  • --installed: Проверить только формулы и casks, которые в настоящее время установлены.
  • --new: Выполнить различные дополнительные проверки стиля, чтобы определить, подходит ли новая формула или cask для Homebrew. Это следует использовать при создании новых формул и подразумевает --strict и --online.
  • --[no-]appcast: Проверить appcast.
  • --token-conflicts: Проверить конфликты токенов.
  • --tap: Проверить формулы в заданном табе, указанном как user/repo.
  • --fix: Автоматически исправить нарушения стиля с помощью функции автоматической коррекции RuboCop.
  • --display-cop-names: Включить имя RuboCop cop для каждого нарушения в выводе.
  • --display-filename: Префикс каждой строки вывода именем проверяемого файла или формулы, чтобы упростить поиск по выводу.
  • --display-failures-only: Отобразить только casks, которые не прошли проверку. По умолчанию для формул.
  • --skip-style: Пропустить выполнение проверок стиля, не являющихся RuboCop. Полезно, если вы планируете выполнять brew style отдельно. Включено по умолчанию, если формула не указана по имени.
  • -D, --audit-debug: Включить отладку и профилирование методов проверки.
  • --only: Указать список методов через запятую, чтобы выполнить только методы, указанные как audit_method.
  • --except: Указать список методов через запятую, чтобы пропустить выполнение методов, указанных как audit_method.
  • --only-cops: Указать список RuboCop cops через запятую, для проверки только указанных RuboCop cop.
  • --except-cops: Указать список RuboCop cops через запятую, для пропуска проверки указанных RuboCop cops.
  • --formula: Все именованные аргументы рассматривать как формулы.
  • --cask: Все именованные аргументы рассматривать как casks.

bottle [options] installed_formula|file […]

Генерация бутылки (бинарного пакета) из формулы, установленной с помощью --build-bottle. Если формула определяет версию перестроения, она будет увеличена в сгенерированном DSL. Передача --keep-old попытается сохранить её исходное значение, в то время как --no-rebuild удалит её.

  • --skip-relocation: Не проверять, может ли бутылка быть помечена как переносимая.
  • --force-core-tap: Создать бутылку, даже если formula не в homebrew/core или в любых установленных табах.
  • --no-rebuild: Если формула указывает версию перестроения, удалить её из сгенерированного DSL.
  • --keep-old: Если формула указывает версию перестроения, попытаться сохранить её значение в сгенерированном DSL.
  • --json: Записать информацию о бутылке в JSON-файл, который может быть использован как значение для --merge.
  • --merge: Сгенерировать обновлённый блок бутылки для формулы и, по желанию, объединить его в файл формулы. Вместо имени формулы требуется путь к JSON-файлу, сгенерированному с помощью brew bottle --json formula.
  • --write: Записать изменения в файл формулы. Будет сгенерирована новая фиксация, если не указано --no-commit.
  • --no-commit: При указании --write, новая фиксация не будет сгенерирована после внесения изменений в файл формулы.
  • --only-json-tab: При указании --json, таб будет записан в JSON-файл, но не бутылка.
  • --committer: Указать имя и адрес коммитера в стандартном формате автора Homebrew.
  • --root-url: Использовать указанный URL в качестве корня URL бутылки вместо значения Homebrew по умолчанию.
  • --root-url-using: Использовать указанный класс стратегии загрузки для скачивания URL бутылки вместо значения Homebrew по умолчанию.

bump [options] [formula|cask …]

Отобразить устаревшие формулы brew и последнюю доступную версию. Если возвращённые текущая и версия livecheck отличаются или при запросе определённых формул, также отображается, открыт ли pull request, с URL.

  • --full-name: Вывести формулы/casks с полными именами.
  • --no-pull-requests: Не извлекать pull requests из GitHub.
  • --formula: Проверить только формулы.
  • --cask: Проверить только casks.
  • --open-pr: Открыть pull request для новой версии, если таковые не открыты.
  • --limit: Ограничить количество возвращаемых результатов пакетов.
  • --start-with: Буква или слово, по которому результаты пакетов должны сортироваться по алфавиту.

bump-cask-pr [options] cask

Создать pull request для обновления cask с новой версией.

Будет сделана попытка определить SHA-256, если значение не предоставлено пользователем.

  • -n, --dry-run: Вывести, что будет сделано, а не делать.
  • --write-only: Внести ожидаемые изменения в файлы без выполнения каких-либо действий Git.
  • --commit: При указании --write-only, сгенерировать новую фиксацию после внесения изменений в файл casks.
  • --no-audit: Не запускать brew audit перед открытием PR.
  • --online: Запустить brew audit --online перед открытием PR.
  • --no-style: Не запускать brew style --fix перед открытием PR.
  • --no-browse: Вывести URL pull request вместо открытия в браузере.
  • --no-fork: Не пытаться форкать репозиторий.
  • --version: Указать новую version для casks.
  • --message: Добавить message к стандартному сообщению pull request.
  • --url: Указать URL для новой загрузки.
  • --sha256: Указать контрольную сумму SHA-256 новой загрузки.
  • --fork-org: Использовать указанную организацию GitHub для форкинга.
  • -f, --force: Игнорировать дублирующиеся открытые PR.

bump-formula-pr [options] [formula]

Создать pull request для обновления formula с новым URL или новым тегом.

Если указан URL, также должна быть указана контрольная сумма SHA-256 новой загрузки. Будет сделана попытка определить SHA-256 и formula имя, если либо одно, либо оба значения не предоставлены пользователем.

Если указан tag, также должен быть указан Git коммит revision, соответствующий этому тегу. Будет сделана попытка определить revision, если значение не предоставлено пользователем.

Если указан version, будет сделана попытка определить URL и SHA-256 или tag и revision, если оба значения не предоставлены пользователем.

Примечание: Эта команда не может быть использована для перехода от формулы URL-и-SHA-256 к формуле тега-и-ревизии, и наоборот. Она должна использовать тот стиль спецификации, который уже используется формулой.

END_OF_DOCUMENT_MARKER
  • -n, --dry-run: Вывести, что будет выполнено, вместо фактического выполнения.
  • --write-only: Внести ожидаемые изменения в файл, не выполняя Git-действий.
  • --commit: При передаче --write-only, создать новый коммит после внесения изменений в файл формулы.
  • --no-audit: Не запускайте brew audit перед открытием запроса на вытягивание.
  • --strict: Запустите brew audit --strict перед открытием запроса на вытягивание.
  • --online: Запустите brew audit --online перед открытием запроса на вытягивание.
  • --no-browse: Вывести URL запроса на вытягивание вместо открытия в браузере.
  • --no-fork: Не пытаться создать форк репозитория.
  • --mirror: Использовать указанный URL в качестве зеркала URL. Если URL — это список URL, разделённых запятыми, будут добавлены несколько зеркал.
  • --fork-org: Использовать указанную организацию GitHub для форкинга.
  • --version: Использовать указанный version для переопределения значения, полученного из URL или тега. Обратите внимание, что --version=0 может быть использован для удаления существующего переопределения версии формулы, если оно стало избыточным.
  • --message: Добавить message к стандартному сообщению запроса на вытягивание.
  • --url: Указать URL для нового скачивания. Если указан URL, то также должен быть указан контрольная сумма SHA-256 нового скачивания.
  • --sha256: Указать контрольную сумму SHA-256 нового скачивания.
  • --tag: Указать новый git коммит tag для формулы.
  • --revision: Указать новый коммит revision, соответствующий указанному git tag или указанному version.
  • -f, --force: Игнорировать дублированные открытые запросы на вытягивание. Удалить все зеркала, если --mirror не был указан.
  • --python-package-name: Использовать указанный package-name при поиске Python-ресурсов для formula. Если имя пакета не указано, оно будет выведено из стабильного URL формулы.
  • --python-extra-packages: Включить эти дополнительные Python-пакеты при поиске ресурсов.
  • --python-exclude-packages: Исключить эти Python-пакеты при поиске ресурсов.

bump-revision [options] formula […]

Создать коммит для увеличения ревизии formula. Если ревизия отсутствует, будет добавлена «ревизия 1».

  • -n, --dry-run: Вывести, что будет выполнено, вместо фактического выполнения.
  • --remove-bottle-block: Удалить блок бутылки помимо увеличения ревизии.
  • --write-only: Внести ожидаемые изменения в файл, не выполняя Git-действий.
  • --message: Добавить message к стандартному сообщению коммита.

bump-unversioned-casks [options] cask|tap […]

Проверить все бочки с неверсионированными URL в заданном tap на наличие обновлений.

  • -n, --dry-run: Выполнить всё, кроме кеширования состояния и открытия запросов на вытягивание.
  • --limit: Максимальное время выполнения в минутах.
  • --state-file: Файл для кеширования состояния.

cat [--formula] [--cask] formula|cask

Отобразить исходный код formula или cask.

  • --formula: Обрабатывать все именованные аргументы как формулы.
  • --cask: Обрабатывать все именованные аргументы как бочки.

command command […]

Отобразить путь к файлу, используемому при вызове brew cmd.

contributions email|name [--repositories=]

Вклад в репозитории Homebrew для пользователя.

Первый аргумент — имя (например, «BrewTestBot») или адрес электронной почты (например, «brewtestbot@brew.sh»).

  • --repositories: Указать список репозиториев для поиска, разделённый запятыми (без пробелов). Поддерживаемые репозитории: brew, core, cask, aliases, autoupdate, bundle, command-not-found, test-bot, services, cask-drivers, cask-fonts и cask-versions. Пропуск этого флага или указание --repositories=all будет искать во всех репозиториях.
  • --from: Дата (в формате ISO-8601) для начала поиска вкладов.
  • --to: Дата (в формате ISO-8601) для окончания поиска вкладов.

create [options] URL

Сгенерировать формулу или, с --cask, бочку для загружаемого файла по адресу URL и открыть её в редакторе. Homebrew попытается автоматически определить имя и версию формулы, но если это не удастся, вам придётся создать свою собственную шаблон. Формула wget служит простым примером. Для полного API см.: https://rubydoc.brew.sh/Formula

  • --autotools: Создать базовый шаблон для сборки в стиле Autotools.
  • --cask: Создать базовый шаблон для бочки.
  • --cmake: Создать базовый шаблон для сборки в стиле CMake.
  • --crystal: Создать базовый шаблон для сборки в стиле Crystal.
  • --go: Создать базовый шаблон для сборки в стиле Go.
  • --meson: Создать базовый шаблон для сборки в стиле Meson.
  • --node: Создать базовый шаблон для сборки в стиле Node.
  • --perl: Создать базовый шаблон для сборки в стиле Perl.
  • --python: Создать базовый шаблон для сборки в стиле Python.
  • --ruby: Создать базовый шаблон для сборки в стиле Ruby.
  • --rust: Создать базовый шаблон для сборки в стиле Rust.
  • --no-fetch: Homebrew не загрузит URL в кэш и, следовательно, не добавит его SHA-256 в формулу, а также не проверит API GitHub для проектов GitHub (чтобы заполнить его описание и домашнюю страницу).
  • --HEAD: Указать, что URL указывает на репозиторий пакета, а не на файл.
  • --set-name: Явно установить name новой формулы или бочки.
  • --set-version: Явно установить version новой формулы или бочки.
  • --set-license: Явно установить license новой формулы.
  • --tap: Сгенерировать новую формулу в указанном тапе, указанном как user/repo.
  • -f, --force: Игнорировать ошибки для запрещённых имён формул и имён, затеняющих псевдонимы.

dispatch-build-bottle [options] formula […]

Собрать бутылки для этих формул с помощью GitHub Actions.

  • --tap: Целевой репозиторий тапа (по умолчанию: homebrew/core).
  • --timeout: Время ожидания сборки (в минутах, по умолчанию: 60).
  • --issue: Если указано, оставить комментарий к этому номеру вопроса, если задача завершится неудачно.
  • --macos: Версии macOS, для которых должна быть построена бутылка.
  • --workflow: Отправить указанный поток работы (по умолчанию: dispatch-build-bottle.yml).
  • --upload: Загрузить собранные бутылки.
  • --linux: Отправить бочку для Linux (используя GitHub runners).
  • --linux-self-hosted: Отправить бочку для Linux (используя самопальный runner).
  • --linux-wheezy: Использовать контейнер Debian Wheezy для сборки бутылки на Linux.

edit [options] [formula|cask …]

Открыть formula или cask в редакторе, заданном EDITOR или HOMEBREW_EDITOR, или открыть репозиторий Homebrew для редактирования, если формула не указана.

  • --formula: Обрабатывать все именованные аргументы как формулы.
  • --cask: Обрабатывать все именованные аргументы как бочки.
  • --print-path: Вывести путь к редактируемому файлу без открытия редактора.

extract [--version=] [--force] formula tap

Просмотреть историю репозитория, чтобы найти последнюю версию formula и создать копию в tap. В частности, команда создаст новый файл формулы по адресу tap/Formula/formula@version.rb. Если тап ещё не установлен, попытаться установить/клонировать тап перед продолжением. Для извлечения формулы из тапа, который не homebrew/core используйте его полную форму user/repo/formula.

  • --version: Извлечь указанную version версию formula вместо последней.
  • -f, --force: Перезаписать целевую формулу, если она уже существует.

formula formula […]

Отобразить путь, где находится formula.

generate-man-completions [--fail-if-not-changed]

Сгенерировать man-страницы и shell-дополнения Homebrew.

  • --fail-if-not-changed: Вернуть код ошибки, если в выходных данных man-страниц не обнаружено изменений. Это можно использовать для уведомления CI, когда man-страницы устарели. Кроме того, дата, используемая в новых man-страницах, будет соответствовать датам в существующих man-страницах (чтобы позволить сравнение без учёта даты).

install-bundler-gems [--groups=]

Установить Bundler-драгоценности Homebrew.

  • --groups: Устанавливает указанный список групп драгоценностей, разделённых запятыми (по умолчанию: последняя используемая).

irb [--examples] [--pry]

Запустить интерактивную оболочку Ruby Homebrew.

  • --examples: Показать несколько примеров.
  • --pry: Использовать Pry вместо IRB. Предполагается, если HOMEBREW_PRY установлено.

linkage [options] [installed_formula …]

Проверить ссылки на библиотеки из указанных formula кегов. Если formula не указаны, проверяются все кеги. Вызывает ошибку, если выполняется на не установленных формулах.

  • --test: Показывать только отсутствующие библиотеки и завершать с ненулевым статусом, если обнаружены какие-либо отсутствующие библиотеки.
  • --strict: Завершать с ненулевым статусом, если обнаружены какие-либо неуказанные зависимости с привязкой.
  • --reverse: Для каждой библиотеки, на которую ссылается кег, выводить её путь dylib, а затем бинарники, которые к ней ссылаются.
  • --cached: Выводить кэшированные значения привязки, хранящиеся в HOMEBREW_CACHE, установленные предыдущей brew linkage операцией.

livecheck, lc [options] [formula|cask …]

Проверить наличие новых версий формул и/или бочек из исходного кода.

Если не указаны формула или бочка, список формул и бочек для проверки берется из HOMEBREW_LIVECHECK_WATCHLIST или ~/.brew_livecheck_watchlist.

  • --full-name: Выводить формулы/бочки с полными именами.
  • --tap: Проверять формулы/бочки внутри указанного репозитория, указанного как user/repo.
  • --all: Проверять все доступные формулы/бочки.
  • --installed: Проверять формулы/бочки, которые в настоящее время установлены.
  • --newer-only: Показывать только последнюю версию, если она новее, чем формула/бочка.
  • --json: Выводить информацию в формате JSON.
  • -q, --quiet: Скрыть предупреждения, не выводить индикатор выполнения для вывода JSON.
  • --formula: Проверять только формулы.
  • --cask: Проверять только бочки.

pr-automerge [options]

Найти запросы на вытягивание, которые могут быть автоматически объединены с помощью brew pr-publish.

  • --tap: Целевой репозиторий репозитория (по умолчанию: homebrew/core).
  • --workflow: Файл рабочего процесса для использования с brew pr-publish.
  • --with-label: Запросы на вытягивание должны иметь эту метку.
  • --without-labels: Запросы на вытягивание не должны иметь эти метки (по умолчанию: do not merge, new formula, automerge-skip).
  • --without-approval: Запросы на вытягивание не требуют утверждения для слияния.
  • --publish: Выполнить brew pr-publish для соответствующих запросов на вытягивание.
  • --no-autosquash: Инструктировать brew pr-publish пропустить автоматическую переформатирование и переформулирование коммитов в запросе на вытягивание в предпочитаемый формат.
  • --ignore-failures: Включать запросы на вытягивание, у которых есть неудачные проверки состояния.

pr-publish [options] pull_request […]

Опубликовать бутылки для запроса на вытягивание с GitHub Actions. Требуется доступ для записи в репозиторий.

  • --no-autosquash: Пропустить автоматическую переформатирование и переформулирование коммитов в запросе на вытягивание в предпочитаемый формат, даже если это поддерживается в целевом репозитории.
  • --branch: Ветка для публикации (по умолчанию: master).
  • --message: Сообщение для включения при автоматическом объединении изменений номера ревизии, удалений и перестроек.
  • --tap: Целевой репозиторий репозитория (по умолчанию: homebrew/core).
  • --workflow: Целевое имя файла рабочего процесса (по умолчанию: publish-commit-bottles.yml).

pr-pull [options] pull_request […]

Загрузить и опубликовать бутылки и применить коммит бутылки из запроса на вытягивание с артефактами, сгенерированными GitHub Actions. Требуется доступ для записи в репозиторий.

  • --no-upload: Загрузить бутылки, но не загружать их.
  • --no-commit: Не генерировать новый коммит перед загрузкой.
  • -n, --dry-run: Вывести, что будет сделано, а не делать это.
  • --clean: Не изменять коммиты из запросов на вытягивание.
  • --keep-old: Если формула указывает версию перестройки, попытаться сохранить её значение в сгенерированном DSL.
  • --no-autosquash: Пропустить автоматическую переформатирование и переформулирование коммитов в запросе на вытягивание в наш предпочитаемый формат.
  • --branch-okay: Не предупреждать, если происходит вытягивание в ветку помимо основной ветки репозитория (полезно для тестирования).
  • --resolve: При неудачном применении исправления, оставаться в процессе и разрешить пользователю его исправить, вместо прерывания.
  • --warn-on-upload-failure: Выводить предупреждение вместо возникновения ошибки, если загрузка бутылки завершилась неудачно. Полезно для исправления ранее неудачных загрузок бутылок.
  • --committer: Указать имя и адрес электронной почты автора в стандартном формате автора git.
  • --message: Сообщение для включения при автоматическом объединении изменений номера ревизии, удалений и перестроек.
  • --artifact: Загружать артефакты с указанным именем (по умолчанию: bottles).
  • --tap: Целевой репозиторий репозитория (по умолчанию: homebrew/core).
  • --root-url: Использовать указанный URL как корень URL бутылки вместо стандартного корня Homebrew.
  • --root-url-using: Использовать указанный класс стратегии загрузки для загрузки URL бутылки вместо стандартного класса Homebrew.
  • --workflows: Получить артефакты из указанного рабочего процесса (по умолчанию: tests.yml). Может быть перечислено через запятую для включения нескольких рабочих процессов.
  • --ignore-missing-artifacts: Список рабочих процессов, которые можно игнорировать, если они не были выполнены.

pr-upload [options]

Применить коммит бутылки и опубликовать бутылки на хост.

  • --keep-old: Если формула указывает версию перестройки, попытаться сохранить её значение в сгенерированном DSL.
  • -n, --dry-run: Вывести, что будет сделано, а не делать это.
  • --no-commit: Не генерировать новый коммит перед загрузкой.
  • --warn-on-upload-failure: Выводить предупреждение вместо возникновения ошибки, если загрузка бутылки завершилась неудачно. Полезно для исправления ранее неудачных загрузок бутылок.
  • --upload-only: Пропустить выполнение brew bottle перед загрузкой.
  • --committer: Указать имя и адрес электронной почты автора в стандартном формате автора git.
  • --root-url: Использовать указанный URL как корень URL бутылки вместо стандартного корня Homebrew.
  • --root-url-using: Использовать указанный класс стратегии загрузки для загрузки URL бутылки вместо стандартного класса Homebrew.

prof [--stackprof] command […]

Запустить Homebrew с профайлером Ruby. Например, brew prof readall.

  • --stackprof: Использовать stackprof вместо ruby-prof (по умолчанию).

release [--major] [--minor]

Создать новый черновик выпуска Homebrew/brew с соответствующим номером версии и заметками к релизу.

По умолчанию brew release будет увеличивать номер патча версии. Передайте --major или --minor для увеличения номера основной или дополнительной версии соответственно. Команда завершится ошибкой, если предыдущий выпуск основной или дополнительной версии был сделан менее чем месяц назад.

Требуется доступ для записи в репозиторий Homebrew/brew.

  • --major: Создать выпуск основной версии.
  • --minor: Создать выпуск дополнительной версии.

rubocop

Устанавливает, настраивает и запускает rubocop Homebrew.

ruby [options] (-e text|file)

Запустить экземпляр Ruby с загруженными библиотеками Homebrew. Например, brew ruby -e "puts :gcc.f.deps" или brew ruby script.rb.

  • -r: Загрузить библиотеку, используя require.
  • -e: Выполнить указанную текстовую строку как скрипт.

sh [--env=] [--cmd=] [file]

Войти в интерактивную оболочку для среды сборки Homebrew. Используйте многолетнюю отработанную логику сборки, чтобы помочь вашим ./configure && make && make install и даже вашим gem install преуспеть. Особенно удобно, если вы запускаете Homebrew только в конфигурации Xcode, так как он добавляет такие инструменты, как make, в ваши PATH, которые системы сборки иначе не найдут.

  • --env: Использовать стандартную PATH вместо superenv, когда std передается.
  • -c, --cmd: Выполнить команды в неинтерактивной оболочке.

sponsors

Обновить список спонсоров GitHub в Homebrew/brew README.

style [options] [file|tap|formula|cask …]

Проверить формулы или файлы на соответствие руководящим принципам стиля Homebrew.

Списки file, tap и formula нельзя объединять. Если не указано ничего, style выполнит проверки стиля для всей библиотеки Homebrew, включая основной код и все формулы.

  • --fix: Автоматически исправить нарушения стиля с помощью функции автоматической коррекции RuboCop.
  • --display-cop-names: Включать имя RuboCop cop для каждого нарушения в выводе.
  • --reset-cache: Сбросить кэш RuboCop.
  • --formula: Обрабатывать все именованные аргументы как формулы.
  • --cask: Обрабатывать все именованные аргументы как бочки.
  • --only-cops: Указать список cops через запятую, чтобы проверять нарушения только указанных RuboCop cop.
  • --except-cops: Указать список cops через запятую, чтобы пропустить проверку нарушений указанных RuboCop cop.

tap-new [options] user/repo

Сгенерировать шаблонные файлы для нового репозитория.

  • --no-git: Не инициализировать Git-репозиторий для репозитория.
  • --pull-label: Имя метки для запросов на вытягивание, готовых к вытягиванию (по умолчанию: pr-pull).
  • --branch: Инициализировать Git-репозиторий и настроить рабочие процессы GitHub Actions с указанной веткой (по умолчанию: main).
  • --github-packages: Загрузить бутылки в GitHub Packages.

test [options] installed_formula […]

Запустите метод тестирования, предоставленный установленной формулой. Стандартный вывод или код возврата отсутствуют, но, как правило, пользователь должен быть уведомлен, если с установленной формулой что-то не так.

Пример: brew install jruby && brew test jruby

  • -f, --force: Тестировать формулы, даже если они не связаны.
  • --HEAD: Тестировать версию заголовка формулы.
  • --keep-tmp: Сохранить временные файлы, созданные для тестирования.
  • --retry: Повторно выполнить тест, если он завершился неудачно.

tests [options]

Запустить модульные и интеграционные тесты Homebrew.

  • --coverage: Сгенерировать отчеты о покрытии кода.
  • --generic: Запустить только платформонезависимые тесты.
  • --no-compat: Не загружать совместимый слой при запуске тестов.
  • --online: Включить тесты, использующие API GitHub, и тесты, использующие любые из репозиториев для официальных внешних команд.
  • --byebug: Включить отладку с использованием byebug.
  • --changed: Запустить только тесты файлов, изменённых с момента основного разветвления.
  • --only: Запустить только test_script_spec.rb. Добавление :line_number позволит начать с указанной строки.
  • --seed: Случайное выполнение тестов со заданным value вместо случайного начального значения.

typecheck, tc [options]

Проверка ошибок проверки типов с помощью Sorbet.

  • --fix: Автоматически исправлять ошибки типов.
  • -q, --quiet: Скрыть все некритические ошибки.
  • --update: Обновить файлы RBI.
  • --all: Перегенерировать все файлы RBI, а не только обновлённые драгоценные камни.
  • --suggest-typed: Попытка обновления typed sigils.
  • --fail-if-not-changed: Возвратить код ошибки, если все драгоценные камни обновлены и определения драгоценных камней не требуют обновления tapioca.
  • --dir: Проверка типов всех файлов в определенной директории.
  • --file: Проверка типов одного файла.
  • --ignore: Игнорирует входные файлы, содержащие заданную строку в своих путях (относительно пути входа, переданного Sorbet).

unbottled [options] [formula …]

Показать неразливаемых зависимых формул.

  • --tag: Использовать указанную метку бутылки (например, big_sur) вместо текущей операционной системы.
  • --dependents: Пропустить получение аналитических данных и отсортировать по количеству зависимых элементов.
  • --all: Вывести количество неразливаемых и общих формул.

unpack [options] formula […]

Распаковать исходные файлы для formula в подкаталоги текущей рабочей директории.

  • --destdir: Создать подкаталоги в директории, указанной в path.
  • --patch: Исправления для formula будут применены к распакованному исходному коду.
  • -g, --git: Инициализировать репозиторий Git в распакованном исходном коде. Это полезно для создания исправлений для программного обеспечения.
  • -f, --force: Перезаписать целевую директорию, если она уже существует.

update-license-data [--fail-if-not-changed]

Обновить данные лицензий SPDX в репозитории Homebrew.

  • --fail-if-not-changed: Возвратить код ошибки, если версия текущих данных лицензии совпадает с версией upstream. Это можно использовать для уведомления CI, когда данные лицензии SPDX устарели.

update-maintainers

Обновить список разработчиков в Homebrew/brew README.

update-python-resources [options] formula […]

Обновить версии блоков ресурсов PyPI в formula.

  • -p, --print-only: Вывести обновлённые блоки ресурсов вместо изменения formula.
  • -s, --silent: Скрыть любой вывод.
  • --ignore-non-pypi-packages: Не завершать выполнение, если formula не является пакетом PyPI.
  • --version: Использовать указанное version при поиске ресурсов для formula. Если версия не указана, будет использована текущая версия для formula.
  • --package-name: Использовать указанное package-name при поиске ресурсов для formula. Если имя пакета не указано, оно будет определено из стабильного URL формулы.
  • --extra-packages: Включить эти дополнительные пакеты при поиске ресурсов.
  • --exclude-packages: Исключить эти пакеты при поиске ресурсов.

update-test [options]

Запустить тест brew update с новым клоном репозитория. Если не указаны параметры, использовать origin/master как начальную точку.

  • --to-tag: Установить HOMEBREW_UPDATE_TO_TAG для тестирования обновления между метками.
  • --keep-tmp: Сохранить временную директорию, содержащую новый клон репозитория.
  • --commit: Использовать указанное commit в качестве начальной точки.
  • --before: Использовать коммит по указанной date в качестве начальной точки.

vendor-gems [--update=]

Установить и зафиксировать сторонние драгоценные камни Homebrew.

  • --update: Обновить все сторонние драгоценные камни до последней версии.

ГЛОБАЛЬНЫЕ ПАРАМЕТРЫ ДЛЯ CASK

Эти параметры применимы к подкомандам install, reinstall, и upgrade с флагом --cask.

  • --appdir: Целевой каталог для приложений (по умолчанию: /Applications).

  • --colorpickerdir: Целевой каталог для выбора цвета (по умолчанию: ~/Library/ColorPickers).

  • --prefpanedir: Целевой каталог для панелей настроек (по умолчанию: ~/Library/PreferencePanes).

  • --qlplugindir: Целевой каталог для плагинов QuickLook (по умолчанию: ~/Library/QuickLook).

  • --mdimporterdir: Целевой каталог для плагинов Spotlight (по умолчанию: ~/Library/Spotlight).

  • --dictionarydir: Целевой каталог для словарей (по умолчанию: ~/Library/Dictionaries).

  • --fontdir: Целевой каталог для шрифтов (по умолчанию: ~/Library/Fonts).

  • --servicedir: Целевой каталог для сервисов (по умолчанию: ~/Library/Services).

  • --input-methoddir: Целевой каталог для методов ввода (по умолчанию: ~/Library/Input Methods).

  • --internet-plugindir: Целевой каталог для плагинов Интернета (по умолчанию: ~/Library/Internet Plug-Ins).

  • --audio-unit-plugindir: Целевой каталог для плагинов Audio Unit (по умолчанию: ~/Library/Audio/Plug-Ins/Components).

  • --vst-plugindir: Целевой каталог для плагинов VST (по умолчанию: ~/Library/Audio/Plug-Ins/VST).

  • --vst3-plugindir: Целевой каталог для плагинов VST3 (по умолчанию: ~/Library/Audio/Plug-Ins/VST3).

  • --screen-saverdir: Целевой каталог для экраносберегателей (по умолчанию: ~/Library/Screen Savers).

  • --language: Список кодов языков через запятую, которые следует предпочесть при установке cask. Используется первый соответствующий язык, в противном случае используется язык по умолчанию cask. Значение по умолчанию – язык вашей системы.

ГЛОБАЛЬНЫЕ ПАРАМЕТРЫ

Эти параметры применяются ко многим подкомандам.

  • -d, --debug: Отобразить информацию об отладке.

  • -q, --quiet: Сделать вывод более тихим.

  • -v, --verbose: Сделать вывод более подробным.

  • -h, --help: Отобразить это сообщение.

ОФИЦИАЛЬНЫЕ ВНЕШНИЕ КОМАНДЫ

alias [alias … | alias=command]

Показать существующие алиасы. Если алиасы не указаны, вывести весь список.

  • --edit: Редактировать алиасы в текстовом редакторе. Можно открыть один или все алиасы одновременно. Если указанный алиас не существует, он будет предварительно заполнен шаблоном.

autoupdate subcommand [interval] [options]

Простой и удобный способ автоматического обновления Homebrew.

Этот скрипт будет запускать brew update в фоновом режиме раз в 24 часа (по умолчанию), пока явно не будет остановлен, используя launchd.

brew autoupdate start [interval] [options]
Начать автоматическое обновление раз в interval часа или раз в 24 часа. Обратите внимание, что интервал должен быть передан в секундах, поэтому 12 часов – это brew autoupdate start 43200. Передайте --upgrade или --cleanup для автоматического запуска brew upgrade и/или brew cleanup соответственно. Передайте --enable-notification для отправки уведомления о завершении процесса автоматического обновления успешно.

brew autoupdate stop
Остановить автоматическое обновление, но сохранить plist и журналы.

brew autoupdate delete
Отменить автоматическое обновление, удалить plist и журналы.

brew autoupdate status
Вывести текущий статус этого инструмента.

brew autoupdate version
Вывести текущую версию этого инструмента и краткий changelog.

  • --upgrade: Автоматически обновлять установленные формулы. Если Caskroom существует локально, Casks также будут обновлены. Должно передаваться с start.
  • --greedy: Обновить casks с помощью –greedy (включая автообновляемые casks). Должно передаваться с start.
  • --cleanup: Автоматически очищать кэш и журналы brew. Должно передаваться с start.
  • --enable-notification: Отправить уведомление о завершении процесса автоматического обновления успешно, если terminal-notifier установлен и найден. Должно передаваться с start. <ПРИМЕЧАНИЕ: Уведомления включены по умолчанию на macOS Catalina и новее.>
  • --immediate: Немедленно запустить команду autoupdate вместо ожидания прохождения интервала (по умолчанию 24 часа). Должно передаваться с start.

bundle [subcommand]

Bundler для зависимостей, не относящихся к Ruby, из Homebrew, Homebrew Cask, Mac App Store и Whalebrew.

brew bundle [install]
Установить и обновить (по умолчанию) все зависимости из Brewfile.

Вы можете указать расположение Brewfile с помощью --file или задав переменную окружения HOMEBREW_BUNDLE_FILE.

Вы можете пропустить установку зависимостей, добавив значения, разделенные пробелами, в одну или несколько из следующих переменных окружения: HOMEBREW_BUNDLE_BREW_SKIP, HOMEBREW_BUNDLE_CASK_SKIP, HOMEBREW_BUNDLE_MAS_SKIP, HOMEBREW_BUNDLE_WHALEBREW_SKIP, HOMEBREW_BUNDLE_TAP_SKIP.

brew bundle выведет Brewfile.lock.json в той же директории, что и Brewfile, если все зависимости успешно установлены. Этот файл содержит информацию о зависимостях и состоянии системы, что может быть полезно для отладки ошибок brew bundle и воссоздания состояния «последней успешной сборки». Вы можете отключить это поведение, задав переменную окружения HOMEBREW_BUNDLE_NO_LOCK или передав опцию --no-lock. Возможно, вам стоит добавить этот файл в систему управления версиями вместе с вашим Brewfile (или убедиться, что ваша система управления версиями его игнорирует, если вы предпочитаете полагаться на информацию об отладке с локальной машины).

brew bundle dump
Запишите все установленные casks/formulae/images/taps в Brewfile в текущей директории.

brew bundle cleanup
Удалите все зависимости, не перечисленные в Brewfile.

Этот рабочий процесс полезен для администраторов или тестировщиков, которые регулярно устанавливают множество формул.

brew bundle check
Проверьте, установлены ли все зависимости из Brewfile.

Это обеспечивает успешный код выхода, если всё обновлено, что делает его полезным для скриптов.

brew bundle list
Выведите список всех зависимостей, присутствующих в Brewfile.

По умолчанию отображаются только зависимости Homebrew.

brew bundle exec command
Запустите внешнюю команду в изолированной среде сборки на основе зависимостей Brewfile.

Эта очищенная среда сборки игнорирует не запрашиваемые зависимости, что гарантирует, что вещи, которые вы не указали в вашем Brewfile, не будут подхвачены командами, такими как bundle install, npm install, и т. д. Также будут добавлены флаги компилятора, которые помогут найти зависимости, доступные только в keg, такие как openssl, icu4c, и т. д.

  • --file: Прочтите Brewfile из этого расположения. Используйте --file=- для передачи в stdin/stdout.
  • --global: Прочтите Brewfile из ~/.Brewfile.
  • -v, --verbose: install выводит вывод команд по мере их выполнения. check перечисляет все отсутствующие зависимости.
  • --no-upgrade: install не будет запускать brew upgrade на устаревших зависимостях. Тем не менее, они могут быть обновлены brew install при необходимости.
  • -f, --force: dump перезаписывает существующий Brewfile. cleanup фактически выполняет свои операции очистки.
  • --cleanup: install выполняет операцию очистки, аналогично запуску cleanup --force.
  • --no-lock: install не будет выводить Brewfile.lock.json.
  • --all: list все зависимости.
  • --formula: list зависимости Homebrew.
  • --cask: list зависимости Homebrew Cask.
  • --tap: list зависимости tap.
  • --mas: list зависимости Mac App Store.
  • --whalebrew: list зависимости Whalebrew.
  • --describe: dump добавляет комментарий с описанием над каждой строкой, если зависимость не имеет описания.
  • --no-restart: dump не добавляет restart_service к формулам.
  • --zap: cleanup casks с использованием команды zap вместо uninstall.

command-not-found-init

Вывести инструкции по настройке хука command-not-found для вашей оболочки. Если вывод не направлен на tty, вывести соответствующий скрипт обработчика для вашей оболочки.

services [subcommand]

Управление фоновыми сервисами с помощью менеджера демонов macOS launchctl.

Если передать sudo, обработать /Library/LaunchDaemons (запущенные при загрузке). В противном случае обработать ~/Library/LaunchAgents (запущенные при входе в систему).

[sudo] brew services [list] (--json)
Вывести информацию обо всех управляемых сервисах для текущего пользователя (или root).

[sudo] brew services info (formula|--all|--json)
Вывести список всех управляемых сервисов для текущего пользователя (или root).

[sudo] brew services run (formula|--all)
Запустить сервис formula без регистрации запуска при входе в систему (или загрузке).

[sudo] brew services start (formula|--all|--file=)
Немедленно запустить сервис formula и зарегистрировать его для запуска при входе в систему (или загрузке).

[sudo] brew services stop (formula|--all)
Немедленно остановить сервис formula и удалить его из списка запуска при входе в систему (или загрузке).

[sudo] brew services kill (formula|--all)
Немедленно остановить сервис formula, но сохранить его в списке запуска при входе в систему (или загрузке).

[sudo] brew services restart (formula|--all)
Немедленно остановить (если необходимо) и запустить сервис formula и зарегистрировать его для запуска при входе в систему (или загрузке).

[sudo] brew services cleanup
Удалить все неиспользуемые сервисы.

  • --file: Используйте файл сервиса из этого расположения для start сервиса.
  • --all: Запустить subcommand для всех сервисов.
  • --json: Вывод в формате JSON.

test-bot [options] [formula]

Тестирует весь жизненный цикл изменения Homebrew в tap (Git-репозиторий). Например, для запроса на добавление GitHub Actions, который изменяет формулу brew test-bot, будет гарантировать, что система очищена и настроена для тестирования формулы, установка формулы, выполнение различных тестов и проверок на ней, создание бинарных пакетов (bottle) и тестирование формул, которые зависят от неё, чтобы убедиться, что эти изменения не сломают их.

Поддерживает только GitHub Actions в качестве поставщика CI. Это связано с тем, что Homebrew использует GitHub Actions, и он свободно доступен для публичного и частного использования с рабочими процессами macOS и Linux.

  • --dry-run: Вывести то, что будет сделано, а не делать.
  • --cleanup: Очистить все данные из директории Homebrew. Используйте с осторожностью!
  • --skip-setup: Не проверять, правильно ли настроена локальная система.
  • --build-from-source: Сборка из исходного кода вместо сборки бинарных пакетов (bottles).
  • --build-dependents-from-source: Сборка зависимостей из исходного кода вместо тестирования бинарных пакетов.
  • --junit: Сгенерировать файл результатов тестирования в формате JUnit XML.
  • --keep-old: Запустить brew bottle --keep-old для создания новых бинарных пакетов (bottles) для одной платформы.
  • --skip-relocation: Запустить brew bottle --skip-relocation для создания новых бинарных пакетов (bottles), которые не требуют перемещения (relocation).
  • --only-json-tab: Запустить brew bottle --only-json-tab для создания новых бинарных пакетов (bottles), которые не содержат вкладок (tab).
  • --local: Попросить Homebrew записывать подробные журналы в ./logs/ и установить $HOME в ./home/
  • --tap: Использовать Git-репозиторий указанного tap. По умолчанию используется основной tap для проверки синтаксиса.
  • --fail-fast: Немедленно завершить выполнение при возникновении ошибки.
  • -v, --verbose: Выводить вывод шагов тестирования в реальном времени. Имеет побочный эффект передачи вывода в виде исходных байтов, а не в кодировке UTF-8.
  • --test-default-formula: Использовать формулу для тестирования по умолчанию, если не строится tap и не указаны другие формулы.
  • --root-url: Использовать указанный URL в качестве корня URL бинарного пакета (bottle) вместо стандартного Homebrew.
  • --git-name: Установить имя автора/коммиттера Git на заданное имя.
  • --git-email: Установить адрес электронной почты автора/коммиттера Git на указанный адрес.
  • --publish: Опубликовать загруженные бинарные пакеты (bottles).
  • --skip-online-checks: Не передавать --online в brew audit и пропустить brew livecheck.
  • --skip-dependents: Не тестировать зависимые формулы.
  • --skip-recursive-dependents: Тестировать только прямые зависимые формулы.
  • --only-cleanup-before: Выполнить только предварительный шаг очистки. Требуется --cleanup.
  • --only-setup: Выполнить только шаг проверки настройки локальной системы.
  • --only-tap-syntax: Выполнить только шаг проверки синтаксиса tap.
  • --only-formulae: Выполнить только шаги для формул.
  • --only-formulae-detect: Выполнить только шаги обнаружения формул.
  • --only-formulae-dependents: Выполнить только шаги зависимостей формул.
  • --only-cleanup-after: Выполнить только заключительный шаг очистки. Требуется --cleanup.
  • --testing-formulae: Использовать эти формулы для тестирования вместо шагов обнаружения формул.
  • --added-formulae: Использовать эти добавленные формулы вместо шагов обнаружения формул.
  • --deleted-formulae: Использовать эти удаленные формулы вместо шагов обнаружения формул.
  • --skipped-or-failed-formulae: Использовать эти пропущенные или завершившиеся с ошибкой формулы из шагов для формул для шага зависимостей формул.

unalias alias […]

Удалить алиасы.

which-formula [--explain] command […]

Выводит формулу(ы), которая(ые) предоставляют данную команду.

  • --explain: Вывод объяснения того, как получить ‘cmd’, установив одну из предоставляющих формул.

which-update [options] [database]

Обновление базы данных для brew which-formula.

  • --stats: Вывод статистики о содержимом базы данных (количество команд и формул, список отсутствующих формул).
  • --commit: Сохранить изменения с помощью git.
  • --update-existing: Обновить записи в базе данных с устаревшими версиями формул.
  • --install-missing: Установить и обновить формулы, отсутствующие в базе данных и не имеющие бинарных пакетов (bottles).
  • --max-downloads: Указать максимальное количество формул для загрузки и обновления.

НАСТРОЕННЫЕ ВНЕШНИЕ КОМАНДЫ

Homebrew, как git(1), поддерживает внешние команды. Это исполняемые скрипты, расположенные где-то в PATH, имеющие имя brew-cmdname или brew-cmdname.rb, которые можно вызывать, как brew cmdname. Это позволяет создавать собственные команды, не изменяя внутренности Homebrew.

Инструкции по созданию собственных команд можно найти в документации: https://docs.brew.sh/External-Commands

УКАЗАНИЕ ФОРМУЛ

Многие команды Homebrew принимают один или несколько аргументов formula. Эти аргументы могут иметь несколько разных форм:

  • Имя формулы: например, git, node, wget.

  • Полное имя формулы из задействованного репозитория: Иногда формула из задействованного репозитория может конфликтовать с формулой в homebrew/core. Вы по-прежнему можете получить доступ к этим формулам, используя специальный синтаксис, например, homebrew/dupes/vim или homebrew/versions/node4.

  • Произвольный файл: Homebrew может устанавливать формулы из локального пути. Он может указывать на файл формулы или бутылку. Предполагайте относительные пути с префиксом ./ чтобы предотвратить их интерпретацию как имя формулы или задействованного репозитория.

УКАЗАНИЕ CASKS

Многие команды Homebrew Cask принимают один или несколько аргументов cask. Их можно указать так же, как аргументы formula, описанные в SPECIFYING FORMULAE выше.

СРЕДА

Обратите внимание, что переменные среды должны иметь установленное значение, чтобы быть обнаруженными. Например, выполните export HOMEBREW_NO_INSECURE_REDIRECT=1 , а не только export HOMEBREW_NO_INSECURE_REDIRECT.

  • HOMEBREW_ADDITIONAL_GOOGLE_ANALYTICS_ID
    Дополнительный идентификатор отслеживания Google Analytics для сбора аналитики поведения пользователей. Дополнительная информация: https://docs.brew.sh/Analytics

  • HOMEBREW_ARCH
    Только для Linux: передайте это значение в имя типа, представляющее -march опцию компилятора.

    По умолчанию: native.

  • HOMEBREW_ARTIFACT_DOMAIN
    Добавьте это значение в качестве префикса к всем URL-адресам скачивания, включая те, которые предназначены для библиотек. Например, HOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080 приведет к тому, что формула с URL https://example.com/foo.tar.gz будет скачиваться с адреса http://localhost:8080/https://example.com/foo.tar.gz. Для URL-адресов библиотек, однако, префикс заменяет домен. Это означает, что, например, https://ghcr.io/v2/homebrew/core/gettext/manifests/0.21 будет скачиваться с адреса http://localhost:8080/v2/homebrew/core/gettext/manifests/0.21

  • HOMEBREW_AUTO_UPDATE_SECS
    Выполнить brew update один раз каждые HOMEBREW_AUTO_UPDATE_SECS секунды перед некоторыми командами, например, brew install, brew upgrade и brew tap. В качестве альтернативы, полностью отключить автоматическое обновление с помощью HOMEBREW_NO_AUTO_UPDATE.

    По умолчанию: 300.

  • HOMEBREW_AUTOREMOVE
    Если установлено, вызовы brew cleanup и brew uninstall будут автоматически удалять неиспользуемые зависимые формулы, а если HOMEBREW_NO_INSTALL_CLEANUP не установлен, brew cleanup начнёт периодически запускать brew autoremove.

  • HOMEBREW_BAT
    Если установлено, использовать bat для команды brew cat.

  • HOMEBREW_BAT_CONFIG_PATH
    Использовать этот файл в качестве конфигурационного файла bat.

    По умолчанию: $HOME/.config/bat/config.

  • HOMEBREW_BAT_THEME
    Использовать эту тему bat для подсветки синтаксиса.

    По умолчанию: $BAT_THEME.

  • HOMEBREW_BOOTSNAP
    Если установлено, использовать Bootsnap для ускорения повторных вызовов brew. Безоперационная функция при использовании встроенной, перемещаемой версии Ruby Homebrew на macOS (так как она не работает).

  • HOMEBREW_BOTTLE_DOMAIN
    Использовать этот URL в качестве зеркала скачивания для библиотек. Если библиотеки на этом URL временно недоступны, будет использоваться стандартный домен библиотек в качестве резервного зеркала. Например, HOMEBREW_BOTTLE_DOMAIN=http://localhost:8080 приведет к тому, что все библиотеки будут скачиваться с префиксом http://localhost:8080/. Если библиотеки недоступны по адресу HOMEBREW_BOTTLE_DOMAIN, они будут скачаны со стандартного домена библиотек.

    По умолчанию: https://ghcr.io/v2/homebrew/core.

  • HOMEBREW_BREW_GIT_REMOTE
    Использовать этот URL в качестве удалённого ресурса Homebrew/brew git(1).

    По умолчанию: https://github.com/Homebrew/brew.

  • HOMEBREW_BROWSER
    Использовать этот браузер при открытии страниц проектов.

    По умолчанию: $BROWSER или стандартный браузер ОС.

  • HOMEBREW_CACHE
    Использовать эту директорию в качестве кэша скачиваний.

    По умолчанию: macOS: $HOME/Library/Caches/Homebrew, Linux: $XDG_CACHE_HOME/Homebrew или $HOME/.cache/Homebrew.

  • HOMEBREW_CASK_OPTS
    Добавить эти опции ко всем командам cask. Поддерживаются все опции --*dir, --language, --require-sha, --no-quarantine и --no-binaries. Например, вы можете добавить что-то вроде следующего в свой ~/.profile, ~/.bash_profile, или ~/.zshenv\n\n export HOMEBREW_CASK_OPTS="--appdir=~/Applications --fontdir=/Library/Fonts"

  • HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS
    Если установлено, brew install, brew upgrade и brew reinstall будут очищать все формулы после того, как пройдёт указанное количество дней.

    По умолчанию: 30.

  • HOMEBREW_CLEANUP_MAX_AGE_DAYS
    Очистить все кэшированные файлы, старше указанного количества дней.

    По умолчанию: 120.

  • HOMEBREW_COLOR
    В случае установки, принудительно использовать цветной вывод на выходах без TTY.

  • HOMEBREW_CORE_GIT_REMOTE
    Использовать этот URL в качестве удалённого ресурса Homebrew/homebrew-core git(1).

    По умолчанию: https://github.com/Homebrew/homebrew-core.

  • HOMEBREW_CURLRC
    Если установлено, не передавать --disable при вызове curl(1), что отключает использование curlrc.

  • HOMEBREW_CURL_PATH
    Только для Linux: установите это значение на достаточно новую curl исполняемую программу, чтобы Homebrew мог её использовать.

    По умолчанию: curl.

  • HOMEBREW_CURL_RETRIES
    Передать указанное количество попыток повторного подключения к --retry при вызове curl(1).

    По умолчанию: 3.

  • HOMEBREW_CURL_VERBOSE
    Если установлено, передать --verbose при вызове curl(1).

  • HOMEBREW_DEVELOPER
    Если установлено, скорректировать поведение, чтобы оно было более релевантным для разработчиков Homebrew (активных или начинающих), например, преобразовывая предупреждения в ошибки.

  • HOMEBREW_DISABLE_LOAD_FORMULA
    Если установлено, отказ от загрузки формул. Это полезно, когда формулы ненадёжны (например, в запросах на включение).

  • HOMEBREW_DISPLAY
    Использовать этот X11 дисплей при открытии страницы в браузере, например, с brew home. В основном полезно на Linux.

    По умолчанию: $DISPLAY.

  • HOMEBREW_DISPLAY_INSTALL_TIMES
    Если установлено, выводить время установки каждой формулы в конце выполнения.

  • HOMEBREW_EDITOR
    Использовать этот редактор при редактировании одной формулы или нескольких формул в одной директории.

    Примечание: brew edit откроет все файлы и каталоги Homebrew как отдельные файлы. Visual Studio Code может обработать это правильно в режиме проекта, но многие редакторы в этом случае могут действовать странно.

    По умолчанию: $EDITOR или $VISUAL.

  • HOMEBREW_FAIL_LOG_LINES
    Вывести столько строк вывода при сбое формулы system.

    По умолчанию: 15.

  • HOMEBREW_FORBIDDEN_LICENSES
    Список лицензий, разделённых пробелами. Homebrew откажется от установки формулы, если у неё или любой из её зависимостей есть лицензия из этого списка.

  • HOMEBREW_FORCE_BREWED_CA_CERTIFICATES
    Если установлено, всегда использовать установленную Homebrew версию ca-certificates вместо системной. Автоматически устанавливается, если системная версия слишком старая.

  • HOMEBREW_FORCE_BREWED_CURL
    Если установлено, всегда использовать установленную Homebrew версию curl(1) вместо системной версии. Автоматически устанавливается, если системная версия curl слишком старая.

  • HOMEBREW_FORCE_BREWED_GIT
    Если установлено, всегда использовать установленную Homebrew версию git(1) вместо системной. Автоматически устанавливается, если системная версия git слишком старая.

  • HOMEBREW_FORCE_VENDOR_RUBY
    Если установлено, использовать встроенную, перемещаемую версию Ruby Homebrew, даже если системная версия Ruby достаточно новая.

  • HOMEBREW_GITHUB_API_TOKEN
    Использовать этот личный токен доступа для API GitHub, для функций, таких как brew search. Вы можете создать его по адресу https://github.com/settings/tokens. При установке GitHub позволит вам совершать большее количество запросов API. Дополнительная информация: https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting

    Примечание: Homebrew не требует разрешений ни для одного из областей видимости, но некоторые команды разработчика могут потребовать дополнительные разрешения.

  • HOMEBREW_GITHUB_PACKAGES_TOKEN
    Использовать этот личный токен доступа к GitHub при доступе к реестру пакетов GitHub (где могут храниться библиотеки).

  • HOMEBREW_DOCKER_REGISTRY_BASIC_AUTH_TOKEN
    Использовать закодированное в base64 имя пользователя и пароль для аутентификации с прокси-сервером Docker реестра GitHub Packages. Если установлено HOMEBREW_DOCKER_REGISTRY_TOKEN, оно будет использоваться вместо этого.

  • HOMEBREW_DOCKER_REGISTRY_TOKEN
    Использовать этот токен bearer для аутентификации с прокси-сервером Docker реестра GitHub Packages. Предпочтительнее, чем HOMEBREW_DOCKER_REGISTRY_TOKEN_BASIC.

  • HOMEBREW_GITHUB_PACKAGES_USER
    Использовать это имя пользователя при доступе к реестру пакетов GitHub (где могут храниться библиотеки).

  • HOMEBREW_GIT_EMAIL
    Установить адрес электронной почты автора и коммитера Git на это значение.

  • HOMEBREW_GIT_NAME
    Установить имя автора и коммитера Git на это значение.

  • HOMEBREW_GIT_PATH
    Только для Linux: установите это значение на достаточно новую git исполняемую программу, чтобы Homebrew мог её использовать.

    По умолчанию: git.

  • HOMEBREW_INSTALL_BADGE
    Вывести этот текст перед сводкой установки каждого успешно собранного проекта.

    По умолчанию: Эмодзи «Пивная кружка».

  • HOMEBREW_INSTALL_FROM_API
    Если установлено, устанавливать формулы и бочки в репозиториях homebrew/core и homebrew/cask с помощью API Homebrew вместо необходимости (больших, медленных) локальных копий этих репозиториев.

    Примечание: Установка HOMEBREW_INSTALL_FROM_API несовместима с разработческим режимом Homebrew и вызовет ошибку (потому что Homebrew требует полную копию).

  • HOMEBREW_LIVECHECK_WATCHLIST
    Обратитесь к этому файлу, чтобы получить список формул, которые по умолчанию проверяются, когда аргумент формулы не передан команде brew livecheck.

    По умолчанию: $HOME/.brew_livecheck_watchlist

  • HOMEBREW_LOGS
    Использовать эту директорию для хранения журналов.

    По умолчанию: macOS: $HOME/Library/Logs/Homebrew, Linux: $XDG_CACHE_HOME/Homebrew/Logs или $HOME/.cache/Homebrew/Logs.

  • HOMEBREW_MAKE_JOBS
    Использовать это значение в качестве количества параллельных задач для выполнения при сборке с помощью make(1).

    По умолчанию: количество доступных ядер процессора.

  • HOMEBREW_NO_ANALYTICS
    Если установлено, не отправлять аналитику. Дополнительная информация: https://docs.brew.sh/Analytics

  • HOMEBREW_NO_AUTO_UPDATE
    Если установлено, не обновлять автоматически перед запуском некоторых команд, например, brew install, brew upgrade и brew tap. В качестве альтернативы, запускайте это реже, установив HOMEBREW_AUTO_UPDATE_SECS на значение больше, чем значение по умолчанию.

  • HOMEBREW_NO_BOOTSNAP
    Если установлено, не использовать Bootsnap для ускорения повторных вызовов brew.

  • HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK
    Если установлено, не проверять наличие проблем со связью зависимостей или устаревших зависимостей после установки, обновления или переустановки формул. Это приведёт к меньшему числу зависимостей (и их зависимостей) обновленных или переустановленных, но может привести к большему числу проблем от запуска brew install *formula* или brew upgrade *formula*.

  • HOMEBREW_NO_CLEANUP_FORMULAE
    Список формул, разделённых запятыми. Homebrew откажется от очистки или автоматического удаления формулы, если она присутствует в этом списке.

  • HOMEBREW_NO_COLOR
    Если установлено, не выводить текст с добавленным цветом.

    По умолчанию: $NO_COLOR.

  • HOMEBREW_NO_COMPAT
    Если установлено, отключить все использование кода обратной совместимости.

  • HOMEBREW_NO_EMOJI
    Если установлено, не выводить HOMEBREW_INSTALL_BADGE при успешной сборке.

    Примечание: Попытается вывести эмодзи только на OS X Lion и более новых версиях.

  • HOMEBREW_NO_ENV_HINTS
    Если установлено, не выводить подсказки об изменении поведения Homebrew с помощью переменных окружения.

  • HOMEBREW_NO_GITHUB_API
    Если установлено, не использовать API GitHub, например, для поиска или получения соответствующих проблем после неудачной установки.

  • HOMEBREW_NO_INSECURE_REDIRECT
    Если установлено, запретить перенаправления с защищенного HTTPS на небезопасный HTTP.

    Примечание: Хотя это обеспечивает полную безопасность загрузок, это, вероятно, приведет к сбоям в загрузке с исходных ресурсов SourceForge, некоторых формул, размещенных в GNU & GNOME.

  • HOMEBREW_NO_INSTALL_CLEANUP
    Если установлено, brew install, brew upgrade и brew reinstall никогда автоматически не будут очищать установленные/обновленные/переустановленные формулы или все формулы каждые HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS дней. В качестве альтернативы, HOMEBREW_NO_CLEANUP_FORMULAE позволяет указать конкретные формулы, которые не следует очищать.

  • HOMEBREW_NO_INSTALL_UPGRADE
    Если установлено, brew install *формула* не будет обновлять *формула* при наличии устаревшей версии.

  • HOMEBREW_PRY
    Если установлено, использовать Pry для команды brew irb.

  • HOMEBREW_SIMULATE_MACOS_ON_LINUX
    Если установлено, выполнение Homebrew на Linux будет моделировать определенные пути кода macOS. Это полезно при аудите формул macOS на Linux.

  • HOMEBREW_SSH_CONFIG_PATH
    Если установлено, Homebrew будет использовать указанный конфигурационный файл вместо ~/.ssh/config при извлечении git репозиториев через ssh.

    По умолчанию: $HOME/.ssh/config

  • HOMEBREW_SKIP_OR_LATER_BOTTLES
    Если установлено вместе с HOMEBREW_DEVELOPER, не использовать бутылки (bottles) из более старых версий macOS. Это полезно при разработке на новых версиях macOS.

  • HOMEBREW_SORBET_RUNTIME
    Если установлено, включить проверку типов во время выполнения с помощью Sorbet.

  • HOMEBREW_SVN
    Использовать этот файл в качестве svn(1) бинарника.

    По умолчанию: бинарник Subversion (если установлен), построенный Homebrew, или системный бинарник.

  • HOMEBREW_TEMP
    Использовать данный путь в качестве временной директории для сборки пакетов. Изменение этого может потребоваться, если временная директория системы и префикс Homebrew находятся на разных томах, так как macOS испытывает трудности с перемещением символических ссылок между томами, когда целевой объект ещё не существует. Эта проблема обычно возникает при использовании FileVault или пользовательских конфигураций SSD.

    По умолчанию: macOS: /private/tmp, Linux: /tmp.

  • HOMEBREW_UPDATE_REPORT_ALL_FORMULAE
    Если установлено, brew update отобразит изменения всех формул и файлов cask, а не только новые или устаревшие и установленные.

  • HOMEBREW_UPDATE_TO_TAG
    Если установлено, всегда использовать последнюю стабильную метку (даже если были выполнены команды разработчика).

  • HOMEBREW_VERBOSE
    Если установлено, всегда предполагать --verbose при выполнении команд.

  • HOMEBREW_DEBUG
    Если установлено, всегда предполагать --debug при выполнении команд.

  • HOMEBREW_VERBOSE_USING_DOTS
    Если установлено, подробный вывод будет печатать . не чаще, чем раз в минуту. Это может быть полезно, чтобы избежать завершения длительных команд Homebrew из-за отсутствия вывода.

  • all_proxy
    Использовать этот SOCKS5 прокси для curl(1), git(1) и svn(1) при загрузке через Homebrew.

  • ftp_proxy
    Использовать этот FTP прокси для curl(1), git(1) и svn(1) при загрузке через Homebrew.

  • http_proxy
    Использовать этот HTTP прокси для curl(1), git(1) и svn(1) при загрузке через Homebrew.

  • https_proxy
    Использовать этот HTTPS прокси для curl(1), git(1) и svn(1) при загрузке через Homebrew.

  • no_proxy
    Список хостов и доменных имен, разделенных запятыми, исключенных из проксирования curl(1), git(1) и svn(1) при загрузке через Homebrew.

  • SUDO_ASKPASS
    Если установлено, передать опцию -A при вызове sudo(8).

ИСПОЛЬЗОВАНИЕ HOMEBREW ЗА ПРОКСИ

Установите переменные окружения http_proxy, https_proxy, all_proxy, ftp_proxy и/или no_proxy, описанные выше.

Например, для использования аутентифицированного HTTP или SOCKS5 прокси:

export http_proxy=http://$HOST:$PORT

export all_proxy=socks5://$HOST:$PORT

И для аутентифицированного HTTP прокси:

export http_proxy=http://$USER:$PASSWORD@$HOST:$PORT

СМОТРИТЕ ТАКЖЕ

Документация Homebrew: https://docs.brew.sh

API Homebrew: https://rubydoc.brew.sh

git(1), git-log(1)

АВТОРЫ

Руководитель проекта Homebrew — Майк Маккуэйд.

Команда руководителей проекта Homebrew — Исси Лонг, Джонатан Чанг, Майк Маккуэйд, Мисти де Мео и Шон Молленаар.

Технический руководящий комитет Homebrew — Бо Андерсон, FX Кудер, Мишка Попофф, Майк Маккуэйд и Райлан Польстер.

Другие текущие разработчики Homebrew — Александр Баядин, Беван Кей, Брэнч Винсент, Кэлеб Сюй, Карло Кабрера, Даниэль Начун, Давид Джиурла, Дастин Родригес, Эрик Книббе, Джордж Адамс, Маркус Райтер, Максим Белкин, Миккал Мэттьюс, Майкл Чо, Нанда Х Кришна, Рэндалл, Руй Чен, Сэм Форд, Шон Джекман, Стив Петерс, Тьерри Муазен и Витор Гальвао.

К бывшим разработчикам с существенными вкладами относятся Клаудия Пеллегрино, Сикер, Уильям Вудруф, Ян Вильянен, Джкаунт, коммитай, Доминик Тиллер, Тим Смит, Баптист Фонтейн, Сюй Ченг, Мартин Афанасьев, Бретт Куонс, Чарли Шарпстин, Джек Нейгел, Адам Ванденберг, Эндрю Янке, Алекс Данн, нутрик, Томаш Пажор, Уладзислау Шабинский, Алиса Росс, ilovezfs, Чонью Жу и создатель Homebrew: Макс Хоуэлл.

ОШИБКИ

Смотрите наши вопросы на GitHub:

  • Homebrew/brew:
    https://github.com/Homebrew/brew/issues

  • Homebrew/homebrew-core:
    https://github.com/Homebrew/homebrew-core/issues

  • Homebrew/homebrew-cask:
    https://github.com/Homebrew/homebrew-cask/issues

© 2009–present Homebrew contributors
Licensed under the BSD 2-Clause License.
https://docs.brew.sh/Manpage

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API