git-check-attr

Имя

git-check-attr - Отображение информации gitattributes

Синтаксис

git check-attr [--source <tree-ish>] [-a | --all | <attr>…] [--] <pathname>…
git check-attr --stdin [-z] [--source <tree-ish>] [-a | --all | <attr>…]

Описание

Для каждого пути к файлу эта команда выведет, установлено ли каждое атрибут unspecified, set, или unset в качестве атрибута git в этом пути.

Параметры

-a, --all: Вывести все атрибуты, связанные со специфицированными путями. Если этот параметр используется, атрибуты unspecified не будут включены в вывод.
--cached: Рассматривать .gitattributes только в индексе, игнорируя рабочую область.
--stdin: Считывать пути из стандартного ввода, по одному на строке, вместо командной строки.
-z: Формат вывода изменяется на машиночитаемый. Если также задан --stdin, пути входных данных разделяются символом NUL вместо символа перевода строки.
--source=<tree-ish>: Проверить атрибуты по указанному tree-ish. Обычно, источник дерева указывается, называя связанный с ним коммит, ветвь или тэг.
--: Рассматривать все предыдущие аргументы как атрибуты, а все последующие аргументы как имена путей.

Если ни --stdin, ни --all, ни -- не используются, первый аргумент будет обработан как атрибут, а остальные аргументы — как пути.

Вывод

Вывод имеет вид: <путь> ДВОЕТОЧИЕ ПРОБЕЛ <атрибут> ДВОЕТОЧИЕ ПРОБЕЛ <информация> ПЕРЕВОД_СТРОКИ

если -z не активен, в этом случае в качестве разделителя используется NUL: <путь> NUL <атрибут> NUL <информация> NUL

<путь> — это путь к файлу, который запрашивается, <атрибут> — это запрашиваемый атрибут, а <информация> может быть:

неустановлено: когда атрибут не определен для пути.
отключено: когда атрибут определён как ложь.
включено: когда атрибут определён как истина.
<значение>: когда атрибуту было назначено значение.

Буферизация происходит, как описано в параметре GIT_FLUSH в git[1]. Ответственный за избежание тупиковых ситуаций, вызванных переполнением буфера ввода или чтением из пустого буфера вывода.

Примеры

В примерах используется следующий .gitattributes файл:

*.java diff=java -crlf myAttr
NoMyAttr.java !myAttr
README caveat=unspecified

Вывод одного атрибута:

$ git check-attr diff org/example/MyClass.java
org/example/MyClass.java: diff: java

Вывод нескольких атрибутов для файла:

$ git check-attr crlf diff myAttr -- org/example/MyClass.java
org/example/MyClass.java: crlf: unset
org/example/MyClass.java: diff: java
org/example/MyClass.java: myAttr: set

Вывод всех атрибутов для файла:

$ git check-attr --all -- org/example/MyClass.java
org/example/MyClass.java: diff: java
org/example/MyClass.java: myAttr: set

Вывод атрибута для нескольких файлов:

$ git check-attr myAttr -- org/example/MyClass.java org/example/NoMyAttr.java
org/example/MyClass.java: myAttr: set
org/example/NoMyAttr.java: myAttr: unspecified

Не все значения одинаково однозначны:

$ git check-attr caveat README
README: caveat: unspecified

См. также

gitattributes[5].

© 2005–2026 Linus Torvalds and others
Licensed under the GNU General Public License version 2.
https://git-scm.com/docs/git-check-attr