git-for-each-ref - En ligne dans le Cloud

PROGRAMME:

Nom

git-for-each-ref - Informations de sortie sur chaque ref

SYNOPSIS

jet pour-chaque-ref [--compte= ] [--shell|--perl|--python|--tcl]
[(--sort= )...] [--format= ] [ ...]
[--pointe-à ] [(--merged | --no-merged) [ ]]
[--contient [ ]]

DESCRIPTION

Itérer sur toutes les références qui correspondent et les montrer selon le donné ,
après les avoir triés selon l'ensemble donné de . Si est donné, arrêter après
montrant que de nombreuses refs. Les valeurs interpolées dans peut éventuellement être cité comme
littéraux de chaîne dans la langue hôte spécifiée permettant leur évaluation directe dans ce
la langue.

OPTIONS

Par défaut, la commande affiche toutes les références qui correspondent . Cette option l'arrête
après avoir montré que de nombreuses références.


Un nom de champ sur lequel effectuer le tri. Préfixe - pour trier par ordre décroissant de la valeur. Lorsque
non spécifié, refname est utilisé. Vous pouvez utiliser --sort= option plusieurs fois, dans
auquel cas la dernière clé devient la clé primaire.


Une chaîne qui interpole %(fieldname) à partir de l'objet pointé par une référence étant
montré. Si fieldname est préfixé par un astérisque (*) et la référence pointe vers une balise
object, la valeur du champ dans la balise object se réfère est utilisée. Lorsqu'il n'est pas spécifié,
par défaut %(objectname) SPC %(objecttype) TAB %(refname). Il interpole également %% à
% et %xx où xx sont des chiffres hexadécimaux interpolés en caractère avec le code hexadécimal xx ; pour
exemple %00 interpole à \0 (NUL), %09 à \t (TAB) et %0a à \n (LF).

...
Si un ou plusieurs modèles sont donnés, seules les références sont affichées qui correspondent à au moins un
modèle, soit en utilisant fnmatch(3) ou littéralement, dans ce dernier cas correspondant complètement
ou du début jusqu'à une barre oblique.

--shell, --perl, --python, --tcl
Si donné, les chaînes qui remplacent les espaces réservés %(fieldname) sont citées en tant que chaîne
des littéraux adaptés à la langue hôte spécifiée. Ceci est destiné à produire un
scriptlet qui peut être directement « évalué ».

--points-à
Ne liste que les références qui pointent vers l'objet donné.

--fusionné [ ]
Seules les références de liste dont les conseils sont accessibles à partir du commit spécifié (HEAD sinon
spécifié).

--no-fusionné [ ]
Ne lister que les références dont les astuces ne sont pas accessibles à partir du commit spécifié (HEAD sinon
spécifié).

--contient [ ]
Ne lister que les balises qui contiennent le commit spécifié (HEAD si non spécifié).

CHAMP DES NOMS

Différentes valeurs de champs structurés dans des objets référencés peuvent être utilisées pour interpoler
dans la sortie résultante, ou en tant que clés de tri.

Pour tous les objets, les noms suivants peuvent être utilisés :

nom de référence
Le nom de la référence (la partie après $GIT_DIR/). Pour un nom court non ambigu du
ref append :short. L'option core.warnAmbiguousRefs est utilisée pour sélectionner le strict
mode abréviation. Si bande= est annexé, bandes chemin séparé par des barres obliques
composants à partir du début du nom de référence (par exemple, %(refname:strip=2) transforme refs/tags/foo
dans foo. doit être un entier positif. Si une référence affichée a moins de composants
que , la commande s'interrompt avec une erreur.

type d'objet
Le type de l'objet (blob, tree, commit, tag).

taille de l'objet
La taille de l'objet (la même que jet chat-fichier -s rapports).

nom de l'objet
Le nom de l'objet (alias SHA-1). Pour une abréviation non ambiguë du nom de l'objet
ajouter :court.

en amont
Le nom d'une réf locale qui peut être considérée comme « en amont » de la réf affichée.
Respecte :short de la même manière que refname ci-dessus. Respecte en plus : piste à montrer
"[ahead N, Behind M]" et :trackshort pour afficher la version laconique : ">" (ahead), "<"
(derrière), "<>" (en avant et en arrière) ou "=" (en synchronisation). N'a aucun effet si la référence ne
avoir des informations de suivi qui lui sont associées.

pousser
Le nom d'une référence locale qui représente l'emplacement @{push} de la référence affichée.
Respecte les options :short, :track et :trackshort comme le fait en amont. Produit un vide
chaîne si aucune référence @{push} n'est configurée.

TÊTE
* si HEAD correspond à la référence actuelle (la branche extraite), ' ' sinon.

Couleur
Changer la couleur de sortie. Suivie par : , où les noms sont décrits dans
branche.de.couleur.*.

aligner
Alignez le contenu à gauche, au milieu ou à droite entre %(align:...) et %(end). Les
"align:" est suivi de et dans n'importe quel ordre séparé par une virgule,
où le est à gauche, à droite ou au milieu, la valeur par défaut étant à gauche et
est la longueur totale du contenu avec alignement. Si la longueur du contenu est supérieure à
la largeur alors aucun alignement n'est effectué. Si utilisé avec --citation tout entre
%(align:...) et %(end) sont entre guillemets, mais s'ils sont imbriqués, seul le niveau le plus élevé est exécuté
citant.

En plus de ce qui précède, pour les objets commit et tag, les noms des champs d'en-tête (arborescence,
parent, objet, type et balise) peut être utilisé pour spécifier la valeur dans le champ d'en-tête.

Pour les objets commit et tag, les champs spéciaux creatordate et créateur correspondront à
la date appropriée ou le tuple nom-email-date des champs committer ou tagger
selon le type d'objet. Ceux-ci sont destinés à travailler sur un mélange d'annotations et
étiquettes légères.

Les champs qui ont comme valeur un tuple nom-email-date (auteur, committer et tagueur) peuvent être
suffixe du nom, de l'e-mail et de la date pour extraire le composant nommé.

Le message complet dans un objet commit et tag est le contenu. Sa première ligne est
contents:subject, où subject est la concaténation de toutes les lignes du message de commit up
à la première ligne vide. La ligne suivante est contenu:corps, où le corps est l'ensemble des lignes
après la première ligne vide. La signature GPG facultative est contents:signature. Le premier N
lignes du message est obtenu en utilisant contents:lines=N.

À des fins de tri, les champs avec des valeurs numériques trient dans l'ordre numérique (taille de l'objet,
auteur, date de validation, date de création, date de tag). Tous les autres champs sont utilisés pour trier
leur ordre de valeur d'octet.

Il existe également une option pour trier par versions, cela peut être fait en utilisant le nom de champ
version:refname ou son alias v:refname.

Dans tous les cas, un nom de champ qui renvoie à un champ inapplicable à l'objet référencé par
la référence ne provoque pas d'erreur. Il renvoie une chaîne vide à la place.

Comme cas particulier pour les champs de type date, vous pouvez spécifier un format pour la date en
ajout : suivi du nom du format de date (voir les valeurs de l'option --date à :git-rev-
liste(1) prend).

EXEMPLES

Un exemple produisant directement du texte formaté. Afficher les 3 commits tagués les plus récents :

#!/ Bin / sh

git for-each-ref --count=3 --sort='-*authordate' \
--format='De : %(*authorname) %(*authoremail)
Objet : %(*objet)
Date : %(*dateauteur)
Réf : %(*refname)

%(*corps)
' 'références/balises'

Un exemple simple montrant l'utilisation de shell eval sur la sortie, démontrant l'utilisation de
--coquille. Lister les préfixes de toutes les têtes :

#!/ Bin / sh

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
pendant la lecture de l'entrée
do
eval "$entry"
echo `dirname $ref`
fait

Un rapport un peu plus élaboré sur les balises, démontrant que le format peut être tout un
script:

#!/ Bin / sh

fmt='
r=%(nom de référence)
t=%(*type d'objet)
T=${r#refs/tags/}

o=%(*nom d'objet)
n=%(*nom de l'auteur)
e=%(*courriel de l'auteur)
s=%(*sujet)
d=%(*dateauteur)
b=%(*corps)

genre=Étiquette
si test "z$t" = z
puis
# pourrait être une balise légère
t=%(type d'objet)
kind="balise légère"
o=%(nom de l'objet)
n=%(nom de l'auteur)
e=%(courriel de l'auteur)
s=%(sujet)
d=%(dateauteur)
b=%(corps)
fi
echo "$kind $T pointe vers un $t objet $o"
si test "z$t" = zcommit
puis
echo "Le commit a été créé par $n $e
à $d, et intitulé

$s

Son message se lit comme suit :
"
echo "$b" | sed -e "s/^/ /"
echo
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*typed'objet' \
--sort=-taggerdate\
références/balises`
eval "$eval"

Utilisez git-for-each-ref en ligne en utilisant les services onworks.net