git-interpret-trailers - 클라우드 온라인

프로그램:

이름

git-interpret-trailers - 구조화된 정보를 커밋 메시지에 추가하도록 도와줍니다.

개요

자식 통역 트레일러 [--트림-빈] [(--트레일러 [(=|:) ])...] [ ...]

기술

추가 도움말 예고편 RFC 822 전자 메일 헤더와 유사하게 보이는 줄
그렇지 않으면 커밋 메시지의 자유 형식 부분입니다.

이 명령은 다음 중 하나에서 일부 패치 또는 커밋 메시지를 읽습니다. 인수 또는
없는 경우 표준 입력 지정됩니다. 그런 다음 이 명령은 전달된 인수를 적용합니다.
각 입력 파일의 커밋 메시지 부분에 --trailer 옵션을 사용합니다. 그만큼
결과는 표준 출력으로 내보냅니다.

일부 구성 변수는 --trailer 인수가 각각에 적용되는 방식을 제어합니다.
커밋 메시지 및 커밋 메시지의 기존 트레일러가 변경되는 방식. 그들
일부 예고편을 자동으로 추가할 수도 있습니다.

기본적으로 = or : --trailer를 사용하여 주어진 인수는
마지막 예고편에 다른 ( ,
) 쌍(또는 기존 트레일러가 없는 경우). 그만큼 그리고 부품은
시작 및 후행 공백을 제거하기 위해 트리밍되고 결과 트리밍 그리고
다음과 같이 메시지에 나타납니다.

토큰: 값

이것은 다듬어진 것을 의미합니다. 그리고 ':'로 구분됩니다(콜론 하나
뒤에 한 칸).

기본적으로 새 예고편은 기존 예고편의 끝에 표시됩니다. 만약 거기에
기존 예고편이 없으면 새 예고편이 커밋 메시지 부분 뒤에 나타납니다.
출력하고, 커밋 메시지 부분 끝에 공백만 있는 줄이 없으면
새 예고편 앞에 빈 줄이 하나 추가됩니다.

기존 예고편은 하나의 그룹을 찾아 입력 메시지에서 추출하거나
콜론을 포함하는 추가 라인(기본값), 그룹 앞에 하나 이상의 라인이 있음
빈(또는 공백만 있는) 줄. 그룹은 메시지의 끝에 있거나
로 시작하는 줄 앞의 공백이 아닌 마지막 줄 ---. 이러한 세 가지 빼기 기호
메시지의 패치 부분을 시작합니다.

예고편을 읽을 때 토큰 앞뒤에 공백이 있을 수 있습니다.
그리고 가치. 토큰과 값 내부에 공백이 있을 수도 있습니다.

참고 예고편 RFC 822에 대한 많은 규칙을 따르지 않으며 따르지 않습니다.
헤더. 예를 들어 줄 접기 규칙, 인코딩 규칙 및
아마 다른 많은 규칙.

옵션

--트림-빈
만약 예고편의 일부에 공백만 있으면 예고편 전체가
결과 메시지에서 제거됩니다. 이것은 기존 예고편뿐만 아니라 새 예고편에도 적용됩니다.
트레일러.

--트레일러 [(=|:) ]
( , ) 입력에 트레일러로 적용되어야 하는 쌍
메시지. 이 명령에 대한 설명을 참조하십시오.

구성 변수

트레일러.분리기
이 옵션은 트레일러 구분 기호로 인식되는 문자를 알려줍니다. 기본적으로
만 : 다음을 제외하고 트레일러 분리기로 인식됩니다. = 에서 항상 수락됩니다.
다른 git 명령과의 호환성을 위한 명령줄.

이 옵션에서 제공하는 첫 번째 문자는 다음과 같은 경우에 사용되는 기본 문자입니다.
이 예고편의 구성에 다른 구분 기호가 지정되지 않았습니다.

예를 들어 이 옵션의 값이 "%=$"이면 다음 형식을 사용하는 행만
~와 함께 함유 %, = or $ 그런 다음 공백이 고려됩니다
예고편. 그리고 % 기본 구분 기호가 사용되므로 기본적으로 예고편이 표시됩니다.
처럼: % (토큰 사이에 퍼센트 기호 XNUMX개와 공백 XNUMX개가 나타납니다.
및 값).

트레일러.어디서
이 옵션은 새 예고편이 추가될 위치를 알려줍니다.

이는 end(기본값), start, after 또는 before일 수 있습니다.

끝이면 기존 예고편 끝에 각각의 새 예고편이 나타납니다.

시작인 경우 각각의 새 예고편이 끝이 아닌 시작 부분에 나타납니다.
기존 트레일러.

이후인 경우 각각의 새 예고편은 마지막 예고편 바로 다음에 표시됩니다.
같은 .

이전인 경우 각각의 새 예고편은 다음과 같은 첫 번째 예고편 바로 앞에 나타납니다.
똑같다 .

트레일러.ifexists
이 옵션을 사용하면 다음이 있을 때 수행할 작업을 선택할 수 있습니다.
이미 동일한 트레일러가 하나 이상 있습니다. 메시지에서.

이 옵션의 유효한 값은 다음과 같습니다. addIfDifferentNeighbor(기본값),
addIfDifferent, 추가, 덮어쓰기 또는 doNothing.

addIfDifferentNeighbor를 사용하면 다음과 같은 예고편이 없는 경우에만 새 예고편이 추가됩니다.
같은 ( , ) 쌍이 새 트레일러가 위치할 라인의 위 또는 아래에 있습니다.
추가.

addIfDifferent를 사용하면 동일한 예고편이 없는 경우에만 새 예고편이 추가됩니다.
( , ) 쌍이 이미 메시지에 있습니다.

추가를 사용하면 일부 예고편이 동일한( ,
) 쌍이 이미 메시지에 있습니다.

교체를 사용하면 동일한 기존 트레일러 삭제되고 새로운
트레일러가 추가됩니다. 삭제된 예고편이 가장 가까운 예고편이 됩니다(동일한
) 새 항목이 추가될 위치로 이동합니다.

doNothing을 사용하면 아무 작업도 수행되지 않습니다. 새 예고편이 없으면 추가됩니다.
이미 같은 사람 메시지에서.

예고편.누락된 경우
이 옵션을 사용하면 다음이 있을 때 수행할 작업을 선택할 수 있습니다.
아직 같은 예고편이 없습니다. 메시지에서.

이 옵션의 유효한 값은 add(기본값) 및 doNothing입니다.

추가하면 새 예고편이 추가됩니다.

doNothing을 사용하면 아무 작업도 수행되지 않습니다.

트레일러. .열쇠
대신 이 키가 사용됩니다. 예고편에서. 이 키의 끝에는
구분 기호가 나타난 다음 일부 공백 문자가 나타날 수 있습니다. 기본적으로 유일하게 유효한
구분 기호는 :, 하지만 trailer.separators 구성 변수를 사용하여 변경할 수 있습니다.

구분 기호가 있는 경우 두 키 대신 키가 사용됩니다. 그리고
예고편을 추가할 때 기본 구분 기호입니다.

트레일러. .어디
이 옵션은 트레일러.어디서 구성 변수 및
예고편에 대해 해당 옵션으로 지정된 내용을 지정된 .

트레일러. .ifexist
이 옵션은 트레일러.ifexist 구성 변수 및
예고편에 대해 해당 옵션으로 지정된 내용을 지정된 .

트레일러. .ifmissing
이 옵션은 예고편.누락된 경우 구성 변수 및
예고편에 대해 해당 옵션으로 지정된 항목을 지정된 .

트레일러. .명령
이 옵션은 호출할 쉘 명령을 지정하는 데 사용할 수 있습니다.
지정된 예고편을 자동으로 추가하거나 수정합니다. .

이 옵션이 지정되면 동작은 마치 특수 =
명령줄 시작 부분에 인수가 추가되었습니다. 여기서 로 간주된다
선행 및 후행 공백이 있는 지정된 명령의 표준 출력
잘랐다.

명령에 $ARG 문자열이 포함된 경우 이 문자열은
동일한 기존 예고편의 일부 , 있는 경우 명령 앞에
시작했다.

만약 일부 = 인수는 명령줄에서도 전달됩니다.
트레일러. .명령 구성되면 각 명령에 대해서도 명령이 실행됩니다.
이러한 주장. 그리고 이러한 인수의 일부가 있는 경우 다음을 수행하는 데 사용됩니다.
명령에서 $ARG 문자열을 바꾸십시오.

사용 예

· 구성 기호 트레일러 서명자 키를 누른 다음 이 트레일러 중 두 개를 추가합니다.
메시지에:

$ git config trailer.sign.key "사인 오프"
$ 고양이 msg.txt
제목

메시지
$ 고양이 msg.txt | 자식 해석-트레일러 --트레일러 '기호: 앨리스[이메일 보호]>' --트레일러 '표시: 밥[이메일 보호]>'
제목

메시지

서명자: Alice[이메일 보호]>
승인자: Bob[이메일 보호]>

· 마지막 커밋을 패치로 추출하고 Cc 및 검토자 트레일러:

$ 자식 형식-패치 -1
0001-foo.패치
$ git interpret-trailers --trailer '참조: 앨리스[이메일 보호]>' --trailer '검토자: 밥[이메일 보호]>' 0001-foo.patch >0001-bar.patch

· 구성 기호 'Signed-off-by:'를 자동으로 추가하는 명령이 포함된 트레일러
이미 'Signed-off-by:'가 없는 경우에만 작성자 정보를 표시하고 어떻게 표시하는지 보여줍니다.
작품 :

$ git config trailer.sign.key "사인 오프: "
$ git config trailer.sign.ifmissing 추가
$ git config trail.sign.ifexists doNothing
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git 해석-트레일러 <
> EOF

승인자: Bob[이메일 보호]>
$ git 해석-트레일러 <
> 승인자: Alice[이메일 보호]>
> EOF

서명자: Alice[이메일 보호]>

· 구성 고정 된 키가 포함된 트레일러 # 이 뒤에 공간이 없습니다
작동 방식을 보여줍니다.

$ git config trailer.separators ":#"
$ git config trailer.fix.key "수정 #"
$ 에코 "제목" | 자식 해석-트레일러 --트레일러 수정=42
제목

수정 # 42

· 구성 참조 커밋의 주제를 표시하는 명령이 포함된 예고편
관련되어 작동 방식을 보여줍니다.

$ git config trailer.see.key "참조: "
$ git config trailer.see.ifExists "교체"
$ git config trailer.see.ifMissing "doNothing"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git 해석-트레일러 <
> 주제
>
> 메시지
>
> 참조: HEAD~2
> EOF
제목

메시지

참조: fe3187489d69c4(관련 커밋의 주제)

· 값이 비어 있는 일부 트레일러로 커밋 템플릿 구성(sed를 사용하여 표시)
트레일러 끝에 후행 공백을 유지) 그런 다음 commit-msg를 구성합니다.
사용하는 후크 자식 통역 트레일러 값이 비어 있는 트레일러를 제거하고 추가하려면
a 자식 버전 트레일러:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***제목***
>
> ***메시지***
>
> 수정: Z
> 참조: Z
> 검토자: Z
> 승인자: Z
> EOF
$ 자식 구성 commit.template commit_template.txt
$ 고양이 >.git/hooks/commit-msg <
> #!/ 빈 / SH
> git interpret-trailers --trim-empty --trailer "git-version: \$(git describe)" "\$1" > "\$1.new"
> mv "\$1.new" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

onworks.net 서비스를 사용하여 온라인에서 git-interpret-trailers 사용