git-interpret-trailers - Online w chmurze

PROGRAM:

IMIĘ

git-interpret-trailers - pomóż dodać ustrukturyzowane informacje do komunikatów zatwierdzenia

STRESZCZENIE

odrzutowiec przyczepy-interpretacje [--przytnij-pusty] [(--zwiastun [(=|:) ])...] [ ...]

OPIS

Pomoc w dodawaniu Przyczepy linie, które wyglądają podobnie do nagłówków wiadomości e-mail RFC 822, na końcu
inaczej swobodna część komunikatu zatwierdzenia.

To polecenie odczytuje niektóre łatki lub komunikaty o zatwierdzeniu z pliku argumenty lub
standardowe wejście, jeśli nie jest specyficzne. Następnie to polecenie stosuje przekazane argumenty
używając opcji --trailer, jeśli istnieje, do części komunikatu zatwierdzenia każdego pliku wejściowego. The
wynik jest emitowany na standardowe wyjście.

Niektóre zmienne konfiguracyjne kontrolują sposób, w jaki argumenty --trailer są stosowane do każdej z nich
komunikat zatwierdzenia i sposób zmiany istniejącego zwiastuna w komunikacie zatwierdzenia. Oni
umożliwiają również automatyczne dodawanie niektórych przyczep.

Domyślnie plik = or : argument podany przy użyciu opcji --trailer będzie
dołączany po istniejących przyczepach tylko wtedy, gdy ostatnia przyczepa ma inny ( ,
) para (lub jeśli nie ma istniejącej przyczepy). The I części będą
przycięte, aby usunąć początkowe i końcowe białe znaki, a wynikowe przycięcie I
pojawi się w wiadomości w następujący sposób:

token: wartość

Oznacza to, że przycięte I będą oddzielone znakiem ': ' (jeden dwukropek
po którym następuje jedna spacja).

Domyślnie nowy zwiastun pojawi się na końcu wszystkich istniejących zwiastunów. Jezeli tam
nie jest istniejącym zwiastunem, nowy zwiastun pojawi się po części komunikatu o zatwierdzeniu
wyjście, a jeśli nie ma wiersza zawierającego tylko spacje na końcu części komunikatu zatwierdzenia,
przed nowym zwiastunem zostanie dodana jedna pusta linia.

Istniejące przyczepy są wyodrębniane z wiadomości wejściowej, szukając grupy składającej się z jednego lub więcej
więcej linii zawierających dwukropek (domyślnie), gdzie grupa jest poprzedzona jednym lub więcej
puste (lub tylko białe znaki) linie. Grupa musi znajdować się na końcu wiadomości lub być
ostatnie wiersze niebędące białymi znakami przed wierszem zaczynającym się od ---. Takie trzy minusy
rozpocznij część wiadomości dotyczącą łaty.

Podczas czytania zwiastunów przed i po tokenie (separatorze) mogą występować spacje
i wartość. Wewnątrz tokena i wartości mogą również znajdować się spacje.

Należy pamiętać, że Przyczepy nie przestrzegają i nie mają na celu przestrzegania wielu zasad RFC 822
nagłówki. Na przykład nie przestrzegają zasad składania linii, zasad kodowania i
prawdopodobnie wiele innych zasad.

OPCJE

--trim-puste
jeśli część dowolnego zwiastuna zawiera tylko białe znaki, będzie nim cały zwiastun
usunięte z wynikowej wiadomości. Dotyczy to zarówno istniejących przyczep, jak i nowych
przyczepy.

--przyczepa [(=|:) ]
Określ ( , ) parę, która powinna być zastosowana jako przyczepa do danych wejściowych
wiadomości. Zobacz opis tego polecenia.

KONFIGURACJA ZMIENNE

przyczepa.separatory
Ta opcja określa, które znaki są rozpoznawane jako separatory przyczep. Domyślnie
tylko : jest rozpoznawany jako separator przyczepy, z wyjątkiem tego = jest zawsze akceptowany na
wiersz poleceń dla zgodności z innymi poleceniami git.

Pierwszy znak podany przez tę opcję będzie domyślnym znakiem używanym kiedy
w konfiguracji tego zwiastuna nie określono innego separatora.

Na przykład, jeśli wartością tej opcji jest „%=$”, to tylko wiersze używające tego formatu
z zawierający %, = or $ a następnie spacje zostaną uwzględnione
przyczepy. I % będzie używanym domyślnym separatorem, więc domyślnie pojawią się zwiastuny
lubić: % (między tokenem pojawi się jeden znak procentu i jedna spacja
i wartość).

przyczepa.gdzie
Ta opcja informuje, gdzie zostanie dodany nowy zwiastun.

Może to być koniec, co jest wartością domyślną, start, po lub przed.

Jeśli to koniec, to każda nowa przyczepa pojawi się na końcu istniejących przyczep.

Jeśli to początek, to każdy nowy zwiastun pojawi się na początku, a nie na końcu
istniejące przyczepy.

Jeśli jest po, to każdy nowy zwiastun pojawi się tuż po ostatnim zwiastunie z
To samo .

Jeśli jest wcześniej, to każdy nowy zwiastun pojawi się tuż przed pierwszym zwiastunem z
ten sam .

zwiastun.jeżeli istnieje
Ta opcja umożliwia wybór, jaka akcja zostanie wykonana, gdy nastąpi
już co najmniej jedna przyczepa z tym samym w wiadomości.

Prawidłowe wartości dla tej opcji to: addIfDifferentNeighbor (jest to wartość domyślna),
addIfDifferent, dodaj, nadpisz lub nie rób nic.

Dzięki addIfDifferentNeighbor nowy zwiastun zostanie dodany tylko wtedy, gdy nie będzie żadnego zwiastuna z rozszerzeniem
To samo ( , ) znajduje się powyżej lub poniżej linii, w której będzie znajdować się nowy zwiastun
w dodatku.

W przypadku addIfDifferent nowy zwiastun zostanie dodany tylko wtedy, gdy nie będzie tego samego zwiastuna
( , ) para jest już w wiadomości.

Dodaj, nowy zwiastun zostanie dodany, nawet jeśli niektóre zwiastuny mają to samo ( ,
) pary znajdują się już w wiadomości.

Z wymianą, istniejąca przyczepa z tym samym zostaną usunięte i nowe
przyczepa zostanie dodana. Usunięty zwiastun będzie najbliższy (z tym samym
) do miejsca, w którym zostanie dodany nowy.

Z doNothing nic nie zostanie zrobione; to znaczy żaden nowy zwiastun nie zostanie dodany, jeśli jest
już jeden z tym samym w wiadomości.

przyczepa.jeśli brakuje
Ta opcja umożliwia wybór, jaka akcja zostanie wykonana, gdy nastąpi
jeszcze nie ma przyczepy z tym samym w wiadomości.

Prawidłowe wartości dla tej opcji to: add (jest to ustawienie domyślne) i doNothing.

Po dodaniu zostanie dodany nowy zwiastun.

Z doNothing nic nie zostanie zrobione.

przyczepa. .klucz
Ten klucz będzie używany zamiast w przyczepie. Na końcu tego klucza a
może pojawić się separator, a następnie spacje. Domyślnie jedyny ważny
separatorem jest :, ale można to zmienić za pomocą zmiennej konfiguracyjnej trailer.separators.

Jeśli istnieje separator, zamiast obu zostanie użyty klucz i
domyślny separator podczas dodawania zwiastuna.

przyczepa. .Gdzie
Ta opcja przyjmuje te same wartości co opcja przyczepa.gdzie zmienna konfiguracyjna i to
zastępuje to, co jest określone przez tę opcję dla przyczep z określonym .

przyczepa. .jeżeli istnieje
Ta opcja przyjmuje te same wartości co opcja przyczepa.jeśliistnieje zmienna konfiguracyjna i to
zastępuje to, co jest określone przez tę opcję dla przyczep z określonym .

przyczepa. brakujące
Ta opcja przyjmuje te same wartości co opcja przyczepa.jeśli brakuje zmienna konfiguracyjna i
zastępuje to, co jest określone przez tę opcję dla przyczep z określonym .

przyczepa. .Komenda
Tej opcji można użyć do określenia polecenia powłoki, które zostanie wywołane
automatycznie dodawać lub modyfikować naczepę o określonej wartości .

Gdy ta opcja jest określona, ​​zachowanie jest podobne do specjalnego =
argumenty zostały dodane na początku wiersza poleceń, gdzie przyjmuje się, że jest
standardowe wyjście określonego polecenia z dowolnymi początkowymi i końcowymi białymi znakami
przycięte.

Jeśli polecenie zawiera łańcuch $ARG, ten ciąg zostanie zastąpiony ciągiem
część istniejącej przyczepy z tym samym , jeśli istnieje, przed poleceniem jest
uruchomiona.

Jeśli niektóre = argumenty są również przekazywane w wierszu poleceń, gdy a
przyczepa. .Komenda jest skonfigurowany, polecenie zostanie również wykonane dla każdego z nich
te argumenty. i część tych argumentów, jeśli w ogóle, zostanie wykorzystana
zamień łańcuch $ARG w poleceniu.

PRZYKŁADY

· Skonfiguruj znak przyczepa z Podpisany przez key, a następnie dodaj dwa z tych zwiastunów
do wiadomości:

$ git config trailer.sign.key „Podpisany przez”
$ kot msg.txt
przedmiot

wiadomość
$ kot msg.txt | git interpret-trailers --trailer 'znak: Alicja[email chroniony]>' --znak zwiastuna: Bob[email chroniony]>'
przedmiot

wiadomość

Podpisany przez: Alice[email chroniony]>
Podpisany przez: Bob[email chroniony]>

· Wyodrębnij ostatnie zatwierdzenie jako łatkę i dodaj plik Cc oraz Zrecenzowany przez przyczepa do tego:

$ git łatka formatująca -1
0001-foo.łatka
$ git interpret-trailers --trailer 'DW: Alicja[email chroniony]>” --trailer „Recenzował: Bob[email chroniony]>' 0001-foo.patch >0001-bar.patch

· Skonfiguruj znak zwiastun z poleceniem automatycznego dodania „Podpisany przez: ” z
informacje o autorze tylko wtedy, gdy nie ma już „Podpisane przez:” i pokaż, jak to zrobić
prace:

$ git config trailer.sign.key "Podpisany przez: "
$ git config trailer.sign.ifmissing dodaj
$ git config trailer.sign.ifexists nic nie robi
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git interpretacja zwiastunów <
> EOF

Podpisany przez: Bob[email chroniony]>
$ git interpretacja zwiastunów <
> Podpisana przez: Alice[email chroniony]>
> EOF

Podpisany przez: Alice[email chroniony]>

· Skonfiguruj stały przyczepa z kluczem, który zawiera # i po tym nie ma spacji
postać i pokaż, jak to działa:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "Popraw #"
$ echo "temat" | git interpret-trailers --trailer fix=42
przedmiot

Poprawka nr 42

· Skonfiguruj widzieć trailer z poleceniem pokazania tematu zatwierdzenia tj
powiązane i pokaż, jak to działa:

$ git config trailer.see.key "Zobacz też: "
$ git config trailer.see.ifExists „zamień”
$ git config trailer.see.ifMissing „doNothing”
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpretacja zwiastunów <
> temat
>
> wiadomość
>
> patrz: GŁOWA~2
> EOF
przedmiot

wiadomość

Zobacz też: fe3187489d69c4 (temat powiązanego zatwierdzenia)

· Skonfiguruj szablon zatwierdzenia z kilkoma zwiastunami z pustymi wartościami (używając sed do pokazania
i zachowaj końcowe spacje na końcu zwiastunów), a następnie skonfiguruj komunikat zatwierdzenia
hak, którego używa odrzutowiec przyczepy-interpretacje aby usunąć przyczepy z pustymi wartościami i dodać
a wersja git zwiastun filmu:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***temat***
>
> ***wiadomość***
>
> Poprawki: Z
> DW: Z
> Recenzent: Z
> Podpisał: Z
> EOF
$ konfiguracja git commit.template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/ Bin / sh
> git interpret-trailers --trim-empty --trailer "git-version: \$(git description)" "\$1" > "\$1.new"
> mv "\$1.new" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

Korzystaj z git-interpret-trailers online, korzystając z usług onworks.net