git-for-each-ref - Online nel cloud

PROGRAMMA:

NOME

git-for-each-ref - Informazioni di output su ciascun ref

SINOSSI

git per-ogni-rif [--count= ] [--shell|--perl|--python|--tcl]
[(--sort= )...] [--format= ] [ ...]
[--punti-a ] [(--merged | --no-merged) [ ]]
[--contiene [ ]]

DESCRIZIONE

Itera su tutti i riferimenti che corrispondono e mostrali secondo il dato ,
dopo averli ordinati in base al dato insieme di . Se è dato, fermati dopo
mostrando che molti rif. I valori interpolati in può facoltativamente essere citato come
letterali stringa nella lingua ospite specificata che consente la loro valutazione diretta in quella
Lingua.

VERSIONI

Per impostazione predefinita il comando mostra tutti i riferimenti che corrispondono . Questa opzione lo fa smettere
dopo aver mostrato che molti rif.


Un nome di campo su cui ordinare. Prefisso - per ordinare in ordine decrescente del valore. quando
non specificato, viene utilizzato refname. Puoi usare --sort= opzione più volte, in
nel qual caso l'ultima chiave diventa la chiave primaria.


Una stringa che interpola %(fieldname) dall'oggetto puntato da un essere ref
mostrato. Se fieldname è preceduto da un asterisco (*) e il ref punta a un tag
oggetto, viene utilizzato il valore per il campo nel tag oggetto si riferisce. Quando non specificato,
il valore predefinito è %(nomeoggetto) SPC %(tipooggetto) TAB %(nomerif). Interpola anche %% a
%, e %xx dove xx sono cifre esadecimali si interpola al carattere con codice esadecimale xx; per
esempio %00 interpola in \0 (NUL), %09 in \t (TAB) e %0a in \n (LF).

...
Se vengono forniti uno o più modelli, vengono mostrati solo i riferimenti che corrispondono ad almeno uno
modello, utilizzando fnmatch(3) o letteralmente, in quest'ultimo caso corrispondendo completamente
o dall'inizio fino a una barra.

--shell, --perl, --python, --tcl
Se fornite, le stringhe che sostituiscono i segnaposto %(fieldname) sono citate come string
letterali adatti alla lingua ospite specificata. Questo ha lo scopo di produrre a
scriptlet che può essere "valutato" direttamente.

--punti-a
Elenca solo i riferimenti che puntano all'oggetto dato.

--unito [ ]
Elenca solo i riferimenti i cui suggerimenti sono raggiungibili dal commit specificato (HEAD in caso contrario
specificato).

--no-unito [ ]
Elenca solo i riferimenti i cui suggerimenti non sono raggiungibili dal commit specificato (HEAD in caso contrario
specificato).

--contiene [ ]
Elenca solo i tag che contengono il commit specificato (HEAD se non specificato).

CAMPO NOMI

Vari valori da campi strutturati in oggetti referenziati possono essere usati per interpolare
nell'output risultante o come chiavi di ordinamento.

Per tutti gli oggetti possono essere utilizzati i seguenti nomi:

nomerif
Il nome del riferimento (la parte dopo $GIT_DIR/). Per un nome breve non ambiguo del
ref append :short. L'opzione core.warnAmbiguousRefs viene utilizzata per selezionare lo strict
modalità di abbreviazione. Se striscia= è aggiunto, strisce percorso separato da una barra
componenti dalla parte anteriore del refname (ad esempio, %(refname:strip=2) trasforma refs/tags/foo
in foo. deve essere un numero intero positivo. Se un riferimento visualizzato ha meno componenti
di , il comando si interrompe con un errore.

tipo di oggetto
Il tipo dell'oggetto (blob, albero, commit, tag).

oggettivare
La dimensione dell'oggetto (la stessa di git file-gatto -s rapporti).

nomeoggetto
Il nome dell'oggetto (noto anche come SHA-1). Per un'abbreviazione non ambigua del nome dell'oggetto
aggiungo: breve.

a monte
Il nome di un rif locale che può essere considerato “a monte” dal rif visualizzato.
Rispetta: breve allo stesso modo del refname sopra. Inoltre rispetta :traccia da mostrare
"[davanti N, dietro M]" e :trackshort per mostrare la versione concisa: ">" (davanti), "<"
(dietro), "<>" (davanti e dietro) o "=" (in sincronia). Non ha effetto se il riferimento non lo fa
avere informazioni di tracciamento ad esso associate.

spingere
Il nome di un riferimento locale che rappresenta la posizione @{push} per il riferimento visualizzato.
Rispetta le opzioni :short, :track e :trackshort come fa l'upstream. Produce un vuoto
stringa se nessun riferimento @{push} è configurato.

TESTA
* se HEAD corrisponde al riferimento corrente (il ramo estratto), ' ' altrimenti.

colore
Cambia colore di output. Seguito da : , dove i nomi sono descritti in
colore.ramo.*.

allineare
Allinea a sinistra, al centro o a destra il contenuto tra %(align:...) e %(end). Il
"align:" è seguito da e in qualsiasi ordine separato da una virgola,
dove il è sinistro, destro o centrale, il valore predefinito è sinistro e
è la lunghezza totale del contenuto con l'allineamento. Se la lunghezza del contenuto è maggiore di
la larghezza quindi non viene eseguito alcun allineamento. Se usato con --Citazione tutto in mezzo
%(align:...) e %(end) sono tra virgolette, ma se annidato viene eseguito solo il livello più alto
citando.

Oltre a quanto sopra, per oggetti commit e tag, i nomi dei campi di intestazione (albero,
genitore, oggetto, tipo e tag) può essere utilizzato per specificare il valore nel campo di intestazione.

Per gli oggetti commit e tag, i campi creatordate e creator speciali corrisponderanno a
la data appropriata o la tupla nome-e-mail-data dai campi committer o tagger
a seconda del tipo di oggetto. Questi sono pensati per lavorare su un mix di annotazioni e
tag leggeri.

I campi che hanno tupla nome-e-mail-data come valore (autore, committer e tagger) possono essere
suffisso con nome, e-mail e data per estrarre il componente denominato.

Il messaggio completo in un oggetto commit e tag è il contenuto. La sua prima riga è
content:subject, dove oggetto è la concatenazione di tutte le righe del messaggio di commit up
alla prima riga vuota. La riga successiva è contenuto:corpo, dove il corpo è tutte le linee
dopo la prima riga vuota. La firma GPG facoltativa è content:signature. Il primo N
righe del messaggio si ottiene utilizzando content:lines=N.

Ai fini dell'ordinamento, i campi con valori numerici vengono ordinati in ordine numerico (dimensione oggetto,
authordate, committerdate, creatordate, taggerdate). Tutti gli altri campi sono usati per ordinare in
il loro ordine in byte.

C'è anche un'opzione per ordinare per versioni, questo può essere fatto usando il nome del campo
version:refname o il suo alias v:refname.

In ogni caso, un nome di campo che fa riferimento a un campo inapplicabile all'oggetto a cui si riferisce
il ref non causa un errore. Restituisce invece una stringa vuota.

Come caso speciale per i campi tipo data, puoi specificare un formato per la data entro
aggiungendo : seguito dal nome del formato della data (vedi i valori l'opzione --date per :git-rev-
stratagemma(1) prende).

ESEMPI

Un esempio che produce direttamente testo formattato. Mostra i 3 commit con tag più recenti:

#!/bin/sh

git for-each-ref --count=3 --sort='-*authordate' \
--format='Da: %(*nomeautore) %(*email autore)
Oggetto: %(*oggetto)
Data: %(*data autore)
Rif: %(*rifname)

%(*corpo)
' 'riferimenti/tag'

Un semplice esempio che mostra l'uso di shell eval sull'output, dimostrando l'uso di
--guscio. Elenca i prefissi di tutte le teste:

#!/bin/sh

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
mentre leggi la voce
do
eval "$voce"
echo `nomedir $rif`
fatto

Un rapporto un po' più elaborato sui tag, a dimostrazione del fatto che il formato può essere un intero
sceneggiatura:

#!/bin/sh

fmt='
r=%(rifname)
t=%(*tipo di oggetto)
T=${r#rif/tag/}

o=%(*nome oggetto)
n=%(*nome autore)
e=%(*email autore)
s=%(*oggetto)
d=%(*data autore)
b=%(*corpo)

tipo = tag
se prova "z$t" = z
poi
# potrebbe essere un tag leggero
t=%(tipo di oggetto)
kind="Etichetta leggera"
o=%(nome oggetto)
n=%(nome autore)
e=%(email autore)
s=%(soggetto)
d=%(data autore)
b=%(corpo)
fi
echo "$tipo $T punta a $t oggetto $o"
if test "z$t" = zcommit
poi
echo "Il commit è stato creato da $n $e
a $d e intitolato

$s

Il suo messaggio recita come:
"
echo "$b" | sed -e "s/^/ /"
eco
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*tipo oggetto' \
--sort=-datatagger \
riferimenti/tag`
eval "$ eval"

Usa git-for-each-ref online utilizzando i servizi onworks.net