git-for-each-ref - クラウドでオンライン

プログラム：

NAME

git-for-each-ref - 各 ref の情報を出力する

SYNOPSIS

git 参照ごとに [--カウント= ] [--shell|--perl|--python|--tcl]
[(--ソート= )...] [--format= ][ ...]
[--ポイント- ] [(--merged | --no-merged) [ ]]
[--[を含む] ]]

DESCRIPTION

一致するすべての参照を反復処理しますそして与えられたものに従ってそれらを示します、
指定されたセットに従って並べ替えた後、 。 もしもが与えられた後は停止します
多くの参照を示しています。 内挿された値オプションで次のように引用できます
指定されたホスト言語の文字列リテラルにより、その言語での直接評価が可能になります。
言語。

OPTIONS

デフォルトでは、コマンドは一致するすべての参照を表示します。 。 このオプションにより停止します
あれだけの参照を示した後。


並べ替えるフィールド名。 プレフィックス - 値の降順に並べ替えます。 いつ
指定されていない場合は、refname が使用されます。 --sort= を使用することもできます。 オプションを複数回、
この場合、最後のキーが主キーになります。


ref が指すオブジェクトから %(fieldname) を補間する文字列
示されています。 fieldname の先頭にアスタリスク (*) が付いており、ref がタグを指している場合
object の場合、object タグが参照するフィールドの値が使用されます。 指定しない場合は、
デフォルトは %(objectname) SPC %(objecttype) TAB %(refname) です。 また、%% を補間して、
%、および %xx (xx は XNUMX 進数) は、XNUMX 進コード xx の文字に補間されます。 ために
たとえば、%00 は \0 (NUL)、%09 は \t (TAB)、%0a は \n (LF) に補間されます。

...
XNUMX つ以上のパターンが指定された場合、少なくとも XNUMX つと一致する参照のみが表示されます。
パターン、どちらかを使用 fnmatch(3) または文字通り、後者の場合は完全に一致します。
または最初からスラッシュまで。

--shell、--perl、--python、--tcl
指定した場合、%(fieldname) プレースホルダーを置換する文字列は文字列として引用されます。
指定されたホスト言語に適したリテラル。 これは、
直接「評価」できるスクリプトレット。

--ポイントポイント
指定されたオブジェクトを指す参照のみをリストします。

--マージ [ ]
指定されたコミット (そうでない場合は HEAD) からヒントが到達可能な参照のみをリストします。
指定）。

--no-merged [ 】
指定されたコミット (そうでない場合は HEAD) からヒントが到達できない参照のみをリストします。
指定）。

-- を含む [ 】
指定されたコミット (指定されていない場合は HEAD) を含むタグのみをリストします。

フィールド 名前

参照オブジェクトの構造化フィールドのさまざまな値を補間に使用できます。
結果の出力に、またはソートキーとして。

すべてのオブジェクトに対して、次の名前を使用できます。

参照名
参照の名前 ($GIT_DIR/ の後の部分)。 曖昧さのない短い名前の場合、
参照追加:短い。 オプション core.warnAmbiguousRefs は、厳密な値を選択するために使用されます。
略語モード。 ストリップ=の場合追加され、削除されますスラッシュで区切られたパス
refname の前からのコンポーネント (例: %(refname:strip=2) は refs/tags/foo になります)
フーに。 正の整数でなければなりません。 表示された参照のコンポーネントが少ない場合
よりもの場合、コマンドはエラーで中止されます。

オブジェクトタイプ
オブジェクトのタイプ (BLOB、ツリー、コミット、タグ)。

オブジェクトサイズ
オブジェクトのサイズ（と同じ） git 猫ファイル -s 報告）。

オブジェクト名
オブジェクト名 (別名 SHA-1)。 オブジェクト名の明確な省略形の場合
追加:短い。

アップストリーム
表示されている参照から「上流」とみなされるローカル参照の名前。
上記の refname と同じように :short を尊重します。 さらに、表示する :track を尊重します
"[ahead N, Behind M]" と :trackshort で簡潔なバージョンを表示します: ">" (前)、"<"
(後ろ)、「<>」(前後)、または「=」(同期)。 参照がそうでない場合は効果がありません
それに関連付けられた追跡情報があります。

プッシュ
表示されている ref の @{push} の場所を表すローカル ref の名前。
アップストリームと同様に、:short、:track、および:trackshort オプションを尊重します。 空の状態を生成します
@{push} ref が設定されていない場合は文字列。

HEAD
* HEAD が現在の ref (チェックアウトされたブランチ) と一致する場合、「 」、そうでない場合。

カラー
出力色を変更します。 に続く ： 、名前は で説明されています。
カラー.ブランチ.*。

整列する
%(align:...) と %(end) の間のコンテンツを左揃え、中央揃え、または右揃えにします。 の
「align:」の後にはとカンマで区切られた任意の順序で、
どこは左、右、中央のいずれかで、デフォルトは左、
アラインメントを含むコンテンツの全長です。 コンテンツの長さがそれ以上の場合
幅が指定されている場合、位置合わせは実行されません。 と一緒に使用する場合 - 見積もり 間のすべて
%(align:...) と %(end) は引用符で囲まれていますが、ネストされている場合は最上位レベルのみが実行されます。
引用します。

上記に加えて、コミット オブジェクトとタグ オブジェクトのヘッダー フィールド名 (ツリー、
親、オブジェクト、タイプ、タグ) を使用して、ヘッダー フィールドの値を指定できます。

コミット オブジェクトとタグ オブジェクトの場合、特別な Creatordate フィールドと Creator フィールドが対応します。
コミッターまたはタガーフィールドからの適切な日付または名前-電子メール-日付タプル
オブジェクトの種類に応じて異なります。 これらは、注釈付きと
軽量タグ。

name-email-date タプルを値として持つフィールド (作成者、コミッター、タグ付け者) は、
名前、電子メール、および日付を接尾辞として付けて、名前付きコンポーネントを抽出します。

コミットおよびタグ オブジェクト内の完全なメッセージはコンテンツです。 その最初の行は
content:subject、subject はコミットメッセージのすべての行を連結したものです。
最初の空白行まで。 次の行は 内容物:本体、ここで body はすべての行です
最初の空白行の後。 オプションの GPG 署名は、contents:signature です。 最初のN
メッセージの行数は、contents:lines=N を使用して取得されます。

並べ替えの目的で、数値を含むフィールドは数値順に並べ替えられます (オブジェクトサイズ、
作成者日付、コミッター日付、作成者日付、タグ付け日付)。 他のすべてのフィールドは並べ替えに使用されます
バイト値の順序。

バージョンで並べ替えるオプションもあります。これは、フィールド名を使用して実行できます。
version:refname またはそのエイリアス v:refname。

いずれの場合も、フィールドを参照するフィールド名は、参照されるオブジェクトには適用されません。
ref はエラーを引き起こしません。 代わりに空の文字列を返します。

日付型フィールドの特殊なケースとして、次の方法で日付の形式を指定できます。
追加: の後に日付形式名が続きます ( --date オプションの値を参照してください) :git-rev-
リスト(1)がかかります)。

例

書式設定されたテキストを直接生成する例。 最新の 3 つのタグ付きコミットを表示します。

#!/bin/sh

git for-each-ref --count=3 --sort='-*authordate' \
--format='From: %(*著者名) %(*著者メールアドレス)
件名: %(*件名)
日付: %(*作成者日付)
参照: %(*参照名)

％（*体）
' '参照/タグ'

出力でのシェル eval の使用を示す簡単な例。
- シェル。 すべてのヘッドの接頭辞をリストします。

#!/bin/sh

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
エントリの読み取り中
do
eval "$entry"
echo `ディレクトリ名 $ref`
行われ

タグに関するもう少し精緻なレポート。フォーマットが全体的なものである可能性があることを示しています。
スクリプト：

#!/bin/sh

fmt='
r=%(参照名)
t=%(*オブジェクトタイプ)
T=${r#refs/tags/}

o=%(*オブジェクト名)
n=%(*著者名)
e=%(*作成者のメールアドレス)
s=%(*件名)
d=%(*作成者日付)
b=%(*本体)

種類=タグ
if テスト "z$t" = z
その後
# 軽量タグである可能性があります
t=%(オブジェクトタイプ)
kind="軽量タグ"
o=%(オブジェクト名)
n=%(著者名)
e=%(作成者のメールアドレス)
s=%(件名)
d=%(作成者日付)
b=%(ボディ)
fi
echo "$kind $T は $t オブジェクト $o を指します"
if テスト "z$t" = zcommit
その後
echo "コミットは $n $e によって作成されました
$d にあり、タイトルが付いています

$s

そのメッセージは次のようになります。
"
エコー "$b" | sed -e "s/^/ /"
echo
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*オブジェクトタイプ' \
--sort=-taggerdate \
参照/タグ`
eval "$eval"

onworks.net サービスを使用してオンラインで git-for-each-ref を使用する