git-for-each-ref — Online w chmurze

PROGRAM:

IMIĘ

git-for-each-ref - Wypisuje informacje o każdym ref

STRESZCZENIE

odrzutowiec dla-każdego-ref [--liczba= ] [--shell|--perl|--python|--tcl]
[(--sortowanie= )...] [--format= ] [ ...]
[--wskazuje-w ] [(--połączył | --nie-połączył) [ ]]
[--zawiera [ ]]

OPIS

Iteruj po wszystkich pasujących referencjach i pokaż je zgodnie z podanym ,
po posortowaniu ich według podanego zbioru . Jeśli jest podane, zatrzymaj się po
pokazując, że wiele ref. Interpolowane wartości w może być opcjonalnie cytowany jako
literały łańcuchowe w określonym języku hosta, umożliwiając ich bezpośrednią ocenę w tym
język.

OPCJE

Domyślnie polecenie pokazuje wszystkie pasujące odnośniki . Ta opcja powoduje zatrzymanie
po pokazaniu tylu refów.


Nazwa pola do sortowania. Prefiks — aby posortować malejąco według wartości. Gdy
nieokreślony, używany jest refname. Możesz użyć opcji --sort= opcja wiele razy, w
w którym to przypadku ostatni klucz staje się kluczem podstawowym.


Łańcuch, który interpoluje %(nazwa pola) z obiektu wskazywanego przez istotę ref
pokazane. Jeśli nazwa pola jest poprzedzona gwiazdką (*), a ref wskazuje na znacznik
obiekt, używana jest wartość pola w znaczniku obiektu, do którego się odnosi. Gdy nieokreślony,
domyślnie %(nazwa obiektu) SPC %(typ obiektu) TAB %(nazwa ref.). Interpoluje również %% do
%, a %xx gdzie xx to cyfry szesnastkowe interpoluje do znaku o kodzie szesnastkowym xx; Do
przykład %00 interpoluje do \0 (NUL), %09 do \t (TAB) i %0a do \n (LF).

...
Jeśli podany jest jeden lub więcej wzorców, wyświetlane są tylko referencje pasujące do co najmniej jednego
wzór, albo za pomocą fndopasowanie(3) lub dosłownie, w tym drugim przypadku pasujące całkowicie
lub od początku do ukośnika.

--shell, --perl, --python, --tcl
Jeśli podano, ciągi zastępujące symbole zastępcze %(nazwa pola) są cytowane jako łańcuch
literały odpowiednie dla określonego języka hosta. Ma to na celu wyprodukowanie a
scriptlet, który może być bezpośrednio `eval`ed.

--wskazuje-w
Podaj tylko referencje, które wskazują na dany obiekt.

--scalone [ ]
Podaj tylko referencje, których wskazówki są osiągalne z określonego zatwierdzenia (HEAD, jeśli nie
określony).

--no-scalone [ ]
Podaj tylko referencje, których wskazówki nie są osiągalne z określonego zatwierdzenia (HEAD, jeśli nie
określony).

--zawiera [ ]
Wyświetlaj tylko te tagi, które zawierają określone zatwierdzenie (HEAD, jeśli nie określono).

POLE NAZWY

Do interpolacji można użyć różnych wartości z pól strukturalnych w obiektach, do których istnieją odnośniki
do wynikowego wyjścia lub jako klucze sortowania.

Dla wszystkich obiektów można używać następujących nazw:

nazwa ref
Nazwa ref (część po $GIT_DIR/). Dla niejednoznacznej krótkiej nazwy
dołącz ref: krótki. Opcja core.warnAmbiguousRefs służy do wyboru strict
tryb skrótów. Jeśli pasek = jest dołączony, paski ścieżka oddzielona ukośnikiem
komponenty z przodu refname (np. %(refname:strip=2) zamienia refs/tags/foo
w foo. musi być dodatnią liczbą całkowitą. Jeśli wyświetlany odnośnik ma mniej elementów
niż , polecenie zostanie przerwane z błędem.

rodzaj obiektu
Typ obiektu (blob, drzewo, zatwierdzenie, znacznik).

uprzedmiotowienie
Rozmiar obiektu (taki sam jak odrzutowiec plik-kot -s raporty).

nazwa obiektu
Nazwa obiektu (inaczej SHA-1). Dla jednoznacznego skrótu nazwy obiektu
dołącz: krótki.

pod prąd
Nazwa lokalnego odnośnika, który można uznać za „w górę” od wyświetlanego odnośnika.
Respects :short w taki sam sposób jak refname powyżej. Dodatkowo szanuje :track to show
„[ahead N, behind M]” i :trackshort, aby pokazać zwięzłą wersję: „>” (ahead), „<”
(z tyłu), „<>” (z przodu iz tyłu) lub „=” (zsynchronizowane). Nie ma efektu, jeśli sędzia tego nie robi
mają powiązane informacje o śledzeniu.

naciskać
Nazwa lokalnego odnośnika, który reprezentuje lokalizację @{push} dla wyświetlanego odnośnika.
Respektuje opcje :short, :track i :trackshort, tak jak robi to upstream. Produkuje pusty
ciąg znaków, jeśli nie skonfigurowano żadnego @{push} ref.

GŁOWA
* jeśli HEAD pasuje do bieżącego ref (wyewidencjonowanej gałęzi), ' ' w przeciwnym razie.

kolor
Zmień kolor wyjściowy. Śledzony przez : , gdzie nazwy są opisane w
kolor.gałąź.*.

wyrównać
Wyrównaj zawartość do lewej, do środka lub do prawej między %(align:...) a %(end). The
Po „wyrównaj:” następuje I w dowolnej kolejności oddzielone przecinkiem,
gdzie jest lewy, prawy lub środkowy, domyślnie lewy i
to całkowita długość treści z wyrównaniem. Jeśli długość zawartości jest większa niż
szerokość, wówczas żadne wyrównanie nie jest wykonywane. Jeśli używany z --cytat wszystko pomiędzy
%(align:...) i %(end) są cytowane, ale jeśli są zagnieżdżone, działa tylko najwyższy poziom
cytując.

Oprócz powyższego, dla obiektów zatwierdzeń i tagów, nazwy pól nagłówka (drzewo,
rodzic, obiekt, typ i znacznik) mogą służyć do określenia wartości w polu nagłówka.

W przypadku zatwierdzania i oznaczania obiektów odpowiednie będą specjalne pola daty twórcy i twórcy
odpowiednią datę lub krotkę nazwa-e-mail-data z pól zatwierdzającego lub taggera
w zależności od typu obiektu. Są one przeznaczone do pracy nad mieszanką adnotacji i
lekkie tagi.

Pola, których wartością jest krotka nazwa-adres-adres-data (autor, osoba zatwierdzająca i tagger) mogą być
z sufiksem nazwy, adresu e-mail i daty, aby wyodrębnić nazwany składnik.

Pełna wiadomość w obiekcie zatwierdzenia i znacznika to zawartość. Jego pierwsza linia to
content:subject, gdzie temat jest konkatenacją wszystkich wierszy komunikatu zatwierdzenia
do pierwszego pustego wiersza. Następna linia jest zawartość: ciało, gdzie ciało to wszystkie linie
po pierwszym pustym wierszu. Opcjonalny podpis GPG to content:signature. pierwszy N
wierszy wiadomości uzyskuje się za pomocą content:lines=N.

Do celów sortowania pola z wartościami numerycznymi są sortowane w porządku numerycznym (rozmiar obiektu,
data autora, data zatwierdzenia, data twórcy, data znacznika). Wszystkie pozostałe pola służą do sortowania
ich kolejność bajtów.

Istnieje również opcja sortowania według wersji, można to zrobić za pomocą nazwy pola
version:refname lub jego alias v:refname.

W każdym przypadku nazwa pola, która odnosi się do pola, które nie ma zastosowania do obiektu, do którego się odwołuje
ref nie powoduje błędu. Zamiast tego zwraca pusty ciąg.

Jako szczególny przypadek dla pól typu data możesz określić format daty wg
dodawanie : po którym następuje nazwa formatu daty (zobacz wartości opcji --date :git-rev-
podstęp(1) bierze).

PRZYKŁADY

Przykład bezpośredniego tworzenia sformatowanego tekstu. Pokaż 3 ostatnie oznaczone zatwierdzenia:

#!/ Bin / sh

git for-each-ref --count=3 --sort='-*autordate' \
--format='Od: %(*autor) %(*adres e-mail autora)
Temat: %(*temat)
Data: %(*autordata)
Ref: %(*nazwa ref.)

%(*ciało)
''referencje/tagi'

Prosty przykład pokazujący użycie eval powłoki na wyjściu, demonstrujący użycie
--powłoka. Wymień przedrostki wszystkich głów:

#!/ Bin / sh

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
podczas czytania wpisu
do
ocena „$ wpis”
echo `nazwa_katalogu $ref`
zrobić

Nieco bardziej rozbudowany raport na temat tagów, pokazujący, że format może być całością
scenariusz:

#!/ Bin / sh

fmt='
r=%(nazwa ref)
t=%(*typ obiektu)
T=${r#refs/tags/

o=%(*nazwaobiektu)
n=%(*nazwisko autora)
e=%(*adres e-mail autora)
s=%(*podmiot)
d=%(*dataautora)
b=%(*ciało)

rodzaj=znacznik
jeśli test „z$t” = z
następnie
# może być lekkim tagiem
t=%(typ obiektu)
kind="Lekki tag"
o=%(nazwa obiektu)
n=%(nazwa autora)
e=%(adres e-mail autora)
s=%(temat)
d=%(data autora)
b=%(ciało)
fi
echo "$kind $T wskazuje na obiekt $t $o"
if test "z$t" = zcommit
następnie
echo "Autorem zatwierdzenia jest $n $e
w $d i zatytułowany

$s

Jego wiadomość brzmi:
"
echo "$b" | sed -e "s/^/ /"
przegapić
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*typ obiektu' \
--sort=-taggerdata \
refs/tagi`
ocena "$ ocena"

Użyj git-for-each-ref online, korzystając z usług onworks.net