Что делает git rev-parse?

Что делает git rev-parse?

Я прочитал справочную страницу, но это вызвало больше вопросов, чем ответов. Вещи как:

Выбрать и параметры массажа

Массаж ? Что это значит?

Я использую в качестве резольвера (для SHA1) спецификаторов ревизии, как

git rev-parse HEAD^

или

git rev-parse origin/master

Это цель команды? Если нет, то даже правильно ли использовать его для достижения этой цели?

git rev-parseявляется вспомогательной plumbingкомандой, в основном используемой для манипуляций.

Одним из распространенных применений git rev-parseявляется печать хэшей SHA1 с указанием ревизии. Кроме того, он имеет различные параметры для форматирования этого вывода, например, --shortдля печати более короткого уникального SHA1.

Также есть и другие варианты использования (в скриптах и ​​других инструментах, построенных поверх git), для которых я использовал:

• --verify проверить, что указанный объект является допустимым объектом git.
• --git-dirдля отображения абс / относительный путь .gitкаталога.
• Проверка, что вы в данный момент находитесь в репозитории, используя --is-inside-git-dirили внутри рабочего дерева, используя--is-inside-work-tree
• Проверка, является ли репо голым, используя --is-bare-repository
• Печать SHA1 хэшей ветвей ( --branches), тегов ( --tags) и ссылок также может быть отфильтрована на основе удаленного (с использованием --remote)
• --parse-optнормализовать аргументы в скрипте (вроде как getopt) и вывести строку вывода, которую можно использовать сeval

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

• имя ветви или тега в SHA1 коммита, на которое он указывает, чтобы его можно было передать сантехнической команде, которая принимает только значения SHA1 для коммита.
• диапазон ревизий A..Bдля git logили git diffв эквивалентных аргументах для базовой сантехнической команды какB ^A

Просто для того, чтобы уточнить этимологию имени команды rev-parse, Git последовательно использует термин revв сантехнических командах как сокращение от «revision» и обычно означает 40-символьный хэш SHA1 для фиксации. Команда, rev-listнапример, печатает список хешей фиксации из 40 символов для ветви или чего-либо еще.

В этом случае имя может быть расширено до parse-a-commitish-to-a-full-SHA1-hash. В то время как команда имеет несколько вспомогательных функций, упомянутых в ответе Tuxdude, ее тезка, по-видимому, является прецедентом преобразования удобной для пользователя ссылки, такой как имя ветви или сокращенный хеш, в однозначный 40-символьный хеш SHA1, наиболее полезный для многих программ / сантехники. цели.

Я знаю, что думал, что это было "обратным анализом" чего-то довольно долгое время, прежде чем я понял это и испытал те же проблемы с пониманием терминов "массаж" и "манипуляция" :)

Во всяком случае, я нахожу это понятие «анализ-пересмотр» удовлетворительным образом обдумать это и надежной концепцией доведения этой команды до ума, когда мне нужны такие вещи. Часто в сценариях Git вы принимаете удобную для пользователя ссылку на коммит в качестве пользовательского ввода и обычно хотите, чтобы она была преобразована в проверенную и однозначную рабочую ссылку как можно скорее после ее получения. В противном случае входной перевод и проверка имеют тенденцию распространяться через сценарий.

git rev-parseТакже работает для получения текущего имени ветки с помощью флага --abbrev-ref, например:

git rev-parse --abbrev-ref HEAD