Git
Plik .mailmap: kojarzenie dostawcy i aliasów e-mail
Szukaj…
Składnia
- # Zamień tylko adresy e-mail
<[email protected]> <[email protected]> - # Zamień nazwę na adres e-mail
Współtwórca <[email protected]> - # Scal wiele aliasów pod jedną nazwą i adresem e-mail
# Uwaga: nie będzie to wiązało „Inne <[email protected]>”.
Współtwórca <[email protected]> <[email protected]> Współtwórca <[email protected]>
Uwagi
Plik .mailmap
można utworzyć w dowolnym edytorze tekstowym i jest to zwykły plik tekstowy zawierający opcjonalne nazwy współpracowników, podstawowe adresy e-mail i ich aliasy. należy go umieścić w katalogu głównym projektu, obok katalogu .git
.
Należy pamiętać, że to po prostu modyfikuje wizualne wyjście poleceń takich jak git shortlog
lub git log --use-mailmap
. Nie spowoduje to przepisania historii zatwierdzeń ani zapobiegania zatwierdzeniom z różnymi nazwami i / lub adresami e-mail.
Aby zapobiec zatwierdzeniom na podstawie informacji takich jak adresy e-mail, powinieneś zamiast tego używać haczyków git .
Scalaj współautorów za pomocą aliasów, aby wyświetlić liczbę zatwierdzeń w krótkiej liście.
Gdy współautorzy dodają do projektu z różnych maszyn lub systemów operacyjnych, może się zdarzyć, że użyją do tego różnych adresów e-mail lub nazw, co spowoduje fragmentację list współautorów i statystyk.
Uruchomienie git shortlog -sn
aby uzyskać listę współautorów i liczbę zatwierdzeń przez nich, może dać następujące wyniki:
Patrick Rothfuss 871
Elizabeth Moon 762
E. Moon 184
Rothfuss, Patrick 90
To rozdrobnienie / rozłączenie można skorygować, udostępniając zwykły plik tekstowy .mailmap
, zawierający mapowania wiadomości e-mail.
Wszystkie nazwiska i adresy e-mail wymienione w jednym wierszu zostaną odpowiednio powiązane z pierwszym nazwanym podmiotem.
W powyższym przykładzie mapowanie może wyglądać następująco:
Patrick Rothfuss <[email protected]> Rothfuss, Patrick <[email protected]>
Elizabeth Moon <[email protected]> E. Moon <[email protected]>
Gdy plik ten znajdzie się w katalogu głównym projektu, ponowne uruchomienie git shortlog -sn
spowoduje utworzenie skróconej listy:
Patrick Rothfuss 961
Elizabeth Moon 946